# Quirk Coverage

The catalog should not imply that every Helm behavior is fully understood. The
quirk coverage audit records which behaviors are tracked, which are only visible
in source scans, and which are known blind spots.

The generated audit is the current source of truth:

| File | Use it for |
| --- | --- |
| [data/quirk-coverage/summary.md](../../data/quirk-coverage/summary.md) | Human-readable coverage summary by quirk axis. |
| [data/quirk-coverage/coverage.csv](../../data/quirk-coverage/coverage.csv) | Spreadsheet-friendly coverage table. |

Each row has a coverage tier:

| Tier | Meaning |
| --- | --- |
| `tracked-and-surfaced` | The behavior appears in generated chart/user data and has recipe or receipt evidence. |
| `tracked-by-lock-not-front-door` | The behavior is recorded in locks or artifacts, but is not yet promoted into front-door tables. |
| `partly-tracked` | The behavior is visible, but one or more lifecycle or per-chart proof pieces is still missing. |
| `disclosed-not-complete` | The behavior is disclosed and gated, but not fully modeled or live-proven. |
| `source-scanned-not-surfaced` | The behavior is detected in source scans, but not promoted to chart facts or outcome tables. |
| `not-scanned` | The behavior is a known blind spot in the current scanner or data model. |

Each row also separates source inventory from modeled support:

| Column | Meaning |
| --- | --- |
| `source_top100_count` | Public top-100 source-scan rows where the quirk was detected. |
| `modeled_or_supported_count` | Current chart facts, recipes, receipts, or maintained work queues that model the quirk. The basis varies by axis and is described in the row. |
| `source_top500_count` | Public top-500 source-scan rows where the quirk was detected. |

Do not read `modeled_or_supported_count` as the number of affected public
charts. Do not read `source_top100_count` as proof that the quirk is supported.

Use the audit when adding chart facts, pain reports, variant paths, hook
lifecycle routes, and top-100/top-500 analysis. A chart can still be usable when
one of its axes is incomplete, but the incomplete axis should stay visible.

The generated summary also carries the current high-value counts for
NGINX-like extension slots. These distinguish explicit catalog control points
from broader source-scan signals such as raw `tpl` usage.

For the chart-level extension-slot list, use
[Extension Slot Coverage](../../data/extension-slots/summary.md).

Regenerate and check the audit:

```sh
npm run quirk-coverage
npm run quirk-coverage:verify
```