docs: add comprehensive command surface analysis
Deep analysis of the full `lore` CLI command surface (34 commands across
6 categories) covering command inventory, data flow, overlap analysis,
and optimization proposals.
Document structure:
- Main consolidated doc: docs/command-surface-analysis.md (1251 lines)
- Split sections in docs/command-surface-analysis/ for navigation:
00-overview.md - Summary, inventory, priorities
01-entity-commands.md - issues, mrs, notes, search, count
02-intelligence-commands.md - who, timeline, me, file-history, trace, related, drift
03-pipeline-and-infra.md - sync, ingest, generate-docs, embed, diagnostics
04-data-flow.md - Shared data source map, command network graph
05-overlap-analysis.md - Quantified overlap percentages for every command pair
06-agent-workflows.md - Common agent flows, round-trip costs, token profiles
07-consolidation-proposals.md - 5 proposals to reduce 34 commands to 29
08-robot-optimization-proposals.md - 6 proposals for --include, --batch, --depth
09-appendices.md - Robot output envelope, field presets, exit codes
Key findings:
- High overlap pairs: who-workload/me (~85%), health/doctor (~90%)
- 5 consolidation proposals to reduce command count by 15%
- 6 robot-mode optimization proposals targeting agent round-trip reduction
- Full DB table mapping and data flow documentation
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
3f38b3fda7