@windyroad/itil 0.61.1 → 0.61.2

package/scripts/test/reconcile-readme.bats

@@ -1,1007 +0,0 @@
-#!/usr/bin/env bats
-
-# @problem P118 — docs/problems/README.md drifts from filesystem truth
-# across sessions despite P094 (refresh-on-create) and P062 (refresh-on-
-# transition) both being Closed. This script is the cross-session
-# robustness layer ON TOP of those per-operation contracts.
-#
-# Contract: `reconcile-readme.sh [<problems-dir>]` is a diagnose-only
-# mechanical drift detector. It reads `<problems-dir>/<NNN>-*.<status>.md`
-# files (default `docs/problems`), parses the WSJF Rankings + Verification
-# Queue + Closed tables in `<problems-dir>/README.md`, and reports each
-# disagreement between README claim and filesystem ground truth.
-#
-# Exit codes:
-#   0 = clean (README matches filesystem for every parsed row)
-#   1 = drift detected (structured diff to stdout, one row per drift)
-#   2 = parse error (README missing or malformed beyond recovery)
-#
-# Diff output budget per ADR-038 progressive disclosure: each diff row
-# ≤ 150 bytes; output is consumed by Claude in agent context, so it
-# must stay terse and machine-readable, not narrative.
-#
-# The script is read-only — it does NOT mutate the README. Narrative
-# content (the long "Last reviewed" prose paragraph, the Closed-section
-# closure-via free text) is preserved by the agent-applied-edits pattern
-# in the `/wr-itil:reconcile-readme` skill which wraps this script.
-#
-# @jtbd JTBD-006 (Progress the Backlog While I'm Away — orchestrators
-# read the README to pick the highest-WSJF actionable ticket; drift
-# burns iterations on already-transitioned tickets)
-# @jtbd JTBD-001 (Enforce Governance Without Slowing Down — read-only
-# diagnostic, no interactive friction on the happy path)
-#
-# Cross-reference:
-#   P118: docs/problems/118-readme-drifts-from-filesystem-truth-despite-refresh-contracts-closed.open.md
-#   ADR-014 amended (Reconciliation as preflight robustness layer)
-#   ADR-022 — Verification Pending lifecycle status conventions
-#   ADR-038 — Progressive disclosure (per-row byte budget on diff output)
-#   ADR-005 — Plugin testing strategy (script-level bats governance)
-
-setup() {
-  SCRIPTS_DIR="$(cd "$(dirname "$BATS_TEST_FILENAME")/.." && pwd)"
-  SCRIPT="$SCRIPTS_DIR/reconcile-readme.sh"
-  FIXTURE_DIR="$(mktemp -d)"
-}
-
-teardown() {
-  rm -rf "$FIXTURE_DIR"
-}
-
-# ── Existence + executable ──────────────────────────────────────────────────
-
-@test "reconcile-readme: script exists" {
-  [ -f "$SCRIPT" ]
-}
-
-@test "reconcile-readme: script is executable" {
-  [ -x "$SCRIPT" ]
-}
-
-# ── Exit code 0: clean state ─────────────────────────────────────────────────
-
-@test "reconcile-readme: exit 0 when WSJF Rankings matches filesystem .open.md set" {
-  cat > "$FIXTURE_DIR/100-foo.open.md" <<EOF
-# Problem 100: Foo
-**Status**: Open
-**WSJF**: 5.0
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-# Problem Backlog
-
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-| 5.0 | P100 | Foo | 12 High | Open | M |
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 0 ]
-}
-
-# ── Exit code 1: drift cases ─────────────────────────────────────────────────
-
-@test "reconcile-readme: exit 1 when README ranks ticket Open but file is .closed.md (P074 case)" {
-  # The exact symptom this ticket addresses: a prior session closed the
-  # ticket without staging the README refresh, leaving the WSJF Rankings
-  # row stale in subsequent sessions.
-  cat > "$FIXTURE_DIR/074-foo.closed.md" <<EOF
-# Problem 074: Foo
-**Status**: Closed
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-# Problem Backlog
-
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-| 6.0 | P074 | Foo | 12 High | Open | M |
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 1 ]
-  # Output mentions P074 as the drift entry.
-  echo "$output" | grep -q "P074"
-}
-
-@test "reconcile-readme: exit 1 when ticket on disk as .open.md is missing from WSJF Rankings" {
-  # The other half of the drift class: a ticket created in a prior
-  # session that never refreshed README — the file exists but the
-  # row was never inserted.
-  cat > "$FIXTURE_DIR/079-bar.open.md" <<EOF
-# Problem 079: Bar
-**Status**: Open
-**WSJF**: 3.0
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-# Problem Backlog
-
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 1 ]
-  echo "$output" | grep -q "P079"
-}
-
-@test "reconcile-readme: exit 1 when README ranks ticket Open but file is .verifying.md (P110 case)" {
-  cat > "$FIXTURE_DIR/110-baz.verifying.md" <<EOF
-# Problem 110: Baz
-**Status**: Verification Pending
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-# Problem Backlog
-
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-| 4.0 | P110 | Baz | 8 Med | Open | M |
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 1 ]
-  echo "$output" | grep -q "P110"
-}
-
-@test "reconcile-readme: exit 1 when Verification Queue lists ticket but file is .closed.md (stale VQ)" {
-  cat > "$FIXTURE_DIR/056-qux.closed.md" <<EOF
-# Problem 056: Qux
-**Status**: Closed
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-# Problem Backlog
-
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-| P056 | Qux | 2026-01-01 | yes |
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 1 ]
-  echo "$output" | grep -q "P056"
-}
-
-# ── Diff output is structured + within byte budget (ADR-038) ────────────────
-
-@test "reconcile-readme: drift output emits one structured line per drift entry" {
-  # Two distinct drift entries; output should contain at least two
-  # rows (one per ID).
-  cat > "$FIXTURE_DIR/074-foo.closed.md" <<EOF
-**Status**: Closed
-EOF
-  cat > "$FIXTURE_DIR/079-bar.open.md" <<EOF
-**WSJF**: 3.0
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-| 6.0 | P074 | Foo | 12 High | Open | M |
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 1 ]
-  # Both drift IDs surface in output.
-  echo "$output" | grep -q "P074"
-  echo "$output" | grep -q "P079"
-}
-
-@test "reconcile-readme: each diff row stays under 150 bytes (ADR-038 progressive-disclosure budget)" {
-  cat > "$FIXTURE_DIR/074-foo.closed.md" <<EOF
-**Status**: Closed
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-| 6.0 | P074 | Foo | 12 High | Open | M |
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 1 ]
-  # Filter to data rows only (drift entries start with a marker char).
-  while IFS= read -r line; do
-    # Skip empty lines + the header line.
-    [ -z "$line" ] && continue
-    case "$line" in
-      DRIFT*|MISSING*|STALE*|MISMATCH*)
-        len=${#line}
-        [ "$len" -le 150 ] || {
-          echo "Diff row over 150 bytes ($len): $line" >&2
-          return 1
-        }
-        ;;
-    esac
-  done <<< "$output"
-}
-
-# ── Exit code 2: parse error ────────────────────────────────────────────────
-
-@test "reconcile-readme: exit 2 when README is missing" {
-  cat > "$FIXTURE_DIR/100-foo.open.md" <<EOF
-**WSJF**: 5.0
-EOF
-  # No README.md created.
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 2 ]
-}
-
-@test "reconcile-readme: exit 2 when README has no WSJF Rankings header (parse error)" {
-  cat > "$FIXTURE_DIR/100-foo.open.md" <<EOF
-**WSJF**: 5.0
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-# Problem Backlog
-
-This README has no WSJF Rankings section header.
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 2 ]
-}
-
-# ── Verification Pending tickets must NOT appear in WSJF Rankings (ADR-022) ─
-
-@test "reconcile-readme: .verifying.md tickets in WSJF Rankings are flagged as drift" {
-  # ADR-022 — Verification Pending tickets are excluded from WSJF Rankings
-  # (they belong in the Verification Queue section). A .verifying.md row
-  # in the dev-work table is drift.
-  cat > "$FIXTURE_DIR/105-verify.verifying.md" <<EOF
-**Status**: Verification Pending
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-| 8.0 | P105 | Verify | 12 High | Open | M |
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 1 ]
-  echo "$output" | grep -q "P105"
-}
-
-# ── Default problems-dir resolution ─────────────────────────────────────────
-
-@test "reconcile-readme: defaults to ./docs/problems when no arg passed" {
-  # cd into a fixture root that has docs/problems/README.md to confirm
-  # the default-arg branch executes.
-  mkdir -p "$FIXTURE_DIR/docs/problems"
-  cat > "$FIXTURE_DIR/docs/problems/README.md" <<'EOF'
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  cd "$FIXTURE_DIR"
-  run "$SCRIPT"
-  [ "$status" -eq 0 ]
-}
-
-# ── Parked tickets are excluded (ADR-022 multiplier 0 + own section) ────────
-
-@test "reconcile-readme: .parked.md tickets are not flagged as missing from WSJF Rankings" {
-  # Parked tickets live in their own section; they are NOT expected in
-  # WSJF Rankings. A .parked.md file with no WSJF Rankings row is
-  # correct, not drift.
-  cat > "$FIXTURE_DIR/005-parked.parked.md" <<EOF
-**Status**: Parked
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-
-## Parked
-
-| ID | Title | Reason | Parked since |
-|----|-------|--------|-------------|
-| P005 | Parked | Upstream | 2026-04-16 |
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 0 ]
-}
-
-# ── Closed tickets never tracked (P001-P028 don't all appear) ───────────────
-
-@test "reconcile-readme: .closed.md tickets absent from Closed section are not drift (history is partial)" {
-  # The Closed section is curated narrative — it lists "recently closed
-  # this session" with closure-via prose. It is NOT exhaustive over
-  # every .closed.md file. A .closed.md file absent from the Closed
-  # section is allowed; the only Closed-section drift is when a row
-  # in that section names an ID that is NOT .closed.md on disk.
-  cat > "$FIXTURE_DIR/001-old.closed.md" <<EOF
-**Status**: Closed
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 0 ]
-}
-
-# ── P133: defensive rename of `status` local → `ticket_status` ──────────────
-
-@test "reconcile-readme: drift detection still works when caller-environment exports status=anything (P133 regression)" {
-  # P133 — `status` is a read-only built-in under zsh (alias for `$?`). The
-  # script's `#!/usr/bin/env bash` shebang means it never runs under zsh
-  # directly, but a caller may export `status=…` into the script's environment
-  # and the script must not depend on the bash-builtin name for its own state.
-  # After the P133 rename (`status` → `ticket_status`), the script's drift
-  # detection is independent of any caller-set `status` env var. This test
-  # asserts the behaviour: caller exports `status=junk`, script still emits
-  # correct drift output (does not pick up the caller's value).
-  cat > "$FIXTURE_DIR/074-foo.closed.md" <<EOF
-**Status**: Closed
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-| 6.0 | P074 | Foo | 12 High | Open | M |
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  # `env status=junk` sets the env var on the script invocation; bats's
-  # `run` still captures the script exit code into the test-scope `$status`.
-  run env status=junk "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 1 ]
-  echo "$output" | grep -q "P074"
-  # Drift line must report actual filesystem status (`closed`), not the
-  # caller's bogus `junk` value — script reads from FS_STATUS, not env.
-  echo "$output" | grep -q "actual=closed"
-  ! echo "$output" | grep -q "actual=junk"
-}
-
-# ── README Closed-section row pointing to non-existent or wrong-status file ──
-
-@test "reconcile-readme: exit 1 when Closed section names ID that is .open.md on disk" {
-  cat > "$FIXTURE_DIR/099-still-open.open.md" <<EOF
-**Status**: Open
-**WSJF**: 3.0
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-| 3.0 | P099 | Still Open | 15 High | Open | L |
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-| P099 | Still Open | (incorrectly listed) |
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 1 ]
-  echo "$output" | grep -q "P099"
-}
-
-# ── RFC-002 T4: dual-tolerant layout enumeration ────────────────────────────
-#
-# Contract: during the P170/RFC-002 migration window, problem tickets MAY
-# live under either the flat layout (`docs/problems/<NNN>-<title>.<state>.md`)
-# OR the per-state subdir layout (`docs/problems/<state>/<NNN>-<title>.md`).
-# `reconcile-readme.sh` MUST enumerate ground-truth status from both,
-# otherwise:
-#   - tickets in the un-migrated layout-half show as MISSING in WSJF Rankings,
-#   - or tickets in the migrated layout-half are not validated against
-#     README claims, masking drift.
-#
-# Behavioural contract: drift output (or exit 0) MUST be IDENTICAL regardless
-# of which layout the source tickets reside in. The script's stdout is the
-# observable signal; tests assert against stdout content + exit code, NOT
-# against script source (P081 — no structural-grep on script content).
-#
-# T6 (post-T5 verification) drops the flat-layout half. These tests update
-# at T6 to single-layout fixtures, NOT removed — the contract becomes
-# "per-state layout enumerates correctly" but remains behavioural.
-#
-# @rfc RFC-002 T4
-# @adr ADR-031 (per-state subdir is post-migration ground truth)
-# @adr ADR-051 (load-bearing-from-the-start — T4 ships with bats coverage)
-# @adr ADR-052 (behavioural-tests-default — fixture-driven not source-grep)
-
-@test "reconcile-readme T4: per-state subdir .open ticket recognised, no drift when README matches" {
-  # Per-state layout — same Open ticket as the flat-only baseline test
-  # at line ~63 ("WSJF Rankings matches filesystem .open.md set"). The
-  # rendered drift output (exit 0) MUST be identical regardless of which
-  # layout the ticket resides in.
-  mkdir -p "$FIXTURE_DIR/open"
-  cat > "$FIXTURE_DIR/open/100-foo.md" <<EOF
-# Problem 100: Foo
-**Status**: Open
-**WSJF**: 5.0
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-# Problem Backlog
-
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-| 5.0 | P100 | Foo | 12 High | Open | M |
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 0 ]
-}
-
-@test "reconcile-readme T4: per-state subdir .closed ticket flagged when README ranks it Open (drift parity with flat)" {
-  # Mirrors the flat-layout P074 case at line ~94. Same drift, different
-  # source layout — drift output must surface P074 the same way.
-  mkdir -p "$FIXTURE_DIR/closed"
-  cat > "$FIXTURE_DIR/closed/074-foo.md" <<EOF
-# Problem 074: Foo
-**Status**: Closed
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-# Problem Backlog
-
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-| 6.0 | P074 | Foo | 12 High | Open | M |
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 1 ]
-  echo "$output" | grep -q "P074"
-  echo "$output" | grep -q "actual=closed"
-}
-
-@test "reconcile-readme T4: per-state subdir .verifying ticket in WSJF Rankings flagged as drift (ADR-022)" {
-  # Mirrors the flat-layout P105 case at line ~317 — Verification Pending
-  # tickets must NOT appear in WSJF Rankings (ADR-022).
-  mkdir -p "$FIXTURE_DIR/verifying"
-  cat > "$FIXTURE_DIR/verifying/105-verify.md" <<EOF
-**Status**: Verification Pending
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-| 8.0 | P105 | Verify | 12 High | Open | M |
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 1 ]
-  echo "$output" | grep -q "P105"
-}
-
-@test "reconcile-readme T4: per-state subdir .open ticket missing from WSJF Rankings is flagged MISSING" {
-  # Mirrors the flat-layout P079 case at line ~127 — a ticket on disk
-  # but absent from README WSJF Rankings is drift.
-  mkdir -p "$FIXTURE_DIR/open"
-  cat > "$FIXTURE_DIR/open/079-bar.md" <<EOF
-# Problem 079: Bar
-**Status**: Open
-**WSJF**: 3.0
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 1 ]
-  echo "$output" | grep -q "P079"
-}
-
-@test "reconcile-readme T4: per-state subdir .verifying ticket listed in Verification Queue is clean (no drift)" {
-  # Verification Queue expects .verifying.md tickets — per-state
-  # equivalent is docs/problems/verifying/<NNN>-*.md.
-  mkdir -p "$FIXTURE_DIR/verifying"
-  cat > "$FIXTURE_DIR/verifying/056-qux.md" <<EOF
-**Status**: Verification Pending
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-| P056 | Qux | 2026-01-01 | yes |
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 0 ]
-}
-
-@test "reconcile-readme T4: mixed-layout fixture (flat + per-state) enumerates BOTH and stays clean" {
-  # Mid-migration race: some tickets already moved to per-state subdir,
-  # others still in flat layout. README accurately tracks both. Script
-  # must recognise both layout-halves as filesystem ground truth and
-  # report exit 0 (no drift) when README rows match.
-  cat > "$FIXTURE_DIR/100-foo.open.md" <<EOF
-**Status**: Open
-EOF
-  mkdir -p "$FIXTURE_DIR/open"
-  cat > "$FIXTURE_DIR/open/200-bar.md" <<EOF
-**Status**: Open
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-| 5.0 | P100 | Foo | 12 High | Open | M |
-| 4.0 | P200 | Bar | 12 High | Open | M |
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 0 ]
-}
-
-@test "reconcile-readme T4: mixed-layout fixture surfaces drift from BOTH halves" {
-  # Both layout-halves contain a drifting ticket; both surfaces in
-  # output. Confirms the script enumerates both, not just one or the
-  # other.
-  cat > "$FIXTURE_DIR/100-foo.closed.md" <<EOF
-**Status**: Closed
-EOF
-  mkdir -p "$FIXTURE_DIR/closed"
-  cat > "$FIXTURE_DIR/closed/200-bar.md" <<EOF
-**Status**: Closed
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-| 6.0 | P100 | Foo | 12 High | Open | M |
-| 5.0 | P200 | Bar | 12 High | Open | M |
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 1 ]
-  echo "$output" | grep -q "P100"
-  echo "$output" | grep -q "P200"
-  # Both surface as DRIFT (claims=open, actual=closed).
-  echo "$output" | grep -q "actual=closed"
-}
-
-@test "reconcile-readme T4: per-state subdir wins on cross-layout ID collision (post-migration is authoritative)" {
-  # Mid-migration race window: same ID may transiently appear in both
-  # layouts between the `git mv` and the README refresh in T5 bulk
-  # migration commit. Per-state subdir is the migration target —
-  # ADR-031 §"Authoritative state signal" treats subdirectory as
-  # authoritative. The script must therefore report per-state status,
-  # not flat-layout status, when both are present.
-  cat > "$FIXTURE_DIR/300-collision.open.md" <<EOF
-**Status**: Open
-EOF
-  mkdir -p "$FIXTURE_DIR/closed"
-  cat > "$FIXTURE_DIR/closed/300-collision.md" <<EOF
-**Status**: Closed
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-| 5.0 | P300 | Collision | 12 High | Open | M |
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  # Per-state subdir is authoritative → README's "Open" claim drifts
-  # against actual=closed. If flat-layout were preferred, the script
-  # would report exit 0 (no drift). Asserting actual=closed proves
-  # per-state-wins semantics.
-  [ "$status" -eq 1 ]
-  echo "$output" | grep -q "P300"
-  echo "$output" | grep -q "actual=closed"
-}
-
-@test "reconcile-readme T4: per-state subdir .parked ticket excluded from WSJF Rankings (ADR-022 multiplier 0)" {
-  # Mirrors the flat-layout P005 case at line ~375 — Parked tickets
-  # have their own section; absence from WSJF Rankings is correct.
-  mkdir -p "$FIXTURE_DIR/parked"
-  cat > "$FIXTURE_DIR/parked/005-parked.md" <<EOF
-**Status**: Parked
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-
-## Parked
-
-| ID | Title | Reason | Parked since |
-|----|-------|--------|-------------|
-| P005 | Parked | Upstream | 2026-04-16 |
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 0 ]
-}
-
-@test "reconcile-readme T4: per-state subdir .known-error ticket recognised in WSJF Rankings as Open-class" {
-  # Known-error tickets belong in WSJF Rankings (ADR-022 — open + known-error
-  # are the dev-work classes). Per-state subdir equivalent is
-  # docs/problems/known-error/<NNN>-*.md.
-  mkdir -p "$FIXTURE_DIR/known-error"
-  cat > "$FIXTURE_DIR/known-error/150-ke.md" <<EOF
-**Status**: Known Error
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-| 4.0 | P150 | KE | 8 Med | Known Error | M |
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 0 ]
-}
-
-# ── P252: Inbound Upstream Reports section excluded from VQ slice ───────────
-#
-# Contract: when `docs/problems/README.md` carries a `## Inbound Upstream
-# Reports` section (per ADR-062 + RFC-004), its rows MUST NOT be counted as
-# Verification Queue rows. Pre-fix the script slices VQ as
-# `[VQ_START, CLOSED_START)`, which swallows the entire Inbound table and
-# mis-attributes its `| P<NNN> |` cross-ref cells to the VQ. Post-fix the
-# VQ slice terminates at `## Inbound Upstream Reports` when present.
-#
-# Behavioural assertion shape: reconcile against a README that has VQ
-# matching filesystem ground truth AND an Inbound Upstream Reports table
-# carrying cross-refs to Open tickets → exit 0. Pre-fix this would emit
-# 31-ish STALE entries. Post-fix it emits none.
-#
-# @problem P252
-# @adr ADR-062 (Inbound upstream-report discovery + assessment pipeline)
-# @rfc RFC-004 (P079 inbound-upstream-report discovery)
-# @jtbd JTBD-006 (Progress the Backlog While I'm Away)
-# @jtbd JTBD-302 (Trust That the README Describes the Plugin I Just Installed)
-
-@test "reconcile-readme P252: Inbound Upstream Reports cross-refs are NOT counted as Verification Queue rows" {
-  # Two Open tickets cross-referenced as inbound-mirror entries. Pre-fix
-  # the script slices VQ as [VQ_START, CLOSED_START), which swallows the
-  # Inbound table — both P-IDs get reported as STALE verification-queue.
-  # Post-fix the VQ slice terminates at Inbound; both IDs are correctly
-  # recognised as Open (their .open.md files exist) and no drift fires.
-  cat > "$FIXTURE_DIR/198-foo.open.md" <<EOF
-**Status**: Open
-EOF
-  cat > "$FIXTURE_DIR/199-bar.open.md" <<EOF
-**Status**: Open
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-| 5.0 | P198 | Foo | 12 High | Open | M |
-| 4.0 | P199 | Bar | 12 High | Open | M |
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-
-## Inbound Upstream Reports
-
-Inbound mirrors discovered via the discovery pipeline (ADR-062 / RFC-004).
-The `Matched local ticket` column carries cross-refs that look like VQ rows
-but live in a different section and MUST NOT be parsed as VQ entries.
-
-| # | Inbound | Matched local ticket |
-|---|---------|----------------------|
-| 1 | upstream/issues/42 | P198 |
-| 2 | upstream/issues/43 | P199 |
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  # Clean state — both P-IDs are correctly Open on disk AND in WSJF
-  # Rankings; the Inbound section's cross-refs are scoped out.
-  [ "$status" -eq 0 ]
-  # Defensive: even if exit 0 lands by accident, output must not contain
-  # any false-positive STALE entries citing Inbound IDs.
-  ! echo "$output" | grep -q "P198 verification-queue"
-  ! echo "$output" | grep -q "P199 verification-queue"
-}
-
-@test "reconcile-readme P252: real VQ drift surfaces, Inbound cross-refs stay silent" {
-  # Mixed fixture: one genuine STALE VQ row (P056 — README lists in VQ,
-  # disk has it Closed) + an Inbound section with cross-refs to Open
-  # tickets. Drift output MUST cite P056 only; Inbound IDs MUST NOT
-  # appear in any verification-queue drift line.
-  cat > "$FIXTURE_DIR/056-qux.closed.md" <<EOF
-**Status**: Closed
-EOF
-  cat > "$FIXTURE_DIR/198-foo.open.md" <<EOF
-**Status**: Open
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-| 5.0 | P198 | Foo | 12 High | Open | M |
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-| P056 | Qux | 2026-01-01 | yes |
-
-## Inbound Upstream Reports
-
-| # | Inbound | Matched local ticket |
-|---|---------|----------------------|
-| 1 | upstream/issues/42 | P198 |
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 1 ]
-  # P056 is the genuine drift (in VQ, file is Closed).
-  echo "$output" | grep -q "P056"
-  # P198 must NOT appear in any verification-queue drift line — it's an
-  # Inbound cross-ref, not a VQ row.
-  ! echo "$output" | grep -q "P198 verification-queue"
-}
-
-@test "reconcile-readme P252: missing Inbound section preserves existing behaviour (back-compat)" {
-  # A README that does NOT have an Inbound Upstream Reports section must
-  # continue to slice VQ as [VQ_START, CLOSED_START) without regression.
-  # This guards against the fix accidentally requiring the Inbound header
-  # to exist.
-  cat > "$FIXTURE_DIR/056-qux.closed.md" <<EOF
-**Status**: Closed
-EOF
-  cat > "$FIXTURE_DIR/README.md" <<'EOF'
-## WSJF Rankings
-
-| WSJF | ID | Title | Severity | Status | Effort |
-|------|-----|-------|----------|--------|--------|
-
-## Verification Queue
-
-| ID | Title | Released | Likely verified? |
-|----|-------|----------|------------------|
-| P056 | Qux | 2026-01-01 | yes |
-
-## Closed
-
-| ID | Title | Closed via |
-|----|-------|-----------|
-EOF
-  run "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 1 ]
-  echo "$output" | grep -q "P056"
-}