wip: phase 2.5 snapshot before pypi work

Author: fanhongy

aidlc-docs/MEMORY_SYSTEM_DESIGN.md

@@ -0,0 +1,49 @@
+# AIDLC State — CAO Memory System Phase 1
+
+**Project**: CAO Memory System Phase 1  
+**Phase**: CONSTRUCTION  
+**Status**: ✅ COMPLETE — all 8 units implemented, challenger-approved, tests passing
+
+---
+
+## Stage Status
+
+### INCEPTION Phase
+
+| Stage | Status | Notes |
+|---|---|---|
+| Workspace Detection | ✅ COMPLETE | Brownfield — existing CAO codebase |
+| Reverse Engineering | ✅ COMPLETE | MEMORY_SYSTEM_DESIGN.md, MEMORY_SYSTEM_PROPOSAL.md produced |
+| Success Criteria Definition | 🔄 DRAFT | Awaiting user approval on aidlc-docs/success-criteria.md |
+| Requirements Analysis | ✅ COMPLETE | Captured in MEMORY_SYSTEM_DESIGN.md |
+| User Stories | ⏭ SKIPPED | System-level feature, not user-story-driven |
+| Workflow Planning | ✅ COMPLETE | Phase 1 scope agreed: no SQLite, full wiki, all providers |
+| Application Design | ✅ COMPLETE | MEMORY_SYSTEM_DESIGN.md is the application design |
+| Tasks Generation | ✅ COMPLETE | aidlc-docs/inception/tasks/tasks.md |
+
+### CONSTRUCTION Phase
+
+| Unit | Status | Notes |
+|---|---|---|
+| U1: MemoryService Core | ✅ COMPLETE | File-based, no SQLite, atomic writes, security hardened |
+| U2: MCP Tools | ✅ COMPLETE | memory_store/recall/forget in server.py lines 619-794 |
+| U3: Provider Injection | ✅ COMPLETE | Centralized inject_memory_context() in send_input() |
+| U4: Hook-Triggered Self-Save | ✅ COMPLETE | Stop + PreCompact hooks, registration.py |
+| U5: Cleanup Integration | ✅ COMPLETE | Tiered retention, scope_id fix, stale flag cleanup |
+| U6: CLI Commands | ✅ COMPLETE | list/show/delete/clear with key validation |
+| U7: Agent Profile Updates | ✅ COMPLETE | ## Memory section in all 3 built-in profiles |
+| U8: Tests & Validation | ✅ COMPLETE | 1292 passed, SC-16/17/18 all verified |
+
+---
+
+## Next Action
+
+Phase 1 complete. Ready for Phase 2 planning (context-manager agent, cross-provider handoff distillation, SQLite metadata, session_context MCP tool).
+
+## Key Design Decisions (locked)
+
+- No SQLite in Phase 1 — file-based only
+- key is optional on memory_store — auto-generated from first 6 words of content
+- Injection via stateless `<cao-memory>` block prepended to first user message (all 6 providers)
+- Stop hook + PreCompact for Claude Code; Stop hook for Codex; instruction-based for others
+- memory_forget exposed as MCP tool in Phase 1 (not deferred)

aidlc-docs/MEMORY_SYSTEM_PROPOSAL.md

@@ -0,0 +1,5 @@
+# Audit Log — CAO Memory System Phase 1
+
+---
+
+## 2026-04-13T00:00:00Z — INCEPTION bootstrapped