chore: snapshot main sync

README.md

@@ -1,8 +1,8 @@
 # boocode
 
-Self-hosted single-user developer chat app. 3-app monorepo: BooChat (read-only chat), BooCoder (write tools + agent dispatch), BooTerm (PTY terminals) — plus the in-app **Orchestrator**, a deterministic multi-agent conductor that runs read-only Han analysis/review flows on local Qwen.
+Self-hosted coding workspace for local and hosted models. 4-app monorepo: BooChat (chat + tools), BooCoder (write tools + agent dispatch), BooTerm (PTY terminals), and BooControl (fleet cockpit for llama-swap hosts), plus the in-app **Orchestrator** for bounded multi-agent analysis/review flows.
 
-**Latest release:** `v2.7.17-orchestrator` (2026-06-03) · [`CHANGELOG.md`](CHANGELOG.md) · **Current focus:** [`CURRENT.md`](CURRENT.md)
+**Latest tag:** `v2.8.30-main-sync` (2026-06-17) · [`CHANGELOG.md`](CHANGELOG.md) · **Current focus:** [`CURRENT.md`](CURRENT.md)
 
 **Architecture:** [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) · **Engineering reference:** [`CLAUDE.md`](CLAUDE.md) · **Roadmap:** [`boocode_roadmap.md`](boocode_roadmap.md)
 
@@ -15,10 +15,11 @@ Self-hosted single-user developer chat app. 3-app monorepo: BooChat (read-only c
 
 ## Layout
 
-- `apps/server` — Fastify API + WebSocket + inference loop + file-read tools
-- `apps/web` — React frontend; served by Fastify in production, Vite in dev
-- `apps/booterm` — Fastify + node-pty + tmux for in-browser terminal panes
-- `apps/coder` — Fastify write tools + ACP/PTY dispatcher + MCP server (BooCoder)
+- `apps/server` - Fastify API + WebSocket + inference loop + file-read tools
+- `apps/web` - React frontend; served by Fastify in production, Vite in dev
+- `apps/booterm` - Fastify + node-pty + tmux for in-browser terminal panes
+- `apps/coder` - Fastify write tools + ACP/PTY dispatcher + MCP server (BooCoder)
+- `apps/control` - Fastify fleet control service for llama-swap hosts (BooControl)
 
 ## Local dev
 
@@ -70,22 +71,24 @@ curl http://100.114.205.53:9502/api/health
 |BooChat|`100.114.205.53:9500`|Read-only chat + SPA |
 |BooTerm|`100.114.205.53:9501`|PTY/tmux terminal panes |
 |BooCoder|host:9502|Write tools + agent dispatch + MCP server (systemd service, not Docker) |
+|BooControl|host:9503|Fleet cockpit, gateway, bench/evals/jobs, SSH config, reports |
 |Postgres|`127.0.0.1:5500`|Shared database (`boochat`; Docker service `boocode_db`) |
-|boocontext|MCP (built into boocoder service)|Tree-sitter code analysis (callgraph, symbols, types, health) |
+|boocontext|MCP (via BooCoder)|Tree-sitter code analysis (summary, scan, symbols, callgraph, types, health) |
 
 ## What's shipped
 
-See [`boocode_roadmap.md`](boocode_roadmap.md) and [`CHANGELOG.md`](CHANGELOG.md) for full version history. Highlights as of **v2.7.17**:
+See [`boocode_roadmap.md`](boocode_roadmap.md) and [`CHANGELOG.md`](CHANGELOG.md) for full version history. Highlights as of **2026-06-17**:
 
-- **BooChat**: streaming chat, file-read tools, compaction, reasoning support, HTML/Markdown artifact panes, cross-repo read grants, MCP client (multi-server + stdio), tool-cost tracking, skills system, builtin agent registry, multi-pane workspace (chat / terminal / coder / orchestrator)
-- **BooTerm**: in-browser terminal panes via tmux + xterm.js, per-session tmux sessions, SSH-out support
-- **BooCoder**: write tools (`edit_file` with fuzzy matching, `create_file`, `delete_file`, `apply_pending`, `rewind`, git-ref checkpoints), pending-changes queue + a **Files/Git diff panel** (stage / commit / discard), provider snapshot (5 providers: boocode, claude, opencode, goose, qwen — cursor/copilot retired), `AgentComposerBar`, warm ACP + **persistent agent sessions** (opencode HTTP server; claude via the Agent SDK with native session resume) + PTY fallback, config-backed provider lifecycle, Arena (same task → N models), MCP server, CLI client, human inbox, Boomerang orchestration, pane-scoped chats
-- **Orchestrator** (v2.7.17): launch any of 22 read-only Han flows (research, code-review, investigate, architectural-analysis, …) from BooChat or BooCoder via the Workflow button, a slash command, or **+ menu → New Orchestrator**; each step runs as a bounded agent on local Qwen (hard read-only via `qwen --approval-mode plan`), streaming live in a Paseo-style run pane with an evidence-disciplined, adversarially-validated report. Persisted + resumable. `@boocode/contracts` single-sources the cross-app wire contracts (v2.7.13).
+- **BooChat**: streaming chat, file-read tools, compaction, reasoning support, artifact panes, MCP client, memory tools, skills system, multi-pane workspace, and the state-graph/supervisor inference architecture.
+- **BooTerm**: in-browser terminal panes via tmux + xterm.js, session metadata, and PTY search over buffered output.
+- **BooCoder**: write tools with staged `pending_changes`, files/git diff review, provider snapshot + lifecycle controls, warm ACP/OpenCode/Claude backends, persistent agent sessions, Arena comparisons, MCP server support, and boocontext-backed code analysis.
+- **BooControl**: live fleet cockpit for llama-swap hosts with gateway routing, jobs/bench/evals streams, reports, host perf history, SSH config editing, and HuggingFace model-pull management.
+- **Orchestrator**: bounded multi-agent research/review/investigation flows with resumable runs, workflow catalog support, and read-only execution on local models.
 
 ## Planned
 
-Most prior roadmap milestones have shipped (see [`boocode_roadmap.md`](boocode_roadmap.md)). What remains is optional/exploratory — e.g. a verify-gate ensembler over pending changes (majority-vote diff ranking). No committed milestones currently in flight.
+Most prior roadmap milestones have shipped (see [`boocode_roadmap.md`](boocode_roadmap.md)). What remains is optional/exploratory - e.g. a verify-gate ensembler over pending changes (majority-vote diff ranking). No committed milestones currently in flight.
 
 ## License
 
-MIT — see [`LICENSE`](LICENSE).
+MIT - see [`LICENSE`](LICENSE).