npm - @windyroad/itil - Versions diffs - 0.61.1 → 0.61.2 - Mend

@windyroad/itil 0.61.1 → 0.61.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (171) hide show

package/scripts/test/check-afk-accept-eligible.bats DELETED Viewed

@@ -1,310 +0,0 @@
-#!/usr/bin/env bats
-# Behavioural tests for check-afk-accept-eligible.sh (ADR-101 / P456 / P465).
-# Each case maps onto an ADR-101 Confirmation item. Behavioural, not structural:
-# every test runs the real script against a real fixture tree and asserts on its
-# exit status and stderr, never on its source text (ADR-052 / P081).
-#
-# The POSITIVE case is the load-bearing one. An earlier revision shipped an
-# `awk -v` escape bug that made the checker permanently inert — it fails closed,
-# so no negative test could ever have caught it. Only asserting that a
-# well-formed story IS eligible surfaces that class of bug.
-#
-# @adr ADR-101 ADR-090 ADR-095 ADR-096 ADR-098 ADR-052  @problem P456 P465
-setup() {
-  SCRIPTS="$(cd "$(dirname "$BATS_TEST_FILENAME")/.." && pwd)"
-  CHECK="$SCRIPTS/check-afk-accept-eligible.sh"
-  MARK="$SCRIPTS/mark-story-oversight-confirmed.sh"
-  TMP="$(mktemp -d)"; cd "$TMP"
-  mkdir -p docs/stories/draft docs/story-maps/draft docs/rfcs docs/jtbd/dev docs/problems/open docs/decisions
-  export HOME="$TMP/home"; mkdir -p "$HOME/.claude"
-  # --- confirmed parents -----------------------------------------------------
-  printf -- '---\nhuman-oversight: confirmed\n---\n\n# ADR-900\n' > docs/decisions/900-a-confirmed-decision.proposed.md
-  printf -- '---\nhuman-oversight: confirmed\n---\n\n# JTBD-900\n' > docs/jtbd/dev/JTBD-900-a-job.proposed.md
-  printf -- '---\nhuman-oversight: confirmed\n---\n\n# persona\n' > docs/jtbd/dev/persona.md
-  printf -- '---\nadrs: [ADR-900]\n---\n\n# RFC-900\n' > docs/rfcs/RFC-900-a-vehicle.proposed.md
-  printf -- '# P900\n' > docs/problems/open/900-a-problem.md
-  # A map that was ratified BEFORE the story's card was added — the common case,
-  # since ADR-095 compels the card at capture.
-  MAP=docs/story-maps/draft/STORY-MAP-900-a-map.html
-  printf '<html><head>\n<a class="slice" data-story-id="STORY-800">old</a>\n</head></html>\n' > "$MAP"
-  bash "$MARK" "$MAP" 2>/dev/null
-  # Now add STORY-901's card, drifting the map exactly as capture would.
-  python3 - "$MAP" <<'PY'
-import sys
-p=sys.argv[1]; s=open(p).read()
-open(p,"w").write(s.replace('</head>','  <a class="slice" data-story-id="STORY-901">new</a>\n</head>'))
-PY
-  export WR_ITIL_AFK_ACCEPT=1
-}
-teardown() { cd /; rm -rf "$TMP"; }
-# A well-formed pure-decomposition story: 2 criteria, 2 basis entries, all
-# citations traced and confirmed.
-seed_story() {
-  cat > docs/stories/draft/STORY-901-a-story.md <<'EOF'
----
-status: draft
-problems: [P900]
-jtbd: [JTBD-900]
-rfcs: [RFC-900]
-story-maps: [STORY-MAP-900]
-adrs: [ADR-900]
-afk-accept: pure-decomposition
----
-# STORY-901: A story
-## User value
-In order to land confirmed work, as a developer, I want the loop to proceed.
-## Acceptance criteria (accepted-gate, INVEST Testable)
-- [ ] The first step happens.
-- [ ] The second step happens.
-## Decomposition basis
-- Criterion 1 decomposes ADR-900's rule about the first step.
-- Criterion 2 decomposes ADR-900's rule about the second step.
-EOF
-}
-run_check() { run bash "$CHECK" docs/stories/draft/STORY-901-a-story.md \
-  docs/story-maps docs/rfcs docs/jtbd docs/problems docs/decisions; }
-# --- ADR-101 Confirmation: eligibility ---------------------------------------
-@test "ELIGIBLE: pure-decomposition story whose parents are all confirmed" {
-  seed_story; run_check
-  [ "$status" -eq 0 ]
-  echo "$output" | grep -q 'ELIGIBLE'
-}
-@test "NOT eligible: a traced ADR parent is unconfirmed" {
-  seed_story
-  printf -- '---\nhuman-oversight: unconfirmed\n---\n\n# ADR-900\n' > docs/decisions/900-a-confirmed-decision.proposed.md
-  run_check
-  [ "$status" -eq 1 ]
-  echo "$output" | grep -q 'ADR-900'
-}
-@test "NOT eligible: a traced JTBD's persona is unconfirmed" {
-  seed_story
-  printf -- '---\nhuman-oversight: unconfirmed\n---\n\n# persona\n' > docs/jtbd/dev/persona.md
-  run_check
-  [ "$status" -eq 1 ]
-  echo "$output" | grep -qi 'persona'
-}
-@test "NOT eligible: a traced artefact does not resolve (new substance)" {
-  seed_story
-  rm docs/decisions/900-a-confirmed-decision.proposed.md
-  run_check
-  [ "$status" -eq 1 ]
-}
-@test "NOT eligible: basis entries do not match the criteria count" {
-  seed_story
-  printf -- '- [ ] A third step nobody accounted for.\n' >> docs/stories/draft/STORY-901-a-story.md
-  run_check
-  [ "$status" -eq 1 ]
-  echo "$output" | grep -q 'Decomposition basis'
-}
-@test "NOT eligible: basis cites an artefact condition (a) never verified" {
-  seed_story
-  sed -i.bak 's/ADR-900.s rule about the first step/ADR-999 rule about the first step/' docs/stories/draft/STORY-901-a-story.md
-  run_check
-  [ "$status" -eq 1 ]
-  echo "$output" | grep -q 'ADR-999'
-}
-@test "NOT eligible: the story does not declare the carve-out" {
-  seed_story
-  sed -i.bak '/^afk-accept:/d' docs/stories/draft/STORY-901-a-story.md
-  run_check
-  [ "$status" -eq 1 ]
-  echo "$output" | grep -q 'afk-accept'
-}
-@test "NOT eligible: no acceptance criteria at all (fail-closed on zero)" {
-  seed_story
-  sed -i.bak 's/^- \[ \] The first step happens.//; s/^- \[ \] The second step happens.//' docs/stories/draft/STORY-901-a-story.md
-  run_check
-  [ "$status" -eq 1 ]
-}
-# --- ADR-101 Confirmation: the secondary blacklist ---------------------------
-@test "NOT eligible: an open-decision marker in ordinary prose" {
-  seed_story
-  printf -- '\nThe storage locus is still to be decided.\n' >> docs/stories/draft/STORY-901-a-story.md
-  run_check
-  [ "$status" -eq 1 ]
-}
-@test "ELIGIBLE: the same vocabulary inside a fenced or backticked span" {
-  seed_story
-  printf -- '\nThe checker rejects the phrase `to be decided` when it appears in prose:\n\n```\nopen question / TBD / decision needed\n```\n' \
-    >> docs/stories/draft/STORY-901-a-story.md
-  run_check
-  [ "$status" -eq 0 ]
-}
-# --- ADR-101 Confirmation: the map leg disjunction ---------------------------
-@test "ELIGIBLE: map re-ratified WITH the story's card already present" {
-  seed_story
-  bash "$MARK" "$MAP" 2>/dev/null   # re-ratify now that STORY-901's card exists
-  run_check
-  [ "$status" -eq 0 ]
-}
-@test "NOT eligible: map drifted for a reason OTHER than the story's own card" {
-  seed_story
-  printf '<p>an unrelated edit</p>\n' >> "$MAP"
-  run_check
-  [ "$status" -eq 1 ]
-  echo "$output" | grep -q 'STORY-MAP-900'
-}
-@test "NOT eligible: map carries no human-oversight marker at all" {
-  seed_story
-  grep -v 'oversight' "$MAP" > "$MAP.tmp" && mv "$MAP.tmp" "$MAP"
-  run_check
-  [ "$status" -eq 1 ]
-}
-# --- ADR-101 Confirmation: the opt-in split ----------------------------------
-@test "NOT eligible without opt-in, even when (a) and (b) both hold" {
-  seed_story
-  unset WR_ITIL_AFK_ACCEPT
-  run_check
-  [ "$status" -eq 1 ]
-  echo "$output" | grep -q 'opted in'
-}
-@test "project config opts in" {
-  seed_story
-  unset WR_ITIL_AFK_ACCEPT
-  mkdir -p .claude
-  printf '{ "afk_accept_pure_decomposition": true }\n' > .claude/itil.config.json
-  run_check
-  [ "$status" -eq 0 ]
-}
-@test "a non-boolean config value does NOT opt in" {
-  seed_story
-  unset WR_ITIL_AFK_ACCEPT
-  mkdir -p .claude
-  printf '{ "afk_accept_pure_decomposition": "true" }\n' > .claude/itil.config.json
-  run_check
-  [ "$status" -eq 1 ]
-}
-@test "an unparseable config does NOT opt in" {
-  seed_story
-  unset WR_ITIL_AFK_ACCEPT
-  mkdir -p .claude
-  printf 'not json at all\n' > .claude/itil.config.json
-  run_check
-  [ "$status" -eq 1 ]
-}
-@test "ADR-098 per-key fallback: a project file omitting the key falls through to machine" {
-  seed_story
-  unset WR_ITIL_AFK_ACCEPT
-  mkdir -p .claude
-  printf '{ "some_other_key": 1 }\n' > .claude/itil.config.json
-  printf '{ "afk_accept_pure_decomposition": true }\n' > "$HOME/.claude/itil.config.json"
-  run_check
-  [ "$status" -eq 0 ]
-}
-@test "a project file setting the key FALSE wins over a machine TRUE" {
-  seed_story
-  unset WR_ITIL_AFK_ACCEPT
-  mkdir -p .claude
-  printf '{ "afk_accept_pure_decomposition": false }\n' > .claude/itil.config.json
-  printf '{ "afk_accept_pure_decomposition": true }\n' > "$HOME/.claude/itil.config.json"
-  run_check
-  [ "$status" -eq 1 ]
-}
-@test "jq absent resolves to the built-in default: NOT eligible" {
-  seed_story
-  unset WR_ITIL_AFK_ACCEPT
-  mkdir -p .claude bin
-  printf '{ "afk_accept_pure_decomposition": true }\n' > .claude/itil.config.json
-  run env PATH="/usr/bin:/bin" bash "$CHECK" docs/stories/draft/STORY-901-a-story.md \
-    docs/story-maps docs/rfcs docs/jtbd docs/problems docs/decisions
-  # Only meaningful where jq is genuinely off PATH; skip otherwise.
-  if PATH="/usr/bin:/bin" command -v jq >/dev/null 2>&1; then skip "jq is on the minimal PATH here"; fi
-  [ "$status" -eq 1 ]
-}
-# --- ADR-101 Confirmation: no automated path writes a `true` opt-in ----------
-@test "no shipped installer or scaffold writes an opt-in value" {
-  # The guard that keeps opt-in from becoming opt-out-by-stealth. Any shipped
-  # code that WRITES this key would defeat the split; reading it is fine.
-  cd "$(dirname "$CHECK")/.."
-  # Guard the search roots. Pointed at a directory that does not exist, grep
-  # matches nothing and the assertion below passes for the wrong reason — and
-  # whether it passes at all then depends on which grep merges its warning into
-  # bats' $output.
-  [ -d bin ] && [ -d hooks ]
-  run grep -rIlE 'afk_accept_pure_decomposition' --include='*.mjs' --include='*.js' bin/ hooks/
-  [ -z "$output" ]
-}
-# --- ADR-101 Confirmation: detector stdout contract --------------------------
-@test "detect-unratified-stories-maps stdout is byte-identical with and without the flag" {
-  seed_story
-  a="$(bash "$SCRIPTS/detect-unratified-stories-maps.sh" docs/stories docs/story-maps 2>/dev/null)"
-  b="$(bash "$SCRIPTS/detect-unratified-stories-maps.sh" --with-afk-accepted docs/stories docs/story-maps 2>/dev/null)"
-  [ "$a" = "$b" ]
-}
-@test "--with-afk-accepted surfaces the machine-accepted story on stderr" {
-  seed_story
-  run bash -c "bash '$SCRIPTS/detect-unratified-stories-maps.sh' --with-afk-accepted docs/stories docs/story-maps 2>&1 >/dev/null"
-  echo "$output" | grep -q 'STORY-901'
-  echo "$output" | grep -q 'AFK-ACCEPTED'
-}
-@test "the post-hoc drain still finds the story when oversight-basis is stripped" {
-  # The union key. `oversight-basis` is excluded from the content hash, so
-  # stripping it would otherwise hide a machine-accepted story from the drain;
-  # the authored `afk-accept:` declaration is inside the hash and closes that.
-  seed_story
-  bash "$MARK" --pure-decomposition docs/stories/draft/STORY-901-a-story.md 2>/dev/null
-  sed -i.bak '/^oversight-basis:/d' docs/stories/draft/STORY-901-a-story.md
-  run bash -c "bash '$SCRIPTS/detect-unratified-stories-maps.sh' --with-afk-accepted docs/stories docs/story-maps 2>&1 >/dev/null"
-  echo "$output" | grep -q 'STORY-901'
-}
-# --- the marker write path ---------------------------------------------------
-@test "--pure-decomposition records the basis AND leaves the story ratified" {
-  seed_story
-  bash "$MARK" --pure-decomposition docs/stories/draft/STORY-901-a-story.md 2>/dev/null
-  grep -q '^oversight-basis: pure-decomposition' docs/stories/draft/STORY-901-a-story.md
-  # The basis line is excluded from the hash, so the story must NOT read as
-  # drifted the instant it is marked.
-  run bash -c "source '$SCRIPTS/../lib/story-oversight.sh'; is_story_map_ratified docs/stories/draft/STORY-901-a-story.md"
-  [ "$status" -eq 0 ]
-}
-@test "a plain re-ratify CLEARS a stale pure-decomposition basis" {
-  seed_story
-  bash "$MARK" --pure-decomposition docs/stories/draft/STORY-901-a-story.md 2>/dev/null
-  bash "$MARK" docs/stories/draft/STORY-901-a-story.md 2>/dev/null
-  ! grep -q '^oversight-basis:' docs/stories/draft/STORY-901-a-story.md
-}

package/scripts/test/check-fail-soft-skip-discipline.bats DELETED Viewed

@@ -1,172 +0,0 @@
-#!/usr/bin/env bats
-# @problem P351 — skills fail-soft-skip when their precondition config is
-#                 missing — should auto-bootstrap with user input as needed
-#                 rather than silently skipping.
-#
-# Contract: `check-fail-soft-skip-discipline.sh <repo-root>` walks
-# `<repo-root>/packages/*/skills/*/SKILL.md`, greps each file for the
-# tightened fail-soft-skip pattern set
-# (fail-soft skip|silently skip|skipping.*config|skipping.*not configured|
-#  not configured.*skip), emits one `WARN  <relpath>:<line>  <pat>: ...`
-# line per match on stderr, and exits 0 in Phase 1 advisory mode
-# regardless of whether violations were found.
-#
-# @adr ADR-049 (bin/ on PATH shim — adopter-safe script resolution)
-# @adr ADR-052 (Behavioural bats default)
-# @adr ADR-040 (Advisory-then-load-bearing reusable pattern)
-# @adr ADR-013 Rule 6 (Non-interactive fail-safe — advisory exit 0)
-# @jtbd JTBD-001 (Enforce Governance — pattern-discipline lint)
-# @jtbd JTBD-101 (Extend the Suite — extensible pattern per skill site)
-setup() {
-  SCRIPTS_DIR="$(cd "$(dirname "$BATS_TEST_FILENAME")/.." && pwd)"
-  SCRIPT="$SCRIPTS_DIR/check-fail-soft-skip-discipline.sh"
-  FIXTURE_ROOT="$(mktemp -d)"
-}
-teardown() {
-  rm -rf "$FIXTURE_ROOT"
-}
-# ── Existence + executable ──────────────────────────────────────────────────
-@test "check-fail-soft-skip-discipline: script exists" {
-  [ -f "$SCRIPT" ]
-}
-@test "check-fail-soft-skip-discipline: script is executable" {
-  [ -x "$SCRIPT" ]
-}
-# ── Phase 1 advisory exit-code contract ─────────────────────────────────────
-@test "Phase 1 advisory: exits 0 on a clean fixture" {
-  mkdir -p "$FIXTURE_ROOT/packages/sample/skills/clean-skill"
-  cat > "$FIXTURE_ROOT/packages/sample/skills/clean-skill/SKILL.md" <<'EOF'
-# Sample clean skill
-This skill auto-bootstraps any missing precondition config via
-AskUserQuestion. No fail-soft pattern present.
-EOF
-  run "$SCRIPT" "$FIXTURE_ROOT"
-  [ "$status" -eq 0 ]
-}
-@test "Phase 1 advisory: exits 0 even when violations present (default WR_FAIL_SOFT_SKIP_WARN_ONLY=1)" {
-  mkdir -p "$FIXTURE_ROOT/packages/sample/skills/dirty-skill"
-  cat > "$FIXTURE_ROOT/packages/sample/skills/dirty-skill/SKILL.md" <<'EOF'
-# Sample dirty skill
-This skill performs a fail-soft skip when the config is missing.
-EOF
-  run "$SCRIPT" "$FIXTURE_ROOT"
-  [ "$status" -eq 0 ]
-}
-# ── WARN-on-fixture: behavioural ────────────────────────────────────────────
-@test "WARN-on-fixture: matches 'fail-soft skip' literal" {
-  mkdir -p "$FIXTURE_ROOT/packages/sample/skills/dirty-skill"
-  cat > "$FIXTURE_ROOT/packages/sample/skills/dirty-skill/SKILL.md" <<'EOF'
-# Dirty skill
-When the file is missing emit a fail-soft skip and continue.
-EOF
-  run "$SCRIPT" "$FIXTURE_ROOT"
-  [ "$status" -eq 0 ]
-  [[ "$output" == *"WARN"* ]]
-  [[ "$output" == *"packages/sample/skills/dirty-skill/SKILL.md"* ]]
-  [[ "$output" == *"fail-soft skip"* ]]
-}
-@test "WARN-on-fixture: matches 'silently skip' synonym" {
-  mkdir -p "$FIXTURE_ROOT/packages/sample/skills/silent-skill"
-  cat > "$FIXTURE_ROOT/packages/sample/skills/silent-skill/SKILL.md" <<'EOF'
-# Silent skill
-If config missing, silently skip the pass.
-EOF
-  run "$SCRIPT" "$FIXTURE_ROOT"
-  [ "$status" -eq 0 ]
-  [[ "$output" == *"silently skip"* ]]
-}
-@test "WARN-on-fixture: matches tightened 'skipping.*config' shape" {
-  mkdir -p "$FIXTURE_ROOT/packages/sample/skills/skipper-skill"
-  cat > "$FIXTURE_ROOT/packages/sample/skills/skipper-skill/SKILL.md" <<'EOF'
-# Skipper skill
-Skipping the pass because the channels config is absent.
-EOF
-  run "$SCRIPT" "$FIXTURE_ROOT"
-  [ "$status" -eq 0 ]
-  [[ "$output" == *"skipper-skill/SKILL.md"* ]]
-}
-# ── CLEAN-on-fixture: behavioural negative ──────────────────────────────────
-@test "CLEAN-on-fixture: no WARN emitted when SKILL.md is fail-soft-skip free" {
-  mkdir -p "$FIXTURE_ROOT/packages/sample/skills/auto-bootstrap-skill"
-  cat > "$FIXTURE_ROOT/packages/sample/skills/auto-bootstrap-skill/SKILL.md" <<'EOF'
-# Auto-bootstrap skill
-When the config file is missing, auto-bootstrap it via AskUserQuestion
-(interactive mode) or queue a config-direction outstanding_question
-(AFK mode). The skill resumes the original pass after bootstrap.
-EOF
-  run "$SCRIPT" "$FIXTURE_ROOT"
-  [ "$status" -eq 0 ]
-  ! [[ "$output" == *"WARN"* ]]
-}
-@test "CLEAN-on-fixture: does NOT false-positive on legitimate per-channel skip prose (architect tightening)" {
-  mkdir -p "$FIXTURE_ROOT/packages/sample/skills/per-channel-skill"
-  cat > "$FIXTURE_ROOT/packages/sample/skills/per-channel-skill/SKILL.md" <<'EOF'
-# Per-channel skill
-On rate-limit, log advisory and skip that channel only — skipping the
-failing channel/report is fine because other channels proceed. This
-prose is the inverse of fail-soft-skip-on-missing-config and must NOT
-fire a WARN per the architect-tightened pattern set.
-EOF
-  run "$SCRIPT" "$FIXTURE_ROOT"
-  [ "$status" -eq 0 ]
-  # The "fail-soft-skip-on-missing-config" hyphenated literal in the
-  # prose does NOT contain a literal space-separated "fail-soft skip"
-  # phrase, but the descriptive text does. Verify the script catches the
-  # descriptive use and does NOT mistake the per-channel skip-prose for
-  # the load-bearing pattern.
-  # We expect EITHER zero WARNs (if the descriptive use is the only
-  # hit) OR exactly the descriptive lines. Either way the per-channel
-  # "skipping the failing channel/report" prose alone must NOT generate
-  # a WARN.
-  channel_only_warns=$(echo "$output" | grep -c "skipping the failing channel" || true)
-  [ "$channel_only_warns" = "0" ]
-}
-# ── Phase 2 promotion: behavioural ──────────────────────────────────────────
-@test "Phase 2 promotion: exits 1 when WR_FAIL_SOFT_SKIP_WARN_ONLY=0 + violations present" {
-  mkdir -p "$FIXTURE_ROOT/packages/sample/skills/dirty-skill"
-  cat > "$FIXTURE_ROOT/packages/sample/skills/dirty-skill/SKILL.md" <<'EOF'
-# Dirty skill
-Fail-soft skip when missing.
-EOF
-  WR_FAIL_SOFT_SKIP_WARN_ONLY=0 run "$SCRIPT" "$FIXTURE_ROOT"
-  [ "$status" -eq 1 ]
-}
-# ── Usage / path-error contract ─────────────────────────────────────────────
-@test "Usage: exits 2 on missing repo-root directory" {
-  run "$SCRIPT" "$FIXTURE_ROOT/does-not-exist"
-  [ "$status" -eq 2 ]
-}
-@test "Usage: exits 2 on repo-root without packages/ subdir" {
-  mkdir -p "$FIXTURE_ROOT/no-packages-here"
-  run "$SCRIPT" "$FIXTURE_ROOT/no-packages-here"
-  [ "$status" -eq 2 ]
-}

package/scripts/test/check-fix-rfc-trace.bats DELETED Viewed

@@ -1,164 +0,0 @@
-#!/usr/bin/env bats
-# @problem P314 — Phase 2 (RFC-005 B3/B4): the fix-time propose-fix
-# RFC-trace gate. Before fix work commences on a Known Error, the
-# framework requires an RFC tracing the problem; if none exists, a
-# problem-traced skeleton RFC is auto-created (per ADR-073) rather than
-# blocked. This script is the load-bearing PREDICATE half of that gate
-# (ADR-060 I1 load-bearing-from-the-start carried forward): it detects
-# whether any RFC traces the problem and emits an auto-create directive
-# on stdout when none does. The CREATE half is skill-orchestrated
-# (delegates to /wr-itil:capture-rfc — the canonical ADR-070-compliant
-# problem-traced-skeleton vehicle, no duplication).
-#
-# Behavioural per ADR-052: assert on the script's exit code + stdout
-# directive given fixture RFC corpora — not on script source content
-# (no structural greps per P081).
-#
-# Contract:
-#   - <problem-file> whose basename is `<NNN>-<slug>.md` → PID = P<NNN>.
-#   - An RFC traces the problem when its frontmatter `problems:` array
-#     contains the exact PID (boundary-safe: P31 / P3140 must NOT match
-#     a P314 query).
-#   - Trace present  → exit 0, EMPTY stdout (fix proceeds; no auto-create).
-#   - Trace absent   → exit 0, stdout carries `no-rfc-trace: P<NNN>` directive
-#     (NEVER a non-zero/block exit — ADR-073 auto-create-not-block).
-#   - Missing problem file / no args → exit 2 (caller misuse), stderr usage.
-#
-# @adr ADR-072 (RFC required at the propose-fix step on a Known Error)
-# @adr ADR-073 (fix-time gate auto-creates a missing RFC, everywhere —
-#   never blocks; hence exit 0 on the absent branch)
-# @adr ADR-071 (every fix goes through an RFC — unconditional, no carve-out)
-# @adr ADR-060 (I1 load-bearing-from-the-start; I13 fix-proposal invariant)
-# @adr ADR-052 (behavioural bats default)
-# @jtbd JTBD-008 (Decompose a Fix Into Coordinated Changes — trace invariant)
-# @jtbd JTBD-006 (Progress the Backlog While I'm Away — never stall/skip)
-setup() {
-  SCRIPTS_DIR="$(cd "$(dirname "$BATS_TEST_FILENAME")/.." && pwd)"
-  SCRIPT="$SCRIPTS_DIR/check-fix-rfc-trace.sh"
-  RFCS_DIR="$(mktemp -d)"
-  PROBLEMS_DIR="$(mktemp -d)"
-}
-teardown() {
-  rm -rf "$RFCS_DIR" "$PROBLEMS_DIR"
-}
-# Write an RFC fixture whose frontmatter `problems:` array is set verbatim.
-write_rfc() {
-  local id="$1" slug="$2" status="$3" problems="$4"
-  cat > "$RFCS_DIR/RFC-${id}-${slug}.${status}.md" <<EOF
----
-status: ${status}
-rfc-id: ${slug}
-problems: ${problems}
----
-# RFC-${id}: ${slug}
-EOF
-}
-# Write a problem fixture; returns the path on stdout.
-write_problem() {
-  local num="$1" slug="${2:-some-problem}"
-  local f="$PROBLEMS_DIR/${num}-${slug}.md"
-  cat > "$f" <<EOF
-# Problem ${num}: ${slug}
-**Status**: Known Error
-EOF
-  printf '%s' "$f"
-}
-@test "trace present (single-PID array) → exit 0, empty stdout" {
-  write_rfc 005 some-fix accepted "[P314]"
-  pf="$(write_problem 314)"
-  run "$SCRIPT" "$pf" "$RFCS_DIR"
-  [ "$status" -eq 0 ]
-  [ -z "$output" ]
-}
-@test "trace present (multi-PID array) → exit 0, empty stdout" {
-  write_rfc 005 some-fix accepted "[P100, P314, P200]"
-  pf="$(write_problem 314)"
-  run "$SCRIPT" "$pf" "$RFCS_DIR"
-  [ "$status" -eq 0 ]
-  [ -z "$output" ]
-}
-@test "trace absent (empty rfcs dir) → exit 0, auto-create directive on stdout" {
-  pf="$(write_problem 314)"
-  run "$SCRIPT" "$pf" "$RFCS_DIR"
-  [ "$status" -eq 0 ]
-  [[ "$output" == *"no-rfc-trace: P314"* ]]
-}
-@test "trace absent (RFCs exist but none claim this PID) → exit 0, directive" {
-  write_rfc 005 other-fix accepted "[P251]"
-  write_rfc 013 another accepted "[P346]"
-  pf="$(write_problem 314)"
-  run "$SCRIPT" "$pf" "$RFCS_DIR"
-  [ "$status" -eq 0 ]
-  [[ "$output" == *"no-rfc-trace: P314"* ]]
-}
-@test "PID boundary: P31 in an RFC does NOT satisfy a P314 query" {
-  write_rfc 005 short-pid accepted "[P31]"
-  pf="$(write_problem 314)"
-  run "$SCRIPT" "$pf" "$RFCS_DIR"
-  [ "$status" -eq 0 ]
-  [[ "$output" == *"no-rfc-trace: P314"* ]]
-}
-@test "PID boundary: P3140 in an RFC does NOT satisfy a P314 query" {
-  write_rfc 005 long-pid accepted "[P3140]"
-  pf="$(write_problem 314)"
-  run "$SCRIPT" "$pf" "$RFCS_DIR"
-  [ "$status" -eq 0 ]
-  [[ "$output" == *"no-rfc-trace: P314"* ]]
-}
-@test "exact match works for a zero-padded low PID (P080 ← [P080])" {
-  # PIDs are canonically 3-digit zero-padded (filenames 080-..., citations P080).
-  write_rfc 005 padded-pid accepted "[P080]"
-  pf="$(write_problem 080)"
-  run "$SCRIPT" "$pf" "$RFCS_DIR"
-  [ "$status" -eq 0 ]
-  [ -z "$output" ]
-}
-@test "default rfcs-dir is docs/rfcs when second arg omitted" {
-  # Run from a temp cwd containing docs/rfcs with a tracing RFC.
-  workdir="$(mktemp -d)"
-  mkdir -p "$workdir/docs/rfcs"
-  cat > "$workdir/docs/rfcs/RFC-005-x.accepted.md" <<'EOF'
----
-problems: [P314]
----
-# RFC-005: x
-EOF
-  pf="$(write_problem 314)"
-  run bash -c "cd '$workdir' && '$SCRIPT' '$pf'"
-  [ "$status" -eq 0 ]
-  [ -z "$output" ]
-  rm -rf "$workdir"
-}
-@test "missing problem file → exit 2, stderr usage" {
-  run "$SCRIPT" "$PROBLEMS_DIR/999-nonexistent.md" "$RFCS_DIR"
-  [ "$status" -eq 2 ]
-}
-@test "no args → exit 2" {
-  run "$SCRIPT"
-  [ "$status" -eq 2 ]
-}
-@test "directive names the canonical auto-create vehicle (capture-rfc) and ADRs" {
-  pf="$(write_problem 314)"
-  run "$SCRIPT" "$pf" "$RFCS_DIR"
-  [ "$status" -eq 0 ]
-  [[ "$output" == *"capture-rfc"* ]]
-  [[ "$output" == *"ADR-073"* ]]
-}