plan-validator

> **AI-consumed reference.** Optimized for Claude to read during execution. > Human-readable explanation: see [docs/architecture/HIERARCHICAL_PLANNING.md](../../../docs/architecture/HIERARCHICAL_PLANNING.md) > or [docs/getting-started/](../../../docs/getting-started/) depending on topic. # Plan Validator **STATUS — v3.7.0-alpha.2.** Thin wrapper over `aura-frog/scripts/plans/validate-plan-tree.sh`. ## Behavior 1. Detect: if `.claude/plans/` does NOT exist → exit silently 2. Run `bash aura-frog/scripts/plans/validate-plan-tree.sh` 3. If exit_code === 0 → silent (or one-line success when `verbose: true`) 4. If exit_code !== 0 → surface the failing invariant(s) and refuse the calling operation ## The 8 invariants (spec §6.7) | # | Invariant | Failure mode | |---|-----------|--------------| | 1 | parent existence | Every node's `parent` field points to an existing node (or `MISSION` for T1) | | 2 | children integrity | Every `children: [...]` entry exists as a node file | | 3 | no orphans | Every non-MISSION node is referenced by exactly one parent | | 4 | valid status | `status` ∈ {planned, active, done, blocked, frozen, discarded, archived} | | 5 | monotonic revision | `revision` only increases; never decreases or skips | | 6 | test_ref existence | When `test_ref:` set, the referenced test file exists | | 7 | DAG no-cycles | `depends_on:` does not introduce cycles when traversed | | 8 | freeze_reason | `status: frozen` requires `freeze_reason:` and `frozen_at:` fields | ...