Consolidate docs and record multi-operation query reuse

[JeremyKuhne]

Summary

• Make docs/roadmap.md the one primary work queue, retaining only concrete triggers, open issues, and a short decision/evidence index.
• Move future-relevant agent, capture, cache, performance, and dependency lessons into docs/design.md; remove six redundant historical pages and speculative LP/TE queues.
• Preserve necessary operational guides, replace the long local-testing history with current activation/recovery instructions, and repair directly affected links.
• Record the shared-store info + rank CLI measurements, the no-store control, and multi-operation design choices. Explain that MCP already reuses one server-lifetime TraceStore, and that extra CLI grammar must improve complete agent outcomes rather than just process timing.

This is documentation-only. No CLI command, MCP tool, product behavior, raw trace, or publishing contract changes.

Validation

• Complete Release suite via tools/Test-WindowsDotNet.ps1: 1,930 passed, one expected elevated-host skip.
• CLI help, MCP server/schema, documentation drift, deterministic eval, and pinned-agent-skill/reference contracts.
• Relative Markdown links and whitespace checks.
• Bounded read-only self-review; corrected the recovery wording to distinguish the Filtrace MCP entry from unrelated MCP configuration.

The first local test/eval attempts found old unmarked ETLX caches beside test fixtures and generated test-output copies. Those caches were explicitly cleaned with the local CLI before the gates were rerun; no raw fixtures or product code were changed. The current deterministic task count was also corrected to 31.

Review scope

Lite review requested: obvious factual mistakes, broken references, and incorrect operational/recovery guidance. Do not expand this into new feature design or revive the removed investigation queues.

[Copilot]

Copilot review overview

🟡 Changes recommended

The recovery guide omits source-preparation quarantine handling and misstates restoration when no prior MCP entry existed.

Review effort: Balanced
Findings: 1

Open (1)

• Restore the captured absence of the filtrace entry · New

What changed in this PR

Consolidates planning and historical documentation into a single roadmap, durable design guidance, and focused operational guides.

Changes:

• Replaces historical planning pages with concise roadmap/design records.
• Adds multi-operation reuse measurements and current local-testing recovery guidance.
• Repairs documentation links and preserves relevant operational boundaries.

File	Description
README.md	Links to local recovery guidance.
benchmarks/​README.md	Redirects measurement guidance to design docs.
docs/​README.md	Updates the documentation index.
docs/​competitive-analysis.md	Removes the historical comparison page.
docs/​design.md	Consolidates durable findings and current gates.
docs/​filtrace-etl-trimming.md	Clarifies that physical trimming is unscheduled.
docs/​local-testing-redesign.md	Removes the completed redesign history.
docs/​local-testing.md	Adds current activation and recovery guidance.
docs/​multi-operation-query-reuse.md	Records reuse measurements and interface options.
docs/​parallelism-opportunities.md	Removes the closed Track D plan.
docs/​primary-plan-closeout.md	Removes the superseded closeout record.
docs/​roadmap.md	Replaces historical queues with concrete triggers.
docs/​source-build.md	Points retained evidence to consolidated design guidance.
docs/​stack-traversal-experiment.md	Removes the completed experiment report.
docs/​traceevent-surface-assessment.md	Removes the superseded dependency inventory.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.