Dead artifacts checkpoints
Presets, tokens and patterns that nothing uses, that are deprecated but still used, or that have not been touched in a long time.
Each checkpoint reports pass, warning, fail or skipped. A finding for a checkpoint links its section on this page.
Unused presets
No unreferenced presets
dead_artifacts.unused_presets.zero_refs
Presets with no references in the codebase usage data. Presets referenced only by themselves are counted by the self-reference checkpoint instead.
| Result | When |
|---|---|
| Pass | Every preset has a reference. |
| Warning | Some do not, up to 30%. |
| Fail | More than 30% have no references. |
| Skipped | No presets were provided, or no codebase usage data was provided. |
How to improve. Remove or archive presets that are no longer needed.
No self-referencing presets
dead_artifacts.unused_presets.self_ref_only
Presets whose only references come from themselves, which makes them effectively unused.
| Result | When |
|---|---|
| Pass | No such presets. |
| Warning | Any such preset. |
| Fail | Not reported by this checkpoint. |
| Skipped | No presets were provided, or no codebase usage data was provided. |
How to improve. Remove those presets, or merge them into ones that are used.
Reference ratio for presets
dead_artifacts.unused_presets.reference_ratio
The share of presets with at least one reference, not counting self references.
| Result | When |
|---|---|
| Pass | At least 90%. |
| Warning | Between 70% and 90%. |
| Fail | Below 70%. |
| Skipped | No presets were provided, or no codebase usage data was provided. |
How to improve. Review unreferenced presets and archive the ones nobody uses.
Orphaned tokens
Tokens used by presets
dead_artifacts.orphaned_tokens.no_preset_ref
Tokens that no preset references, according to the codebase usage data.
| Result | When |
|---|---|
| Pass | Every token is referenced by a preset. |
| Warning | Some are not, up to 30%. |
| Fail | More than 30% are not. |
| Skipped | No tokens or no presets were provided, or no codebase usage data was provided. |
How to improve. Remove tokens that no preset uses. Only references from presets count here, so a token used directly in code still counts as unreferenced; the codebase checkpoint measures direct use.
Tokens used in the codebase
dead_artifacts.orphaned_tokens.no_codebase_ref
Tokens with no reference anywhere in the codebase usage data.
| Result | When |
|---|---|
| Pass | Every token has a reference. |
| Warning | Some do not, up to 30%. |
| Fail | More than 30% have none. |
| Skipped | No tokens were provided, or no codebase usage data was provided. |
How to improve. Remove tokens with no references, after confirming the scan covered the whole codebase.
Token utilization ratio
dead_artifacts.orphaned_tokens.utilization_ratio
The share of tokens with at least one reference. in the codebase usage data.
| Result | When |
|---|---|
| Pass | At least 90%. |
| Warning | Between 70% and 90%. |
| Fail | Below 70%. |
| Skipped | No tokens were provided, or no codebase usage data was provided. |
How to improve. Remove orphaned tokens so the system is simpler to use.
Superseded
Deprecated artifacts out of use
dead_artifacts.superseded.deprecated_active
Deprecated presets, tokens and patterns that are still referenced.
| Result | When |
|---|---|
| Pass | None is still referenced, or nothing is deprecated. |
| Warning | Some are still referenced. |
| Fail | Not reported by this checkpoint. |
| Skipped | Something is deprecated, but no codebase usage data was provided. |
How to improve. Move those references to the replacements.
Superseded artifacts marked deprecated
dead_artifacts.superseded.deprecation_notices
Artifacts that name a replacement (replacedBy) but are not marked deprecated.
| Result | When |
|---|---|
| Pass | None. |
| Warning | Any. |
| Fail | Not reported by this checkpoint. |
| Skipped | Not reported by this checkpoint. |
How to improve. Mark each superseded artifact as deprecated so consumers know to move off it.
Deprecated artifacts have replacements
dead_artifacts.superseded.replacements_exist
Deprecated artifacts with no replacedBy, or whose replacedBy names an artifact that does not exist.
| Result | When |
|---|---|
| Pass | Every deprecated artifact has a valid replacement, or nothing is deprecated. |
| Warning | Some do not. |
| Fail | Not reported by this checkpoint. |
| Skipped | Not reported by this checkpoint. |
How to improve. Give each deprecated artifact a replacement that exists.
Staleness
No stale, unreferenced artifacts
dead_artifacts.staleness.old_unreferenced
Artifacts not updated for longer than the staleness threshold (90 days by default, set with stalenessThresholdDays) that also have no references.
| Result | When |
|---|---|
| Pass | None. |
| Warning | Some, up to 20% of artifacts with an update date. |
| Fail | More than 20%. |
| Skipped | No artifacts were provided, none has an updatedAt date, or no codebase usage data was provided. |
How to improve. Review those artifacts and remove the ones nobody needs.
Freshness score
dead_artifacts.staleness.freshness_score
How recently artifacts were updated. Each artifact with an update date scores 100 if updated within 30 days, 75 within the staleness threshold, 40 within twice the threshold and 10 beyond that. The result is the average.
| Result | When |
|---|---|
| Pass | A score of 70 or more. |
| Warning | Between 50 and 70. |
| Fail | Below 50. |
| Skipped | No artifacts were provided, or none has an updatedAt date. |
How to improve. Review stale artifacts regularly: update the ones in use and remove the rest.