Project Control — agents-switching

Continue prompt

{
  "project": "agents-switching",
  "mission": "Maintain and evolve the VM101 multi-agent switching middleware (v0.8.11) and containerized sandbox fleet (5 agent sandboxes + 9router + filebrowser), executing the v0.8.5→v0.8.11 roadmap items (RAM-floor dispatch guard, dashboard $ cost view, MCP dispatch path for Gemini-style orchestrators) while preserving the thin-middleware architecture invariant.",
  "read_first": [
    "/data/vault/wiki/projects/agents-switching.md",
    "/data/vault/wiki/preferences/Workflow Preferences.md",
    "/data/vault/wiki/patterns/Middleware Orchestration Patterns.md",
    "/data/vault/wiki/projects/agents-switching-v0.8.5-to-v0.8.11.md",
    "/data/vault/wiki/hot.md",
    "/data/vault/wiki/log.md"
  ],
  "verification_anchor": {
    "command": "curl -s http://agents-switching:3100/api/health && echo '' && curl -s http://agents-switching:3100/api/agents",
    "expect": "{\"ok\":true,\"version\":\"0.8.11\",\"pid\":7,\"orchestrator_name\":\"claude-max\"} and an agents JSON object with ready:true across claude-max (2.1.241), claude-2 (2.1.241), agy-suro1 (gemini-3.7-flash-high), agy-2 (gemini-3.7-flash-high), and hermes (v0.20.5 via 9router)"
  },
  "project_context": {
    "what_it_is": "MCP stdio + Hono HTTP middleware and CLI (agents-switching) running on VM101 in Docker (Profile 2 container-per-sandbox topology) for parallel task dispatch across coding-agent CLIs (Claude Code, Antigravity CLI, Hermes via 9router) in isolated worktrees/containers with structured debrief aggregation.",
    "domain_notes": "Deliberately a thin pipe: no retry, routing, rate-limit classification, or redelegation logic lives in TypeScript; all delegation judgment and operational policy lives in ORCHESTRATOR.md and prompt instructions. VM101 hosts 5 live sandboxes (sbx-claude-max, sbx-claude-2, sbx-agy-suro1, sbx-agy-2, sbx-hermes), a 9router gateway (port 20128) proxying SumoPod LLM backends, a filebrowser container (port 3004), and the middleware (port 3100). All sandboxes mount shared /data/project and /data/vault, with docker.sock mounted for container management."
  },
  "tech_stack": {
    "runtime": "Node.js 22 LTS, TypeScript, Docker / Docker Compose",
    "frameworks": "Hono (HTTP / SSE API adapter), React 19 + Vite 8 (Dashboard), Commander v12 (CLI)",
    "libraries": "Execa, Zod (config validation), better-sqlite3 (9router runtime)",
    "agent_ecosystem": "Claude Code 2.1.241, Antigravity CLI 1.1.19 (gemini-3.7-flash-high), Hermes Agent v0.20.5 (Python/uv via 9router to SumoPod)",
    "infrastructure": "Docker Compose (docker-compose.vm101.yml), 9router (port 20128), FileBrowser (port 3004), Tailscale"
  },
  "current_state": {
    "summary": "Running v0.8.11 on VM101 with 8 active containers (middleware on port 3100, 9router on port 20128, filebrowser on port 3004, and 5 sandbox containers: sbx-claude-max, sbx-claude-2, sbx-agy-suro1, sbx-agy-2, sbx-hermes). All 5 agent probes return ready:true. Fleet expansion M0-M7 completed on 2026-08-24. Gitea repo dimas/agents-switching updated 2026-08-25T00:00:03Z.",
    "source_of_this_status": "census-latest.json (containers, container_project_map, gitea_repos) + vault pages /data/vault/wiki/projects/agents-switching.md, /data/vault/wiki/hot.md, and /data/vault/wiki/log.md (§2026-08-24 fleet expansion M0-M7)"
  },
  "repo_locations": {
    "gitea_remote": "http://localhost:3001/dimas/agents-switching.git (internal Gitea repo, private, 305 KB, updated 2026-08-25T00:00:03Z; historical home Gitea: http://172.24.0.2:8070/dimasvadriawan/agents-switching.git)",
    "vm101_host_path": "/home/ubuntu/agents-switching (host working tree deploying Profile 2 container topology via docker/docker-compose.vm101.yml)",
    "docker_shared_mount": "/home/ubuntu/agents-switching/docker/data/project (mounted to /data/project in sandbox containers)",
    "sandbox_view": "Running inside sandbox containers without a direct local repo clone in /data/project; codebase deployed as containerized middleware service and git repo on host/Gitea"
  },
  "key_files": {
    "/home/ubuntu/agents-switching/ORCHESTRATOR.md": "Master integration and conversational delegation guidance for orchestrators (codifies delegation criteria, task schemas, and approval protocol)",
    "/home/ubuntu/agents-switching/docker/docker-compose.vm101.yml": "Docker Compose definition for middleware, 9router, filebrowser, and 5 sandbox containers",
    "/home/ubuntu/agents-switching/agents.vm101.toml": "Live agent roster configuration bind-mounted into the middleware container (reloaded on docker compose restart middleware)",
    "/home/ubuntu/agents-switching/docker/README.md": "Operational stamping guide and runbook for VM101 container-per-sandbox topology",
    "/home/ubuntu/agents-switching/docker/hermes.Dockerfile": "Debian-based container definition for Python/uv Hermes agent with uid 1001",
    "/home/ubuntu/agents-switching/docker/9router.Dockerfile": "Container definition for 9router Next.js gateway on port 20128",
    "/home/ubuntu/agents-switching/src/core/dispatch/index.ts": "Core dispatch orchestration, prompt composition, and agent runner dispatch",
    "/home/ubuntu/agents-switching/src/http-adapter/server.ts": "Hono HTTP server, CORS, SSE /events streaming, and dashboard static asset hosting",
    "/data/vault/wiki/projects/agents-switching.md": "Vault master project page documenting architecture, release history, and VM101 container topology"
  },
  "next_steps": [
    "Implement RAM-floor dispatch guard in src/core/dispatch/ (deferred in M7 backlog) to pre-flight check host/container available memory before starting concurrent dispatches.",
    "Develop dashboard $ cost view and usage tracking (/api/jobs cost aggregation) on the React 19 dashboard as tracked in v0.8.5→v0.8.11 backlog.",
    "Evaluate native MCP dispatch interface for Gemini/AGY-style orchestrators to bypass HTTP curl wrappers.",
    "Implement POST /api/pair/refresh endpoint for session and token management.",
    "Strengthen hermes agent probe from binary launch (`hermes --version`) to an active endpoint probe, matching the agy model probe standard."
  ],
  "constraints": [
    "VM101 house rule: NEVER run `docker prune` — 13 production SCADA containers (pjt2-scada, influxdb, grafana, postgres, gitea, etc.) are co-tenant on this VM.",
    "Preserve the Thin Middleware Invariant: no retry, routing, rate-limit classification, or policy logic in TypeScript; all delegation policy belongs in ORCHESTRATOR.md.",
    "Hermes hard fence: hermes must NEVER be given write access to `agents.toml`, `docker-compose.yml`, or `Dockerfile` configuration files.",
    "Never echo or write provider API keys or tokens to vault pages or logs (9router keys reside in container SQLite/config).",
    "When editing `agents.vm101.toml`, reload by running `docker compose restart middleware` (file is bind-mounted); do not rebuild images unless code/dependencies change.",
    "All agent sandboxes must maintain uid 1001 file ownership for `/data/project` shared disk compatibility.",
    "Host shared disk operations must target `/home/ubuntu/agents-switching/docker/data/project` (and `.../vault`), not the host's unmounted `/data/project` directory."
  ],
  "known_staleness_warning": "The main vault page (`wiki/projects/agents-switching.md`) contains historical Windows-era documentation (v0.2 through v0.7.2 portable app, `C:\\Tools\\agents-switching-portable`, `gemini.cmd`) in its upper sections. The bottom sections dated 2026-08-11 and 2026-08-24 explicitly clarify that VM101 runs Profile 2 container-per-sandbox topology on Linux Docker. Also, older vault references to Gitea at `172.24.0.2:8070` are historical/unreachable; active Gitea is at `localhost:3001`.",
  "handoff_metadata": {
    "created": "2026-08-25",
    "created_by": "project-control automated continue-prompt generator",
    "all_facts_sourced_from": "census-latest.json + /data/vault/wiki/projects/agents-switching.md + /data/vault/wiki/projects/agents-switching-v0.8.5-to-v0.8.11.md + /data/vault/wiki/projects/agents-switching-v0.8-steel-frame.md + /data/vault/wiki/preferences/Workflow Preferences.md + /data/vault/wiki/patterns/Middleware Orchestration Patterns.md + /data/vault/wiki/hot.md + /data/vault/wiki/log.md"
  }
}

Detail

Observed Signals

Containers: 8 active containers: agents-switching (docker-middleware, Up 17 hours, healthy, port 127.0.0.1:3100->3100/tcp), 9router (docker-9router, Up 18 hours, port 0.0.0.0:20128->20128/tcp), filebrowser (filebrowser/filebrowser:s6, Up 4 days, healthy, port 0.0.0.0:3004->80/tcp), plus 5 agent sandbox containers: sbx-hermes (Up 17 hours), sbx-claude-max (Up 19 hours), sbx-agy-2 (Up 19 hours), sbx-claude-2 (Up 19 hours), sbx-agy-suro1 (Up 19 hours).
Deployments: Managed directly via Docker Compose on host topology.
Git Repos & Local Clones: Gitea repository dimas/agents-switching (305 KB, updated_at: 2026-08-25T00:00:03Z).
Vault Documentation: agents-switching.md (status: active, updated 2026-08-24), agents-switching-v0.8.5-to-v0.8.11.md (status: developing, updated 2026-08-11), agents-switching-v0.8-steel-frame.md (status: active, updated 2026-07-14), agents-switching-v0.7.1-portable.md (status: superseded), agents-switching-v0.7.2-remote.md (status: superseded).

1. What's Left

Implementing and stabilizing roadmap items for v0.8.5→v0.8.11 (RAM-floor dispatch guard in src/core/dispatch/, dashboard $ cost view on React 19 UI, native MCP dispatch interface evaluation for Gemini-style orchestrators, and hermes agent endpoint probe hardening).

2. Continue / Drop Suggestion

Continue — Core fleet switching and orchestration infrastructure under active daily execution with 8 running containers and commits pushed today to Gitea.

3. Dynamic Milestone Estimate

Delivery Window: 3–7 days (by 2026-08-31) for v0.8.11 roadmap completion and dispatch guard stabilization.
Confidence: High (controller estimate, revised 2026-08-25).