Complete State Hub bootstrap workplans (WP-0001)

- Review integration files; fill SCOPE where templated
- Document dev workflow in stack-and-commands.md
- Seed WP-0002 implementation workplan; mark bootstrap finished
- Hub sync via fix-consistency

.claude/rules/stack-and-commands.md

@@ -1,19 +1,20 @@
 ## Stack
 
-<!-- TODO: Fill in language, frameworks, and key dependencies -->
+- **Language:** Python 3.11+
-- **Language:**
+- **Key deps:** stdlib + pytest (see `pyproject.toml`)
-- **Key deps:**
 
 ## Dev Commands
 
 ```bash
-# TODO: Fill in the standard commands for this repo
+# Install (editable)
-
+pip install -e ".[dev]"   # or: python3 -m pip install pytest
-# Install dependencies
 
 # Run tests
+make test
+python3 -m pytest -q
 
-# Lint / type check
+# Mock audit backend smoke / cleanup
-
+make mock-audit-smoke
-# Build / package (if applicable)
+make mock-audit-cleanup
+python3 -m audit_core emit --help
 ```

workplans/AUDIT-WP-0001-statehub-bootstrap.md

@@ -4,7 +4,7 @@ type: workplan
 title: "Bootstrap State Hub integration"
 domain: infotech
 repo: audit-core
-status: ready
+status: finished
 owner: codex
 topic_slug: custodian
 created: "2026-06-22"
@@ -20,11 +20,14 @@ Reliable multi-tenant auto setup audit capability.
 
 ```task
 id: AUDIT-WP-0001-T01
-status: todo
+status: done
 priority: high
 state_hub_task_id: "59896d6b-85ed-455d-9bd4-b546a050205e"
+
 ```
 
+Result 2026-06-22: INTENT.md and SCOPE.md reviewed; AGENTS.md and brief confirmed.
+
 Review `INTENT.md`, `SCOPE.md`, `AGENTS.md`, and `.custodian-brief.md`.
 Replace generated placeholders with repo-specific facts where needed.
 
@@ -32,11 +35,14 @@ Replace generated placeholders with repo-specific facts where needed.
 
 ```task
 id: AUDIT-WP-0001-T02
-status: todo
+status: done
 priority: high
 state_hub_task_id: "f74d7033-a20b-45da-9d0a-23426e60403e"
+
 ```
 
+Result 2026-06-22: Documented Python/pytest workflow in stack-and-commands.md.
+
 Identify the repo's install, test, lint, build, and run commands. Add or refine
 those commands in the agent instructions so future coding sessions can verify
 changes confidently.
@@ -45,11 +51,14 @@ changes confidently.
 
 ```task
 id: AUDIT-WP-0001-T03
-status: todo
+status: done
 priority: medium
 state_hub_task_id: "5df0cd46-9193-48a0-bd59-0e6acbc56270"
+
 ```
 
+Result 2026-06-22: Created AUDIT-WP-0002.
+
 Create the first implementation workplan for the repository's most important
 next change. After workplan file updates, run from `~/state-hub`:
 

workplans/AUDIT-WP-0002-pluggable-audit-backend.md

@@ -0,0 +1,28 @@
+---
+id: AUDIT-WP-0002
+type: workplan
+title: "Pluggable audit backend contract"
+domain: infotech
+repo: audit-core
+status: ready
+owner: codex
+topic_slug: custodian
+created: "2026-06-22"
+updated: "2026-06-22"
+state_hub_workstream_id: "14725dbf-16ae-43e5-bf52-3f93238cf264"
+---
+
+# Pluggable audit backend contract
+
+Define the replaceable audit backend interface beyond the mock JSONL writer and document retention guarantees.
+
+## Author backend interface contract
+
+```task
+id: AUDIT-WP-0002-T01
+status: todo
+priority: high
+state_hub_task_id: "588ac6fa-eb41-49ce-8a1c-850d5791de0b"
+```
+
+Document `AuditBackend` protocol, event schema, retention policy, and migration path from the mock file backend in `docs/` or module docstrings.