aped-purge

What problem does it solve?

APED projects can accumulate stale, unknown, or orphaned documentation under the output directory, making it hard to keep a clean canon and a reliable entry-point index.

Core Features & Use Cases

• Doc hygiene audit + classification: Walks {{OUTPUT_DIR}}/** and classifies each entry as canonical, archived, allowlisted, or unknown.
• Always-on index regeneration: Rewrites {{OUTPUT_DIR}}/INDEX.md from the current filesystem state so downstream tooling and future runs stay accurate.
• Interactive unknown triage with safety rails: Surfaces unknown files with a per-file menu that supports archiving, inlining into canonical artefacts, allowlisting, deleting (typed confirmation), or skipping—read-only by default.

Quick Start

Run aped-purge to audit docs/aped, regenerate INDEX.md, and interactively resolve any unknown or orphaned documentation.