surfaces/.planning/STATE.md

gsd_state_version	milestone	milestone_name	status	last_updated	progress
1.0	v1.0	— Production-ready surfaces	Ready to execute	2026-04-17T16:10:00.000Z	total_phases completed_phases total_plans completed_plans percent 5 2 12 9 75

State

Project Reference

See: .planning/PROJECT.md (updated 2026-04-02)

Core value: Пользователь ведёт диалог с Lambda через любой мессенджер без изменения ядра Current focus: Phase 04 complete — Matrix MVP implementation ready for testing

Current Phase

Phase 4 implementation complete: Matrix MVP

Phase 4 is implemented. Next step is manual and automated testing of the Matrix MVP flow before deciding on follow-up work.

Decisions

• Продолжаем с Threaded Mode несмотря на баги Mac клиента (2026-04-02)
• Invite flow Matrix переведён на idempotent-проверку через user_meta.space_id, а не через invite-room metadata (2026-04-02)
• Неизвестные Matrix rooms больше не auto-register в роутере; используется явный fallback unregistered:{room_id} с warning-логом (2026-04-02)
• [Phase 01]: Use ChatContext.surface_ref as the Matrix room identifier for !rename updates.
• [Phase 01]: Keep !archive limited to core archive state in Phase 1; Space child removal remains deferred.
• [Phase 01]: Matrix OutgoingUI no longer emits reactions; confirmation state is persisted and resumed via !yes / !no.
• [Phase 01]: !settings now renders a dashboard snapshot instead of advertising mutable subcommands.
• [Phase 01]: Split Matrix regression coverage into dedicated invite/chat/send_outgoing/confirm test modules.
• [Phase 01]: Kept 01-04 scoped to test coverage without widening into production-code changes.
• [Phase 01]: Matrix command callbacks now include room_id in payload for !yes and !no so confirm handlers can resolve runtime state without changing core protocol types.
• [Phase 01]: Pending confirmations are stored under the D-08 composite key of matrix user id plus room id, with a narrow legacy fallback only for callers that omit room context.
• [Phase 01]: Removed Matrix reaction conversion entirely and kept command callbacks limited to !yes/!no.
• [Phase 01]: Kept !settings as a pure snapshot surface while preserving mutable subcommands outside the dashboard.
• [Phase 01]: Seeded invite and dispatcher tests with explicit next_chat_index and room ids instead of treating C1 as Matrix transport identity.
• [Phase 04]: Replaced AgentSessionClient with AgentApiWrapper and persistent agent connection lifecycle in Matrix runtime.
• [Phase 04]: Added !save, !load, !reset, and !context commands with pending-state interception and local prototype session metadata.
• [Phase 04]: Added Matrix-only Docker packaging for MVP deployment; platform services remain external to this compose setup.

Blockers

• Lambda platform SDK не готов — Phase 2 заблокирована до готовности платформы

Accumulated Context

Roadmap Evolution

• Phase 01.1 inserted after Phase 01: Matrix restart reconciliation and dev reset workflow (URGENT)
• Phase 4 added: Matrix MVP: shared agent context and context management command
• New platform signal: upcoming proper chat_id support should enable file-level context separation and stronger context management in a future follow-up phase.

Performance Metrics

Phase	Plan	Duration	Tasks	Files	Recorded
01	01	1 min	3	3	2026-04-02T19:50:50Z
01	02	1 min	2	2	2026-04-02
01	03	3 min	2	5	2026-04-02T19:57:34Z
01	04	3 min	2	7	2026-04-02T20:03:38Z
01	05	2 min	2	7	2026-04-03T09:28:47Z
01	06	4 min	2	7	2026-04-03T09:35:39Z
04	01	1 session	1 wave	8	2026-04-17
04	02	1 session	2 commits + summary	8	2026-04-17
04	03	1 session	1 commit + summary	4	2026-04-17

Session

• Last session: 2026-04-17T16:10:00Z
• Stopped at: Phase 4 implementation complete, ready for testing