Cannabis Observer Archiver service — central registry + authoring service for the information layer. Owns Information Items, Information Sources (URL-keyed root or parent-keyed fragment), Source Revisions (content-addressed snapshots), Replication Specifications, and effective-dated item↔rep-spec assignments. FastAPI + PostgreSQL. Sibling to watcher and notifier; consumed by Watcher (and the forthcoming Replicator) via the archiver-client v1.x Python SDK; produces the info.changes Redis Stream via an internal outbox publisher.
Extracted from the in-tree src/information/ of watcher in 2026-05 (watcher#149). The current data model (Phase 4 / Archiver v2) is documented in docs/plans/2026-05-08-archiver-v2-architecture-design.md; the implementation plan is at docs/plans/2026-05-08-phase-4-archiver-v2-implementation.md.
export $(cat /etc/archiver/.env .env 2>/dev/null | xargs)
uv sync
uv run alembic upgrade head
uv run uvicorn src.api.main:app --host 0.0.0.0 --port 8021 --reloadProduction listens on port 8020 under archiver.service. The dev server uses 8021 to leave 8020 alone for systemd.
export $(cat /etc/archiver/.env .env 2>/dev/null | xargs)
uv run pytestTEST_DATABASE_URL is required (a separate Postgres database from ARCHIVER_DATABASE_URL).
Generated + hand-written Python client at clients/python/, currently at v1.0 (Phase 4 cutover; breaking-change boundary vs. the v0.x InfoSpec API). Path-installed by Watcher and Replicator. To regenerate from the running service:
bash clients/python/scripts/regen.sh(The script invokes dump_openapi.py internally.)
Set ARCHIVER_REDIS_URL=redis://localhost:6379/0 in the environment to enable the outbox publisher background task that drains changes_outbox rows to the info.changes Redis Stream. Unset → publisher is silently disabled (degraded local-dev mode).