feat(orchestrator): read the pkgmgr branch tree file instead of running git

Phase 3 of requirement 001. The orchestrator no longer starts git: orchestrator/kvb_orchestrator/tree.py maps the document that pkgmgr branch tree writes (repos, branches, worktrees, detached heads, delete_ready) onto the Tree view, re-reads it when mtime or size change, and reports a missing or broken file as an empty tree with the error. compose.yml mounts the tree directory read-only (a file mount would keep the replaced inode). /api/state touches state/tree-heartbeat; kvb-orchestrator-tree.timer runs every minute and its oneshot service runs only while that heartbeat is younger than 5 minutes, with PATH=/usr/bin:/bin and the pkgmgr venv that the install builds from the newest v* tag a fully trusted GPG key signed, cloned fresh from PKGMGR_REPO because the local checkout's config is sandbox-writable.

Dialectic verdict 2026-11-06 (2 rounds, 5 skeptics, ~85 %): hardened git runner in pkgmgr, gc classification shared with the tree scan, forge facts only from an unlocked Secret Service token with a 600 s cache, atomic tree output refreshed by open/close/drop/gc, host units outside sandbox-writable paths, orchestrator reads the file only. Losing objections: extending the host runner (it would run bash -c on signed text), a new payload kind, copying the pkgmgr checkout, a tree limited to .worktrees. Operator answers: signed-tag venv, UI delete keeps volumes and is local only, ignored files beyond known caches block a delete, scan only while the page polls. Delete jobs, gc_item signing and the UI delete path follow in phase 4.

MEDUSA acceptances (kvb-think-criticize 2026-11-07, 1 skeptic): MEDUSA-MM-SCAN-058 orchestrator/server.py:64 and :80 false positives (case-insensitive substring pla in --templates and Places; --tree-file is a read-only JSON file, no model loading).

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

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

orchestrator/compose.yml

@@ -44,10 +44,8 @@ services:
       - /projects
       - --templates
       - /app/templates
-      - --repos
-      - "${KVB_ORCHESTRATOR_REPOS:?written into .env by scripts/install.sh}"
-      - --worktrees
-      - "${KVB_ORCHESTRATOR_WORKTREES:?written into .env by scripts/install.sh}"
+      - --tree-file
+      - /tree/branch-tree.json
       - --timers
       - /timers
       - --llm-url
@@ -100,14 +98,9 @@ services:
         bind:
           create_host_path: false
       - type: bind
-        source: "${KVB_ORCHESTRATOR_REPOS:?written into .env by scripts/install.sh}"
-        target: "${KVB_ORCHESTRATOR_REPOS:?written into .env by scripts/install.sh}"
-        read_only: true
-        bind:
-          create_host_path: false
-      - type: bind
-        source: "${KVB_ORCHESTRATOR_WORKTREES:?written into .env by scripts/install.sh}"
-        target: "${KVB_ORCHESTRATOR_WORKTREES:?written into .env by scripts/install.sh}"
+        # the directory, not the file: pkgmgr replaces the file, and a file mount keeps showing the old inode
+        source: "${KVB_ORCHESTRATOR_TREE:?written into .env by scripts/orchestrator.sh}"
+        target: /tree
         read_only: true
         bind:
           create_host_path: false