doc-analysis-dead-code

Packet · {{ repo }} · analysis/dead-code.md

1. Objective

Produce {{ docs_root }}/analysis/dead-code.md: three tables enumerating unreferenced exports, unreferenced files, and dead imports in {{ repo }}. The file is always emitted — when the graph reports no dead code, emit a No unreferenced symbols detected. banner plus a timestamp so Phase E cross-references have a stable target.

2. Scope

• Create: {{ docs_root }}/analysis/dead-code.md
• Do not touch: {{ docs_root }}/analysis/risk-hotspots.md, {{ docs_root }}/analysis/ownership.md, any other file under {{ docs_root }}/, any source file in the repo, .context.md, .prefetch.md, or any .packets/*.md other than this one.

3. Input specification

Source	Read how	Cache state
Shared context	Read {{ context_path }}	always first
Prefetch ledger	Read {{ prefetch_path }}	always first
Dead-code inventory	mcp__codehub__list_dead_code({repo: "{{ repo }}"})	mid-run (rarely cached; the tool is cheap)
Last-modified per path	from list_dead_code response fields when present, else git log -1 --format=%cs -- <path> via shell	mid-run
Graph hash	{{ graph_hash }} for the empty-state banner timestamp anchor	cached

4. Process

1. Read {{ context_path }} and Read {{ prefetch_path }}. Confirm graph hash and any cached dead-code digest.
2. Call mcp__codehub__list_dead_code({repo: "{{ repo }}"}). Partition the response into three buckets: Unreferenced exports, Unreferenced files, Dead imports.
3. If all three buckets are empty: skip to step 7 (empty-state banner).
4. For Unreferenced exports: draft a table with columns Symbol | Path | Last modified. Path is a backtick path:LOC. Last modified is an ISO date.
5. For Unreferenced files: draft a table with columns File | Lines | Last modified. File is a backtick path. Lines is an integer LOC count.
6. For Dead imports: draft a table with columns Path | Symbol | Imported from. Path is a backtick path:LOC at the import site; Imported from is a backtick path (module/package).
7. Empty-state handling: if list_dead_code returns no rows in any bucket, emit the banner No unreferenced symbols detected. on its own line, followed by Graph hash: {{ graph_hash }} and a UTC timestamp line. Still emit the three H2 headings (## Unreferenced exports, ## Unreferenced files, ## Dead imports) each with a single _none_ line under them, so Phase E cross-references resolve.
8. Write {{ docs_root }}/analysis/dead-code.md with H1 = {{ repo }} · Dead code.