Summary

Phase 6 of graph memory (#1222): user-facing features — init wizard, CLI flag, TUI commands, metrics, documentation.

Depends on: #1228 (communities)

Tasks

1. Init Wizard (--init)

Add to interactive configuration wizard:

• "Enable knowledge graph memory? (experimental) [y/N]" → sets [memory.graph] enabled
• "LLM model for entity extraction (empty = agent model):" → sets extract_model

2. CLI Argument

Add --graph-memory flag to root CLI (clap):

#[arg(long)]
graph_memory: bool,

When set, overrides config.memory.graph.enabled = true.

3. TUI Commands

4. Metrics

Add to MetricsSnapshot (cfg-gated):

• graph_entities_total: u64
• graph_edges_total: u64
• graph_communities_total: u64
• graph_extraction_count: u64
• graph_extraction_failures: u64

Updated via existing watch channel pattern.

5. Documentation

• Create docs/src/concepts/graph-memory.md: what, why, how to enable, how extraction works, cost, backfill, troubleshooting
• Update docs/src/concepts/memory.md: add "Graph Memory" section
• Update docs/src/SUMMARY.md: add graph-memory page
• Update CHANGELOG.md: document feature under [Unreleased]

6. README Updates

Update root README.md and crates/zeph-memory/README.md via /readme-generator skill.

Architecture Reference

See .local/plan/graph-memory-architecture.md Section 8 for wizard flow, TUI commands, and metrics fields.

Acceptance Criteria

• Init wizard includes graph memory question
• --graph-memory CLI flag enables graph memory
• /graph shows entity, edge, community counts
• /graph entities lists entities with pagination
• /graph facts <name> shows edges for specific entity
• /graph backfill processes existing messages with progress
• Metrics visible in TUI dashboard
• Documentation complete and linked from SUMMARY.md
• CHANGELOG.md updated
• ~9 tests (7 unit + 2 integration)