Module reflect 

v0.7.0 ARCH-3 / FX-C3 (batch2) — ai-memory reflect CLI subcommand.

Closes the three-surface-parity gap on memory_reflect. The MCP tool (crate::mcp::handle_reflect) and the HTTP route landed previously; this module wires the CLI surface so operators can drive the recursive-learning primitive from a terminal without constructing an MCP-stdio JSON-RPC envelope.

DRY contract

No business logic lives here — this module is a clap arg-parser plus an output formatter. The reflect pipeline (depth-cap, signature, reflects_on edge writes) lives in crate::mcp::handle_reflect. The MCP, HTTP, and CLI surfaces share that one implementation.

Signing posture

Matches the existing CLI convention (Persona / Calibrate / Skill): the CLI dispatches with active_keypair = None and embedder / vector_index = None. Operators who want signed reflects_on edges or LLM-driven dedup must drive memory_reflect over the MCP / HTTP daemon where the resolved keypair + embedder are ambient. The CLI surface stays unsigned by design so shell scripts can drive reflections without re-implementing the keypair-load ceremony.

Structs

ReflectArgs

CLI args for ai-memory reflect. Mirrors the MCP memory_reflect input_schema shape.

Functions

cmd_reflect

ai-memory reflect dispatch entry.