feat(orchestrator): mount the host's agents-council state read-only as /kept

The W4 resources view reads gates.db and the resources/ files of the host sampler. The installer creates ~/.local/state/agents-council/resources and writes KVB_ORCHESTRATOR_KEPT into .env; compose binds it read-only at /kept without creating the host path, and the server passes --kept to the hub.

🎯 Fix: 90 %
💥 Break: 3 %
💸 Cost: 100 %
⏱️ Time: 100 %
🛡️ Security: 100 %
🏆 Score: 87
🚦 Gate: ✅ 90/5, cost and time <= 100, security 100 %

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

orchestrator/compose.yml

@@ -49,6 +49,8 @@ services:
       - /tree/branch-tree.json
       - --timers
       - /timers
+      - --kept
+      - /kept
       - --vendor
       - /app/vendor
       - --cleanup
@@ -117,6 +119,12 @@ services:
         read_only: true
         bind:
           create_host_path: false
+      - type: bind
+        source: "${KVB_ORCHESTRATOR_KEPT:?written into .env by scripts/install.sh}"
+        target: /kept
+        read_only: true
+        bind:
+          create_host_path: false
       - type: bind
         source: "${KVB_ORCHESTRATOR_APPROVERS:?written into .env by scripts/install.sh}"
         target: /approvers

orchestrator/kvb_orchestrator/hub.py

@@ -49,6 +49,7 @@ class Places:
     vendor: Path
     cleanup: Path
     offices: Path
+    kept: Path
 
 
 def environment(templates: Path) -> jinja2.Environment:
@@ -89,6 +90,7 @@ class Hub(Mcp, Reviewing, Asking, Messaging, Choosing, Approving, Denying, Reque
     agent_sessions: Path
     model: Model
     timers: Path
+    kept: Path
     settings: Settings
     redirects: Redirects
     speech: Speech
@@ -137,6 +139,7 @@ def open_hub(council: Path, pages: Path, public_port: int, state: Path, host_sta
         agent_sessions=state / SNAPSHOT,
         model=model,
         timers=places.timers,
+        kept=places.kept,
         council=council,
         pages=pages,
         public_port=public_port,

orchestrator/server.py

@@ -25,6 +25,8 @@
     --tree-file: the JSON file `pkgmgr branch tree --output` writes, mounted
         read-only; read again whenever it changes.
     --timers: directory holding the systemd user units (*.timer).
+    --kept: ~/.local/state/agents-council, mounted read-only: gates.db and
+        the resources/ files of the host sampler.
     --vendor: directory holding the vendored Bootstrap Icons sprite,
         3d-force-graph and three with their licence texts.
     --cleanup: host-mounted directory the hub writes signed branch deletions
@@ -78,7 +80,7 @@ def main() -> int:
     parser.add_argument("--bind", required=True)
     for name in ("--listen-port", "--public-port"):
         parser.add_argument(name, type=int, required=True)
-    paths = ("--council", "--pages", "--state", "--host-state", "--skills", "--transcripts", "--templates", "--tree-file", "--timers", "--vendor", "--cleanup", "--offices", "--llm-key-file", "--approvers")
+    paths = ("--council", "--pages", "--state", "--host-state", "--skills", "--transcripts", "--templates", "--tree-file", "--timers", "--kept", "--vendor", "--cleanup", "--offices", "--llm-key-file", "--approvers")
     for name in (*paths, "--piper", "--voices", "--whisper", "--whisper-model", "--scratch"):
         parser.add_argument(name, type=Path, required=True)
     for name in ("--llm-url", "--llm-model", "--operator-voice"):
@@ -94,7 +96,7 @@ def main() -> int:
             transcripts=args.transcripts,
             scripts=Scripts(skills=args.skills, council=args.council, home=args.state),
             templates=args.templates,
-            places=Places(tree_file=args.tree_file, timers=args.timers, vendor=args.vendor, cleanup=args.cleanup, offices=args.offices),
+            places=Places(tree_file=args.tree_file, timers=args.timers, vendor=args.vendor, cleanup=args.cleanup, offices=args.offices, kept=args.kept),
             model=Model(url=args.llm_url.strip(), model=args.llm_model.strip(), key=read_key(args.llm_key_file)),
             engines=Engines(piper=args.piper, voices=args.voices, operator_voice=args.operator_voice, whisper=args.whisper, whisper_model=args.whisper_model, scratch=args.scratch),
             approvers=args.approvers,