Skip to content

Commit fe4209f

Browse files
committed
docs: fan-in caveat + fix audit-verdict roadmap anchors
Glossary § fan-in now points at C.9 closed-dead-subgraph caveat. audit-delta-attribution plan links audit verdict to Core substrate section (not Recipe & audit enrichment).
1 parent 684ce51 commit fe4209f

2 files changed

Lines changed: 3 additions & 3 deletions

File tree

docs/glossary.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -237,7 +237,7 @@ TS shape for one row of the `exports` table.
237237

238238
### fan-in
239239

240-
Number of edges _into_ a file in the `dependencies` table — `COUNT(*) FROM dependencies WHERE to_path = ?`. Surfaces as the `fan-in` recipe (top files by inbound edges, i.e. **hubs**).
240+
Number of edges _into_ a file in the `dependencies` table — `COUNT(*) FROM dependencies WHERE to_path = ?`. Surfaces as the `fan-in` recipe (top files by inbound edges, i.e. **hubs**). **Hotspot ranker only** — not an orphan/dead-code detector; N-file packs with sibling imports can all have non-zero fan-in yet be unreachable from a real entry point ([`plans/c9-plugin-layer.md`](./plans/c9-plugin-layer.md) closed-dead-subgraph caveat).
241241

242242
### fan-out
243243

docs/plans/audit-delta-attribution.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ Baseline-prefix audits without ref-scoped key store; audit verdict + thresholds;
5151
| A.2 | **Stable finding keys.** Each auditable row maps to a deterministic string key from its delta's `requiredColumns` (canonical column order, joined with `\0` or stable JSON). Same key at base SHA and at HEAD. | Existing `AuditDeltaSpec.requiredColumns` |
5252
| A.3 | **Reuse audit-cache infrastructure.** Base-side keys come from the sha-keyed extract under `.codemap/audit-cache/<sha>/` (already populated by `git archive` + reindex). Cache key snapshots alongside or derived from the cached index. | [architecture § audit-worktree](../architecture.md) |
5353
| A.4 | **`--base` path only for v1 attribution.** Baseline-prefix audits (`source: "baseline"`) keep today's flat `added`/`removed` shape unless a follow-up adds historical key stores in `query_baselines`. | Tracer bullet — ship ref-scoped first |
54-
| A.5 | **Composable CI.** Consumers filter `added` where `attribution === "introduced"` via SQL/`jq`; complements deferred [audit verdict + thresholds](../roadmap.md#recipe--audit-enrichment). | Roadmap trigger-gated verdict item |
54+
| A.5 | **Composable CI.** Consumers filter `added` where `attribution === "introduced"` via SQL/`jq`; complements deferred [audit verdict + thresholds](../roadmap.md#core-substrate--platform). | Roadmap trigger-gated verdict item |
5555

5656
---
5757

@@ -123,4 +123,4 @@ MCP/HTTP: same envelope via `tool-handlers` audit handler — spot-check JSON sh
123123
## Dependencies
124124

125125
- Shipped: `audit-worktree.ts`, `runAuditFromRef`, v1 delta registry (`files`, `dependencies`, `deprecated`)
126-
- Independent of [audit verdict + thresholds](../roadmap.md#recipe--audit-enrichment) (trigger-gated)
126+
- Independent of [audit verdict + thresholds](../roadmap.md#core-substrate--platform) (trigger-gated)

0 commit comments

Comments
 (0)