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