Search docs
Docs searchValidation rule
Back to Rule CatalogAP-SUP-003DocumentationSuppression does not match any active finding
Reports suppression entries that no longer match an active finding.
infoguidanceNo auto-fix
How to fix
- Remove unused suppression entries.
- Refresh suppressions only for findings that are still active.
- Run validation again to confirm no stale entries remain.
What it means
A suppression entry remains after the finding it targeted disappeared or changed fingerprint.
Why it matters
Unused suppressions create configuration clutter and can confuse future reviews.
Common causes
- The finding was fixed.
- The file path or fingerprint changed.
- A broad suppression was copied forward unnecessarily.
Example bad pattern
A suppression stays in the file after the matching AP-DEP-004 finding is gone.Example good pattern
The suppression file only contains entries that match current approved findings.Related files/config
.archpilot/suppressions.json.archpilot/exceptions.json
Related CLI commands
archpilot validatearchpilot validate --ci