wip: 05-mvp-deployment paused at task 0/0

This commit is contained in:
Mikhail Putilovskij 2026-04-30 18:04:24 +03:00
parent 7e5f9c20a0
commit 6369721876
2 changed files with 93 additions and 42 deletions

View file

@ -1,86 +1,114 @@
{
"version": "1.0",
"timestamp": "2026-04-28T18:39:43.064Z",
"timestamp": "2026-04-30T15:03:14Z",
"phase": "05",
"phase_name": "MVP Deployment",
"phase_name": "MVP deployment",
"phase_dir": ".planning/phases/05-mvp-deployment",
"plan": 4,
"plan": 0,
"task": 0,
"total_tasks": 0,
"status": "paused",
"completed_tasks": [
{
"id": 1,
"name": "Finalize multi-agent surface image handoff",
"name": "Fix path-based base_url normalization and add WS debug visibility",
"status": "done",
"commit": "5b53788"
"commit": "7e5f9c2"
},
{
"id": 2,
"name": "Publish Docker image for the Matrix surface",
"name": "Add Matrix room recovery, reinvite flow, and default-agent warning behavior",
"status": "done",
"artifact": "mput1/surfaces-bot:latest",
"digest": "sha256:26ba3a49290ab7c1cf0fa97f3de3fefdc70b59df7e6f1e0c2255728f8e2369be"
"commit": "7e5f9c2"
},
{
"id": 3,
"name": "Verify multi-agent file-volume routing contract",
"name": "Switch user file handling to workspace-root filenames with copy-style collision suffixes",
"status": "done",
"evidence": "tests cover /agents/17/incoming and /agents/17/output routing"
"commit": "7e5f9c2"
},
{
"id": 4,
"name": "Verify recent routing incident cause",
"status": "done",
"progress": "Confirmed that config lookup is exact-MXID based; mismatch in homeserver suffix caused fallback to the first agent."
}
],
"remaining_tasks": [
{
"id": 1,
"name": "Platform team integrates the published surface image into their 25-30 agent deployment",
"status": "external"
"id": 5,
"name": "Build and publish a fresh production image with the current workspace-root attachment contract",
"status": "not_started"
},
{
"id": 2,
"name": "Run a real platform smoke test with production Matrix credentials, matrix-agents.yaml, and shared /agents volume",
"id": 6,
"name": "Send the new digest to platform and request Matrix bot redeploy",
"status": "not_started"
}
],
"blockers": [
{
"description": "Full production verification depends on the platform team's real 25-30 agent orchestration and volume mounts.",
"description": "Platform redeploy is still required after the next image publish.",
"type": "external",
"workaround": "Use docker-compose.fullstack.yml only as local E2E harness; production uses mput1/surfaces-bot:latest plus platform-managed agents."
"workaround": "None until a fresh digest is published."
},
{
"description": "Old Phase 04 planning files still contain placeholder content.",
"type": "technical",
"workaround": "Ignore for the current deploy task; clean later as planning debt."
}
],
"human_actions_pending": [
{
"action": "Send platform the image tag, digest, deploy docs, and matrix-agents.yaml contract",
"context": "The bot is published as a single surface container; platform supplies agents, base_url values, and /agents/N volume mounts.",
"action": "Use exact Matrix MXIDs in user_agents, including the real homeserver suffix.",
"context": "Routing fallback to the first agent occurs whenever the config key does not exactly match the sender.",
"blocking": true
},
{
"action": "Platform prepares production config/matrix-agents.yaml",
"context": "Each external agent needs agent_id, base_url, and workspace_path such as /agents/17.",
"action": "Redeploy matrix-bot after the new image is published.",
"context": "Config edits alone need a container restart; the file-contract code change needs a new image first.",
"blocking": true
}
],
"decisions": [
{
"decision": "Ship one generic Matrix surface image, not a compose stack with 25-30 agents.",
"rationale": "The platform owns agent lifecycle/orchestration; the surface only needs base_url and workspace_path per agent.",
"decision": "Keep fallback to the first agent for users missing from user_agents.",
"rationale": "Platform wanted that behavior to remain available, but with explicit user warning.",
"phase": "05"
},
{
"decision": "Make SURFACES_BOT_IMAGE explicit and document the published mput1/surfaces-bot image.",
"rationale": "Docker Hub push access is namespace-specific; hardcoding mrkan0 caused insufficient_scope.",
"decision": "Require exact Matrix MXID matching in user_agents.",
"rationale": "Current routing is deterministic and simple; no fuzzy matching or homeserver aliasing was introduced.",
"phase": "05"
},
{
"decision": "Keep docker-compose.fullstack.yml as internal E2E only.",
"rationale": "It validates the bot plus one local agent, but is not a model of production multi-agent orchestration.",
"decision": "Use workspace-root filenames for incoming user files and Windows-style copy suffixes on collision.",
"rationale": "Platform requested removal of incoming/outgoing directory split and timestamp-prefixed names.",
"phase": "05"
}
],
"uncommitted_files": [
".planning/HANDOFF.json",
".planning/phases/05-mvp-deployment/.continue-here.md"
".planning/STATE.md",
".planning/phases/05-mvp-deployment/.continue-here.md",
"README.md",
"adapter/matrix/agent_registry.py",
"adapter/matrix/bot.py",
"adapter/matrix/files.py",
"adapter/matrix/handlers/auth.py",
"adapter/matrix/handlers/chat.py",
"adapter/matrix/reconciliation.py",
"adapter/matrix/routed_platform.py",
"config/matrix-agents.example.yaml",
"docs/deploy-architecture.md",
"sdk/real.py",
"tests/adapter/matrix/test_dispatcher.py",
"tests/adapter/matrix/test_files.py",
"tests/adapter/matrix/test_invite_space.py",
"tests/adapter/matrix/test_reconciliation.py",
"tests/platform/test_real.py",
"tests/test_deploy_handoff.py"
],
"next_action": "Resume by coordinating platform integration: confirm they use mput1/surfaces-bot:latest, mount /agents, provide config/matrix-agents.yaml, then run a real Matrix smoke test.",
"context_notes": "Phase 05 implementation and handoff commit 5b53788 are pushed. The Docker image was successfully built and pushed by the user as mput1/surfaces-bot:latest with digest sha256:26ba3a49290ab7c1cf0fa97f3de3fefdc70b59df7e6f1e0c2255728f8e2369be. Existing unrelated .planning dirt and a local jpg remain in the worktree and were intentionally not included in the handoff commit."
"next_action": "Build and publish a fresh production image from the current worktree, then send the digest to the platform for redeploy.",
"context_notes": "Current runtime logic appears correct. The last reported routing bug was traced to config mismatch between the real Matrix sender and the user_agents key. Do not reuse the previously published recovery image for deployment because it does not include the final workspace-root file contract."
}