feat: enhance service discovery and proxy management

backend/app/services/mitmproxy/examples.py

@@ -4,11 +4,11 @@ DOCS_EXAMPLES_URL = "https://docs.mitmproxy.org/stable/addons/examples/"
 
 BUILTIN_EXAMPLES = [
     AddonExampleDocument(
-        id="http-add-response-header",
-        name="HTTP add response header",
+        id="http-tag-traffic",
+        name="Tag proxied traffic",
         description=(
-            "Injects a fixed response header on every HTTP response so you can "
-            "verify that traffic is passing through the proxy response path."
+            "Adds a visible response header on every HTTP reply so you can tell "
+            "immediately whether the request crossed the proxy."
         ),
         category="http",
         source_url=DOCS_EXAMPLES_URL,
@@ -21,11 +21,11 @@ def response(flow: http.HTTPFlow) -> None:
 """,
     ),
     AddonExampleDocument(
-        id="http-modify-query",
-        name="HTTP modify query",
+        id="http-force-query-flag",
+        name="Force request flag",
         description=(
-            "Adds or overwrites a query parameter before each request is "
-            "forwarded upstream. Useful for forced debug or feature flags."
+            "Adds or overwrites a request query flag before the flow is sent "
+            "upstream. Useful when you need a stable marker on every request."
         ),
         category="http",
         source_url=DOCS_EXAMPLES_URL,
@@ -38,11 +38,11 @@ def request(flow: http.HTTPFlow) -> None:
 """,
     ),
     AddonExampleDocument(
-        id="http-reply-from-proxy",
-        name="HTTP reply from proxy",
+        id="http-local-health-response",
+        name="Serve local health response",
         description=(
-            "Serves a local HTTP response for a selected path without touching "
-            "the upstream service. Useful for probes, maintenance, or stubs."
+            "Answers one health endpoint directly from the proxy without "
+            "touching the upstream service. Useful for smoke tests and checks."
         ),
         category="http",
         source_url=DOCS_EXAMPLES_URL,
@@ -57,14 +57,32 @@ def request(flow: http.HTTPFlow) -> None:
             b"ok",
             {"content-type": "text/plain"},
         )
+""",
+    ),
+    AddonExampleDocument(
+        id="http-rewrite-health-path",
+        name="Rewrite one request path",
+        description=(
+            "Rewrites a single incoming path before forwarding it upstream. "
+            "Useful when the public route and upstream route do not match."
+        ),
+        category="http",
+        source_url=DOCS_EXAMPLES_URL,
+        built_in=True,
+        code="""from mitmproxy import http
+
+
+def request(flow: http.HTTPFlow) -> None:
+    if flow.request.path == "/healthz":
+        flow.request.path = "/status"
 """,
     ),
     AddonExampleDocument(
         id="websocket-rewrite",
         name="WebSocket rewrite",
         description=(
-            "Rewrites matching bytes inside live WebSocket frames to alter "
-            "runtime flags or payload markers in transit."
+            "Rewrites matching bytes inside live WebSocket frames to flip a "
+            "runtime marker while the flow is passing through the proxy."
         ),
         category="websocket",
         source_url=DOCS_EXAMPLES_URL,
@@ -83,8 +101,8 @@ def websocket_message(flow: http.HTTPFlow) -> None:
         id="tcp-log-messages",
         name="TCP log messages",
         description=(
-            "Logs raw TCP message direction and size for each frame so you can "
-            "observe binary traffic without altering it."
+            "Logs direction and byte size for every TCP frame so you can see "
+            "what is crossing the route without modifying the payload."
         ),
         category="tcp",
         source_url=DOCS_EXAMPLES_URL,
@@ -104,8 +122,8 @@ def tcp_message(flow: tcp.TCPFlow) -> None:
         id="dns-spoof-a-record",
         name="DNS spoof A record",
         description=(
-            "Overrides one DNS A record while forwarding every other query "
-            "unchanged. Useful for selective service redirection."
+            "Overrides one DNS A record while leaving all other queries alone. "
+            "Useful for selective redirection during local testing."
         ),
         category="dns",
         source_url=DOCS_EXAMPLES_URL,