contmemo 0.1.0

Memory custodian agent for the Cont Hive ecosystem (offline, air-gapped). Memory only — recipes live in contrecipe.

contmemo

Memory custodian agent for the Cont Hive ecosystem. Offline, air-gapped, single-writer, deterministic-first.

contmemo is the kâtip ("scribe") of the Cont Hive. It is the only module that writes to Cont's memory. Every other agent — including cont itself — submits proposals; contmemo evaluates them and decides what gets persisted.

Scope is memory only. Recipe sanity, lifecycle, and evolution are the responsibility of the sibling agent contrecipe. The two are peers, not nested.

See docs/architecture.md for the full design.

Status

Sprint M1 — Skeleton. Repo structure, CLI parser, test harness. No runtime behavior yet. Each core/*.py module exposes a stub class so later sprints can fill in their own corner without touching the wiring.

Sprint	Scope	Status
M1	Skeleton (this commit)	done
M2	Event log (append-only JSONL + lookup)	next
M3	Proposal inbox watcher + deterministic	—
M4	Single-writer Cont memory writer	—
M5	Light-mode runtime (trace watching)	—
M6	Bulk mode + mini-LLM client	—
M7	PyPI publish (offline-friendly artifact)	—
M8	Cont integration (shim layer in cont)	—

Install (dev)

git clone <repo>
cd contmemo
pip install -e ".[dev]"
pytest

Usage (planned)

contmemo --watch              # light-mode daemon (Sprint M5)
contmemo --bulk --since "1h"  # one-shot reflection (Sprint M6)
contmemo --report --last 50   # event-log tail (Sprint M2)

In M1 these flags parse but exit with 2 and a "not yet implemented" notice pointing at the responsible sprint.

Design invariants

These never bend, regardless of sprint:

1. Single-writer. Cont memory is written by contmemo and nothing else.
2. Proposal-only. Cont thinks it writes; it actually submits.
3. Deterministic before LLM. Light path has no model. LLM only in bulk.
4. Append-only event log. Contmemo's own memory has no LLM in the loop — no recursion, no self-summarization.
5. Air-gapped. Zero cloud, zero outbound network, zero telemetry.

License

Private — internal Cont Hive component. Not for redistribution.