wip: matrix-restart-reconciliation-and-dev-reset-workflow paused at task 1/2
This commit is contained in:
parent
6ced154124
commit
b08a5e3d96
2 changed files with 47 additions and 57 deletions
|
|
@ -1,6 +1,6 @@
|
|||
{
|
||||
"version": "1.0",
|
||||
"timestamp": "2026-04-04T10:13:58.720Z",
|
||||
"timestamp": "2026-04-07T15:11:42.203Z",
|
||||
"phase": "01.1",
|
||||
"phase_name": "matrix-restart-reconciliation-and-dev-reset-workflow",
|
||||
"phase_dir": ".planning/phases/01.1-matrix-restart-reconciliation-and-dev-reset-workflow",
|
||||
|
|
@ -23,65 +23,49 @@
|
|||
],
|
||||
"blockers": [
|
||||
{
|
||||
"description": "Phase 02 SDK integration remains blocked because platform control-plane contract is not stable yet; current platform repos only clearly expose the direct agent WebSocket layer.",
|
||||
"description": "The longer-term Phase 02 platform integration is still blocked because `master` does not yet expose a stable user/chat/session/settings API for surfaces.",
|
||||
"type": "external",
|
||||
"workaround": "Keep the current consumer-facing bot flows and mock-backed facade for now; use Matrix as the internal testing surface and revisit integration once master user/chat/session access is clarified."
|
||||
"workaround": "Use the direct `agent` WebSocket for a working prototype and keep control-plane concerns deferred behind a compatibility shim."
|
||||
},
|
||||
{
|
||||
"description": "The current `agent` implementation uses a shared fixed thread id, so all prototype conversations would share memory unless the agent side is parameterized by chat/session.",
|
||||
"type": "external",
|
||||
"workaround": "Ask the platform team for a minimal upstream change to accept per-chat thread identity, then keep the bot-side implementation inside `sdk/real.py`."
|
||||
}
|
||||
],
|
||||
"human_actions_pending": [
|
||||
{
|
||||
"action": "Confirm with the platform team the minimal control-plane contract for user/chat/session access and whether settings/attachments will exist in master.",
|
||||
"context": "Current evidence shows agent_api is usable, but master is not yet a stable consumer-facing API.",
|
||||
"action": "Decide whether the direct-agent Matrix prototype should live in this repo or in a separate repo.",
|
||||
"context": "This determines whether the prototype is treated as a short-lived spike or the first durable real-backend path for surfaces.",
|
||||
"blocking": true
|
||||
},
|
||||
{
|
||||
"action": "Confirm with the platform team the minimal agent-side change needed to support per-chat or per-user thread identity.",
|
||||
"context": "Without that, all conversations on the prototype would share a single memory thread.",
|
||||
"blocking": true
|
||||
}
|
||||
],
|
||||
"decisions": [
|
||||
{
|
||||
"decision": "Do not start a full rewrite of the consumer-facing bot integration yet.",
|
||||
"rationale": "Platform direction is visible, but too many pieces outside the direct agent WebSocket protocol are still undefined or inconsistent.",
|
||||
"decision": "Do not use `master` as the prototype backend yet.",
|
||||
"rationale": "Live repo analysis shows only minimal HTTP endpoints, not the consumer-facing APIs required by surfaces.",
|
||||
"phase": "02"
|
||||
},
|
||||
{
|
||||
"decision": "Treat sdk/mock.py as a temporary local integration facade rather than a near-drop-in replacement for the real platform.",
|
||||
"rationale": "The current mock assumes a unified platform API, while the real platform is split between control plane and direct agent session.",
|
||||
"decision": "Use the direct `agent` WebSocket as the prototype response path.",
|
||||
"rationale": "It already exists and can be wrapped behind the current `PlatformClient` boundary with limited adapter impact.",
|
||||
"phase": "02"
|
||||
},
|
||||
{
|
||||
"decision": "Use Matrix as the internal testing surface while waiting for the platform contract to stabilize.",
|
||||
"rationale": "This preserves product iteration without coupling the bot too early to a moving platform backend.",
|
||||
"decision": "Keep Matrix adapter logic as stable as possible and absorb platform differences inside a new `sdk/real.py` implementation.",
|
||||
"rationale": "This preserves expandability for later platform versions and avoids coupling transport code to a temporary backend shape.",
|
||||
"phase": "02"
|
||||
}
|
||||
],
|
||||
"uncommitted_files": [
|
||||
".planning/config.json",
|
||||
"adapter/matrix/bot.py",
|
||||
"adapter/matrix/handlers/__init__.py",
|
||||
"adapter/matrix/handlers/auth.py",
|
||||
"adapter/matrix/handlers/chat.py",
|
||||
"adapter/matrix/handlers/settings.py",
|
||||
"adapter/telegram/bot.py",
|
||||
"sdk/mock.py",
|
||||
"tests/adapter/matrix/test_chat_space.py",
|
||||
"tests/adapter/matrix/test_dispatcher.py",
|
||||
"tests/adapter/matrix/test_invite_space.py",
|
||||
"tests/platform/test_mock.py",
|
||||
".planning/phases/01-matrix-qa-polish/01-01-SUMMARY.md",
|
||||
".planning/phases/01-matrix-qa-polish/01-04-SUMMARY.md",
|
||||
".planning/phases/01-matrix-qa-polish/01-05-PLAN.md",
|
||||
".planning/phases/01-matrix-qa-polish/01-06-PLAN.md",
|
||||
".planning/phases/01-matrix-qa-polish/01-VERIFICATION.md",
|
||||
".planning/phases/01.1-matrix-restart-reconciliation-and-dev-reset-workflow/.gitkeep",
|
||||
"bot-examples/",
|
||||
"docs/reports/2026-04-01-surfaces-progress-report.md",
|
||||
"docs/superpowers/plans/2026-03-31-matrix-adapter.md",
|
||||
"docs/workflow-backup-2026-04-01.md",
|
||||
"forum_topics_research.md",
|
||||
"image copy 2.png",
|
||||
"image copy.png",
|
||||
"image.png",
|
||||
"lambda_bot.db",
|
||||
"lambda_matrix.db"
|
||||
".planning/HANDOFF.json",
|
||||
".planning/phases/01.1-matrix-restart-reconciliation-and-dev-reset-workflow/.continue-here.md"
|
||||
],
|
||||
"next_action": "When resuming, either execute Phase 01.1 Plan 03 Task 1 (Matrix reset CLI) or continue the platform-integration design by defining a split MasterClient/AgentSession boundary without changing consumer adapters yet.",
|
||||
"context_notes": "This session was research-heavy rather than implementation-heavy. The key conclusion is that the real platform currently exposes a direct agent WebSocket SDK plus an unfinished master control plane; our mock models a richer unified platform than what exists today. That means future work should isolate the integration boundary, not rush a full rewrite."
|
||||
"next_action": "On resume, either continue Phase 01.1 Plan 03 Task 1 (`adapter.matrix.reset`) or finish the design decision about whether the direct-agent prototype belongs in this repo or a separate repo.",
|
||||
"context_notes": "Latest conclusion as of 2026-04-07: full platform integration through `master` is still premature, but a usable Matrix prototype can be built now by introducing `sdk/real.py` as a compatibility shim over the direct `agent` WebSocket. The critical open design question is repo placement, followed by a small upstream request for per-chat thread identity in the agent."
|
||||
}
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue