Overview

🚀Scan Path Headers

Preview First

Discover supported files, validate their path headers, and apply corrections only when explicitly requested.

Commandpath-header-scanner scan

📦Category

Header Scanning

🚀Quick Command

path-header-scanner scan [TARGET_DIRECTORY] [OPTIONS]

---

validationpreviewlanguage-aware headers

---

📁

Default Target

app

✅

Default Effect

Preview only

⚠️

Write Opt-in

--apply

🛡️

Simulation Override

--dry-run

Overview

The command resolves the target, discovers files with supported extensions, selects a language strategy, and compares each existing header with its expected project-relative path. The optional target defaults to the configured target_directory, which is app in the generated configuration.

⚠️Preview is the default

scan does not write target files unless effective apply mode is enabled. --dry-run overrides both --apply and apply = true from configuration.

Result states

• Valid: the existing header already matches.
• Inserted: a missing header would be inserted, or was inserted in apply mode.
• Updated: a stale header would be replaced, or was replaced in apply mode.
• Failed: the file could not be processed safely.