All commands · quality
pm ops validate
Validate metadata, lifecycle policies, files, command references, and history.
Runs standalone metadata, resolution, lifecycle (including dependency-cycle diagnostics), linked-file, linked-command reference, and history drift checks with default remediation hints for resolution gaps.
Usage
pm ops validate [options]Options
| --check-metadata | Run metadata completeness checks | optional |
|---|---|---|
| --metadata-profile <value> | Metadata profile (core|strict|custom) | optional |
| --check-resolution | Run closed-item resolution metadata checks | optional |
| --check-completeness | Check declarative lifecycle field requirements | optional |
| --check-lifecycle | Run active-item lifecycle governance drift checks | optional |
| --check-stale-blockers | Include stale blocker-pattern diagnostics in lifecycle checks | optional |
| --dependency-cycle-severity <value> | Set dependency-cycle warning policy for lifecycle checks (off|warn|error) | optional |
| --parent-cycle-severity <value> | Set parent-hierarchy cycle warning policy for lifecycle checks (off|warn|error) | optional |
| --check-files | Run linked-file and orphaned-file checks | optional |
| --check-command-references | Run linked-command PM-ID reference checks | optional |
| --scan-mode <value> | Select file candidate scan mode for --check-files (default|tracked-all|tracked-all-strict) | optional |
| --include-pm-internals | Include PM storage internals in tracked-all candidate scans | optional |
| --verbose-file-lists | Include full file-path lists for validate --check-files details | optional |
| --verbose-diagnostics | Include full diagnostic ID lists | optional |
| --all-affected-ids | Emit complete missing_* affected-ID lists with no truncation (implied by --json) | optional |
| --strict-exit | Return non-zero exit when validation warnings are present | optional |
| --fix-hints | Add a machine-executable fix_hints[] of pm commands to each failing check's details | optional |
| --auto-fix | Apply safe, deterministic field backfills | optional |
| --dry-run | Preview planned --auto-fix/--prune-missing fixes without applying them | optional |
| --fix-scope <scope> | Grant --auto-fix scopes (metadata, resolution, estimates, timestamps, lifecycle; comma-separated or repeatable). Default: metadata, resolution; other scopes require explicit opt-in | optional |
| --prune-missing | Remove deleted-path file/doc links; preserves real files | optional |
| --check-history-drift | Run item/history hash drift checks | optional |
| --check-storage-integrity | Run the post-merge storage-integrity check (unreadable items, history conflict markers, resurrected deletes, unparseable config/schema) | optional |
| --counts | Keep validation counts and totals while omitting per-item diagnostic arrays | optional |
| --full | Return the complete validation diagnostic projection | optional |
Examples
pm ops validate