Files

tegwick feb60c1d96 feat(PMEM-WP-0017): federated store management CLI and activity reports

Add phase_memory.management for cross-store discovery and windowed
activity reporting. Extend the phase-memory CLI with stores list and
report commands, plus make report-7d for the default weekly operator view.

2026-07-03 01:24:16 +02:00

2.5 KiB

Raw Blame History

id, type, title, domain, repo, status, owner, topic_slug, created, updated

id	type	title	domain	repo	status	owner	topic_slug	created	updated
PMEM-WP-0017	workplan	Federated Store Management CLI And Activity Reports	communication	phase-memory	finished	codex	phase-memory	2026-07-03	2026-07-03

PMEM-WP-0017: Federated Store Management CLI And Activity Reports

Goal

Extend the phase-memory CLI into a management interface for every on-disk memory store the runtime has produced — not only the ops-warden coordination store. Operators and agents need one command to answer:

How much memory activity happened in the last N days across all stores?
Which store contributed what (episodes, audit events, session kinds, outcomes)?
What does a single store look like in detail for the same window?

LLM interactivity stays out of scope here. When memory is "brought to life" through ops-warden (worker, route/access, coding-agent sessions), chat already happens in that surface. This workplan adds inspectable reporting only.

Implementation Update - 2026-07-03

Shipped federated store discovery, windowed activity aggregation, and CLI reporting:

src/phase_memory/management.py — discovery, classification, aggregation, build_federated_report, build_store_list
phase-memory stores list and phase-memory report [--days N] [--store …]
make report-7d and make report REPORT_DAYS=N
Tests in tests/test_management_cli.py with tests/fixtures/management/

Validation: make test → 117 passed, 1 skipped.

T01 - Store discovery and classification

id: PMEM-WP-0017-T01
status: done
priority: high

Implement phase_memory.management with discover_memory_stores, classify_store, and registry read path.

T02 - Windowed activity aggregation

id: PMEM-WP-0017-T02
status: done
priority: high

Aggregate ops-warden episodes and local graph events/audit for a time window.

T03 - Federated report envelope

id: PMEM-WP-0017-T03
status: done
priority: high

build_federated_report returns phase_memory.management.federated_report.v1.

T04 - CLI commands

id: PMEM-WP-0017-T04
status: done
priority: high

stores list and report wired in cli.py.

T05 - Makefile, README, and operator runbook

id: PMEM-WP-0017-T05
status: done
priority: medium

make report-7d, README management section, runbook cross-store activity.

T06 - Tests and evaluation hook

id: PMEM-WP-0017-T06
status: done
priority: medium

tests/test_management_cli.py and management fixtures; public API snapshot updated.

2.5 KiB Raw Blame History