feat(v3.0): Phase 52 Simple CLI API

[RichardHightower]

Summary

Phase 52 of v3.0 Competitive Parity & Benchmarks — adds the memory binary, a dead-simple CLI that talks to the daemon over gRPC. All commands route through existing RPCs; no direct RocksDB access from the CLI.

Commands

Command	Purpose
memory search <query>	Orchestrated hybrid search (BM25 + vector + TOC + topic, optional rerank)
memory context <query>	Build a context window for the current conversation
memory recall <query>	Alias for search --rerank=llm (heavier, slower, higher quality)
memory add <text>	Ingest a new memory event
memory timeline	Browse the memory timeline
memory summary	Summary of recent memory

Global args: --format, --endpoint, plus TTY-aware output (JSON when piped, human-friendly when interactive).

Design decisions

• gRPC-only — every command goes through memory-daemon RPCs; the CLI never opens RocksDB directly. Keeps the daemon as the single source of truth and works with remote stores.
• JsonEnvelope output — ok / error / context_ok constructors with TTY detection via IsTerminal. Scripted callers get parseable JSON; humans get prose.
• New crate — crates/memory-cli/ (binary name memory) added to the workspace alongside memory-daemon. Each binary stays focused.
• Recall as alias — rather than a separate flag, recall is an explicit subcommand that maps to search --rerank=llm. Discoverable in --help.

Files added

• crates/memory-cli/ — new binary crate (12 files, ~1500 LOC)
  • cli.rs — clap derive Parser/Subcommand
  • client.rs — gRPC client helper
  • output.rs — JsonEnvelope and TTY detection
  • commands/{add,context,recall,search,summary,timeline}.rs — one file per subcommand
• .planning/phases/52-simple-cli-api/ — 3 plans + 3 summaries + context/research/validation/verification

Touched: crates/memory-client/src/lib.rs (added a couple of helpers used by the CLI).

Tests

• All workspace tests pass (task test): 54 test result blocks, 0 failures
• Clippy clean (task clippy): zero warnings on --workspace --all-targets --all-features -- -D warnings
• Docs clean (task doc): zero rustdoc warnings under RUSTDOCFLAGS=-D warnings
• task fmt passes

Rebase notes (2026-05-12)

Rebased from gsd/phase-52-simple-cli-api (local stack, 36 commits ahead of an old main) onto post-Phase-51 origin/main. Used git rebase --onto to drop the Phase 51 commits already absorbed via PR #28. The 15 commits in this PR are Phase 52's own work plus a final clean planning-doc update.

Next in v3.0

Phase 53 (Benchmark Suite) is the remaining v3.0 work — stacked on this branch locally at gsd/phase-53-benchmark-suite. PR #25 (cross-project federation, Phase 53.5) is also open.