ci(prd): rename PRD to prd-new placeholder per new convention

Each DLP block/warn now reports where the match was found (body,
authorization header, response body) and includes a context snippet:
SNIPPET_CONTEXT chars before and after the match, with the matched
value replaced by REDACT ("********").

scan_token_patterns/scan_known_secrets/scan_naive_injection all gain
`location` and `context` fields on their ScanResult returns. The
outbound scanner takes `auth_header` as a separate kwarg so the two
locations are scanned and reported independently.

redact_tokens() is added to dlp_detectors and used in egress_addon.py
to scrub token patterns and provisioned secrets from host/path fields
before they appear in any log output (level 1 and 2).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

.gitea/workflows/prd-number.yml

@@ -1,125 +0,0 @@
-# Assign sequential numbers to prd-new-*.md files on merge to main.
-#
-# When a PR merges to main and includes prd-new-*.md files this workflow:
-#   1. Finds the next available NNNN number by scanning existing PRDs.
-#   2. Renames each prd-new-*.md to NNNN-<slug>.md.
-#   3. Updates the title header (# PRD prd-new: → # PRD NNNN:).
-#   4. Flips Status: Draft → Active when the push touched files outside
-#      docs/prds/ anywhere in its commit range (i.e. the implementation
-#      shipped together with the PRD).
-#   5. Commits the renaming back to main.
-#
-# No-op if the working tree contains no prd-new-*.md files.
-#
-# NOTE: The workflow scans the working tree (not just HEAD~1..HEAD) because
-# PRs land as multi-commit pushes and the prd-new file is often added in an
-# earlier commit on the branch, not in the final squash/merge commit.
-
-name: prd-number
-
-on:
-  push:
-    branches:
-      - main
-    paths:
-      - 'docs/prds/prd-new-*.md'
-
-jobs:
-  assign-numbers:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-          token: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
-
-      - name: Configure git
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-
-      - name: Assign PRD numbers
-        run: |
-          python3 - <<'EOF'
-          import os
-          import re
-          import subprocess
-          import sys
-          from pathlib import Path
-
-          prds_dir = Path("docs/prds")
-
-          # Scan the working tree — prd-new files may have landed in any
-          # commit of a multi-commit push, not just HEAD.
-          new_prds = sorted(prds_dir.glob("prd-new-*.md"))
-
-          if not new_prds:
-              print("No prd-new-*.md files found — nothing to do.")
-              sys.exit(0)
-
-          # Determine whether non-PRD files were also changed anywhere in
-          # the push range (BEFORE_SHA → HEAD).  Falls back to HEAD~1 when
-          # the env var isn't set (e.g. local act runs).
-          before_sha = os.environ.get("GITHUB_EVENT_BEFORE", "HEAD~1")
-          all_changed = subprocess.run(
-              ["git", "diff", "--name-only", before_sha, "HEAD"],
-              capture_output=True, text=True, check=True,
-          ).stdout.splitlines()
-          non_prd_changed = any(
-              not f.startswith("docs/prds/") for f in all_changed
-          )
-
-          # Find next available number.
-          existing = sorted(
-              int(m.group(1))
-              for p in prds_dir.glob("*.md")
-              if (m := re.match(r"^(\d{4})-", p.name))
-          )
-          next_num = (max(existing) + 1) if existing else 1
-
-          for prd_path in sorted(new_prds):
-              slug = re.sub(r"^prd-new-", "", prd_path.stem)
-              new_name = f"{next_num:04d}-{slug}.md"
-              new_path = prds_dir / new_name
-              print(f"  {prd_path.name}  →  {new_name}")
-
-              content = prd_path.read_text()
-
-              # Update title header.
-              content = re.sub(
-                  r"^(#\s+PRD\s+)prd-new(:)",
-                  rf"\g<1>{next_num:04d}\2",
-                  content,
-                  count=1,
-                  flags=re.MULTILINE,
-              )
-
-              # Conditionally flip Status.
-              if non_prd_changed:
-                  content = re.sub(
-                      r"(\*\*Status:\*\*\s*)Draft",
-                      r"\g<1>Active",
-                      content,
-                      count=1,
-                  )
-
-              new_path.write_text(content)
-              subprocess.run(["git", "rm", str(prd_path)], check=True)
-              subprocess.run(["git", "add", str(new_path)], check=True)
-              next_num += 1
-
-          subprocess.run(
-              ["git", "commit", "-m", "ci(prd): assign sequential numbers to new PRDs"],
-              check=True,
-          )
-          subprocess.run(["git", "push"], check=True)
-          EOF

AGENTS.md

@@ -36,11 +36,10 @@ the container lifecycle and the copying of skills and env vars into it.
 
 - Three kinds of doc, each with its own conventions in-folder; see
   `docs/README.md` for when to write which:
-  - **PRDs** (`docs/prds/`) — one feature per file. While a PR is open
-    the file is named `prd-new-<kebab>.md`; CI assigns a sequential
-    number on merge to `main` and renames it. A `Status:` line tracks
-    lifecycle: Draft → Active (shipped to `main`) →
-    Superseded/Retargeted. Format in `docs/prds/README.md`.
+  - **PRDs** (`docs/prds/`) — one feature per file, numbered
+    `NNNN-kebab.md`. A `Status:` line tracks lifecycle: Draft → Active
+    (shipped to `main`) → Superseded/Retargeted. Format in
+    `docs/prds/README.md`.
   - **Research notes** (`docs/research/`) — opinionated investigations;
     unnumbered kebab-case, freeform and verdict-first. See
     `docs/research/README.md`.

Dockerfile.claude

@@ -16,20 +16,14 @@ FROM node:22-slim
 # features (status checks, commits, PR creation) — without git in the
 # image, those features fail in surprising ways once the user does any
 # real work. ca-certificates is already in the slim base; listed for
-# clarity in case the base ever drops it. curl is here so any
-# HTTPS_PROXY-aware tool (curl itself, plus anything that shells out
-# to it) works against egress's bumped TLS without the agent needing
-# local DNS.
+# clarity in case the base ever drops it. socat is the privileged
+# forwarder for the in-container ssh-agent (see bot_bottle/ssh.py): the agent
+# runs as root and rejects non-root connections, so socat sits between
+# node and the agent socket. curl is here so any HTTPS_PROXY-aware
+# tool (curl itself, plus anything that shells out to it) works
+# against egress's bumped TLS without the agent needing local DNS.
 RUN apt-get update \
-  && apt-get install -y --no-install-recommends git ca-certificates curl \
-  && rm -rf /var/lib/apt/lists/*
-
-# App-specific deps. Python isn't required by claude-code itself
-# (claude-code is a Node CLI), but is convenient for the agent to
-# shell out to for ad-hoc scripts. Kept on its own layer so it can
-# be moved to a downstream image if the base ever needs to shrink.
-RUN apt-get update \
-  && apt-get install -y --no-install-recommends python3 python3-pip python3-venv \
+  && apt-get install -y --no-install-recommends git ca-certificates openssh-client socat curl dnsutils python3 python3-pip python3-venv \
   && rm -rf /var/lib/apt/lists/*
 
 # Install claude-code globally. Pinned to the version verified in the v1

Dockerfile.codex

@@ -6,15 +6,7 @@
 FROM node:22-slim
 
 RUN apt-get update \
-  && apt-get install -y --no-install-recommends git ca-certificates curl \
-  && rm -rf /var/lib/apt/lists/*
-
-# App-specific deps. Python isn't required by codex itself
-# (codex is a Node CLI), but is convenient for the agent to shell
-# out to for ad-hoc scripts. Kept on its own layer so it can be
-# moved to a downstream image if the base ever needs to shrink.
-RUN apt-get update \
-  && apt-get install -y --no-install-recommends python3 python3-pip python3-venv \
+  && apt-get install -y --no-install-recommends git ca-certificates openssh-client socat curl dnsutils python3 python3-pip python3-venv \
   && rm -rf /var/lib/apt/lists/*
 
 RUN npm install -g --no-fund --no-audit @openai/codex@0.136.0 \

README.md

@@ -5,7 +5,7 @@
 # bot-bottle
 
 [![test](https://gitea.dideric.is/didericis/bot-bottle/actions/workflows/test.yml/badge.svg?branch=main)](https://gitea.dideric.is/didericis/bot-bottle/actions?workflow=test.yml)
-[![pylint](https://img.shields.io/badge/pylint-9.93%2F10-brightgreen)](https://github.com/PyCQA/pylint)
+[![pylint](https://img.shields.io/badge/pylint-9.92%2F10-brightgreen)](https://github.com/PyCQA/pylint)
 [![pyright](https://img.shields.io/badge/pyright-0%20errors-brightgreen)](https://github.com/microsoft/pyright)
 
 **Problem:** Developer wants to run a coding agent without supervision, but they don't want a prompt injected or misbehaving agent wrecking their environment or exfiltrating sensitive data.

bot_bottle/agent_provider.py

@@ -19,10 +19,6 @@ Per PRD 0050 the per-provider implementations live under
 
 from __future__ import annotations
 
-import importlib.util
-import os
-import shlex
-import tempfile
 from abc import ABC, abstractmethod
 from dataclasses import dataclass, field
 from pathlib import Path
@@ -139,8 +135,6 @@ class AgentProvider(ABC):
         forward_host_credentials: bool = False,
         host_env: dict[str, str] | None = None,
         trusted_project_path: str = "",
-        label: str = "",
-        color: str = "",
     ) -> AgentProvisionPlan:
         """Build the declarative AgentProvisionPlan for one launch.
         Backends call this during `prepare` and consume the result as
@@ -180,130 +174,13 @@ class AgentProvider(ABC):
         the supervise sidecar is reachable. No-op when
         `plan.supervise_plan is None`."""
 
-    def provision_ca(self, bottle: "Bottle", plan: "BottlePlan") -> None:
-        """Install the egress MITM CA into the agent's trust store.
-
-        Default: Debian-style — cp the cert to the standard source path,
-        run update-ca-certificates, log the fingerprint. Override for
-        non-Debian base images or non-standard trust mechanisms."""
-        from .backend.util import AGENT_CA_PATH, log_ca_fingerprint, select_ca_cert
-        from .log import die
-        cert_host_path, label = select_ca_cert(plan.egress_plan)
-        bottle.cp_in(str(cert_host_path), AGENT_CA_PATH)
-        r = bottle.exec(
-            f"chmod 644 {AGENT_CA_PATH} && update-ca-certificates",
-            user="root",
-        )
-        if r.returncode != 0:
-            die(
-                f"update-ca-certificates failed (exit {r.returncode}): "
-                f"stdout={(r.stdout or '').strip()!r} "
-                f"stderr={(r.stderr or '').strip()!r}"
-            )
-        log_ca_fingerprint(cert_host_path, label)
-
-    def provision_git(self, bottle: "Bottle", plan: "BottlePlan") -> None:
-        """Configure git inside the agent container.
-
-        Default: Debian/node — copies .git when --cwd is set, writes the
-        git-gate insteadOf gitconfig, sets user.name/email as node.
-        Override for images that run as a different user or use a
-        non-standard home directory."""
-        from .log import info
-        workspace = plan.workspace_plan
-        if workspace.enabled and workspace.copy_git and workspace.has_host_git_dir:
-            guest_workspace_git = f"{workspace.guest_path}/.git"
-            host_git = str(workspace.host_path / ".git")
-            info(f"copying {host_git} -> {bottle.name}:{guest_workspace_git}")
-            bottle.exec(f"mkdir -p {shlex.quote(workspace.guest_path)}", user="root")
-            bottle.cp_in(host_git, guest_workspace_git)
-            bottle.exec(
-                f"chown -R {shlex.quote(workspace.owner)} "
-                f"{shlex.quote(guest_workspace_git)}",
-                user="root",
-            )
-
-        manifest_bottle = plan.spec.manifest.bottle_for(plan.spec.agent_name)
-        if manifest_bottle.git:
-            from .git_gate import GIT_GATE_HOSTNAME, git_gate_render_gitconfig
-            gate_host = getattr(plan, "git_gate_insteadof_host", GIT_GATE_HOSTNAME)
-            gate_scheme = getattr(plan, "git_gate_insteadof_scheme", "git")
-            content = git_gate_render_gitconfig(
-                manifest_bottle.git, gate_host, scheme=gate_scheme,
-            )
-            guest_gitconfig = f"{plan.guest_home}/.gitconfig"
-            with tempfile.NamedTemporaryFile(
-                "w", dir=str(plan.stage_dir), prefix="gitconfig.", delete=False,
-            ) as f:
-                f.write(content)
-                config_file = Path(f.name)
-            os.chmod(config_file, 0o600)
-            info(
-                f"writing {guest_gitconfig} with "
-                f"{len(manifest_bottle.git)} insteadOf rule(s)"
-            )
-            bottle.cp_in(str(config_file), guest_gitconfig)
-            bottle.exec(
-                f"chown node:node {shlex.quote(guest_gitconfig)} && "
-                f"chmod 644 {shlex.quote(guest_gitconfig)}",
-                user="root",
-            )
-
-        gu = manifest_bottle.git_user
-        if not gu.is_empty():
-            if gu.name:
-                info(f"git config --global user.name = {gu.name!r}")
-                bottle.exec(
-                    f"git config --global user.name {shlex.quote(gu.name)}",
-                    user="node",
-                )
-            if gu.email:
-                info(f"git config --global user.email = {gu.email!r}")
-                bottle.exec(
-                    f"git config --global user.email {shlex.quote(gu.email)}",
-                    user="node",
-                )
-
-
-def _load_user_plugin(template: str) -> AgentProvider | None:
-    """Check ~/.bot-bottle/contrib/<template>/agent_provider.py for a
-    user-defined AgentProvider subclass. Returns an instance if found,
-    None if the plugin directory doesn't exist, raises ValueError if
-    the file exists but exports no AgentProvider subclass."""
-    plugin_path = (
-        Path.home() / ".bot-bottle" / "contrib" / template / "agent_provider.py"
-    )
-    if not plugin_path.exists():
-        return None
-    spec = importlib.util.spec_from_file_location(
-        f"_user_contrib_{template}.agent_provider", plugin_path
-    )
-    if spec is None or spec.loader is None:
-        raise ValueError(f"user plugin at {plugin_path} could not be loaded")
-    mod = importlib.util.module_from_spec(spec)
-    spec.loader.exec_module(mod)  # type: ignore[union-attr]
-    for obj in vars(mod).values():
-        if (
-            isinstance(obj, type)
-            and issubclass(obj, AgentProvider)
-            and obj is not AgentProvider
-        ):
-            return obj()
-    raise ValueError(
-        f"user plugin at {plugin_path} defines no AgentProvider subclass"
-    )
-
 
 def get_provider(template: str) -> AgentProvider:
     """Resolve a provider template name to its plugin instance.
 
-    Checks ~/.bot-bottle/contrib/<template>/agent_provider.py first so
-    users can shadow a built-in for local testing. Falls through to the
-    built-in registry; raises ValueError for unknown names with no
-    matching user plugin."""
-    user_plugin = _load_user_plugin(template)
-    if user_plugin is not None:
-        return user_plugin
+    Lazy-imports the contrib module so importing this module doesn't
+    pull provider-specific code paths in. Mirrors the contrib
+    convention PRD 0048 established for deploy key provisioners."""
     if template == PROVIDER_CLAUDE:
         from .contrib.claude.agent_provider import ClaudeAgentProvider
         return ClaudeAgentProvider()
@@ -328,8 +205,6 @@ def agent_provision_plan(
     forward_host_credentials: bool = False,
     host_env: dict[str, str] | None = None,
     trusted_project_path: str = "",
-    label: str = "",
-    color: str = "",
 ) -> AgentProvisionPlan:
     """Back-compat shim — `prepare` callers stay the same; the work
     now lives on the provider plugin."""
@@ -342,8 +217,6 @@ def agent_provision_plan(
         forward_host_credentials=forward_host_credentials,
         host_env=host_env,
         trusted_project_path=trusted_project_path,
-        label=label,
-        color=color,
     )
 
 

bot_bottle/backend/__init__.py

@@ -67,8 +67,6 @@ class BottleSpec:
     # (`cli.py resume <identity>`) sets this to continue an existing
     # bottle's state. Empty string for a fresh `start`.
     identity: str = ""
-    label: str = ""
-    color: str = ""
 
 
 @dataclass(frozen=True)
@@ -80,20 +78,6 @@ class BottlePlan(ABC):
     stage_dir: Path
     guest_home: str
     git_gate_plan: GitGatePlan
-
-    @property
-    def git_gate_insteadof_host(self) -> str:
-        """Host (and optional port) used in git-gate insteadOf URLs.
-        Docker uses the compose-network DNS alias; smolmachines
-        overrides with a loopback IP:port since TSI has no DNS."""
-        return "git-gate"
-
-    @property
-    def git_gate_insteadof_scheme(self) -> str:
-        """URL scheme for git-gate insteadOf rewrites. 'git' for
-        Docker (git daemon); 'http' for smolmachines (HTTP proxy
-        over a published host port)."""
-        return "git"
     egress_plan: EgressPlan
     supervise_plan: SupervisePlan | None
     agent_provision: AgentProvisionPlan
@@ -191,8 +175,6 @@ class ActiveAgent:
     agent_name: str       # from metadata.json; "?" if missing
     started_at: str       # ISO 8601 from metadata.json; "" if missing
     services: tuple[str, ...]  # alphabetical
-    label: str = ""
-    color: str = ""
 
 
 class Bottle(ABC):
@@ -357,22 +339,36 @@ class BottleBackend(ABC, Generic[PlanT, CleanupT]):
         HTTPS_PROXY (claude-code, git over HTTPS, npm, curl) is
         intercepted without per-tool reconfiguration."""
         provider = get_provider(plan.agent_provision.template)
-        provider.provision_ca(bottle, plan)
+        self.provision_ca(plan, bottle)
         prompt_path = provider.provision_prompt(plan, bottle)
         provider.provision(plan, bottle)
         provider.provision_skills(plan, bottle)
         self.provision_workspace(plan, bottle)
-        provider.provision_git(bottle, plan)
+        self.provision_git(plan, bottle)
         provider.provision_supervise_mcp(
             plan, bottle, self.supervise_mcp_url(plan),
         )
         return prompt_path
 
+    def provision_ca(self, plan: PlanT, bottle: "Bottle") -> None:
+        """Install the per-bottle CA into the agent's trust store so
+        the agent trusts the bumped CONNECT cert egress presents.
+        Default impl is a no-op so
+        backends that don't yet support TLS interception (every backend
+        except Docker today) aren't forced to implement it. The Docker
+        backend overrides to docker-cp the cert in and run
+        `update-ca-certificates`."""
+
     def provision_workspace(self, plan: PlanT, bottle: "Bottle") -> None:
         """Copy the operator workspace into the running bottle when
         the backend cannot bake it into the agent image. Default is
         no-op for backends like Docker that handle this before launch."""
 
+    @abstractmethod
+    def provision_git(self, plan: PlanT, bottle: "Bottle") -> None:
+        """Copy the host's cwd `.git` directory into the running
+        bottle if the user requested --cwd. No-op otherwise."""
+
     def supervise_mcp_url(self, plan: PlanT) -> str:
         """Return the agent-side URL of the per-bottle supervise
         sidecar, or "" when this bottle has no sidecar. The provider
@@ -415,8 +411,8 @@ class BottleBackend(ABC, Generic[PlanT, CleanupT]):
 # Import concrete backend classes AFTER the base types are defined, so
 # each backend module can pull BottleSpec / BottlePlan / BottleBackend
 # via `from . import ...` without hitting a partially-initialized module.
-from .docker import DockerBottleBackend  # noqa: E402  # pylint: disable=wrong-import-position
-from .smolmachines import SmolmachinesBottleBackend  # noqa: E402  # pylint: disable=wrong-import-position
+from .docker import DockerBottleBackend  # noqa: E402
+from .smolmachines import SmolmachinesBottleBackend  # noqa: E402
 
 
 # The dict is heterogeneous: each value is a BottleBackend specialized

bot_bottle/backend/docker/backend.py

@@ -25,7 +25,7 @@ from pathlib import Path
 from typing import Generator, Sequence
 
 from ...supervise import SUPERVISE_HOSTNAME, SUPERVISE_PORT
-from .. import ActiveAgent, BottleBackend, BottleSpec
+from .. import ActiveAgent, Bottle, BottleBackend, BottleSpec
 from . import cleanup as _cleanup
 from . import enumerate as _enumerate
 from . import launch as _launch
@@ -33,6 +33,10 @@ from . import prepare as _prepare
 from .bottle import DockerBottle
 from .bottle_cleanup_plan import DockerBottleCleanupPlan
 from .bottle_plan import DockerBottlePlan
+from .provision import ca as _ca
+from .provision import git as _git
+
+
 class DockerBottleBackend(BottleBackend["DockerBottlePlan", "DockerBottleCleanupPlan"]):
     """Docker backend implementation. Selected by BOT_BOTTLE_BACKEND
     (default)."""
@@ -56,6 +60,12 @@ class DockerBottleBackend(BottleBackend["DockerBottlePlan", "DockerBottleCleanup
         with _launch.launch(plan, provision=self.provision) as bottle:
             yield bottle
 
+    def provision_ca(self, plan: DockerBottlePlan, bottle: Bottle) -> None:
+        _ca.provision_ca(plan, bottle)
+
+    def provision_git(self, plan: DockerBottlePlan, bottle: Bottle) -> None:
+        _git.provision_git(plan, bottle)
+
     def supervise_mcp_url(self, plan: DockerBottlePlan) -> str:
         """Docker bottles reach the supervise sidecar via the
         compose-network alias `supervise:9100`. No per-bottle URL

bot_bottle/backend/docker/bottle_state.py

@@ -109,8 +109,6 @@ class BottleMetadata:
     # for state dirs written before PRD 0040; callers default to "docker"
     # for backward compatibility.
     backend: str = ""
-    label: str = ""
-    color: str = ""
 
 
 def metadata_path(identity: str) -> Path:
@@ -146,8 +144,6 @@ def read_metadata(identity: str) -> BottleMetadata | None:
         started_at=str(raw_typed.get("started_at", "")),
         compose_project=str(raw_typed.get("compose_project", "")),
         backend=str(raw_typed.get("backend", "")),
-        label=str(raw_typed.get("label", "")),
-        color=str(raw_typed.get("color", "")),
     )
 
 

bot_bottle/backend/docker/egress_apply.py

@@ -1,20 +1,70 @@
-"""Host-side helper for egress sidecar inspection (issue #198).
+"""Host-side helper to apply a routes.yaml change to a running
+egress sidecar (PRD 0014 retargeted by PRD 0017 chunk 3, PRD 0053).
 
-`_merge_single_route`, `add_route`, and `apply_routes_change` were
-removed when the egress-block MCP tool was dropped. The remaining
-helpers support runtime inspection and validation of the routes file
-without modifying it at runtime.
+Used by the supervise dashboard when the operator approves an
+egress-block proposal. Fetches current routes.yaml, validates,
+writes into the sidecar, then SIGHUPs to reload.
 """
 
 from __future__ import annotations
 
+import json
 import subprocess
+from pathlib import Path
+from typing import cast
 
 from ...egress import EGRESS_ROUTES_IN_CONTAINER
 from ...egress_addon_core import load_routes
+from ...yaml_subset import YamlSubsetError, parse_yaml_subset
+from .bottle_state import egress_state_dir
 from .sidecar_bundle import sidecar_bundle_container_name
 
 
+def _render_routes_payload(routes_list: list[dict[str, object]]) -> str:
+    """Render a list-of-dicts routes payload as YAML matching the
+    shape `egress_render_routes` produces."""
+    if not routes_list:
+        return "routes: []\n"
+    lines: list[str] = ["routes:"]
+    for entry in routes_list:
+        host = str(entry.get("host", ""))
+        lines.append(f'  - host: "{host}"')
+        auth_scheme = entry.get("auth_scheme")
+        token_env = entry.get("token_env")
+        if auth_scheme and token_env:
+            lines.append(f'    auth_scheme: "{auth_scheme}"')
+            lines.append(f'    token_env: "{token_env}"')
+        matches_obj = entry.get("matches")
+        if isinstance(matches_obj, list) and matches_obj:
+            lines.append("    matches:")
+            for match_entry in matches_obj:
+                me = cast(dict[str, object], match_entry)
+                first_key = True
+                if "paths" in me:
+                    lines.append("      - paths:")
+                    first_key = False
+                    for pd in cast(list[dict[str, str]], me["paths"]):
+                        if "type" in pd:
+                            lines.append(f'          - type: "{pd["type"]}"')
+                            lines.append(f'            value: "{pd["value"]}"')
+                        else:
+                            lines.append(f'          - value: "{pd["value"]}"')
+                if "methods" in me:
+                    methods_str = ", ".join(
+                        f'"{m}"' for m in cast(list[str], me["methods"])
+                    )
+                    prefix = "      - " if first_key else "        "
+                    lines.append(f'{prefix}methods: [{methods_str}]')
+                    first_key = False
+                if first_key:
+                    lines.append("      - {}")
+    return "\n".join(lines) + "\n"
+
+
+def _egress_routes_host_path(slug: str) -> Path:
+    return egress_state_dir(slug) / "egress_routes.yaml"
+
+
 class EgressApplyError(RuntimeError):
     pass
 
@@ -42,8 +92,144 @@ def validate_routes_content(content: str) -> None:
         ) from e
 
 
+def apply_routes_change(slug: str, new_content: str) -> tuple[str, str]:
+    container = sidecar_bundle_container_name(slug)
+    before = fetch_current_routes(slug)
+    validate_routes_content(new_content)
+
+    target = _egress_routes_host_path(slug)
+    target.parent.mkdir(parents=True, exist_ok=True)
+    target.write_text(new_content)
+    target.chmod(0o644)
+    sig = subprocess.run(
+        ["docker", "kill", "--signal", "HUP", container],
+        capture_output=True, text=True, check=False,
+    )
+    if sig.returncode != 0:
+        raise EgressApplyError(
+            f"failed to SIGHUP {container}: "
+            f"{(sig.stderr or '').strip()}"
+        )
+
+    return before, new_content
+
+
+def _merge_single_route(
+    current_yaml: str, new_route: dict[str, object],
+) -> str:
+    """Merge a single proposed route into the current routes.yaml.
+
+    - Host absent → append the route.
+    - Host present → union the match paths (proposed ∪ existing).
+      Auth is preserved from existing route.
+    """
+    try:
+        cfg = parse_yaml_subset(current_yaml)
+    except YamlSubsetError as e:
+        raise EgressApplyError(
+            f"current routes.yaml is not valid YAML: {e}"
+        ) from e
+    routes = cfg.get("routes")
+    if not isinstance(routes, list):
+        raise EgressApplyError(
+            "current routes.yaml: 'routes' is not a list"
+        )
+    routes_typed = cast(list[object], routes)
+
+    new_host = str(new_route.get("host", "")).lower()
+    if not new_host:
+        raise EgressApplyError(
+            "proposed route is missing 'host'"
+        )
+
+    # Build proposed matches from the input
+    proposed_matches = new_route.get("matches")
+    if proposed_matches is None:
+        # Accept legacy path_allowlist from agent proposals and convert
+        proposed_paths = new_route.get("path_allowlist")
+        if isinstance(proposed_paths, list) and proposed_paths:
+            proposed_matches = [{"paths": [{"value": p} for p in proposed_paths]}]
+
+    for entry in routes_typed:
+        if not isinstance(entry, dict):
+            continue
+        entry_typed = cast(dict[str, object], entry)
+        if str(entry_typed.get("host", "")).lower() == new_host:
+            # Merge matches: union path values from proposed into existing
+            if isinstance(proposed_matches, list) and proposed_matches:
+                existing_matches = entry_typed.get("matches")
+                if not isinstance(existing_matches, list):
+                    existing_matches = []
+                # Simple merge: collect all existing path values, add new ones
+                existing_paths: set[str] = set()
+                for me in existing_matches:
+                    me_typed = cast(dict[str, object], me) if isinstance(me, dict) else {}
+                    paths = me_typed.get("paths")
+                    if isinstance(paths, list):
+                        for p in paths:
+                            p_typed = cast(dict[str, object], p) if isinstance(p, dict) else {}
+                            val = p_typed.get("value")
+                            if isinstance(val, str):
+                                existing_paths.add(val)
+                new_paths: list[str] = []
+                for me in proposed_matches:
+                    me_typed = cast(dict[str, object], me) if isinstance(me, dict) else {}
+                    paths = me_typed.get("paths")
+                    if isinstance(paths, list):
+                        for p in paths:
+                            p_typed = cast(dict[str, object], p) if isinstance(p, dict) else {}
+                            val = p_typed.get("value")
+                            if isinstance(val, str) and val not in existing_paths:
+                                new_paths.append(val)
+                                existing_paths.add(val)
+                if new_paths:
+                    existing_matches.append(
+                        {"paths": [{"value": p} for p in new_paths]}
+                    )
+                    entry_typed["matches"] = existing_matches
+            break
+    else:
+        entry_typed: dict[str, object] = {"host": new_route.get("host")}  # type: ignore
+        if isinstance(proposed_matches, list) and proposed_matches:
+            entry_typed["matches"] = proposed_matches
+        auth = new_route.get("auth")
+        if isinstance(auth, dict) and auth.get("scheme") and auth.get("token_ref"):  # type: ignore
+            auth_typed = cast(dict[str, object], auth)
+            existing_slots = sorted({
+                str(r_entry.get("token_env", ""))
+                for r_entry_obj in routes_typed
+                if isinstance(r_entry_obj, dict)
+                for r_entry in [cast(dict[str, object], r_entry_obj)]
+                if r_entry.get("token_env")
+            })
+            next_idx = len(existing_slots)
+            entry_typed["auth_scheme"] = str(cast(object, auth_typed.get("scheme")))
+            entry_typed["token_env"] = f"EGRESS_TOKEN_{next_idx}"
+        routes_typed.append(entry_typed)
+
+    return _render_routes_payload(cast(list[dict[str, object]], routes_typed))
+
+
+def add_route(slug: str, proposed_route_json: str) -> tuple[str, str]:
+    try:
+        proposed = json.loads(proposed_route_json)
+    except json.JSONDecodeError as e:
+        raise EgressApplyError(
+            f"proposed route is not valid JSON: {e}"
+        ) from e
+    if not isinstance(proposed, dict):
+        raise EgressApplyError(
+            "proposed route must be a JSON object"
+        )
+    current = fetch_current_routes(slug)
+    merged = _merge_single_route(current, proposed)
+    return apply_routes_change(slug, merged)
+
+
 __all__ = [
     "EgressApplyError",
+    "add_route",
+    "apply_routes_change",
     "fetch_current_routes",
     "validate_routes_content",
 ]

bot_bottle/backend/docker/enumerate.py

@@ -39,8 +39,6 @@ def enumerate_active() -> list[ActiveAgent]:
             agent_name=metadata.agent_name if metadata else "?",
             started_at=metadata.started_at if metadata else "",
             services=tuple(sorted(services)),
-            label=metadata.label if metadata else "",
-            color=metadata.color if metadata else "",
         ))
     return out
 

bot_bottle/backend/docker/prepare.py

@@ -15,7 +15,7 @@ from datetime import datetime, timezone
 from dataclasses import replace
 from pathlib import Path
 
-from ...agent_provider import PROVIDER_TEMPLATES, agent_provision_plan, runtime_for
+from ...agent_provider import agent_provision_plan, runtime_for
 from ...egress import Egress
 from ...env import ResolvedEnv, resolve_env
 from ...git_gate import GitGate
@@ -80,8 +80,6 @@ def resolve_plan(
         started_at=datetime.now(timezone.utc).isoformat(),
         compose_project=f"bot-bottle-{slug}",
         backend="docker",
-        label=spec.label,
-        color=spec.color,
     ))
     # Clear any leftover preserve marker from a prior capability-block
     # so this fresh launch can be cleaned up at session-end unless
@@ -102,15 +100,6 @@ def resolve_plan(
     elif provider_runtime.dockerfile:
         image_default = provider_runtime.image
         dockerfile_path = provider_runtime.dockerfile
-    elif provider.template not in PROVIDER_TEMPLATES:
-        user_dockerfile = (
-            Path.home() / ".bot-bottle" / "contrib" / provider.template / "Dockerfile"
-        )
-        if user_dockerfile.is_file():
-            image_default = f"bot-bottle-{provider.template}:{slug}"
-            dockerfile_path = str(user_dockerfile)
-        else:
-            image_default = provider_runtime.image
     else:
         image_default = provider_runtime.image
     image = os.environ.get("BOT_BOTTLE_IMAGE", image_default)
@@ -193,8 +182,6 @@ def resolve_plan(
         auth_token=provider.auth_token,
         host_env=dict(os.environ),
         trusted_project_path=workspace_plan.workdir,
-        label=spec.label,
-        color=spec.color,
     )
     guest_env = dict(agent_provision.guest_env)
     for key, val in agent_provision.env_vars.items():

bot_bottle/backend/docker/provision/__init__.py

@@ -2,11 +2,10 @@
 
 Per PRD 0050 the per-provider provisioning steps (prompt, skills,
 declarative provision-plan apply, supervise MCP registration) live on
-the `AgentProvider` plugin under `bot_bottle/contrib/`. CA and git
-provisioning also moved to the AgentProvider ABC (with Debian/node
-defaults); user plugins override them for non-standard images.
+the `AgentProvider` plugin under `bot_bottle/contrib/`. The modules
+left in this subpackage handle only the steps that are
+backend-specific:
 
-No modules remain in this subpackage — the directory is kept so that
-existing imports of `from .provision import ...` don't need updating
-if new backend-specific provisioners are added later.
+  - ca.py   — install per-bottle CA bundle into the guest trust store
+  - git.py  — copy host cwd `.git` into the guest when --cwd is used
 """

bot_bottle/backend/docker/provision/ca.py

@@ -0,0 +1,40 @@
+"""Install the per-bottle egress MITM CA into the agent container's
+trust store.
+
+By the time this provisioner runs, `egress_tls_init` has generated
+the egress CA and the path is re-bound into `plan.egress_plan`.
+
+Cert lands on Debian's standard source path
+(`/usr/local/share/ca-certificates/`); `update-ca-certificates`
+rebuilds `/etc/ssl/certs/ca-certificates.crt`, which is what curl,
+Python `ssl`, and OpenSSL-based tools all read by default. The env
+trio set on the agent's `docker run` covers Node
+(`NODE_EXTRA_CA_CERTS`) and Python `requests` /
+`SSL_CERT_FILE`-honoring libraries that don't load the system
+bundle.
+
+The fingerprint is computed via stdlib (`ssl.PEM_cert_to_DER_cert`
++ `hashlib.sha256`) and logged once to stderr. The private key
+stays on the host (under `stage_dir`) until teardown wipes the
+stage dir; nothing in the agent ever sees it."""
+
+from __future__ import annotations
+
+from ... import Bottle
+from ...util import AGENT_CA_PATH, log_ca_fingerprint, select_ca_cert
+from ..bottle_plan import DockerBottlePlan
+
+
+def provision_ca(plan: DockerBottlePlan, bottle: Bottle) -> None:
+    """Copy the agent-facing CA cert into the agent, rebuild the
+    trust bundle, emit a one-line fingerprint log. Called from
+    `BottleBackend.provision` after the agent container is up."""
+    cert_host_path, label = select_ca_cert(plan.egress_plan)
+
+    bottle.cp_in(str(cert_host_path), AGENT_CA_PATH)
+    bottle.exec(
+        f"chmod 644 {AGENT_CA_PATH} && update-ca-certificates",
+        user="root",
+    )
+
+    log_ca_fingerprint(cert_host_path, label)

bot_bottle/backend/docker/provision/git.py

@@ -0,0 +1,106 @@
+"""Git provisioning inside a running Docker bottle.
+
+Three concerns, all about git in the agent:
+
+  1. If --cwd was passed AND the host cwd has a .git, copy that .git
+     into the planned guest workspace so the agent operates on the
+     user's repo.
+  2. If the bottle declares `git` entries (PRD 0008), write a
+     ~/.gitconfig with insteadOf rules so every git operation
+     against a declared upstream (push, fetch, clone, pull,
+     ls-remote) transparently hits the per-agent git-gate. The
+     gate mirrors the upstream in both directions, so URL
+     rewriting is symmetric.
+  3. If the bottle declares `git.user` (issue #86), set
+     `git config --global user.{name,email}` inside the bottle so
+     the agent's commits are attributed to that identity.
+"""
+
+from __future__ import annotations
+
+import shlex
+
+from ....git_gate import GIT_GATE_HOSTNAME, git_gate_render_gitconfig
+from ....log import info
+from ... import Bottle
+from ..bottle_plan import DockerBottlePlan
+
+
+def provision_git(plan: DockerBottlePlan, bottle: Bottle) -> None:
+    """Set up git inside the bottle. Runs all three subcases; each
+    no-ops when its condition isn't met."""
+    _provision_cwd_git(plan, bottle)
+    _provision_git_gate_config(plan, bottle)
+    _provision_git_user(plan, bottle)
+
+
+def _provision_cwd_git(plan: DockerBottlePlan, bottle: Bottle) -> None:
+    """If --cwd was set and the host cwd has a .git directory, copy
+    it into /home/node/workspace/.git and fix ownership. No-op
+    otherwise."""
+    workspace = plan.workspace_plan
+    if not (workspace.enabled and workspace.copy_git and workspace.has_host_git_dir):
+        return
+    guest_workspace_git = f"{workspace.guest_path}/.git"
+    host_git = str(workspace.host_path / ".git")
+    info(f"copying {host_git} -> {bottle.name}:{guest_workspace_git}")
+    bottle.cp_in(host_git, guest_workspace_git)
+    bottle.exec(
+        f"chown -R {shlex.quote(workspace.owner)} {shlex.quote(guest_workspace_git)}",
+        user="root",
+    )
+
+
+def _provision_git_gate_config(plan: DockerBottlePlan, bottle: Bottle) -> None:
+    """Write ~/.gitconfig in the bottle with the git-gate
+    insteadOf rules. No-op when the bottle has no `git` entries."""
+    manifest_bottle = plan.spec.manifest.bottle_for(plan.spec.agent_name)
+    if not manifest_bottle.git:
+        return
+    container_gitconfig = f"{plan.guest_home}/.gitconfig"
+
+    content = git_gate_render_gitconfig(manifest_bottle.git, GIT_GATE_HOSTNAME)
+    config_file = plan.stage_dir / "agent_gitconfig"
+    config_file.write_text(content)
+    config_file.chmod(0o600)
+
+    info(f"writing {container_gitconfig} with {len(manifest_bottle.git)} insteadOf rule(s)")
+    bottle.cp_in(str(config_file), container_gitconfig)
+    bottle.exec(
+        f"chown node:node {shlex.quote(container_gitconfig)} && "
+        f"chmod 644 {shlex.quote(container_gitconfig)}",
+        user="root",
+    )
+
+
+def _provision_git_user(plan: DockerBottlePlan, bottle: Bottle) -> None:
+    """Apply `git config --global user.{name,email}` inside the
+    bottle so the agent's commits are attributed to the operator-
+    chosen identity instead of the agent image's default
+    (which is no user — git would refuse to commit at all
+    until the agent ran its own `git config`).
+
+    Runs as the `node` user so `--global` lands in
+    `/home/node/.gitconfig` (matching the existing
+    `_provision_git_gate_config` write location). No-op when the
+    bottle didn't declare `git.user`.
+
+    Each field set independently — name-only or email-only
+    configs only run the `git config` line for the field
+    present."""
+    manifest_bottle = plan.spec.manifest.bottle_for(plan.spec.agent_name)
+    gu = manifest_bottle.git_user
+    if gu.is_empty():
+        return
+    if gu.name:
+        info(f"git config --global user.name = {gu.name!r}")
+        bottle.exec(
+            f"git config --global user.name {shlex.quote(gu.name)}",
+            user="node",
+        )
+    if gu.email:
+        info(f"git config --global user.email = {gu.email!r}")
+        bottle.exec(
+            f"git config --global user.email {shlex.quote(gu.email)}",
+            user="node",
+        )

bot_bottle/backend/smolmachines/backend.py

@@ -22,6 +22,8 @@ from . import smolvm as _smolvm
 from .bottle import SmolmachinesBottle
 from .bottle_cleanup_plan import SmolmachinesBottleCleanupPlan
 from .bottle_plan import SmolmachinesBottlePlan
+from .provision import ca as _ca
+from .provision import git as _git
 from .provision import workspace as _workspace
 
 
@@ -53,11 +55,21 @@ class SmolmachinesBottleBackend(
         with _launch.launch(plan, provision=self.provision) as bottle:
             yield bottle
 
+    def provision_ca(
+        self, plan: SmolmachinesBottlePlan, bottle: Bottle
+    ) -> None:
+        _ca.provision_ca(plan, bottle)
+
     def provision_workspace(
         self, plan: SmolmachinesBottlePlan, bottle: Bottle
     ) -> None:
         _workspace.provision_workspace(plan, bottle)
 
+    def provision_git(
+        self, plan: SmolmachinesBottlePlan, bottle: Bottle
+    ) -> None:
+        _git.provision_git(plan, bottle)
+
     def supervise_mcp_url(self, plan: SmolmachinesBottlePlan) -> str:
         """The smolmachines guest reaches the supervise sidecar via a
         host-published random port the launch step pinned earlier

bot_bottle/backend/smolmachines/bottle.py

@@ -19,7 +19,6 @@ from __future__ import annotations
 
 import subprocess
 import sys
-import time
 from typing import Mapping, cast
 
 from ...agent_provider import PromptMode, prompt_args
@@ -132,11 +131,6 @@ class SmolmachinesBottle(Bottle):
             self.agent_argv(argv, tty=tty), check=False,
         ).returncode
 
-    # smolvm/libkrun can SIGKILL an otherwise-normal exec during
-    # early-VM provisioning. Retry once after a short settle so
-    # callers (provision_ca, etc.) don't have to handle it themselves.
-    _SIGKILL_EXIT = 128 + 9
-
     def exec(self, script: str, *, user: str = "node") -> ExecResult:
         """Run a POSIX shell script as `user` (default `node`) and
         capture the result. Matches the docker backend's `exec`,
@@ -147,22 +141,14 @@ class SmolmachinesBottle(Bottle):
 
         `runuser -u <user> -- env ... /bin/sh -c <script>` switches UID
         without invoking a login shell, then sets HOME / USER and the
-        bottle env in the child process.
-
-        Retries once on SIGKILL (exit 137) — libkrun occasionally
-        kills short-lived execs during VM bring-up."""
-        r = self._exec_raw(script, user=user)
-        if r.returncode == self._SIGKILL_EXIT:
-            time.sleep(1.0)
-            r = self._exec_raw(script, user=user)
-        return r
-
-    def _exec_raw(self, script: str, *, user: str = "node") -> ExecResult:
+        bottle env in the child process."""
         argv = [
             "--", "runuser", "-u", user, "--",
             "env", *_env_assignments_for(user, self._guest_env),
             "/bin/sh", "-c", script,
         ]
+        # Call smolvm directly because this path needs the host-side
+        # subprocess capture shape used by the Docker backend.
         r = subprocess.run(
             ["smolvm", "machine", "exec", "--name", self.name] + argv,
             capture_output=True, text=True, check=False,

bot_bottle/backend/smolmachines/bottle_plan.py

@@ -82,14 +82,6 @@ class SmolmachinesBottlePlan(BottlePlan):
     agent_git_gate_host: str = ""
     agent_supervise_url: str = ""
 
-    @property
-    def git_gate_insteadof_host(self) -> str:
-        return self.agent_git_gate_host
-
-    @property
-    def git_gate_insteadof_scheme(self) -> str:
-        return "http"
-
     @property
     def agent_command(self) -> str:
         return self.agent_provision.command

bot_bottle/backend/smolmachines/enumerate.py

@@ -64,8 +64,6 @@ def enumerate_active() -> list[ActiveAgent]:
             agent_name=metadata.agent_name if metadata else "?",
             started_at=metadata.started_at if metadata else "",
             services=services_by_slug.get(slug, ()),
-            label=metadata.label if metadata else "",
-            color=metadata.color if metadata else "",
         ))
     return out
 

bot_bottle/backend/smolmachines/prepare.py

@@ -73,8 +73,6 @@ def resolve_plan(
         started_at=datetime.now(timezone.utc).isoformat(),
         compose_project="",
         backend="smolmachines",
-        label=spec.label,
-        color=spec.color,
     ))
 
     subnet, gateway, bundle_ip = smolmachines_bundle_subnet(slug)
@@ -138,8 +136,6 @@ def resolve_plan(
         auth_token=provider.auth_token,
         host_env=dict(os.environ),
         trusted_project_path=workspace_plan.workdir,
-        label=spec.label,
-        color=spec.color,
     )
     merged_guest_env = dict(agent_provision.guest_env)
     for key, val in agent_provision.env_vars.items():

bot_bottle/backend/smolmachines/provision/__init__.py

@@ -2,12 +2,11 @@
 
 Per PRD 0050 the per-provider provisioning steps (prompt, skills,
 declarative provision-plan apply, supervise MCP registration) live on
-the `AgentProvider` plugin under `bot_bottle/contrib/`. CA and git
-provisioning also moved to the AgentProvider ABC (with Debian/node
-defaults); user plugins override them for non-standard images.
-
-The module left in this subpackage handles the remaining backend-
-specific step:
+the `AgentProvider` plugin under `bot_bottle/contrib/`. The modules
+left in this subpackage handle only the steps that are
+backend-specific:
 
+  - ca.py        — install per-bottle CA bundle into the guest trust store
+  - git.py       — copy host cwd `.git` into the guest when --cwd is used
   - workspace.py — copy the operator workspace into the guest
 """

bot_bottle/backend/smolmachines/provision/ca.py

@@ -0,0 +1,90 @@
+"""Install the per-bottle egress MITM CA into the smolmachines
+guest's trust store (PRD 0023 chunk 4d).
+
+Mirrors `backend.docker.provision.ca`: copy the egress CA to
+Debian's `/usr/local/share/ca-certificates/` path,
+`update-ca-certificates` to rebuild the trust bundle, and log the
+fingerprint once.
+
+`smolvm machine exec` runs commands as root in the VM (no `-u`
+flag exists; the VM init is root), so we don't need the explicit
+`-u 0` the docker backend uses on its `docker exec` calls."""
+
+from __future__ import annotations
+
+import time
+
+from ....log import die
+from ...util import (
+    AGENT_CA_BUNDLE,
+    AGENT_CA_PATH,
+    log_ca_fingerprint,
+    select_ca_cert,
+)
+from ... import Bottle, ExecResult
+from ..bottle_plan import SmolmachinesBottlePlan
+
+
+_SIGKILL_EXIT = 128 + 9
+
+
+def provision_ca(plan: SmolmachinesBottlePlan, bottle: Bottle) -> None:
+    """Copy the agent-facing CA cert into the guest, rebuild the
+    trust bundle, emit a one-line fingerprint log. Called from
+    `BottleBackend.provision` after the smolvm guest is up."""
+    cert_host_path, label = select_ca_cert(plan.egress_plan)
+
+    bottle.cp_in(str(cert_host_path), AGENT_CA_PATH)
+    # Mode 0644 — readable to non-root tools in the guest.
+    # update-ca-certificates rebuilds the bundle at AGENT_CA_BUNDLE,
+    # which is what curl / Python ssl / OpenSSL-based tools read by
+    # default. The env trio (NODE_EXTRA_CA_CERTS / SSL_CERT_FILE /
+    # REQUESTS_CA_BUNDLE) on the guest_env covers Node + Python
+    # `requests` / libraries that don't load the system bundle.
+    #
+    r = _install_ca(bottle)
+    if r.returncode == _SIGKILL_EXIT:
+        # smolvm/libkrun can SIGKILL an otherwise-normal exec
+        # during early-VM provisioning. `update-ca-certificates`
+        # is idempotent, so retry the same install once after a
+        # short settle delay before treating it as fatal.
+        time.sleep(1.0)
+        r = _install_ca(bottle)
+
+    if r.returncode != 0:
+        # update-ca-certificates not adding our cert is fatal —
+        # claude-code's TLS handshake against the egress-MITM'd
+        # api.anthropic.com would fail downstream. Bail early
+        # with what we can see (output is captured so we can
+        # surface it).
+        die(
+            f"update-ca-certificates didn't add the agent CA "
+            f"(exit {r.returncode}): "
+            f"stdout={(r.stdout or '').strip()!r} "
+            f"stderr={(r.stderr or '').strip()!r}"
+        )
+
+    log_ca_fingerprint(cert_host_path, label)
+
+
+def _install_ca(bottle: Bottle) -> ExecResult:
+    # chown + chmod + update-ca-certificates + bundle
+    # verification run in one exec so we only pay one
+    # round trip; the `&&` chaining surfaces the first failure
+    # as the return code. The verify check is more stable than
+    # requiring "1 added" in stdout: a retry after a
+    # partially-completed first run may legitimately report "0
+    # added" while the cert is already installed.
+    return bottle.exec(
+        f"chown root:root {AGENT_CA_PATH} && "
+        f"chmod 644 {AGENT_CA_PATH} && "
+        f"update-ca-certificates && "
+        f"openssl verify -CAfile {AGENT_CA_BUNDLE} {AGENT_CA_PATH}",
+        user="root",
+    )
+
+
+# Re-exported for the launch/provision_ca caller + tests. The path
+# constants live in the shared `backend.util` (Debian's
+# `update-ca-certificates` layout is the same in both backends).
+__all__ = ["AGENT_CA_BUNDLE", "AGENT_CA_PATH", "provision_ca"]

bot_bottle/backend/smolmachines/provision/git.py

@@ -0,0 +1,133 @@
+"""Git provisioning inside a running smolmachines bottle
+(PRD 0023 chunk 4d).
+
+Three concerns, all about git in the agent:
+
+  1. If --cwd was passed AND the host cwd has a .git, copy that
+     .git into the planned guest workspace so the agent operates on
+     the user's repo.
+  2. If the bottle declares `git` entries (PRD 0008), write a
+     ~/.gitconfig with insteadOf rules so every git operation
+     against a declared upstream transparently hits the per-bottle
+     git-gate. The gate mirrors the upstream in both directions,
+     so URL rewriting is symmetric.
+  3. If the bottle declares `git.user` (issue #86), set
+     `git config --global user.{name,email}` inside the guest so
+     the agent's commits are attributed to that identity.
+
+Differs from `backend.docker.provision.git` in one address detail:
+the TSI-allowlisted guest can only reach the bundle's pinned IP
+(no DNS resolver in the /32 allowlist), so the insteadOf URLs
+are `http://<bundle_ip>:<port>/<name>.git` rather than the
+docker backend's `git://git-gate/<name>.git`. The render itself
+is the shared `git_gate_render_gitconfig` on the platform-neutral
+git_gate module."""
+
+from __future__ import annotations
+
+import os
+import shlex
+import tempfile
+from pathlib import Path
+
+from ....git_gate import git_gate_render_gitconfig
+from ....log import info
+from ... import Bottle
+from ..bottle_plan import SmolmachinesBottlePlan
+
+
+def provision_git(plan: SmolmachinesBottlePlan, bottle: Bottle) -> None:
+    """Set up git inside the guest. Runs all three subcases; each
+    no-ops when its condition isn't met."""
+    _provision_cwd_git(plan, bottle)
+    _provision_git_gate_config(plan, bottle)
+    _provision_git_user(plan, bottle)
+
+
+def _provision_cwd_git(plan: SmolmachinesBottlePlan, bottle: Bottle) -> None:
+    """If --cwd was set and the host cwd has a .git directory, copy
+    it into <guest_home>/workspace/.git and fix ownership. No-op
+    otherwise."""
+    workspace = plan.workspace_plan
+    if not (workspace.enabled and workspace.copy_git and workspace.has_host_git_dir):
+        return
+    guest_workspace_git = f"{workspace.guest_path}/.git"
+    host_git = str(workspace.host_path / ".git")
+    info(f"copying {host_git} -> {bottle.name}:{guest_workspace_git}")
+    # mkdir -p the workspace dir so cp_in lands the .git
+    # directly there even on first-time bottles.
+    bottle.exec(f"mkdir -p {shlex.quote(workspace.guest_path)}", user="root")
+    bottle.cp_in(host_git, guest_workspace_git)
+    # cp_in lands files as root; the agent runs as node so
+    # the workspace tree must be chowned over.
+    bottle.exec(
+        f"chown -R {shlex.quote(workspace.owner)} {shlex.quote(guest_workspace_git)}",
+        user="root",
+    )
+
+
+def _provision_git_gate_config(
+    plan: SmolmachinesBottlePlan, bottle: Bottle
+) -> None:
+    """Write ~/.gitconfig in the guest with the git-gate insteadOf
+    rules. No-op when the bottle has no `git` entries."""
+    manifest_bottle = plan.spec.manifest.bottle_for(plan.spec.agent_name)
+    if not manifest_bottle.git:
+        return
+
+    # `<loopback alias>:<host port>` form: the bundle's git-gate
+    # HTTP port is published on host loopback at launch time so
+    # the smolvm guest (which can only reach macOS networking via
+    # TSI, not the docker bridge IP) can dial it. launch.py
+    # populates `plan.agent_git_gate_host` after bundle bringup.
+    content = git_gate_render_gitconfig(
+        manifest_bottle.git, plan.agent_git_gate_host, scheme="http",
+    )
+
+    guest_gitconfig = f"{plan.guest_home}/.gitconfig"
+    # Stage the file under the plan's stage_dir so cp_in
+    # has a stable host path. The plan's stage_dir is cleaned up
+    # by start.py's session-end teardown.
+    with tempfile.NamedTemporaryFile(
+        "w", dir=str(plan.stage_dir), prefix="gitconfig.",
+        delete=False,
+    ) as f:
+        f.write(content)
+        config_file = Path(f.name)
+    os.chmod(config_file, 0o600)
+
+    info(f"writing {guest_gitconfig} with {len(manifest_bottle.git)} insteadOf rule(s)")
+    bottle.cp_in(str(config_file), guest_gitconfig)
+    bottle.exec(
+        f"chown node:node {shlex.quote(guest_gitconfig)} && "
+        f"chmod 644 {shlex.quote(guest_gitconfig)}",
+        user="root",
+    )
+
+
+def _provision_git_user(
+    plan: SmolmachinesBottlePlan, bottle: Bottle,
+) -> None:
+    """Apply `git config --global user.{name,email}` inside the
+    guest as the node user so --global lands in the same
+    `/home/node/.gitconfig` that `_provision_git_gate_config`
+    writes to. No-op when the bottle didn't declare `git.user`.
+
+    SmolmachinesBottle.exec(user="node") automatically sets
+    HOME=/home/node so --global writes to /home/node/.gitconfig."""
+    manifest_bottle = plan.spec.manifest.bottle_for(plan.spec.agent_name)
+    gu = manifest_bottle.git_user
+    if gu.is_empty():
+        return
+    if gu.name:
+        info(f"git config --global user.name = {gu.name!r}")
+        bottle.exec(
+            f"git config --global user.name {shlex.quote(gu.name)}",
+            user="node",
+        )
+    if gu.email:
+        info(f"git config --global user.email = {gu.email!r}")
+        bottle.exec(
+            f"git config --global user.email {shlex.quote(gu.email)}",
+            user="node",
+        )

bot_bottle/backend/smolmachines/pty_resize.py

@@ -68,9 +68,8 @@ def _read_winsize() -> tuple[int, int] | None:
       - tmux respawn-pane: tmux sets all three to the pane's PTY.
       - non-TTY (someone piped stdin in tests): none are; the
         sync just no-ops, which is the right behavior."""
-    for stream in (sys.stdin, sys.stdout, sys.stderr):
+    for fd in (sys.stdin.fileno(), sys.stdout.fileno(), sys.stderr.fileno()):
         try:
-            fd = stream.fileno()
             data = fcntl.ioctl(fd, termios.TIOCGWINSZ, b"\x00" * 8)
         except OSError:
             continue

bot_bottle/cli/list.py

@@ -3,47 +3,12 @@
 from __future__ import annotations
 
 import argparse
-import os
 import sys
 
 from ..backend import enumerate_active_agents
 from ..manifest import Manifest
 from ._common import PROG, USER_CWD
 
-_ANSI_COLOR_CODES: dict[str, str] = {
-    "black": "\033[30m",
-    "red": "\033[31m",
-    "green": "\033[32m",
-    "yellow": "\033[33m",
-    "blue": "\033[34m",
-    "magenta": "\033[35m",
-    "cyan": "\033[36m",
-    "white": "\033[37m",
-    "bright-black": "\033[90m",
-    "bright-red": "\033[91m",
-    "bright-green": "\033[92m",
-    "bright-yellow": "\033[93m",
-    "bright-blue": "\033[94m",
-    "bright-magenta": "\033[95m",
-    "bright-cyan": "\033[96m",
-    "bright-white": "\033[97m",
-}
-_ANSI_RESET = "\033[0m"
-
-
-def _ansi_label(text: str, color: str) -> str:
-    if not color:
-        return text
-    if not sys.stdout.isatty():
-        return text
-    term = os.environ.get("TERM", "")
-    if term in ("dumb", ""):
-        return text
-    code = _ANSI_COLOR_CODES.get(color)
-    if not code:
-        return text
-    return f"{code}{text}{_ANSI_RESET}"
-
 
 def cmd_list(argv: list[str]) -> int:
     parser = argparse.ArgumentParser(prog=f"{PROG} list", add_help=True)
@@ -62,11 +27,11 @@ def cmd_list(argv: list[str]) -> int:
     if not active:
         print("no active bot-bottle bottles", file=sys.stderr)
         return 0
-    # One line per bottle: `<backend>\t<slug>\t<label>\t<services>`.
-    # Tab-separated keeps the format stable for shell pipelines.
+    # One line per bottle: `<backend>\t<slug>\t<agent>\t<status>`.
+    # Tab-separated keeps the format stable for shell pipelines;
+    # the dashboard renders the same data through its own
+    # formatter.
     for b in active:
         services = ",".join(b.services) if b.services else "-"
-        display_name = b.label if b.label else b.agent_name
-        colored_name = _ansi_label(display_name, b.color)
-        print(f"{b.backend_name}\t{b.slug}\t{colored_name}\t{services}")
+        print(f"{b.backend_name}\t{b.slug}\t{b.agent_name}\t{services}")
     return 0

bot_bottle/cli/start.py

@@ -80,15 +80,11 @@ def cmd_start(argv: list[str]) -> int:
         if backend_name is None:
             return 0
 
-    label, color = tui.name_color_modal(default_label=agent_name)
-
     spec = BottleSpec(
         manifest=manifest,
         agent_name=agent_name,
         copy_cwd=args.cwd,
         user_cwd=USER_CWD,
-        label=label,
-        color=color,
     )
     return _launch_bottle(
         spec,

bot_bottle/cli/supervise.py

@@ -2,8 +2,9 @@
 act on them (approve / modify / reject).
 
 Curses-based TUI; modify-then-approve shells out to $EDITOR. The
-approval handler wires to PRD 0016 (capability-block), which rebuilds
-the bottle Dockerfile. The egress-block tool was removed in issue #198.
+approval handlers wire to the per-tool remediation engines:
+PRD 0014 (egress) writes routes.yaml + SIGHUPs egress; PRD 0016
+(capability) rebuilds the bottle Dockerfile.
 """
 
 from __future__ import annotations
@@ -25,6 +26,7 @@ from ..backend.docker.capability_apply import (
     CapabilityApplyError,
     apply_capability_change,
 )
+from ..backend.docker.egress_apply import EgressApplyError, add_route
 from ..log import Die, error, info
 from ..supervise import (
     COMPONENT_FOR_TOOL,
@@ -35,6 +37,7 @@ from ..supervise import (
     STATUS_MODIFIED,
     STATUS_REJECTED,
     TOOL_CAPABILITY_BLOCK,
+    TOOL_EGRESS_BLOCK,
     archive_proposal,
     list_pending_proposals,
     render_diff,
@@ -58,7 +61,7 @@ class QueuedProposal:
 # Errors any remediation engine may raise. Caught by the TUI key
 # handlers and surfaced in the status line so a failed apply keeps
 # the proposal pending rather than crashing curses.
-ApplyError = (CapabilityApplyError,)
+ApplyError = (EgressApplyError, CapabilityApplyError)
 
 
 def discover_pending() -> list[QueuedProposal]:
@@ -79,7 +82,9 @@ def discover_pending() -> list[QueuedProposal]:
 def _approval_status(qp: QueuedProposal, verb: str) -> str:
     """Status-line text after a successful approval."""
     base = f"{verb} {qp.proposal.tool} for [{qp.proposal.bottle_slug}]"
-    return f"{base}; resume: ./cli.py resume {qp.proposal.bottle_slug}"
+    if qp.proposal.tool == TOOL_CAPABILITY_BLOCK:
+        return f"{base}; resume: ./cli.py resume {qp.proposal.bottle_slug}"
+    return base
 
 
 def _detail_lines(
@@ -127,7 +132,11 @@ def approve(
     file_to_apply = final_file if final_file is not None else qp.proposal.proposed_file
 
     diff_before, diff_after = "", ""
-    if qp.proposal.tool == TOOL_CAPABILITY_BLOCK:
+    if qp.proposal.tool == TOOL_EGRESS_BLOCK:
+        diff_before, diff_after = add_route(
+            qp.proposal.bottle_slug, file_to_apply,
+        )
+    elif qp.proposal.tool == TOOL_CAPABILITY_BLOCK:
         _meta = read_metadata(qp.proposal.bottle_slug)
         if _meta is not None and not _meta.compose_project:
             raise CapabilityApplyError(

bot_bottle/cli/tui.py

@@ -3,7 +3,6 @@
 Exposed surface:
 
   filter_select(items, *, title="", tty_path="/dev/tty") -> str | None
-  name_color_modal(default_label, *, tty_path="/dev/tty") -> (str, str)
 
 Opens /dev/tty directly so the picker works even when stdout/stdin are
 redirected.  Returns the selected item or None on cancel.
@@ -219,219 +218,3 @@ def _addstr_safe(screen: Any, row: int, col: int, text: str, attr: int = curses.
         screen.addstr(row, col, text, attr)
     except curses.error:
         pass
-
-
-# ---------------------------------------------------------------------------
-# name_color_modal — two-step label + color picker
-# ---------------------------------------------------------------------------
-
-_ANSI_COLORS = [
-    "red", "green", "blue", "yellow", "magenta", "cyan", "white", "black",
-    "bright-red", "bright-green", "bright-blue", "bright-yellow",
-    "bright-magenta", "bright-cyan", "bright-white", "bright-black",
-]
-
-_CURSES_COLOR_MAP: dict[str, int] = {
-    "black": curses.COLOR_BLACK,
-    "red": curses.COLOR_RED,
-    "green": curses.COLOR_GREEN,
-    "yellow": curses.COLOR_YELLOW,
-    "blue": curses.COLOR_BLUE,
-    "magenta": curses.COLOR_MAGENTA,
-    "cyan": curses.COLOR_CYAN,
-    "white": curses.COLOR_WHITE,
-}
-
-_COLOR_NONE = "(none)"
-
-
-def name_color_modal(
-    default_label: str,
-    *,
-    tty_path: str = "/dev/tty",
-) -> tuple[str, str]:
-    """Present a two-step curses modal: first edit the agent label,
-    then optionally pick a color.
-
-    Returns ``(label, color)`` where ``color`` is one of the 16 ANSI
-    color name strings or ``""`` for no color. Falls back to
-    ``(default_label, "")`` on any error (terminal too small, not a tty).
-    """
-    try:
-        tty_fd = open(tty_path, "r+b", buffering=0)  # pylint: disable=consider-using-with
-    except OSError:
-        return default_label, ""
-
-    try:
-        fd_dup = os.dup(tty_fd.fileno())
-        return _run_name_color(default_label, tty_fd=fd_dup)
-    except Exception:  # noqa: BLE001  # pylint: disable=broad-exception-caught
-        return default_label, ""
-    finally:
-        tty_fd.close()
-
-
-def _run_name_color(default_label: str, *, tty_fd: int) -> tuple[str, str]:
-    import io
-    orig_stdin = sys.__stdin__
-    orig_stdout = sys.__stdout__
-    try:
-        tty_text = io.TextIOWrapper(io.FileIO(tty_fd, mode="r+"), write_through=True)
-        sys.__stdin__ = tty_text   # type: ignore[assignment]
-        sys.__stdout__ = tty_text  # type: ignore[assignment]
-        os.environ.setdefault("TERM", "xterm-256color")
-
-        screen = curses.initscr()
-        curses.noecho()
-        curses.cbreak()
-        screen.keypad(True)
-        try:
-            label = _label_step(screen, default_label)
-            color = _color_step(screen, label)
-        finally:
-            screen.keypad(False)
-            curses.nocbreak()
-            curses.echo()
-            curses.endwin()
-    finally:
-        sys.__stdin__ = orig_stdin    # type: ignore[assignment]
-        sys.__stdout__ = orig_stdout  # type: ignore[assignment]
-    return label, color
-
-
-def _label_step(screen: Any, default_label: str) -> str:
-    """Step 1: edit the label. First printable key replaces the
-    pre-fill; subsequent keys append. Enter confirms."""
-    text = default_label
-    replaced = False  # True once the user has typed their first char
-
-    while True:
-        _render_label(screen, text)
-        try:
-            key = screen.getch()
-        except KeyboardInterrupt:
-            return default_label
-
-        if key in (curses.KEY_ENTER, _KEY_ENTER_ALT, ord("\r")):
-            return text.strip() or default_label
-
-        if key in (curses.KEY_BACKSPACE, _KEY_BACKSPACE_WIN, 127):
-            if replaced:
-                text = text[:-1]
-            else:
-                text = ""
-                replaced = True
-
-        elif 32 <= key <= 126:
-            if not replaced:
-                text = chr(key)
-                replaced = True
-            else:
-                text += chr(key)
-
-
-def _render_label(screen: Any, text: str) -> None:
-    screen.erase()
-    rows, cols = screen.getmaxyx()
-    sep = "─" * min(cols - 1, 40)
-    _addstr_safe(screen, 0, 0, "Name agent", curses.A_BOLD)
-    _addstr_safe(screen, 1, 0, sep)
-    _addstr_safe(screen, 2, 0, text[:cols - 1], curses.A_REVERSE)
-    _addstr_safe(screen, 3, 0, sep)
-    if rows > 5:
-        _addstr_safe(screen, 5, 0, "[any key] edit  [Enter] confirm", curses.A_DIM)
-    screen.refresh()
-
-
-def _color_step(screen: Any, confirmed_label: str) -> str:
-    """Step 2: pick a color from the list, or skip."""
-    items = [_COLOR_NONE] + _ANSI_COLORS
-    cursor = 0
-
-    # Initialise color pairs once; index 0 = none, 1..16 = palette.
-    color_attrs = _init_color_pairs()
-
-    while True:
-        _render_color(screen, items, cursor, confirmed_label, color_attrs)
-        try:
-            key = screen.getch()
-        except KeyboardInterrupt:
-            return ""
-
-        if key in (ord("q"), _KEY_ESC):
-            return ""
-
-        if key in (curses.KEY_ENTER, _KEY_ENTER_ALT, ord("\r")):
-            chosen = items[cursor]
-            return "" if chosen == _COLOR_NONE else chosen
-
-        if key in (curses.KEY_UP, ord("k")) and cursor > 0:
-            cursor -= 1
-        elif key in (curses.KEY_DOWN, ord("j")) and cursor < len(items) - 1:
-            cursor += 1
-
-
-def _init_color_pairs() -> dict[str, int]:
-    """Return {color_name: curses_attr} for the palette items."""
-    attrs: dict[str, int] = {_COLOR_NONE: curses.A_NORMAL}
-    try:
-        curses.start_color()
-        curses.use_default_colors()
-        pair_idx = 2  # pair 1 reserved for other uses
-        for name in _ANSI_COLORS:
-            base = name.replace("bright-", "")
-            fg = _CURSES_COLOR_MAP.get(base, curses.COLOR_WHITE)
-            try:
-                curses.init_pair(pair_idx, fg, -1)
-                attr = curses.color_pair(pair_idx)
-                if name.startswith("bright-"):
-                    attr |= curses.A_BOLD
-                attrs[name] = attr
-                pair_idx += 1
-            except curses.error:
-                attrs[name] = curses.A_NORMAL
-    except curses.error:
-        for name in _ANSI_COLORS:
-            attrs[name] = curses.A_NORMAL
-    return attrs
-
-
-def _render_color(
-    screen: Any,
-    items: list[str],
-    cursor: int,
-    confirmed_label: str,
-    color_attrs: dict[str, int],
-) -> None:
-    screen.erase()
-    rows, cols = screen.getmaxyx()
-    sep = "─" * min(cols - 1, 40)
-    _addstr_safe(screen, 0, 0, "Name agent", curses.A_BOLD)
-    _addstr_safe(screen, 1, 0, sep)
-    _addstr_safe(screen, 2, 0, confirmed_label[:cols - 1])
-    _addstr_safe(screen, 3, 0, sep)
-    _addstr_safe(screen, 4, 0, "Color (optional)", curses.A_BOLD)
-
-    list_start = 5
-    list_rows = rows - list_start - 2
-    scroll = max(0, cursor - list_rows + 1)
-    visible = items[scroll: scroll + list_rows]
-
-    for idx, name in enumerate(visible):
-        abs_idx = scroll + idx
-        row = list_start + idx
-        if row >= rows - 2:
-            break
-        prefix = "> " if abs_idx == cursor else "  "
-        attr = color_attrs.get(name, curses.A_NORMAL)
-        if abs_idx == cursor:
-            attr |= curses.A_REVERSE
-        _addstr_safe(screen, row, 0, (prefix + name)[:cols - 1], attr)
-
-    _addstr_safe(screen, rows - 2, 0, sep)
-    _addstr_safe(
-        screen, rows - 1, 0,
-        "[↑↓/jk] move  [Enter] select  [Esc/q] skip",
-        curses.A_DIM,
-    )
-    screen.refresh()

bot_bottle/codex_auth.py

@@ -15,8 +15,8 @@ from datetime import datetime, timezone
 from pathlib import Path
 from typing import cast
 
-from ...log import die
-from ...util import expand_tilde
+from .log import die
+from .util import expand_tilde
 
 
 def codex_auth_path(host_env: dict[str, str] | None = None) -> Path:

bot_bottle/contrib/claude/agent_provider.py

@@ -68,8 +68,6 @@ class ClaudeAgentProvider(AgentProvider):
         forward_host_credentials: bool = False,
         host_env: dict[str, str] | None = None,
         trusted_project_path: str = "",
-        label: str = "",
-        color: str = "",
     ) -> AgentProvisionPlan:
         del forward_host_credentials, host_env  # Codex-only knobs
         resolved_guest_env = dict(guest_env or {})
@@ -82,17 +80,12 @@ class ClaudeAgentProvider(AgentProvider):
         claude_config = state_dir / "claude.json"
         claude_projects = {guest_home: {"hasTrustDialogAccepted": True}}
         claude_projects[trusted_path] = {"hasTrustDialogAccepted": True}
-        payload: dict[str, object] = {
+        claude_config.write_text(json.dumps({
             "hasCompletedOnboarding": True,
             "theme": "dark",
             "bypassPermissionsModeAccepted": True,
             "projects": claude_projects,
-        }
-        if label:
-            payload["name"] = label
-        if color:
-            payload["color"] = color
-        claude_config.write_text(json.dumps(payload, indent=2) + "\n")
+        }, indent=2) + "\n")
         claude_config.chmod(0o600)
         files = (
             AgentProvisionFile(claude_config, f"{guest_home}/.claude.json"),

bot_bottle/contrib/codex/agent_provider.py

@@ -23,7 +23,7 @@ from ...agent_provider import (
     AgentProvisionFile,
     AgentProvisionPlan,
 )
-from .codex_auth import codex_host_access_token, write_codex_dummy_auth_file
+from ...codex_auth import codex_host_access_token, write_codex_dummy_auth_file
 from ...egress import CODEX_HOST_CREDENTIAL_TOKEN_REF, EgressRoute
 from ...log import die, info, warn
 
@@ -76,10 +76,8 @@ class CodexAgentProvider(AgentProvider):
         forward_host_credentials: bool = False,
         host_env: dict[str, str] | None = None,
         trusted_project_path: str = "",
-        label: str = "",
-        color: str = "",
     ) -> AgentProvisionPlan:
-        del auth_token, label, color  # Claude-only knobs
+        del auth_token  # Claude-only knob
         resolved_guest_env = dict(guest_env or {})
         trusted_path = trusted_project_path or guest_home
 

bot_bottle/manifest_agent.py

@@ -49,6 +49,11 @@ class AgentProvider:
                 f"bottle '{bottle_name}' agent_provider.template must be a "
                 f"non-empty string"
             )
+        if template not in PROVIDER_TEMPLATES:
+            raise ManifestError(
+                f"bottle '{bottle_name}' agent_provider.template {template!r} "
+                f"is not one of {', '.join(sorted(PROVIDER_TEMPLATES))}"
+            )
         dockerfile = d.get("dockerfile", "")
         if not isinstance(dockerfile, str):
             raise ManifestError(
@@ -61,12 +66,6 @@ class AgentProvider:
                 f"bottle '{bottle_name}' agent_provider.auth_token must be a "
                 f"string (was {type(auth_token).__name__})"
             )
-        if auth_token and template not in PROVIDER_TEMPLATES:
-            raise ManifestError(
-                f"bottle '{bottle_name}' agent_provider.auth_token is only "
-                f"supported for built-in templates "
-                f"({', '.join(sorted(PROVIDER_TEMPLATES))})"
-            )
         if auth_token and template != "claude":
             raise ManifestError(
                 f"bottle '{bottle_name}' agent_provider.auth_token is only "
@@ -78,12 +77,6 @@ class AgentProvider:
                 f"bottle '{bottle_name}' agent_provider.forward_host_credentials "
                 f"must be a boolean (was {type(forward_host_credentials).__name__})"
             )
-        if forward_host_credentials and template not in PROVIDER_TEMPLATES:
-            raise ManifestError(
-                f"bottle '{bottle_name}' agent_provider.forward_host_credentials "
-                f"is only supported for built-in templates "
-                f"({', '.join(sorted(PROVIDER_TEMPLATES))})"
-            )
         if forward_host_credentials and template != "codex":
             raise ManifestError(
                 f"bottle '{bottle_name}' agent_provider.forward_host_credentials "

bot_bottle/supervise.py

@@ -48,9 +48,11 @@ from pathlib import Path
 SUPERVISE_HOSTNAME = "supervise"
 SUPERVISE_PORT = 9100
 
+TOOL_EGRESS_BLOCK = "egress-block"
 TOOL_CAPABILITY_BLOCK = "capability-block"
 TOOL_LIST_EGRESS_ROUTES = "list-egress-routes"
 TOOLS: tuple[str, ...] = (
+    TOOL_EGRESS_BLOCK,
     TOOL_CAPABILITY_BLOCK,
     TOOL_LIST_EGRESS_ROUTES,
 )
@@ -68,8 +70,10 @@ EGRESS_INTROSPECT_URL = "http://_egress.local/allowlist"
 # capability-block has no on-disk config the operator edits in place
 # (the Dockerfile is rebuilt, not patched), so it has no audit log
 # here — those changes are captured by git history + the rebuild
-# record laid down in PRD 0016. egress-block was removed in issue #198.
-COMPONENT_FOR_TOOL: dict[str, str] = {}
+# record laid down in PRD 0016.
+COMPONENT_FOR_TOOL: dict[str, str] = {
+    TOOL_EGRESS_BLOCK: "egress",
+}
 
 STATUS_APPROVED = "approved"
 STATUS_MODIFIED = "modified"
@@ -551,6 +555,7 @@ __all__ = [
     "EGRESS_FORWARD_PROXY",
     "EGRESS_INTROSPECT_URL",
     "TOOL_CAPABILITY_BLOCK",
+    "TOOL_EGRESS_BLOCK",
     "TOOL_LIST_EGRESS_ROUTES",
     "archive_proposal",
     "audit_dir",

bot_bottle/supervise_server.py

@@ -1,10 +1,8 @@
 """Supervise sidecar HTTP server (PRD 0013).
 
-Per-bottle MCP server exposing tools the agent calls to propose config
-changes when stuck. The egress-block tool was removed in issue #198;
-the remaining tools are `capability-block` and `list-egress-routes`.
-
-Each queued tool call:
+Per-bottle MCP server exposing two tools — `egress-block`,
+`capability-block` — that the agent calls to propose config changes
+when stuck. Each tool call:
 
   1. Validates the proposed file syntactically.
   2. Writes a Proposal to /run/supervise/queue/ (bind-mounted from
@@ -135,6 +133,69 @@ def jsonrpc_error(request_id: object, code: int, message: str) -> bytes:
 
 
 TOOL_DEFINITIONS: list[dict[str, object]] = [
+    {
+        "name": _sv.TOOL_EGRESS_BLOCK,
+        "description": (
+            "Call when egress refused your HTTPS request — host "
+            "without a matching route, or a request that did not match "
+            "the route's matches rules (typically a 403 from the "
+            "proxy). Propose a SINGLE route to add: the host you "
+            "need + (optionally) a path_allowlist of path prefixes + "
+            "(optionally) an auth block. The supervisor merges the "
+            "route into the live table at approval time — you do NOT "
+            "need to see or reproduce the existing routes. If the "
+            "host already has a route, the proposed paths are unioned "
+            "with the existing ones (host stays single-route). The "
+            "operator approves or rejects in the supervise TUI. On "
+            "approval the supervisor writes the merged routes.yaml "
+            "and SIGHUPs egress (no dropped connections)."
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "host": {
+                    "type": "string",
+                    "description": (
+                        "The hostname to allow (e.g. 'api.github.com'). "
+                        "Case-insensitive on match."
+                    ),
+                },
+                "path_allowlist": {
+                    "type": "array",
+                    "items": {"type": "string"},
+                    "description": (
+                        "Optional URL path prefixes the route permits. "
+                        "Each must start with '/'. Omit to allow all "
+                        "paths under this host (bare-pass route). "
+                        "Internally converted to matches entries."
+                    ),
+                },
+                "auth": {
+                    "type": "object",
+                    "description": (
+                        "Optional credential injection. {scheme, "
+                        "token_ref}: scheme is 'Bearer' or 'token'; "
+                        "token_ref names the host env var holding the "
+                        "secret value. Omit to add a host without "
+                        "credential injection. Ignored if the host "
+                        "already has a route (operator decides auth "
+                        "changes, not the agent)."
+                    ),
+                    "properties": {
+                        "scheme": {"type": "string"},
+                        "token_ref": {"type": "string"},
+                    },
+                    "required": ["scheme", "token_ref"],
+                    "additionalProperties": False,
+                },
+                "justification": {
+                    "type": "string",
+                    "description": "Why this host needs to be allowed.",
+                },
+            },
+            "required": ["host", "justification"],
+        },
+    },
     {
         "name": _sv.TOOL_LIST_EGRESS_ROUTES,
         "description": (
@@ -193,6 +254,11 @@ PROPOSED_FILE_FIELD: dict[str, str] = {
 # --- Validation ------------------------------------------------------------
 
 
+# Auth schemes accepted on egress-block proposals — match the
+# manifest-side EGRESS_AUTH_SCHEMES.
+_AUTH_SCHEMES = ("Bearer", "token")
+
+
 def validate_proposed_file(tool: str, content: str) -> None:
     """Syntactic validation. The operator is the real gate; this just
     catches obvious paste-errors / wrong-tool selections before they
@@ -207,6 +273,70 @@ def validate_proposed_file(tool: str, content: str) -> None:
         raise _RpcError(ERR_INVALID_PARAMS, f"unknown tool {tool!r}")
 
 
+def _validate_and_bundle_egress_route(
+    args: dict[str, object],
+) -> str:
+    """Validate egress-block input fields and bundle them into
+    a JSON string that becomes the Proposal.proposed_file. Raises
+    _RpcError on bad input — the agent retries with a fixed shape."""
+    tool = _sv.TOOL_EGRESS_BLOCK
+    host = args.get("host")
+    if not isinstance(host, str) or not host.strip():
+        raise _RpcError(
+            ERR_INVALID_PARAMS,
+            f"{tool}: 'host' is required and must be a non-empty string",
+        )
+    payload: dict[str, object] = {"host": host}
+
+    path_allow_raw = args.get("path_allowlist")
+    if path_allow_raw is not None:
+        if not isinstance(path_allow_raw, list):
+            raise _RpcError(
+                ERR_INVALID_PARAMS,
+                f"{tool}: 'path_allowlist' must be an array of strings",
+            )
+        prefixes: list[str] = []
+        for i, p in enumerate(path_allow_raw):
+            if not isinstance(p, str):
+                raise _RpcError(
+                    ERR_INVALID_PARAMS,
+                    f"{tool}: path_allowlist[{i}] must be a string",
+                )
+            if not p.startswith("/"):
+                raise _RpcError(
+                    ERR_INVALID_PARAMS,
+                    f"{tool}: path_allowlist[{i}] {p!r} must start with '/'",
+                )
+            prefixes.append(p)
+        if prefixes:
+            payload["path_allowlist"] = prefixes
+
+    auth_raw = args.get("auth")
+    if auth_raw is not None:
+        if not isinstance(auth_raw, dict):
+            raise _RpcError(
+                ERR_INVALID_PARAMS,
+                f"{tool}: 'auth' must be an object with 'scheme' and 'token_ref'",
+            )
+        scheme = auth_raw.get("scheme")
+        token_ref = auth_raw.get("token_ref")
+        if not isinstance(scheme, str) or scheme not in _AUTH_SCHEMES:
+            raise _RpcError(
+                ERR_INVALID_PARAMS,
+                f"{tool}: auth.scheme must be one of "
+                f"{', '.join(_AUTH_SCHEMES)} (got {scheme!r})",
+            )
+        if not isinstance(token_ref, str) or not token_ref:
+            raise _RpcError(
+                ERR_INVALID_PARAMS,
+                f"{tool}: auth.token_ref must be a non-empty string "
+                f"naming the host env var holding the token",
+            )
+        payload["auth"] = {"scheme": scheme, "token_ref": token_ref}
+
+    return json.dumps(payload, indent=2) + "\n"
+
+
 # --- MCP handlers ----------------------------------------------------------
 
 
@@ -292,7 +422,13 @@ def handle_tools_call(
             f"{name}: 'justification' is required and must be a non-empty string",
         )
 
-    if name in PROPOSED_FILE_FIELD:
+    if name == _sv.TOOL_EGRESS_BLOCK:
+        # Structured input → JSON bundle on Proposal.proposed_file.
+        # The dashboard's apply step (egress_apply.add_route)
+        # parses this JSON, fetches the current routes, merges in
+        # the new one, and writes the merged file.
+        proposed_file = _validate_and_bundle_egress_route(args_raw)
+    elif name in PROPOSED_FILE_FIELD:
         file_field = PROPOSED_FILE_FIELD[name]
         proposed_file = args_raw.get(file_field)
         if not isinstance(proposed_file, str):

docs/prds/0053-user-provider-plugins.md

@@ -1,269 +0,0 @@
-# PRD 0053: User-defined agent provider plugins
-
-- **Status:** Active
-- **Author:** claude
-- **Created:** 2026-06-04
-
-## Summary
-
-The `get_provider()` registry in `bot_bottle/agent_provider.py` is a closed list —
-only `"claude"` and `"codex"` are valid templates, validated at manifest-load time and
-again at launch. Users who want to run a different agent (Gemini, Aider, a custom
-local model wrapper) cannot add a provider without forking the package.
-
-This PRD opens the registry to user-defined plugins. A plugin placed at
-`~/.bot-bottle/contrib/<name>/` is discovered and loaded at launch time. The manifest
-accepts any non-empty template string that names a built-in or resolves to a user
-plugin at that path.
-
-Alongside discovery, this PRD moves CA and git provisioning out of the Docker backend
-and into the `AgentProvider` ABC as overridable methods. The current standalone
-`provision/ca.py` and `provision/git.py` files in the Docker backend are deleted;
-their logic becomes the default implementations on the ABC. This lets exotic provider
-images (different base OS, different user, non-standard trust mechanism) override
-provisioning freely without the abstraction fighting them.
-
-The preceding commit on this PR moves `codex_auth.py` from `bot_bottle/` into
-`bot_bottle/contrib/codex/` — a clean-up that fits naturally here since this PR
-also clarifies that `contrib/` is the per-provider home.
-
-## Problem
-
-Users building unconventional setups hit a hard wall: the template validation in
-`manifest_agent.AgentProvider.from_dict` rejects any string not in `PROVIDER_TEMPLATES`.
-There is no escape hatch short of editing bot-bottle's source.
-
-PRD 0050 moved provider logic into `contrib/` specifically so a third provider would
-be "cheap to add" — but "cheap" today still means a pull request against the bot-bottle
-repo, not a drop-in file in the user's home directory. The filesystem layout is already
-the right shape; the discovery step is missing.
-
-Beyond discovery, the Docker backend's `provision_ca` and `provision_git` functions
-bake in Debian-specific commands (`update-ca-certificates`) and a hardcoded container
-user (`node`). A user plugin that runs as a different user, or on a different base OS,
-silently gets the wrong provisioning with no way to correct it short of forking.
-
-## Goals / Success Criteria
-
-1. A user places `~/.bot-bottle/contrib/<name>/agent_provider.py` — a file that exports
-   a class inheriting `AgentProvider` — sets `agent_provider.template: <name>` in a
-   bottle's frontmatter, and launches a bottle using that provider with no changes to
-   the bot-bottle source.
-2. The plugin directory may also contain a `Dockerfile` at
-   `~/.bot-bottle/contrib/<name>/Dockerfile`; the existing three-tier Dockerfile cascade
-   (per-bottle override → manifest `dockerfile:` field → provider default) uses this
-   path as the provider default for user plugins.
-3. The manifest validator accepts any non-empty template string. Unknown templates that
-   resolve to no user plugin still raise a clear error, but at launch (via `get_provider`)
-   rather than at manifest-load time.
-4. Built-in provider knobs (`auth_token` → claude only; `forward_host_credentials` →
-   codex only) are guarded to built-in template names. Bottles using a user provider
-   may set neither knob.
-5. `get_provider(template)` checks `~/.bot-bottle/contrib/<template>/agent_provider.py`
-   before the built-ins, so a user can shadow a built-in for local testing.
-6. A clear `ValueError` is raised if the user plugin file exists but contains no
-   `AgentProvider` subclass.
-7. `AgentProvider` gains `provision_ca(self, bottle, plan)` and
-   `provision_git(self, bottle, plan)` with default implementations that reproduce
-   current Docker/Debian/node behavior. Built-in providers inherit the defaults
-   unchanged. User plugins override either method when their image diverges.
-8. `bot_bottle/backend/docker/provision/ca.py` and
-   `bot_bottle/backend/docker/provision/git.py` are deleted. The Docker backend base
-   class calls `provider.provision_ca(bottle, plan)` and
-   `provider.provision_git(bottle, plan)` directly.
-
-## Non-goals
-
-- Packaging or distributing user plugins as installable Python packages.
-- A plugin registry, index, or discovery beyond the filesystem path convention.
-- Adding a third built-in provider.
-- Validating that user plugin images, Dockerfiles, or commands exist before launch
-  (same policy as built-ins).
-- Sandboxing user plugin code — plugins run with full Python interpreter access.
-- Per-provider opt-out of the egress sidecar or network provisioning (follow-on).
-
-## Scope
-
-### In scope
-
-- `get_provider(template: str) -> AgentProvider` gains a `_load_user_plugin(template)`
-  step that checks `~/.bot-bottle/contrib/<template>/agent_provider.py` first, then
-  falls through to the built-in look-ups.
-- `_load_user_plugin` uses `importlib.util.spec_from_file_location` to load the module
-  and returns the first `AgentProvider` subclass found in its `__dict__`. Raises
-  `ValueError` if the file exists but exports no subclass.
-- The Dockerfile cascade in the Docker backend's `resolve_plan()` uses
-  `~/.bot-bottle/contrib/<template>/Dockerfile` as the provider default for user
-  plugins (the same slot currently occupied by `Dockerfile.claude` / `Dockerfile.codex`
-  for built-ins).
-- `manifest_agent.AgentProvider.from_dict`: the `template not in PROVIDER_TEMPLATES`
-  check is removed; the two built-in-specific knob guards (`auth_token` → claude,
-  `forward_host_credentials` → codex) are tightened to `template in PROVIDER_TEMPLATES`
-  so they are skipped for user-defined names.
-- `PROVIDER_TEMPLATES` remains in `agent_provider.py` as the set of built-in names for
-  use by tests and any enumeration callers.
-- `AgentProvider` ABC gains:
-  ```python
-  def provision_ca(self, bottle: Bottle, plan: BottlePlan) -> None: ...
-  def provision_git(self, bottle: Bottle, plan: BottlePlan) -> None: ...
-  ```
-  Default implementations reproduce the current `provision/ca.py` and
-  `provision/git.py` logic exactly (Debian `update-ca-certificates`, `node` user,
-  `/home/node` home).
-- `bot_bottle/backend/docker/provision/ca.py` and
-  `bot_bottle/backend/docker/provision/git.py` deleted. The Docker backend base
-  class substitutes direct calls to the provider methods.
-- Unit tests for the discovery path:
-  - Plugin found and loaded → correct `AgentProvider` instance returned.
-  - Plugin file exists but exports no subclass → `ValueError`.
-  - Unknown template with no user plugin → `ValueError` from `get_provider`.
-  - Built-in template name still works normally even when no user plugin exists.
-- Unit tests for the provisioning delegation:
-  - A provider subclass that overrides `provision_ca` has its override called.
-  - A provider subclass that overrides `provision_git` has its override called.
-- One paragraph added to `README.md` under a new "Custom providers" section describing
-  the `~/.bot-bottle/contrib/<name>/` convention (both `agent_provider.py` and
-  `Dockerfile`), the `provision_ca` / `provision_git` override points, and pointing at
-  the existing contrib providers as reference implementations.
-
-### Out of scope
-
-- Hot-reloading plugins during a running session.
-- Plugin versioning or dependency declaration.
-- Changes to the smolmachines backend provisioning path.
-
-## Proposed design
-
-### Discovery in `get_provider`
-
-```python
-import importlib.util
-
-def get_provider(template: str) -> AgentProvider:
-    user_plugin = _load_user_plugin(template)
-    if user_plugin is not None:
-        return user_plugin
-    if template == PROVIDER_CLAUDE:
-        from .contrib.claude.agent_provider import ClaudeAgentProvider
-        return ClaudeAgentProvider()
-    if template == PROVIDER_CODEX:
-        from .contrib.codex.agent_provider import CodexAgentProvider
-        return CodexAgentProvider()
-    raise ValueError(f"unknown agent provider template: {template!r}")
-
-
-def _load_user_plugin(template: str) -> AgentProvider | None:
-    plugin_path = (
-        Path.home() / ".bot-bottle" / "contrib" / template / "agent_provider.py"
-    )
-    if not plugin_path.exists():
-        return None
-    spec = importlib.util.spec_from_file_location(
-        f"_user_contrib_{template}.agent_provider", plugin_path
-    )
-    if spec is None or spec.loader is None:
-        raise ValueError(f"user plugin at {plugin_path} could not be loaded")
-    mod = importlib.util.module_from_spec(spec)
-    spec.loader.exec_module(mod)  # type: ignore[union-attr]
-    for obj in vars(mod).values():
-        if (
-            isinstance(obj, type)
-            and issubclass(obj, AgentProvider)
-            and obj is not AgentProvider
-        ):
-            return obj()
-    raise ValueError(
-        f"user plugin at {plugin_path} defines no AgentProvider subclass"
-    )
-```
-
-### Dockerfile convention for user plugins
-
-`resolve_plan()` in the Docker backend already has a three-tier cascade. For user
-plugins the provider-default slot is filled by:
-
-```python
-Path.home() / ".bot-bottle" / "contrib" / template / "Dockerfile"
-```
-
-Per-bottle overrides and manifest `dockerfile:` fields continue to take precedence.
-
-### Provisioning methods on `AgentProvider`
-
-```python
-class AgentProvider(ABC):
-    ...
-    def provision_ca(self, bottle: Bottle, plan: BottlePlan) -> None:
-        """Install the egress MITM CA into the agent container's trust store.
-        Override for non-Debian base images or non-standard trust mechanisms."""
-        cert_host_path, label = select_ca_cert(plan.egress_plan)
-        bottle.cp_in(str(cert_host_path), AGENT_CA_PATH)
-        bottle.exec(
-            f"chmod 644 {AGENT_CA_PATH} && update-ca-certificates",
-            user="root",
-        )
-        log_ca_fingerprint(cert_host_path, label)
-
-    def provision_git(self, bottle: Bottle, plan: BottlePlan) -> None:
-        """Configure git inside the agent container.
-        Override for images that run as a different user or use a non-standard home."""
-        _provision_cwd_git(plan, bottle)
-        _provision_git_gate_config(plan, bottle)
-        _provision_git_user(plan, bottle)
-```
-
-The Docker backend base class replaces the direct calls to the old standalone
-functions with:
-
-```python
-provider.provision_ca(bottle, plan)
-provider.provision_git(bottle, plan)
-```
-
-### Manifest validation change
-
-In `manifest_agent.AgentProvider.from_dict`, remove the hard rejection:
-
-```python
-# Before
-if template not in PROVIDER_TEMPLATES:
-    raise ManifestError(
-        f"bottle '{bottle_name}' agent_provider.template {template!r} "
-        f"is not one of {', '.join(sorted(PROVIDER_TEMPLATES))}"
-    )
-
-# After — removed entirely; get_provider() raises at launch for unknown names
-```
-
-Guard the built-in knob checks with `template in PROVIDER_TEMPLATES`:
-
-```python
-if auth_token and template == "claude":   # unchanged
-    ...
-if auth_token and template not in PROVIDER_TEMPLATES:
-    raise ManifestError(
-        f"bottle '{bottle_name}' agent_provider.auth_token is only "
-        f"supported for built-in templates ({', '.join(sorted(PROVIDER_TEMPLATES))})"
-    )
-if forward_host_credentials and template == "codex":  # unchanged
-    ...
-if forward_host_credentials and template not in PROVIDER_TEMPLATES:
-    raise ManifestError(
-        f"bottle '{bottle_name}' agent_provider.forward_host_credentials "
-        f"is only supported for built-in templates"
-    )
-```
-
-## Open questions
-
-1. **`BOT_BOTTLE_CONTRIB_DIR` env var.** Omitted for now — `~/.bot-bottle/contrib/`
-   is consistent with the rest of the user config layout. Revisit if the need surfaces.
-
-## References
-
-- PRD 0050 — agent provider contrib (established `contrib/` as the per-provider home)
-- PRD 0048 — SSH deploy key provisioning (the `contrib/` convention)
-- `bot_bottle/agent_provider.py` — `get_provider`, `PROVIDER_TEMPLATES`, `AgentProvider` ABC
-- `bot_bottle/manifest_agent.py` — template validation that this PRD relaxes
-- `bot_bottle/backend/docker/provision/ca.py` — current CA provisioner (to be deleted)
-- `bot_bottle/backend/docker/provision/git.py` — current git provisioner (to be deleted)

docs/prds/0054-named-labelled-agents.md

@@ -1,318 +0,0 @@
-# PRD 0054: Named / Labelled Agents
-
-- **Status:** Active
-- **Author:** didericis
-- **Created:** 2026-06-03
-- **Issue:** #171
-
-## Summary
-
-At agent launch time, present the operator with a curses modal to optionally
-set a human-readable label and color for the agent before it launches. The
-modal pre-fills the label with the current agent name pattern (e.g.
-`implementer-a3f9`) and leaves color unset; Enter with no changes accepts
-those defaults. Store both in the bottle's `metadata.json`. Display the label —
-rendered in the chosen ANSI color — in `cli list active` output, replacing
-the bare manifest key. Inject the label and color into the in-container
-`claude.json` as `name` / `color` so Claude Code can surface them in its own
-harness when upstream support lands.
-
-## Problem
-
-`cli list active` identifies each running instance by its manifest agent key
-(e.g., `implementer`) plus a random slug suffix. When an operator runs three
-`implementer` bottles simultaneously — one each for three different repos —
-the output shows:
-
-```
-docker  a3f9  implementer  egress,pipelock
-docker  b81c  implementer  egress,pipelock
-docker  d220  implementer  egress,pipelock
-```
-
-There is no way to tell which bottle is working on which task without attaching
-to each one in turn. The slug is opaque; the manifest key is shared. Operators
-working a multi-bottle session resort to keeping a mental map of slug→task,
-which breaks the moment they switch windows.
-
-## Goals / Success Criteria
-
-1. After the operator selects an agent (picker or CLI argument) and backend,
-   a curses modal appears before the preflight. The modal pre-fills the label
-   with `<agent_name>-<slug_suffix>` (the same pattern currently shown in
-   `list active`). No color is pre-selected.
-2. In the modal, any printable keystroke immediately replaces the pre-filled
-   label and starts building the new name. Backspace edits normally. Enter
-   at any point confirms — accepting the pre-fill if nothing was typed, or
-   the in-progress text otherwise.
-3. After the label field is confirmed, the modal presents color selection:
-   a list of the 16 ANSI color names the operator can navigate with arrow
-   keys, or Enter / Esc with no selection to skip color entirely.
-4. `label` and `color` are stored in `BottleMetadata` and written to the
-   bottle's `metadata.json`. Both fields default to `""` (empty / unset).
-5. `ActiveAgent` carries `label` and `color`; `enumerate_active()` reads them
-   from `metadata.json`.
-6. `cli list active` shows the label when non-empty (falling back to
-   `agent_name`). If a non-empty color is set and the terminal supports it,
-   the label is prefixed with the appropriate ANSI escape code and reset
-   afterward.
-7. `BottleSpec` carries `label` and `color`; both backends' `prepare` steps
-   copy them into `BottleMetadata`.
-8. `ClaudeAgentProvider.provision_plan()` writes `label` → `"name"` and
-   `color` → `"color"` into the generated `claude.json`. Fields are omitted
-   when empty.
-9. `cmd_start` calls `name_color_modal` after backend selection and before
-   `_launch_bottle`; passes `label` / `color` into `BottleSpec`.
-10. All existing unit tests stay green; no new tests are required for this
-    change (the label/color fields are thin plumbing with no branching logic
-    worth unit-testing beyond the already-tested metadata read/write path).
-
-## Non-goals
-
-- Showing the agent label inside the Claude Code TUI (status line, terminal
-  title, custom header). That requires upstream Claude Code / codex support.
-  Writing to `claude.json` is best-effort scaffolding for when that lands.
-- Validating or constraining label content beyond the 64-byte printable cap.
-- Editing the label or color of an already-running bottle.
-
-## Design
-
-### Data flow
-
-```
-operator input (modal)
-     │
-     ▼
-BottleSpec.label, BottleSpec.color
-     │
-     ├─► docker/prepare.py  → BottleMetadata.label / .color → metadata.json
-     ├─► smolmachines/prepare.py → BottleMetadata.label / .color → metadata.json
-     │
-     └─► contrib/claude/agent_provider.py → claude.json {"name": label, "color": color}
-                                                             (omitted when empty)
-
-cli list active
-     │
-     ▼
-enumerate_active() → read_metadata(slug) → ActiveAgent.label / .color
-     │
-     ▼
-cmd_list → label (with ANSI color) in the row string
-```
-
-### BottleSpec changes
-
-```python
-@dataclass(frozen=True)
-class BottleSpec:
-    manifest: Manifest
-    agent_name: str
-    copy_cwd: bool
-    user_cwd: str
-    identity: str = ""
-    label: str = ""   # operator-chosen display name; defaults to agent_name at render time
-    color: str = ""   # one of the 16 ANSI color names, or "" for terminal default
-```
-
-`label` and `color` default to `""` so all existing callers remain valid with
-no changes.
-
-### BottleMetadata changes
-
-Add two new fields with backward-compatible defaults:
-
-```python
-@dataclass
-class BottleMetadata:
-    identity: str
-    agent_name: str
-    cwd: str
-    copy_cwd: bool
-    started_at: str
-    compose_project: str
-    backend: str
-    label: str = ""
-    color: str = ""
-```
-
-`metadata.json` written by older bot-bottle versions won't have these keys;
-`read_metadata` already uses `dict.get` with defaults, so existing slugs load
-cleanly with `label=""`, `color=""`.
-
-### ActiveAgent changes
-
-```python
-@dataclass(frozen=True)
-class ActiveAgent:
-    backend_name: str
-    slug: str
-    agent_name: str
-    started_at: str
-    services: tuple[str, ...]
-    label: str = ""
-    color: str = ""
-```
-
-`enumerate_active()` copies `label` and `color` out of `BottleMetadata` when
-constructing each `ActiveAgent`. The smolmachines backend gets the same
-additions for symmetry.
-
-### `cli list active` rendering
-
-The current row format is tab-separated:
-`{backend}\t{slug}\t{agent_name}\t{services}`
-
-With labels it becomes:
-```python
-display_name = a.label if a.label else a.agent_name
-```
-
-Color is rendered via ANSI escape codes. A small `_ansi_color(color_name)`
-helper returns the appropriate escape prefix for the 16 named colors, or `""`
-when the name is unrecognised or the terminal doesn't support color
-(`NO_COLOR` env var or `not sys.stdout.isatty()`).
-
-The 16 ANSI color name → escape mapping:
-
-| Name | ANSI code |
-|------|-----------|
-| `black` | `\033[30m` |
-| `red` | `\033[31m` |
-| `green` | `\033[32m` |
-| `yellow` | `\033[33m` |
-| `blue` | `\033[34m` |
-| `magenta` | `\033[35m` |
-| `cyan` | `\033[36m` |
-| `white` | `\033[37m` |
-| `bright-black` | `\033[90m` |
-| `bright-red` | `\033[91m` |
-| `bright-green` | `\033[92m` |
-| `bright-yellow` | `\033[93m` |
-| `bright-blue` | `\033[94m` |
-| `bright-magenta` | `\033[95m` |
-| `bright-cyan` | `\033[96m` |
-| `bright-white` | `\033[97m` |
-
-Reset is `\033[0m`. Applied around the label substring only.
-
-### The label+color modal
-
-A single curses modal (`name_color_modal` in `bot_bottle/cli/tui.py`) handles
-both label and color in two sequential steps within the same window.
-
-```python
-label, color = name_color_modal(default_label=f"{agent_name}-{slug_suffix}")
-```
-
-**Step 1 — label.** The window renders:
-
-```
-  Name agent
-  ──────────────────────────────────────
-  implementer-a3f9
-  ──────────────────────────────────────
-  [any key] edit  [Enter] confirm
-```
-
-The pre-filled text is shown in the input field. Any printable keystroke
-immediately clears the pre-fill and starts a new name from that character
-(first-keystroke-replaces semantics). Subsequent keystrokes append normally.
-Backspace edits from the right. Enter confirms — accepting the pre-fill if
-the field was never edited, or the typed text otherwise.
-
-**Step 2 — color.** After confirming the label, the window transitions to:
-
-```
-  Name agent
-  ──────────────────────────────────────
-  implementer-a3f9  ← confirmed label
-  ──────────────────────────────────────
-  Color (optional)
-  > (none)
-    red
-    green
-    blue
-    …
-  ──────────────────────────────────────
-  [↑↓] move  [Enter] select  [Esc] skip
-```
-
-The list starts with `(none)` selected. Arrow keys move the cursor; Enter
-confirms the highlighted choice; Esc or `q` skips color. Each color name in
-the list is rendered in its own curses color so the operator can preview the
-palette.
-
-The function returns `(label, color)` — both strings, `color` is `""` when
-`(none)` is selected or the step is skipped.
-
-### Slug suffix for the default label
-
-The default label is `<agent_name>-<slug_suffix>`, where `slug_suffix` is the
-last four characters of the slug (the same short hash shown in `list active`).
-
-In `cmd_start` the slug is minted inside `prepare`, after the modal appears.
-The modal is therefore called with the manifest agent key as a fallback
-(`default_label=agent_name`). Once `prepare` returns the plan (which contains
-the slug), the `BottleSpec` is not reconstructed — the label entered by the
-operator is already in the spec. The full `<agent_name>-<slug_suffix>` form is
-only available for display in subsequent `list active` calls once the bottle
-is running.
-
-### Claude Code config injection
-
-Per PRD 0050, the `claude.json` trust-marker file is written by
-`ClaudeAgentProvider.provision_plan()` in
-`bot_bottle/contrib/claude/agent_provider.py`. Add `label: str = ""` and
-`color: str = ""` keyword parameters to `provision_plan()` on both the
-`AgentProvider` ABC and `ClaudeAgentProvider`, and to the
-`agent_provision_plan()` shim in `agent_provider.py`. Both `prepare.py`
-modules pass `spec.label` / `spec.color`; `CodexAgentProvider` accepts the
-params and ignores them.
-
-In `ClaudeAgentProvider.provision_plan()`:
-
-```python
-payload = {
-    "hasCompletedOnboarding": True,
-    "theme": "dark",
-    "bypassPermissionsModeAccepted": True,
-    "projects": claude_projects,
-}
-if label:
-    payload["name"] = label
-if color:
-    payload["color"] = color
-claude_config.write_text(json.dumps(payload, indent=2) + "\n")
-```
-
-## Implementation chunks
-
-Two PRs, each independently mergeable.
-
-### Chunk 1 — schema + storage
-
-- Add `label: str = ""` and `color: str = ""` to `BottleSpec`,
-  `BottleMetadata`, and `ActiveAgent`.
-- `docker/prepare.py` and `smolmachines/prepare.py`: copy `spec.label` /
-  `spec.color` into `BottleMetadata`; pass them to `agent_provision_plan()`.
-- `docker/enumerate.py` and smolmachines equivalent: copy `metadata.label` /
-  `metadata.color` into `ActiveAgent`.
-- Add `label: str = ""` and `color: str = ""` keyword params to
-  `AgentProvider.provision_plan()` (ABC), `ClaudeAgentProvider.provision_plan()`
-  (uses them in the `claude.json` write), and the `agent_provision_plan()` shim.
-  `CodexAgentProvider` accepts the params and ignores them.
-- `cmd_list`: update `list active` row to use `label` when non-empty, with
-  ANSI color escape codes.
-- No prompt changes; no UI changes. All existing behavior is identical.
-
-### Chunk 2 — modal
-
-- `bot_bottle/cli/tui.py`: add `name_color_modal(default_label)` implementing
-  the two-step curses window described above.
-- `cmd_start`: call `name_color_modal(default_label=agent_name)` after backend
-  selection and before `_launch_bottle`; pass `label` / `color` into
-  `BottleSpec`.
-
-## Open questions
-
-None.

docs/prds/README.md

@@ -7,12 +7,9 @@ document vs. a research note or a decision record).
 
 ## Naming and numbering
 
-New PRDs use a `prd-new-<kebab-title>.md` placeholder name while the PR
-is open. On merge to `main` a CI workflow assigns the next sequential
-number (`0024-…`, `0025-…`), renames the file, and updates the title
-header. Numbers are never reused; gaps are fine.
-
-Once numbered, the filename stays fixed for the life of the doc.
+`NNNN-kebab-title.md`, zero-padded and sequential (`0024-…`, `0025-…`).
+Numbers are never reused; gaps are fine (there is no 0005). The number
+is assigned at creation and stays fixed for the life of the doc.
 
 ## Status
 
@@ -26,7 +23,7 @@ The `Status:` line near the top tracks the PRD's lifecycle:
 ## Format
 
 ```markdown
-# PRD prd-new: <short title>    ← placeholder; CI fills in the number on merge
+# PRD NNNN: <short title>
 
 - **Status:** Draft
 - **Author:** <who>

tests/unit/test_codex_auth.py

@@ -9,7 +9,7 @@ import unittest
 from datetime import datetime, timezone
 from pathlib import Path
 
-from bot_bottle.contrib.codex.codex_auth import (
+from bot_bottle.codex_auth import (
     codex_auth_path,
     codex_dummy_auth_json,
     codex_host_access_token,

tests/unit/test_docker_provision_git_user.py

@@ -1,9 +1,10 @@
-"""Unit: AgentProvider.provision_git — git-user and cwd .git copy (issue #86).
+"""Unit: docker backend `_provision_git_user` (issue #86).
 
-Mocks bottle.exec / bottle.cp_in and asserts on the dispatched script
-shape. provision_git is now a method on AgentProvider (default impl);
-the internal passes (_provision_cwd_git, _provision_git_gate_config,
-_provision_git_user) are no longer exposed as separate helpers."""
+Mocks `bottle.exec` / `bottle.cp_in` and asserts on the script
+strings and user parameter. The cwd + git-gate passes are covered
+indirectly by the existing integration-shaped tests in
+test_smolmachines_provision; this file targets just the git_user
+pass."""
 
 from __future__ import annotations
 
@@ -12,39 +13,16 @@ import unittest
 from pathlib import Path
 from unittest.mock import MagicMock
 
-from bot_bottle.agent_provider import (
-    AgentProvider,
-    AgentProvisionPlan,
-    AgentProviderRuntime,
-)
+from bot_bottle.agent_provider import AgentProvisionPlan
 from bot_bottle.backend import Bottle, BottleSpec, ExecResult
 from bot_bottle.backend.docker.bottle_plan import DockerBottlePlan
+from bot_bottle.backend.docker.provision import git as _git
 from bot_bottle.egress import EgressPlan
 from bot_bottle.git_gate import GitGatePlan
 from bot_bottle.manifest import Manifest
 from bot_bottle.workspace import workspace_plan
 
 
-class _Provider(AgentProvider):
-    """Minimal concrete subclass for testing the default provision_git."""
-    @property
-    def runtime(self) -> AgentProviderRuntime:
-        return AgentProviderRuntime(
-            template="test", command="test", image="", dockerfile="",
-            prompt_mode="append_file", bypass_args=(), resume_args=(),
-            remote_control_args=(),
-        )
-    def provision_plan(self, **kwargs):  # type: ignore[override]
-        raise NotImplementedError
-    def provision_skills(self, plan, bottle): ...  # type: ignore[override]
-    def provision_prompt(self, plan, bottle): ...  # type: ignore[override]
-    def provision(self, plan, bottle): ...  # type: ignore[override]
-    def provision_supervise_mcp(self, plan, bottle, supervise_url): ...  # type: ignore[override]
-
-
-_PROVIDER = _Provider()
-
-
 def _plan(*, git_user: dict | None = None,  # type: ignore
           copy_cwd: bool = False,
           user_cwd: str = "/tmp/x",
@@ -109,6 +87,8 @@ def _make_bottle(name: str = "bot-bottle-demo-abc12") -> MagicMock:
 
 
 def _git_config_exec_calls(bottle: MagicMock) -> list[tuple[str, str]]:
+    """Filter bottle.exec calls to git-config invocations.
+    Returns list of (script, user) tuples."""
     out = []
     for c in bottle.exec.call_args_list:
         script = c.args[0] if c.args else c.kwargs.get("script", "")
@@ -120,7 +100,7 @@ def _git_config_exec_calls(bottle: MagicMock) -> list[tuple[str, str]]:
 
 class TestProvisionGitUser(unittest.TestCase):
     def setUp(self):
-        self._tmp = tempfile.TemporaryDirectory(prefix="cb-prov-git-user.")  # pylint: disable=consider-using-with
+        self._tmp = tempfile.TemporaryDirectory(prefix="cb-prov-git-user.")
         self.stage = Path(self._tmp.name)
 
     def tearDown(self):
@@ -128,7 +108,7 @@ class TestProvisionGitUser(unittest.TestCase):
 
     def test_noop_when_no_git_user(self):
         bottle = _make_bottle()
-        _PROVIDER.provision_git(bottle, _plan(stage_dir=self.stage))
+        _git._provision_git_user(_plan(stage_dir=self.stage), bottle)
         self.assertEqual([], _git_config_exec_calls(bottle))
 
     def test_copies_cwd_git_to_workspace_plan_path(self):
@@ -136,7 +116,7 @@ class TestProvisionGitUser(unittest.TestCase):
         (cwd / ".git").mkdir(parents=True)
         plan = _plan(copy_cwd=True, user_cwd=str(cwd), stage_dir=self.stage)
         bottle = _make_bottle()
-        _PROVIDER.provision_git(bottle, plan)
+        _git._provision_cwd_git(plan, bottle)
 
         bottle.cp_in.assert_called_once_with(
             f"{cwd}/.git",
@@ -145,10 +125,10 @@ class TestProvisionGitUser(unittest.TestCase):
         chown_calls = [
             c for c in bottle.exec.call_args_list
             if "chown" in (c.args[0] if c.args else "")
-            and "/home/node/workspace/.git" in (c.args[0] if c.args else "")
         ]
         self.assertEqual(1, len(chown_calls))
         self.assertIn("node:node", chown_calls[0].args[0])
+        self.assertIn("/home/node/workspace/.git", chown_calls[0].args[0])
 
     def test_sets_name_and_email(self):
         plan = _plan(
@@ -156,7 +136,7 @@ class TestProvisionGitUser(unittest.TestCase):
             stage_dir=self.stage,
         )
         bottle = _make_bottle()
-        _PROVIDER.provision_git(bottle, plan)
+        _git._provision_git_user(plan, bottle)
         calls = _git_config_exec_calls(bottle)
         self.assertEqual(2, len(calls))
         for script, user in calls:
@@ -170,7 +150,7 @@ class TestProvisionGitUser(unittest.TestCase):
     def test_name_only_sets_only_name(self):
         plan = _plan(git_user={"name": "Bot"}, stage_dir=self.stage)
         bottle = _make_bottle()
-        _PROVIDER.provision_git(bottle, plan)
+        _git._provision_git_user(plan, bottle)
         calls = _git_config_exec_calls(bottle)
         self.assertEqual(1, len(calls))
         self.assertIn("user.name", calls[0][0])
@@ -181,7 +161,7 @@ class TestProvisionGitUser(unittest.TestCase):
             git_user={"email": "bot@example.com"}, stage_dir=self.stage,
         )
         bottle = _make_bottle()
-        _PROVIDER.provision_git(bottle, plan)
+        _git._provision_git_user(plan, bottle)
         calls = _git_config_exec_calls(bottle)
         self.assertEqual(1, len(calls))
         self.assertIn("user.email", calls[0][0])

tests/unit/test_egress_apply.py

@@ -1,19 +1,27 @@
-"""Unit: validate_routes_content (issue #198: _merge_single_route and
-add_route removed; docker exec / cp / kill paths are covered by the
-integration test)."""
+"""Unit: validate_routes_content (PRD 0014 retargeted by PRD 0017
+chunk 3, PRD 0053). docker exec / cp / kill paths are covered by the
+integration test."""
 
 import unittest
 
 from bot_bottle.backend.docker.egress_apply import (
     EgressApplyError,
+    _merge_single_route,
     validate_routes_content,
 )
+from bot_bottle.yaml_subset import parse_yaml_subset
 
 
 _ROUTES_EMPTY = "routes: []\n"
 _ROUTES_ONE = 'routes:\n  - host: "api.anthropic.com"\n'
 
 
+def _routes(parsed: str) -> list[dict]:  # type: ignore
+    """Parse a YAML routes string and pull out the routes list, so
+    tests can assert on shape directly."""
+    return parse_yaml_subset(parsed)["routes"]  # type: ignore
+
+
 class TestValidateRoutesContent(unittest.TestCase):
     def test_accepts_minimal_route_table(self):
         validate_routes_content(_ROUTES_EMPTY)
@@ -52,5 +60,130 @@ class TestValidateRoutesContent(unittest.TestCase):
             )
 
 
+class TestMergeSingleRoute(unittest.TestCase):
+    BASE = _ROUTES_ONE
+
+    def test_appends_route_when_host_absent(self):
+        merged = _merge_single_route(self.BASE, {"host": "github.com"})
+        hosts = [r["host"] for r in _routes(merged)]
+        self.assertEqual(["api.anthropic.com", "github.com"], hosts)
+
+    def test_appends_matches(self):
+        merged = _merge_single_route(
+            self.BASE,
+            {"host": "github.com", "matches": [
+                {"paths": [{"value": "/repos/x/"}]}
+            ]},
+        )
+        new_route = _routes(merged)[-1]
+        self.assertIn("matches", new_route)
+
+    def test_appends_legacy_path_allowlist_as_matches(self):
+        merged = _merge_single_route(
+            self.BASE,
+            {"host": "github.com", "path_allowlist": ["/repos/x/"]},
+        )
+        new_route = _routes(merged)[-1]
+        self.assertIn("matches", new_route)
+
+    def test_appends_auth_with_token_env_slot(self):
+        merged = _merge_single_route(
+            self.BASE,
+            {
+                "host": "api.github.com",
+                "auth": {"scheme": "Bearer", "token_ref": "GH"},
+            },
+        )
+        new_route = _routes(merged)[-1]
+        self.assertEqual("Bearer", new_route["auth_scheme"])
+        self.assertEqual("EGRESS_TOKEN_0", new_route["token_env"])
+
+    def test_auth_slot_increments_past_existing(self):
+        base = (
+            'routes:\n'
+            '  - host: "api.anthropic.com"\n'
+            '    auth_scheme: "Bearer"\n'
+            '    token_env: "EGRESS_TOKEN_0"\n'
+        )
+        merged = _merge_single_route(base, {
+            "host": "api.github.com",
+            "auth": {"scheme": "Bearer", "token_ref": "GH"},
+        })
+        new_route = _routes(merged)[-1]
+        self.assertEqual("EGRESS_TOKEN_1", new_route["token_env"])
+
+    def test_existing_host_merges_match_paths_as_union(self):
+        base = (
+            'routes:\n'
+            '  - host: "github.com"\n'
+            '    matches:\n'
+            '      - paths:\n'
+            '          - value: "/a/"\n'
+        )
+        merged = _merge_single_route(base, {
+            "host": "github.com",
+            "matches": [{"paths": [{"value": "/b/"}]}],
+        })
+        routes = _routes(merged)
+        self.assertEqual(1, len(routes))
+        all_paths: list[str] = []
+        for me in routes[0].get("matches", []):
+            for p in me.get("paths", []):
+                all_paths.append(p["value"])
+        self.assertIn("/a/", all_paths)
+        self.assertIn("/b/", all_paths)
+
+    def test_existing_host_dedup_match_paths(self):
+        base = (
+            'routes:\n'
+            '  - host: "github.com"\n'
+            '    matches:\n'
+            '      - paths:\n'
+            '          - value: "/a/"\n'
+        )
+        merged = _merge_single_route(base, {
+            "host": "github.com",
+            "matches": [{"paths": [{"value": "/a/"}, {"value": "/b/"}]}],
+        })
+        all_paths: list[str] = []
+        for me in _routes(merged)[0].get("matches", []):
+            for p in me.get("paths", []):
+                all_paths.append(p["value"])
+        self.assertEqual(1, all_paths.count("/a/"))
+        self.assertIn("/b/", all_paths)
+
+    def test_existing_host_preserves_existing_auth_ignores_proposed(self):
+        base = (
+            'routes:\n'
+            '  - host: "api.github.com"\n'
+            '    auth_scheme: "Bearer"\n'
+            '    token_env: "EGRESS_TOKEN_0"\n'
+        )
+        merged = _merge_single_route(base, {
+            "host": "api.github.com",
+            "auth": {"scheme": "token", "token_ref": "DIFFERENT"},
+        })
+        route = _routes(merged)[0]
+        self.assertEqual("Bearer", route["auth_scheme"])
+        self.assertEqual("EGRESS_TOKEN_0", route["token_env"])
+
+    def test_host_match_is_case_insensitive(self):
+        base = 'routes:\n  - host: "GitHub.com"\n'
+        merged = _merge_single_route(base, {
+            "host": "github.com",
+            "matches": [{"paths": [{"value": "/x/"}]}],
+        })
+        routes = _routes(merged)
+        self.assertEqual(1, len(routes))
+
+    def test_missing_host_raises(self):
+        with self.assertRaises(EgressApplyError):
+            _merge_single_route(self.BASE, {})
+
+    def test_invalid_current_yaml_raises(self):
+        with self.assertRaises(EgressApplyError):
+            _merge_single_route("routes:\n\tbad", {"host": "x.example"})
+
+
 if __name__ == "__main__":
     unittest.main()

tests/unit/test_smolmachines_provision.py

@@ -14,23 +14,21 @@ from pathlib import Path
 from unittest.mock import MagicMock, patch
 
 from bot_bottle.agent_provider import (
-    AgentProvider,
-    AgentProviderRuntime,
     AgentProvisionCommand,
     AgentProvisionDir,
     AgentProvisionFile,
     AgentProvisionPlan,
 )
 from bot_bottle.backend import Bottle, BottleSpec, ExecResult
-from bot_bottle.backend.smolmachines.bottle import SmolmachinesBottle
 from bot_bottle.backend.smolmachines.bottle_plan import (
     SmolmachinesBottlePlan,
 )
 from bot_bottle.backend.smolmachines.provision import (
+    ca as _ca,
+    git as _git,
     workspace as _workspace,
 )
 from bot_bottle.backend.smolmachines.launch import _bundle_launch_spec
-from bot_bottle.backend.util import AGENT_CA_PATH
 from bot_bottle.egress import EgressPlan, EgressRoute
 from bot_bottle.git_gate import GitGatePlan, GitGateUpstream
 from bot_bottle.manifest import GitEntry, Manifest
@@ -38,26 +36,6 @@ from bot_bottle.supervise import SupervisePlan
 from bot_bottle.workspace import workspace_plan
 
 
-class _Provider(AgentProvider):
-    """Minimal concrete subclass for testing the default provision_ca/provision_git."""
-    @property
-    def runtime(self) -> AgentProviderRuntime:
-        return AgentProviderRuntime(
-            template="test", command="test", image="", dockerfile="",
-            prompt_mode="append_file", bypass_args=(), resume_args=(),
-            remote_control_args=(),
-        )
-    def provision_plan(self, **kwargs):  # type: ignore[override]
-        raise NotImplementedError
-    def provision_skills(self, plan, bottle): ...  # type: ignore[override]
-    def provision_prompt(self, plan, bottle): ...  # type: ignore[override]
-    def provision(self, plan, bottle): ...  # type: ignore[override]
-    def provision_supervise_mcp(self, plan, bottle, supervise_url): ...  # type: ignore[override]
-
-
-_PROVIDER = _Provider()
-
-
 def _make_bottle(
     name: str = "bot-bottle-demo-abc12",
     exec_result: ExecResult | None = None,
@@ -254,7 +232,7 @@ class TestProvisionCA(unittest.TestCase):
     cp_in + exec in the right order."""
 
     def setUp(self):
-        self._tmp = tempfile.TemporaryDirectory(prefix="cb-prov-ca.")  # pylint: disable=consider-using-with
+        self._tmp = tempfile.TemporaryDirectory(prefix="cb-prov-ca.")
         self.tmp = Path(self._tmp.name)
         self.egress_ca = self.tmp / "egress-ca.pem"
         _write_self_signed_cert(self.egress_ca)
@@ -274,10 +252,10 @@ class TestProvisionCA(unittest.TestCase):
     def test_egress_ca_always_installed(self):
         plan = _plan(egress_ca_path=self.egress_ca)
         bottle = _make_bottle(exec_result=self._UPDATE_OK)
-        _PROVIDER.provision_ca(bottle, plan)
+        _ca.provision_ca(plan, bottle)
         bottle.cp_in.assert_called_once_with(
             str(self.egress_ca),
-            AGENT_CA_PATH,
+            _ca.AGENT_CA_PATH,
         )
         bottle.exec.assert_called_once()
         script = bottle.exec.call_args.args[0]
@@ -285,59 +263,28 @@ class TestProvisionCA(unittest.TestCase):
         self.assertIn("update-ca-certificates", script)
         self.assertEqual("root", bottle.exec.call_args.kwargs.get("user"))
 
+    def test_retries_smolvm_sigkill_during_update_ca(self):
+        plan = _plan(egress_ca_path=self.egress_ca)
+        killed = ExecResult(
+            returncode=137,
+            stdout="Updating certificates in /etc/ssl/certs...\n",
+            stderr="",
+        )
+        bottle = _make_bottle()
+        bottle.exec.side_effect = [killed, self._UPDATE_OK]
+        with patch(
+            "bot_bottle.backend.smolmachines.provision.ca.time.sleep"
+        ) as sleep:
+            _ca.provision_ca(plan, bottle)
+
+        self.assertEqual(2, bottle.exec.call_count)
+        sleep.assert_called_once_with(1.0)
+
     def test_dies_when_egress_cert_missing(self):
         plan = _plan(egress_ca_path=self.tmp / "does-not-exist.pem")
         bottle = _make_bottle()
         with self.assertRaises(SystemExit):
-            _PROVIDER.provision_ca(bottle, plan)
-
-
-class TestSmolmachinesBottleExec(unittest.TestCase):
-    """SmolmachinesBottle.exec retries once on SIGKILL (exit 137)."""
-
-    _SIGKILL = subprocess.CompletedProcess(
-        args=[], returncode=137, stdout="", stderr="",
-    )
-    _SUCCESS = subprocess.CompletedProcess(
-        args=[], returncode=0, stdout="done", stderr="",
-    )
-
-    def test_retries_on_sigkill(self):
-        bottle = SmolmachinesBottle("test-machine")
-        with patch(
-            "bot_bottle.backend.smolmachines.bottle.subprocess.run",
-            side_effect=[self._SIGKILL, self._SUCCESS],
-        ) as mock_run, patch(
-            "bot_bottle.backend.smolmachines.bottle.time.sleep"
-        ) as mock_sleep:
-            result = bottle.exec("echo hi")
-
-        self.assertEqual(0, result.returncode)
-        self.assertEqual(2, mock_run.call_count)
-        mock_sleep.assert_called_once_with(1.0)
-
-    def test_no_retry_on_success(self):
-        bottle = SmolmachinesBottle("test-machine")
-        with patch(
-            "bot_bottle.backend.smolmachines.bottle.subprocess.run",
-            return_value=self._SUCCESS,
-        ) as mock_run:
-            result = bottle.exec("echo hi")
-
-        self.assertEqual(0, result.returncode)
-        self.assertEqual(1, mock_run.call_count)
-
-    def test_no_retry_on_other_error(self):
-        fail = subprocess.CompletedProcess(args=[], returncode=1, stdout="", stderr="err")
-        bottle = SmolmachinesBottle("test-machine")
-        with patch(
-            "bot_bottle.backend.smolmachines.bottle.subprocess.run",
-            return_value=fail,
-        ) as mock_run:
-            result = bottle.exec("bad-cmd")
-
-        self.assertEqual(1, result.returncode)
-        self.assertEqual(1, mock_run.call_count)
+            _ca.provision_ca(plan, bottle)
 
 
 class TestProvisionGit(unittest.TestCase):
@@ -346,7 +293,7 @@ class TestProvisionGit(unittest.TestCase):
     when its condition doesn't hold."""
 
     def setUp(self):
-        self._tmp = tempfile.TemporaryDirectory(prefix="cb-prov-git.")  # pylint: disable=consider-using-with
+        self._tmp = tempfile.TemporaryDirectory(prefix="cb-prov-git.")
         self.stage = Path(self._tmp.name)
 
     def tearDown(self):
@@ -354,20 +301,20 @@ class TestProvisionGit(unittest.TestCase):
 
     def test_noop_when_no_cwd_and_no_git_entries(self):
         bottle = _make_bottle()
-        _PROVIDER.provision_git(bottle, _plan(stage_dir=self.stage))
+        _git.provision_git(_plan(stage_dir=self.stage), bottle)
         bottle.cp_in.assert_not_called()
         bottle.exec.assert_not_called()
 
     def test_copies_cwd_git_when_copy_cwd_and_git_present(self):
         # Stage a fake host .git dir under user_cwd so the path-
-        # check in provision_git fires.
+        # check in _provision_cwd_git fires.
         cwd = self.stage / "cwd"
         (cwd / ".git").mkdir(parents=True)
         plan = _plan(
             copy_cwd=True, user_cwd=str(cwd), stage_dir=self.stage,
         )
         bottle = _make_bottle()
-        _PROVIDER.provision_git(bottle, plan)
+        _git.provision_git(plan, bottle)
         bottle.cp_in.assert_called_once_with(
             f"{cwd}/.git",
             "/home/node/workspace/.git",
@@ -383,7 +330,7 @@ class TestProvisionGit(unittest.TestCase):
     def test_skips_cwd_when_copy_cwd_false(self):
         plan = _plan(copy_cwd=False, stage_dir=self.stage)
         bottle = _make_bottle()
-        _PROVIDER.provision_git(bottle, plan)
+        _git.provision_git(plan, bottle)
         bottle.cp_in.assert_not_called()
 
     def test_writes_gitconfig_with_ip_port_form_for_smolmachines(self):
@@ -401,13 +348,13 @@ class TestProvisionGit(unittest.TestCase):
             agent_git_gate_host="127.0.0.1:9418",
         )
         bottle = _make_bottle()
-        _PROVIDER.provision_git(bottle, plan)
+        _git.provision_git(plan, bottle)
         # The staged gitconfig path is whatever NamedTemporaryFile
         # picked; we read its contents.
         cp_call = bottle.cp_in.call_args
         staged_path = Path(cp_call.args[0])
         self.assertEqual(self.stage, staged_path.parent)
-        content = staged_path.read_text(encoding="utf-8")
+        content = staged_path.read_text()
         self.assertIn(
             '[url "http://127.0.0.1:9418/bot-bottle.git"]', content,
         )
@@ -445,7 +392,7 @@ class TestBundleLaunchSpec(unittest.TestCase):
 
 
 class TestProvisionGitUser(unittest.TestCase):
-    """`provision_git` runs `git config --global` inside the
+    """`_provision_git_user` runs `git config --global` inside the
     guest as the node user. SmolmachinesBottle.exec sets HOME and
     USER automatically for the requested user, so --global lands
     in /home/node/.gitconfig. No-op when the bottle didn't declare
@@ -464,7 +411,7 @@ class TestProvisionGitUser(unittest.TestCase):
 
     def test_noop_when_no_git_user(self):
         bottle = _make_bottle()
-        _PROVIDER.provision_git(bottle, _plan())
+        _git._provision_git_user(_plan(), bottle)
         self.assertEqual([], self._git_config_calls(bottle))
 
     def test_sets_name_and_email_as_node(self):
@@ -473,7 +420,7 @@ class TestProvisionGitUser(unittest.TestCase):
             "email": "eric@dideric.is",
         })
         bottle = _make_bottle()
-        _PROVIDER.provision_git(bottle, plan)
+        _git._provision_git_user(plan, bottle)
         calls = self._git_config_calls(bottle)
         self.assertEqual(2, len(calls))
         # Both run as node so SmolmachinesBottle.exec sets HOME=/home/node
@@ -489,7 +436,7 @@ class TestProvisionGitUser(unittest.TestCase):
     def test_name_only(self):
         plan = _plan(git_user={"name": "Bot"})
         bottle = _make_bottle()
-        _PROVIDER.provision_git(bottle, plan)
+        _git._provision_git_user(plan, bottle)
         calls = self._git_config_calls(bottle)
         self.assertEqual(1, len(calls))
         self.assertIn("user.name", calls[0][0])
@@ -498,7 +445,7 @@ class TestProvisionGitUser(unittest.TestCase):
     def test_email_only(self):
         plan = _plan(git_user={"email": "bot@example.com"})
         bottle = _make_bottle()
-        _PROVIDER.provision_git(bottle, plan)
+        _git._provision_git_user(plan, bottle)
         calls = self._git_config_calls(bottle)
         self.assertEqual(1, len(calls))
         self.assertIn("user.email", calls[0][0])
@@ -507,7 +454,7 @@ class TestProvisionGitUser(unittest.TestCase):
 
 class TestProvisionWorkspace(unittest.TestCase):
     def setUp(self):
-        self._tmp = tempfile.TemporaryDirectory(prefix="cb-prov-workspace.")  # pylint: disable=consider-using-with
+        self._tmp = tempfile.TemporaryDirectory(prefix="cb-prov-workspace.")
         self.stage = Path(self._tmp.name)
 
     def tearDown(self):

tests/unit/test_supervise.py

@@ -17,6 +17,7 @@ from bot_bottle.supervise import (
     STATUS_MODIFIED,
     STATUS_REJECTED,
     TOOL_CAPABILITY_BLOCK,
+    TOOL_EGRESS_BLOCK,
     archive_proposal,
     audit_log_path,
     list_pending_proposals,
@@ -36,16 +37,16 @@ FIXED_TS = datetime(2026, 5, 25, 12, 0, 0, tzinfo=timezone.utc)
 
 
 def _proposal(
-    tool: str = TOOL_CAPABILITY_BLOCK,
-    proposed: str = "FROM python:3.13\n",
-    justification: str = "need a capability",
+    tool: str = TOOL_EGRESS_BLOCK,
+    proposed: str = "{}",
+    justification: str = "need a route",
 ) -> Proposal:
     return Proposal.new(
         bottle_slug="dev",
         tool=tool,
         proposed_file=proposed,
         justification=justification,
-        current_file_hash=sha256_hex(proposed),
+        current_file_hash=sha256_hex("{}"),
         now=FIXED_TS,
     )
 
@@ -56,7 +57,7 @@ class TestProposalRoundtrip(unittest.TestCase):
         self.assertTrue(p.id)
         self.assertEqual("2026-05-25T12:00:00+00:00", p.arrival_timestamp)
         self.assertEqual("dev", p.bottle_slug)
-        self.assertEqual(TOOL_CAPABILITY_BLOCK, p.tool)
+        self.assertEqual(TOOL_EGRESS_BLOCK, p.tool)
 
     def test_to_from_dict_roundtrip(self):
         p = _proposal()
@@ -141,14 +142,14 @@ class TestQueueIO(unittest.TestCase):
     def test_list_pending_sorted_by_arrival(self):
         # Fabricate two with explicit timestamps.
         a = Proposal.new(
-            bottle_slug="dev", tool=TOOL_CAPABILITY_BLOCK,
-            proposed_file="FROM python:3.13\n", justification="early",
+            bottle_slug="dev", tool=TOOL_EGRESS_BLOCK,
+            proposed_file="{}", justification="early",
             current_file_hash="x",
             now=datetime(2026, 5, 25, 10, 0, 0, tzinfo=timezone.utc),
         )
         b = Proposal.new(
-            bottle_slug="dev", tool=TOOL_CAPABILITY_BLOCK,
-            proposed_file="FROM python:3.13\n", justification="late",
+            bottle_slug="dev", tool=TOOL_EGRESS_BLOCK,
+            proposed_file="{}", justification="late",
             current_file_hash="x",
             now=datetime(2026, 5, 25, 14, 0, 0, tzinfo=timezone.utc),
         )
@@ -317,15 +318,16 @@ class TestToolConstants(unittest.TestCase):
     def test_tools_tuple_matches_individual_constants(self):
         self.assertEqual(
             (
+                TOOL_EGRESS_BLOCK,
                 TOOL_CAPABILITY_BLOCK,
                 supervise.TOOL_LIST_EGRESS_ROUTES,
             ),
             supervise.TOOLS,
         )
 
-    def test_component_map_has_no_entries(self):
-        # egress-block removed in issue #198; capability-block never had one.
-        self.assertEqual({}, supervise.COMPONENT_FOR_TOOL)
+    def test_component_map_covers_egress_remediation_only(self):
+        self.assertIn(TOOL_EGRESS_BLOCK, supervise.COMPONENT_FOR_TOOL)
+        self.assertNotIn(TOOL_CAPABILITY_BLOCK, supervise.COMPONENT_FOR_TOOL)
 
 
 class _StubSupervise(supervise.Supervise):

tests/unit/test_supervise_cli.py

@@ -1,10 +1,12 @@
-"""Unit: supervise headless paths (PRD 0013 phase 4, PRD 0016).
+"""Unit: supervise headless paths (PRD 0013 phase 4, PRD 0014).
 
 The curses TUI itself isn't exercised here — these tests cover the
-discovery + approve/reject paths that the TUI's key handlers call into.
+discovery + approve/reject + audit-write paths that the TUI's key
+handlers call into.
 
-egress-block (add_route) was removed in issue #198; the TestEgressApplyWiring
-class and all stubs for add_route have been dropped accordingly.
+add_route is stubbed at the supervise CLI module level so the tests
+don't need a running egress sidecar; the real docker exec/cp/SIGHUP
+plumbing is covered by the integration test.
 """
 
 import os
@@ -15,6 +17,7 @@ from pathlib import Path
 
 from bot_bottle import supervise
 from bot_bottle.backend.docker.capability_apply import CapabilityApplyError
+from bot_bottle.backend.docker.egress_apply import EgressApplyError
 from bot_bottle.cli import supervise as supervise_cli
 from bot_bottle.supervise import (
     Proposal,
@@ -22,6 +25,7 @@ from bot_bottle.supervise import (
     STATUS_MODIFIED,
     STATUS_REJECTED,
     TOOL_CAPABILITY_BLOCK,
+    TOOL_EGRESS_BLOCK,
     read_audit_entries,
     read_response,
     sha256_hex,
@@ -31,8 +35,9 @@ from bot_bottle.supervise import (
 FIXED = datetime(2026, 5, 25, 12, 0, 0, tzinfo=timezone.utc)
 
 
-def _proposal(slug: str = "dev", tool: str = TOOL_CAPABILITY_BLOCK) -> Proposal:
+def _proposal(slug: str = "dev", tool: str = TOOL_EGRESS_BLOCK) -> Proposal:
     payloads = {
+        TOOL_EGRESS_BLOCK: '{"routes": []}\n',
         TOOL_CAPABILITY_BLOCK: "FROM python:3.13\n",
     }
     payload = payloads.get(tool, "")
@@ -83,14 +88,14 @@ class TestDiscoverPending(_FakeHomeMixin, unittest.TestCase):
 
     def test_sorted_by_arrival_across_bottles(self):
         early = Proposal.new(
-            bottle_slug="api", tool=TOOL_CAPABILITY_BLOCK,
-            proposed_file="FROM python:3.13\n", justification="early",
+            bottle_slug="api", tool=TOOL_EGRESS_BLOCK,
+            proposed_file="{}", justification="early",
             current_file_hash="h",
             now=datetime(2026, 5, 25, 10, 0, 0, tzinfo=timezone.utc),
         )
         late = Proposal.new(
-            bottle_slug="dev", tool=TOOL_CAPABILITY_BLOCK,
-            proposed_file="FROM python:3.13\n", justification="late",
+            bottle_slug="dev", tool=TOOL_EGRESS_BLOCK,
+            proposed_file="{}", justification="late",
             current_file_hash="h",
             now=datetime(2026, 5, 25, 14, 0, 0, tzinfo=timezone.utc),
         )
@@ -115,38 +120,48 @@ class TestDiscoverPending(_FakeHomeMixin, unittest.TestCase):
 class TestApproveReject(_FakeHomeMixin, unittest.TestCase):
     def setUp(self):
         self._setup_fake_home()
+        self._original_add_route = supervise_cli.add_route
         self._original_apply_capability = supervise_cli.apply_capability_change
+        # Default stubs: succeed with deterministic before/after so the
+        # audit log shows a non-empty diff.
+        supervise_cli.add_route = lambda slug, content: (  # type: ignore
+            '{"routes": []}\n', '{"routes": [{"host": "x"}]}\n',
+        )
         supervise_cli.apply_capability_change = lambda slug, content: (  # type: ignore
             "FROM old\n", content,
         )
 
     def tearDown(self):
+        supervise_cli.add_route = self._original_add_route
         supervise_cli.apply_capability_change = self._original_apply_capability
         self._teardown_fake_home()
 
-    def _enqueue(self, tool: str = TOOL_CAPABILITY_BLOCK):
+    def _enqueue(self, tool: str = TOOL_EGRESS_BLOCK):
         p = _proposal(tool=tool)
         qdir = supervise.queue_dir_for_slug("dev")
         qdir.mkdir(parents=True, exist_ok=True)
         supervise.write_proposal(qdir, p)
         return supervise_cli.QueuedProposal(proposal=p, queue_dir=qdir)
 
-    def test_approve_writes_response(self):
+    def test_approve_writes_response_and_audit(self):
         qp = self._enqueue()
         supervise_cli.approve(qp)
-        # capability-block is archived on approve, so the response file
-        # moves to processed/ before the caller can read it.
-        resp = read_response(qp.queue_dir / "processed", qp.proposal.id)
+        resp = read_response(qp.queue_dir, qp.proposal.id)
         self.assertEqual(STATUS_APPROVED, resp.status)
         self.assertIsNone(resp.final_file)
+        entries = read_audit_entries("egress", "dev")
+        self.assertEqual(1, len(entries))
+        self.assertEqual("approved", entries[0].operator_action)
 
     def test_approve_with_final_file_marks_modified(self):
         qp = self._enqueue()
-        supervise_cli.approve(qp, final_file="FROM bookworm\n", notes="tweaked")
-        resp = read_response(qp.queue_dir / "processed", qp.proposal.id)
+        supervise_cli.approve(qp, final_file='{"routes": [{"path": "/x/"}]}\n', notes="tweaked")
+        resp = read_response(qp.queue_dir, qp.proposal.id)
         self.assertEqual(STATUS_MODIFIED, resp.status)
-        self.assertEqual("FROM bookworm\n", resp.final_file)
+        self.assertEqual('{"routes": [{"path": "/x/"}]}\n', resp.final_file)
         self.assertEqual("tweaked", resp.notes)
+        entries = read_audit_entries("egress", "dev")
+        self.assertEqual("modified", entries[0].operator_action)
 
     def test_reject_writes_rejection(self):
         qp = self._enqueue()
@@ -154,13 +169,113 @@ class TestApproveReject(_FakeHomeMixin, unittest.TestCase):
         resp = read_response(qp.queue_dir, qp.proposal.id)
         self.assertEqual(STATUS_REJECTED, resp.status)
         self.assertEqual("nope", resp.notes)
+        entries = read_audit_entries("egress", "dev")
+        self.assertEqual("rejected", entries[0].operator_action)
+        self.assertEqual("nope", entries[0].operator_notes)
 
-    def test_no_audit_log_for_capability_block(self):
+    def test_capability_block_skips_audit_log(self):
         qp = self._enqueue(tool=TOOL_CAPABILITY_BLOCK)
         supervise_cli.approve(qp)
+        # No audit log for capability-block (per PRD 0013 / 0016).
         self.assertEqual([], read_audit_entries("egress", "dev"))
 
 
+class TestEgressApplyWiring(_FakeHomeMixin, unittest.TestCase):
+    """PRD 0017 chunk 3: approve() on an egress-block proposal
+    must call add_route (single-route merge) with the right args
+    and surface its failures."""
+
+    def setUp(self):
+        self._setup_fake_home()
+        self._original_add_route = supervise_cli.add_route
+
+    def tearDown(self):
+        supervise_cli.add_route = self._original_add_route
+        self._teardown_fake_home()
+
+    def _enqueue_egress(self, proposed: str = '{"host": "x.example"}\n'):
+        p = Proposal.new(
+            bottle_slug="dev", tool=TOOL_EGRESS_BLOCK,
+            proposed_file=proposed,
+            justification="need a route",
+            current_file_hash=sha256_hex(proposed),
+            now=FIXED,
+        )
+        qdir = supervise.queue_dir_for_slug("dev")
+        qdir.mkdir(parents=True, exist_ok=True)
+        supervise.write_proposal(qdir, p)
+        return supervise_cli.QueuedProposal(proposal=p, queue_dir=qdir)
+
+    def test_egress_block_calls_add_route_with_proposed_json(self):
+        calls = []
+        supervise_cli.add_route = lambda slug, content: (  # type: ignore
+            calls.append((slug, content)) or ("before", "after")
+        )
+        qp = self._enqueue_egress(
+            proposed='{"host": "new.example", "path_allowlist": ["/x/"]}\n'
+        )
+        supervise_cli.approve(qp)
+        self.assertEqual(1, len(calls))
+        slug, content = calls[0]
+        self.assertEqual("dev", slug)
+        # The single-route JSON the agent proposed reaches add_route
+        # unchanged — add_route fetches current state + merges.
+        self.assertEqual(
+            '{"host": "new.example", "path_allowlist": ["/x/"]}\n',
+            content,
+        )
+
+    def test_modify_passes_final_file_to_add_route(self):
+        calls = []
+        supervise_cli.add_route = lambda slug, content: (  # type: ignore
+            calls.append(content) or ("before", "after")
+        )
+        qp = self._enqueue_egress()
+        supervise_cli.approve(
+            qp,
+            final_file='{"host": "edited.example"}\n',
+            notes="tweaked",
+        )
+        self.assertEqual(['{"host": "edited.example"}\n'], calls)
+
+    def test_apply_failure_blocks_response_and_audit(self):
+        supervise_cli.add_route = lambda slug, content: (_ for _ in ()).throw(  # type: ignore
+            EgressApplyError("docker exec failed")
+        )
+        qp = self._enqueue_egress()
+        with self.assertRaises(EgressApplyError):
+            supervise_cli.approve(qp)
+        # No response file (proposal stays pending).
+        self.assertEqual(
+            [qp.proposal.id],
+            [p.id for p in supervise.list_pending_proposals(qp.queue_dir)],
+        )
+        # No audit entry.
+        self.assertEqual([], read_audit_entries("egress", "dev"))
+
+    def test_real_diff_lands_in_audit(self):
+        supervise_cli.add_route = lambda slug, content: (  # type: ignore
+            '{"routes": []}\n',  # before
+            '{"routes": [{"host": "new.example"}]}\n',  # after
+        )
+        qp = self._enqueue_egress(proposed='{"host": "new.example"}\n')
+        supervise_cli.approve(qp)
+        entries = read_audit_entries("egress", "dev")
+        self.assertEqual(1, len(entries))
+        self.assertIn('+{"routes": [{"host": "new.example"}]}', entries[0].diff)
+        self.assertIn('-{"routes": []}', entries[0].diff)
+
+    def test_reject_does_not_call_apply(self):
+        qp = self._enqueue_egress()
+        supervise_cli.reject(qp, reason="no thanks")
+        # Reject still writes a response + audit entry with empty diff.
+        resp = read_response(qp.queue_dir, qp.proposal.id)
+        self.assertEqual(STATUS_REJECTED, resp.status)
+        entries = read_audit_entries("egress", "dev")
+        self.assertEqual(1, len(entries))
+        self.assertEqual("", entries[0].diff)
+
+
 class TestCapabilityApplyWiring(_FakeHomeMixin, unittest.TestCase):
     """PRD 0016 Phase 3: approve() on a capability-block proposal
     calls apply_capability_change, archives the proposal afterward
@@ -213,12 +328,17 @@ class TestCapabilityApplyWiring(_FakeHomeMixin, unittest.TestCase):
         supervise_cli.apply_capability_change = lambda slug, content: ("FROM old\n", content)  # type: ignore
         qp = self._enqueue_capability()
         supervise_cli.approve(qp)
+        # capability-block has no audit log per PRD 0013 — its record
+        # lives in the per-bottle Dockerfile + transcript state.
         self.assertEqual([], read_audit_entries("egress", "dev"))
 
     def test_proposal_archived_after_apply(self):
         supervise_cli.apply_capability_change = lambda slug, content: ("FROM old\n", content)  # type: ignore
         qp = self._enqueue_capability()
         supervise_cli.approve(qp)
+        # Sidecar would normally archive after delivering the response,
+        # but it's gone by then. The supervise TUI archives so
+        # discover_pending stops surfacing the resolved proposal.
         self.assertEqual([], supervise.list_pending_proposals(qp.queue_dir))
         processed = list((qp.queue_dir / "processed").glob("*.json"))
         self.assertEqual(2, len(processed))
@@ -226,8 +346,20 @@ class TestCapabilityApplyWiring(_FakeHomeMixin, unittest.TestCase):
 
 class TestEditInEditor(unittest.TestCase):
     def test_runs_editor_returns_edited_content(self):
+        # Fake "editor" is /bin/sh -c 'cat <<EOF > $1 ... EOF'
         original_editor = os.environ.get("EDITOR")
         try:
+            # Use a fake editor that overwrites the file with a known
+            # marker. EDITOR is split with shlex equivalence by
+            # subprocess.run when invoked as a list — keep it as a
+            # single program path that takes the file as argv[1].
+            os.environ["EDITOR"] = (
+                "/bin/sh -c 'printf %s \"edited\" > \"$0\"'"
+            )
+            # subprocess.run with the str as the first list element
+            # would try to find a binary literally named "/bin/sh -c ..."
+            # — that won't work. Use shell mode trick: wrap in a script.
+            # Easier: build a tiny helper script.
             with tempfile.NamedTemporaryFile(
                 mode="w", suffix=".sh", delete=False, prefix="fake-editor.",
             ) as script:
@@ -249,6 +381,7 @@ class TestEditInEditor(unittest.TestCase):
     def test_returns_none_when_unchanged(self):
         original_editor = os.environ.get("EDITOR")
         try:
+            # No-op editor: touch the file (leaves it unchanged).
             with tempfile.NamedTemporaryFile(
                 mode="w", suffix=".sh", delete=False, prefix="noop-editor.",
             ) as script:
@@ -312,6 +445,7 @@ class TestCapabilityBlockSmolmachinesGuard(_FakeHomeMixin, unittest.TestCase):
         supervise_cli.approve(qp)  # must not raise
 
     def test_no_metadata_falls_through_to_docker_path(self):
+        # No metadata at all → assume Docker (backward-compatible).
         qp = self._enqueue_capability("dev")
         supervise_cli.approve(qp)  # must not raise
 

tests/unit/test_supervise_server.py

@@ -141,6 +141,7 @@ class TestHandleToolsList(unittest.TestCase):
         names = [t["name"] for t in result["tools"]]  # type: ignore[index]
         self.assertEqual(
             sorted([
+                _sv.TOOL_EGRESS_BLOCK,
                 _sv.TOOL_CAPABILITY_BLOCK,
                 _sv.TOOL_LIST_EGRESS_ROUTES,
             ]),
@@ -205,10 +206,10 @@ class TestHandleToolsCall(unittest.TestCase):
         try:
             result = handle_tools_call(
                 {
-                    "name": _sv.TOOL_CAPABILITY_BLOCK,
+                    "name": _sv.TOOL_EGRESS_BLOCK,
                     "arguments": {
-                        "dockerfile": "FROM python:3.13\n",
-                        "justification": "need git",
+                        "host": "example.com",
+                        "justification": "need a route",
                     },
                 },
                 self.config,
@@ -249,8 +250,8 @@ class TestHandleToolsCall(unittest.TestCase):
         with self.assertRaises(_RpcError):
             handle_tools_call(
                 {
-                    "name": _sv.TOOL_CAPABILITY_BLOCK,
-                    "arguments": {"dockerfile": "FROM python:3.13\n"},
+                    "name": _sv.TOOL_EGRESS_BLOCK,
+                    "arguments": {"host": "example.com"},
                 },
                 self.config,
             )
@@ -260,9 +261,9 @@ class TestHandleToolsCall(unittest.TestCase):
         try:
             handle_tools_call(
                 {
-                    "name": _sv.TOOL_CAPABILITY_BLOCK,
+                    "name": _sv.TOOL_EGRESS_BLOCK,
                     "arguments": {
-                        "dockerfile": "FROM python:3.13\n",
+                        "host": "example.com",
                         "justification": "x",
                     },
                 },
@@ -284,10 +285,10 @@ class TestHandleToolsCall(unittest.TestCase):
         )
         result = handle_tools_call(
             {
-                "name": _sv.TOOL_CAPABILITY_BLOCK,
+                "name": _sv.TOOL_EGRESS_BLOCK,
                 "arguments": {
-                    "dockerfile": "FROM python:3.13\n",
-                    "justification": "need a capability",
+                    "host": "example.com",
+                    "justification": "need a route",
                 },
             },
             config,
@@ -411,8 +412,7 @@ class TestHttpEndToEnd(unittest.TestCase):
         self.assertEqual("2.0", result["jsonrpc"])
         self.assertEqual(1, result["id"])
         names = [t["name"] for t in result["result"]["tools"]]  # type: ignore[index]
-        self.assertIn(_sv.TOOL_CAPABILITY_BLOCK, names)
-        self.assertNotIn("egress-block", names)
+        self.assertIn(_sv.TOOL_EGRESS_BLOCK, names)
 
     def test_unknown_method_returns_jsonrpc_error(self):
         result = self._post_jsonrpc(