diff --git a/AGENTS.md b/AGENTS.md index 0463e58..3e08005 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -11,6 +11,31 @@ --- +## Dev Workflow + +The deliverable code lives in `session_memory/` (the Helix Forge coding-session +memory system). It is **pure-stdlib Python 3.11+** — `tomllib`, `sqlite3`, +`dataclasses`; no third-party runtime dependencies and no build step. `pytest` is +the only dev dependency. Run everything from the repo root. + +| Need | Command | +|------|---------| +| Python | `python3` (3.11+ required for `tomllib`; developed on 3.12) | +| Install deps | none at runtime; for tests: `pip install pytest` (or `uv pip install pytest`) | +| Test | `python3 -m pytest` (full suite) · `python3 -m pytest tests/test_curate_review.py` (one file) · `-q` for quiet | +| Lint / build | none configured — keep changes matching surrounding style | +| Run: ingest sweep | `python3 -m session_memory.ingest` (`--dry-run`, `--config PATH`) | +| Run: detect | `python3 -m session_memory.detect` (`--json`, `--min-frequency N`) | +| Run: curate | `python3 -m session_memory.curate` (`--auto-approve`, `--json`) | +| Config | `session_memory/config.toml`; local store under `session_memory/.store/` (gitignored) | + +**Verify a change before declaring it done:** run `python3 -m pytest` (expect all +green), and for pipeline changes do a live `ingest → detect → curate` pass against +the local store. See `session_memory/README.md` for the full layout and the +detect → curate → distribute flow. + +--- + ## State Hub Integration The Custodian State Hub tracks work across all domains. Interact via HTTP REST — diff --git a/workplans/AGENTIC-WP-0001-statehub-bootstrap.md b/workplans/AGENTIC-WP-0001-statehub-bootstrap.md index fe54343..56f9798 100644 --- a/workplans/AGENTIC-WP-0001-statehub-bootstrap.md +++ b/workplans/AGENTIC-WP-0001-statehub-bootstrap.md @@ -4,11 +4,11 @@ type: workplan title: "Bootstrap State Hub integration" domain: helix_forge repo: agentic-resources -status: ready +status: finished owner: codex topic_slug: helix-forge created: "2026-06-06" -updated: "2026-06-06" +updated: "2026-06-07" state_hub_workstream_id: "bb9a43a3-a54f-434b-97c2-e1c7142b52f5" --- @@ -20,7 +20,7 @@ Iterating towards optimal agentic performance. ```task id: AGENTIC-WP-0001-T01 -status: todo +status: done priority: high state_hub_task_id: "3ad7b7a9-ee5b-40e7-bd83-d6f0d1db7867" ``` @@ -32,7 +32,7 @@ Replace generated placeholders with repo-specific facts where needed. ```task id: AGENTIC-WP-0001-T02 -status: todo +status: done priority: high state_hub_task_id: "db248d57-8e1b-41ef-8386-c04ba490bc6d" ``` @@ -45,7 +45,7 @@ changes confidently. ```task id: AGENTIC-WP-0001-T03 -status: todo +status: done priority: medium state_hub_task_id: "9cbb7aa5-dd49-48e2-b5a0-1670584aecf7" ```