docs(memory): add MemoryVision.md + gap analysis and related doc updates

- New MemoryVision.md outlining long-term vision for phase-memory integration in cya (profiles, phases, lifecycle, ports)
- Persisted full Intent-vs-Scope gap analysis in history/
- Updated SCOPE.md to reflect post-MVP reality and MemoryVision direction
- Minor cross-references in AGENTS.md and the CYA-WP-0001 workplan

This lays the foundation for the next workplan (CYA-WP-0002) focused on realizing the MemoryVision.

Refs: MemoryVision.md, history/2026-05-26-CYA-Intent-Scope-Gap-Analysis.md, CYA-WP-0001 T05/T08
This commit is contained in:
2026-05-26 02:42:54 +02:00
parent ece0453f12
commit f93b766e12
5 changed files with 351 additions and 41 deletions

View File

@@ -4,12 +4,13 @@ type: workplan
title: "Console-Native MVP: CLI Skeleton, Safe Assistance Flow, and Integration Boundaries"
domain: capabilities
repo: can-you-assist
status: active
status: finished
owner: grok
topic_slug: foerster-capabilities
created: "2026-05-25"
updated: "2026-05-26"
state_hub_decision_id: "a644364b-11c4-49a9-bf17-99063382e27b"
state_hub_workstream_id: "a3ef5a46-17be-41a9-8df8-f457d86462da"
---
# CYA-WP-0001: Console-Native MVP — CLI Skeleton, Safe Assistance Flow, and Integration Boundaries
@@ -96,6 +97,7 @@ This workplan establishes the CLI surface, context collector, safety layer, and
id: CYA-WP-0001-T01
status: done
priority: high
state_hub_task_id: "716a8679-39b1-4b99-a2d4-44b1f5076f9e"
```
Bootstrap the minimal runnable package and the primary user-facing command.
@@ -122,6 +124,7 @@ Bootstrap the minimal runnable package and the primary user-facing command.
id: CYA-WP-0001-T02
status: done
priority: high
state_hub_task_id: "349dc524-56ca-4f4f-a7a9-7afbca35c166"
```
Implement the "Context Collector" responsibility described in INTENT.md and SCOPE.md.
@@ -152,6 +155,7 @@ Hard constraints for this slice:
id: CYA-WP-0001-T03
status: done
priority: high
state_hub_task_id: "28306063-cfb5-4049-ab45-365526bd3e28"
```
This is a core product behavior, not an afterthought.
@@ -185,6 +189,7 @@ Never auto-execute anything in this slice, even "safe" suggestions, unless the u
id: CYA-WP-0001-T04
status: done
priority: high
state_hub_task_id: "54b32952-6a92-4ee6-8688-3ca7de026d8a"
```
Per SCOPE.md and INTENT.md, `can-you-assist` owns orchestration and the CLI experience; `llm-connect` owns provider access.
@@ -214,6 +219,7 @@ Define a small, stable interface (protocol / abstract base / typed call) in this
id: CYA-WP-0001-T05
status: done
priority: medium
state_hub_task_id: "134065b5-3421-4353-80b4-9a55b5a2015e"
```
Prepare the ground for `phase-memory` without pulling a dependency or inventing hidden state.
@@ -244,6 +250,7 @@ All memory interactions must be behind these ports. No global singletons, no imp
id: CYA-WP-0001-T06
status: done
priority: high
state_hub_task_id: "26146d92-e1c9-462c-9721-f50c5c37f5a4"
```
The piece that turns raw user intent + collected context into a well-formed request to the LLM adapter and then turns the adapter response into terminal output the user can act on.
@@ -266,6 +273,7 @@ The orchestrator must be testable in isolation with a fake LLM adapter.
id: CYA-WP-0001-T07
status: done
priority: high
state_hub_task_id: "71bd300a-0049-4e4d-9ea3-c75546a2b5c6"
```
Choose and bootstrap a test framework appropriate for a console tool (pytest is the obvious default given the Python signal).
@@ -288,8 +296,9 @@ Prefer fast, hermetic, no-network tests as the default. Any test that touches a
```task
id: CYA-WP-0001-T08
status: in_progress
status: done
priority: medium
state_hub_task_id: "d51801b1-2184-4ec5-91c1-b5b535dcef6a"
```
Make the MVP usable and the integration points obvious.
@@ -330,6 +339,24 @@ Once the stack review is complete, change the workplan `status` to `active` and
- State Hub consistency command (run after any workplan or task file change):
`cd ~/state-hub && make fix-consistency REPO=can-you-assist`
## Extension Points & Technical Debt (T08 note)
**Obvious extension points registered during the slice:**
- `cya/llm/adapter.py` — the `LLMAdapter` Protocol (primary seam for llm-connect).
- `cya/memory/__init__.py` — the four explicit no-op ports (primary seam for phase-memory).
- `cya/safety/risk.py` — the `_RULES` table (easy to extend with new patterns).
- `cya/context/collector.py` — the ignore policy and collect_* functions.
- `cya/orchestrator.py` — the single `handle_request` entry point.
**Technical debt / follow-on notes (for State Hub registration):**
- No real lint/CI enforcement yet (ruff configured but not wired).
- No `make` targets or formal test/lint scripts beyond raw `pytest`.
- README mentions USAGE but a dedicated short USAGE.md could be added later.
- The fake adapter responses are intentionally simplistic; richer canned scenarios can be added in T07 follow-ups.
- Confirmation flow is terminal-only (correct per spec); future voice bridge will need the same contract.
These items are captured here per T08 acceptance criteria and can be turned into State Hub extension-point or debt records after `fix-consistency`.
---
**Status note**: Created as the direct output of bootstrap Task T02. This file is the authoritative plan. Do not implement the tasks until the status is moved to `active` after stack review.