ArchPilotExecutable architecture guardrails

Search docs

Docs search

Validation rule

Back to Rule Catalog
AP-SUP-005Documentation

Suppression expiry format invalid

Checks that suppression expiry dates use a valid format.

warningsetup-gapNo auto-fix

How to fix

  1. Use a clear ISO-style date.
  2. Remove prose from the expiry field.
  3. Run validation to confirm the expiry is recognized.

What the rule validates

A suppression expiry value cannot be parsed reliably.

Why it matters

Invalid expiry dates prevent ArchPilot from enforcing time-bound suppressions.

Common causes

  • The date uses a local shorthand format.
  • The expiry field contains prose.
  • A timezone or separator typo was introduced.

Typical violation example

"expiresAt": "next Friday"

Typical compliant example

"expiresAt": "2026-06-30"

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-005 - Suppression expiry format invalid | ArchPilot Docs