ArchPilotExecutable architecture guardrails

Search docs

Docs search

Validation rule

Back to Rule Catalog
AP-SUP-003Documentation

Suppression does not match any active finding

Reports suppression entries that no longer match an active finding.

infoguidanceNo auto-fix

How to fix

  1. Remove unused suppression entries.
  2. Refresh suppressions only for findings that are still active.
  3. Run validation again to confirm no stale entries remain.

What the rule validates

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.

Typical violation example

A suppression stays in the file after the matching AP-DEP-004 finding is gone.

Typical compliant example

The suppression file only contains entries that match current approved findings.

Related rules

AP-ADR-001 - ADR directory missingAP-ADR-002 - ADR file missing titleAP-ADR-003 - ADR status missing or invalidAP-ADR-004 - Required ADR missing for architecture context

Adjacent categories

Documentation Rules

Related files/config

  • .archpilot/suppressions.json
  • .archpilot/exceptions.json

Related CLI commands

  • archpilot validate
  • archpilot validate --ci

Related docs

Rule CatalogQuick Fixes, Exceptions & Suppressions
AP-SUP-003 - Suppression does not match any active finding | ArchPilot Docs