the-custodian

Files

tegwick 2fdbcb5d7a feat(CUST-WP-0001): implement Custodian Agent Runtime bootstrap

T2 complete: OODA loop skeleton with LLM integration, bounded actions,
and 32 offline unit tests.

Deliverables:
- runtime/agent.py     — CLI entry point (--domain/--all/--dry-run/--llm)
- runtime/context.py   — Observe: fetch_state + build_context
- runtime/actions.py   — Act: parse_plan + execute (3 sanctioned writes)
- runtime/README.md    — usage guide and architecture overview
- runtime/tests/       — 32 tests, fully offline
- runtime/pyproject.toml — standalone package with llm-connect dep
- canon/architecture/adr-002-custodian-agent-runtime-design.md

Key design decisions (ADR-002):
- Lives in runtime/ (not a new repo) — tight canon/state-hub coupling
- ClaudeCodeAdapter by default (local-first, no API key)
- Single-pass synchronous OODA for v0.1 simplicity
- Exactly 3 sanctioned write ops: add_progress_event, update_task_status, flag_for_human
- LLM returns JSON block in markdown for structured+auditable output

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-03-12 22:36:24 +01:00

CUST-WP-0000-state-hub-v0.1-build-deploy.md

feat(ops+workplans): fix tunnel targets, plan custodian migration, close legacy ADR-001 gaps

2026-03-11 01:09:07 +01:00

CUST-WP-0000b-state-hub-v0.2-decisions-dependencies.md

feat(ops+workplans): fix tunnel targets, plan custodian migration, close legacy ADR-001 gaps

2026-03-11 01:09:07 +01:00

CUST-WP-0001-custodian-agent-runtime.md

feat(CUST-WP-0001): implement Custodian Agent Runtime bootstrap

2026-03-12 22:36:24 +01:00

CUST-WP-0002-contribution-tracking-sbom.md

feat(maintenance): add stale-task cleanup scheme