@windyroad/itil 0.61.1 → 0.61.2

package/scripts/test/update-jtbd-references-related-problems.bats

@@ -1,178 +0,0 @@
-#!/usr/bin/env bats
-
-# P170 / Phase 4 P4.1 — behavioural fixture for the
-# update-jtbd-references-section.sh "Related problems" extension.
-# Adds a fourth lookup-table row (alongside RFCs / Story Maps /
-# Stories) so JTBD files auto-maintain a `## Related problems`
-# reverse-trace section sourced from problem-ticket frontmatter
-# `jtbd:` arrays. Mirrors the parallel-existence one-way reverse-
-# trace shape from ADR-060 § Phase 3 + Phase 4 in-scope amendment
-# (2026-05-13) P4.1.
-#
-# Per ADR-060 architect finding A4 + JTBD finding F5: lookup-table
-# row addition, NOT a new helper. The body MUST remain
-# per-section-name-branchless (assertion in
-# update-references-section-sibling-helpers.bats).
-
-setup() {
-  REPO_ROOT="$(cd "$(dirname "$BATS_TEST_FILENAME")/../../../.." && pwd)"
-  SCRIPT="$REPO_ROOT/packages/itil/scripts/update-jtbd-references-section.sh"
-
-  WORKSPACE="$(mktemp -d)"
-  cd "$WORKSPACE"
-  mkdir -p docs/problems/open docs/problems/known-error docs/jtbd/solo-developer
-
-  cat > docs/jtbd/solo-developer/JTBD-999-sample-job.proposed.md <<'EOF'
----
-status: proposed
-job-id: sample-job
-persona: solo-developer
-date-created: 2026-05-13
----
-
-# JTBD-999: Sample Job
-
-## Job Statement
-
-Sample.
-
-## Desired Outcomes
-
-- Outcome A.
-EOF
-}
-
-teardown() {
-  if [ -n "${WORKSPACE:-}" ] && [ -d "$WORKSPACE" ]; then
-    rm -rf "$WORKSPACE"
-  fi
-}
-
-@test "Related problems: extracts user-business problem citing the JTBD" {
-  cat > docs/problems/open/501-business-problem.md <<'EOF'
----
-type: user-business
-jtbd: [JTBD-999]
-persona: solo-developer
----
-# Problem 501: Business problem citing JTBD-999
-
-**Status**: Open
-
-## Description
-
-Business problem.
-EOF
-
-  run bash "$SCRIPT" docs/jtbd/solo-developer/JTBD-999-sample-job.proposed.md "Related problems"
-  [ "$status" -eq 0 ]
-  grep -q '^## Related problems' docs/jtbd/solo-developer/JTBD-999-sample-job.proposed.md
-  grep -q '| P501 |' docs/jtbd/solo-developer/JTBD-999-sample-job.proposed.md
-}
-
-@test "Related problems: ignores problems that don't cite the JTBD" {
-  cat > docs/problems/open/502-unrelated.md <<'EOF'
----
-type: technical
----
-# Problem 502: Unrelated technical problem
-
-**Status**: Open
-
-## Description
-
-Unrelated.
-EOF
-
-  run bash "$SCRIPT" docs/jtbd/solo-developer/JTBD-999-sample-job.proposed.md "Related problems"
-  [ "$status" -eq 0 ]
-  ! grep -q '^## Related problems' docs/jtbd/solo-developer/JTBD-999-sample-job.proposed.md
-}
-
-@test "Related problems: lazy-empty when no problem cites the JTBD" {
-  cat > docs/problems/open/503-something-else.md <<'EOF'
----
-type: user-business
-jtbd: [JTBD-001]
----
-# Problem 503: Cites a different JTBD
-
-**Status**: Open
-EOF
-
-  run bash "$SCRIPT" docs/jtbd/solo-developer/JTBD-999-sample-job.proposed.md "Related problems"
-  [ "$status" -eq 0 ]
-  ! grep -q '^## Related problems' docs/jtbd/solo-developer/JTBD-999-sample-job.proposed.md
-}
-
-@test "Related problems: searches per-state subdirs (RFC-002 layout)" {
-  cat > docs/problems/known-error/504-business-known-error.md <<'EOF'
----
-type: user-business
-jtbd: [JTBD-999]
-persona: solo-developer
----
-# Problem 504: Known-error business problem
-
-**Status**: Known Error
-EOF
-
-  run bash "$SCRIPT" docs/jtbd/solo-developer/JTBD-999-sample-job.proposed.md "Related problems"
-  [ "$status" -eq 0 ]
-  grep -q '| P504 |' docs/jtbd/solo-developer/JTBD-999-sample-job.proposed.md
-}
-
-@test "Related problems: idempotent across re-runs" {
-  cat > docs/problems/open/505-idempotent.md <<'EOF'
----
-type: user-business
-jtbd: [JTBD-999]
-persona: solo-developer
----
-# Problem 505: Idempotent test
-
-**Status**: Open
-EOF
-
-  run bash "$SCRIPT" docs/jtbd/solo-developer/JTBD-999-sample-job.proposed.md "Related problems"
-  [ "$status" -eq 0 ]
-  before_hash=$(md5 -q docs/jtbd/solo-developer/JTBD-999-sample-job.proposed.md 2>/dev/null || md5sum docs/jtbd/solo-developer/JTBD-999-sample-job.proposed.md | awk '{print $1}')
-
-  run bash "$SCRIPT" docs/jtbd/solo-developer/JTBD-999-sample-job.proposed.md "Related problems"
-  [ "$status" -eq 0 ]
-  after_hash=$(md5 -q docs/jtbd/solo-developer/JTBD-999-sample-job.proposed.md 2>/dev/null || md5sum docs/jtbd/solo-developer/JTBD-999-sample-job.proposed.md | awk '{print $1}')
-
-  [ "$before_hash" = "$after_hash" ]
-}
-
-@test "Related problems: unknown section-name still fails" {
-  run bash "$SCRIPT" docs/jtbd/solo-developer/JTBD-999-sample-job.proposed.md "Bogus Section"
-  [ "$status" -ne 0 ]
-}
-
-@test "Related problems: helper still no per-section-name branch (P4.1 lookup-table-row addition only)" {
-  ! grep -E 'case[[:space:]]+"\$\{?section[_-]?name\}?"|if[[:space:]]+\[[[:space:]]+"\$\{?section[_-]?name\}?"[[:space:]]+=' "$SCRIPT"
-}
-
-@test "Related problems: extracts problem using body-field **JTBD**: convention (capture-problem schema P3.1)" {
-  # P3.1 capture-problem skeleton writes body-field **JTBD**: (matches
-  # existing **Status**: / **Type**: schema); helper must accept both
-  # frontmatter `jtbd:` arrays AND body-field **JTBD**: lines.
-  cat > docs/problems/open/506-body-field-business-problem.md <<'EOF'
-# Problem 506: Body-field business problem
-
-**Status**: Open
-**Reported**: 2026-05-13
-**Type**: user-business
-**JTBD**: JTBD-999
-**Persona**: solo-developer
-
-## Description
-
-Problem captured via Phase 4 P3.1 capture-problem with body-field JTBD trace.
-EOF
-
-  run bash "$SCRIPT" docs/jtbd/solo-developer/JTBD-999-sample-job.proposed.md "Related problems"
-  [ "$status" -eq 0 ]
-  grep -q '| P506 |' docs/jtbd/solo-developer/JTBD-999-sample-job.proposed.md
-}

package/scripts/test/update-problem-references-section.bats

@@ -1,242 +0,0 @@
-#!/usr/bin/env bats
-
-# P170 / Phase 2 Slice 2 — behavioural fixture for the generalised
-# update-problem-references-section.sh helper. Covers polymorphic
-# extraction (HTML data attributes for Story Maps; markdown frontmatter
-# for Stories + RFCs) feeding a uniform markdown-row render into the
-# target problem ticket's ## <section-name> section. Per ADR-060
-# § Phase 2 encoding amendment 2026-05-12 architect finding 4: helper
-# body MUST NOT carry per-section-name branching; section-name is a
-# positional argument; per-extension dispatch is the only branch.
-
-setup() {
-  REPO_ROOT="$(cd "$(dirname "$BATS_TEST_FILENAME")/../../../.." && pwd)"
-  SCRIPT="$REPO_ROOT/packages/itil/scripts/update-problem-references-section.sh"
-
-  # Build an isolated workspace mirroring the docs layout.
-  WORKSPACE="$(mktemp -d)"
-  cd "$WORKSPACE"
-  mkdir -p docs/problems/open docs/rfcs docs/story-maps/in-progress docs/stories/accepted
-
-  # Sample problem ticket
-  cat > docs/problems/open/200-sample-problem.md <<'EOF'
-# Problem 200: Sample problem ticket
-
-**Status**: Open
-**Reported**: 2026-05-12
-
-## Description
-
-Sample description.
-
-## Related
-
-Sibling refs.
-EOF
-
-  # Sample RFC tracing problem 200
-  cat > docs/rfcs/RFC-100-sample-rfc.in-progress.md <<'EOF'
----
-status: in-progress
-rfc-id: sample-rfc
-problems: [P200]
-adrs: []
-jtbd: []
----
-
-# RFC-100: Sample RFC
-EOF
-
-  # Sample HTML story map tracing problem 200
-  cat > docs/story-maps/in-progress/STORY-MAP-050-sample-map.html <<'EOF'
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <title>STORY-MAP-050: Sample map</title>
-  <meta name="story-map-id" content="STORY-MAP-050">
-  <meta name="status" content="in-progress">
-  <meta name="problems" content="P200">
-  <meta name="rfcs" content="RFC-100">
-  <meta name="jtbd" content="JTBD-008">
-</head>
-<body>
-  <h1>STORY-MAP-050: Sample map</h1>
-</body>
-</html>
-EOF
-
-  # Sample markdown story tracing problem 200
-  cat > docs/stories/accepted/STORY-300-sample-story.md <<'EOF'
----
-status: accepted
-story-id: sample-story
-problems: [P200]
-jtbd: [JTBD-008]
-rfcs: [RFC-100]
-story-maps: [STORY-MAP-050]
-estimated-effort: M
----
-
-# STORY-300: Sample story
-EOF
-}
-
-teardown() {
-  rm -rf "$WORKSPACE"
-}
-
-@test "helper: script exists and is executable" {
-  [ -x "$SCRIPT" ]
-}
-
-@test "helper: requires problem-file argument; bare invocation halts" {
-  run bash "$SCRIPT"
-  [ "$status" -ne 0 ]
-}
-
-@test "helper: requires section-name argument" {
-  run bash "$SCRIPT" docs/problems/open/200-sample-problem.md
-  [ "$status" -ne 0 ]
-}
-
-@test "helper: refresh ## RFCs section from docs/rfcs/*.md frontmatter (markdown-extraction path)" {
-  cd "$WORKSPACE"
-  run bash "$SCRIPT" docs/problems/open/200-sample-problem.md RFCs
-  [ "$status" -eq 0 ]
-  grep -q '^## RFCs$' docs/problems/open/200-sample-problem.md
-  grep -q 'RFC-100' docs/problems/open/200-sample-problem.md
-}
-
-@test "helper: refresh ## Story Maps section from docs/story-maps/*.html data attributes (HTML-extraction path)" {
-  cd "$WORKSPACE"
-  run bash "$SCRIPT" docs/problems/open/200-sample-problem.md "Story Maps"
-  [ "$status" -eq 0 ]
-  grep -q '^## Story Maps$' docs/problems/open/200-sample-problem.md
-  grep -q 'STORY-MAP-050' docs/problems/open/200-sample-problem.md
-}
-
-@test "helper: refresh ## Stories section from docs/stories/*.md frontmatter (markdown-extraction path)" {
-  cd "$WORKSPACE"
-  run bash "$SCRIPT" docs/problems/open/200-sample-problem.md Stories
-  [ "$status" -eq 0 ]
-  grep -q '^## Stories$' docs/problems/open/200-sample-problem.md
-  grep -q 'STORY-300' docs/problems/open/200-sample-problem.md
-}
-
-@test "helper: lazy-empty — section removed entirely when no traces match" {
-  cd "$WORKSPACE"
-  # Create a problem ticket nothing references
-  cat > docs/problems/open/201-unreferenced-problem.md <<'EOF'
-# Problem 201: Unreferenced
-
-**Status**: Open
-
-## Related
-
-Some related content.
-
-## Story Maps
-
-| ID | Title |
-|----|-------|
-| STORY-MAP-999 | stale entry |
-EOF
-  run bash "$SCRIPT" docs/problems/open/201-unreferenced-problem.md "Story Maps"
-  [ "$status" -eq 0 ]
-  ! grep -q '^## Story Maps$' docs/problems/open/201-unreferenced-problem.md
-}
-
-@test "helper: idempotent — running twice produces no change on second invocation" {
-  cd "$WORKSPACE"
-  bash "$SCRIPT" docs/problems/open/200-sample-problem.md RFCs
-  local first_hash
-  first_hash=$(md5 -q docs/problems/open/200-sample-problem.md 2>/dev/null || md5sum docs/problems/open/200-sample-problem.md | cut -d' ' -f1)
-  bash "$SCRIPT" docs/problems/open/200-sample-problem.md RFCs
-  local second_hash
-  second_hash=$(md5 -q docs/problems/open/200-sample-problem.md 2>/dev/null || md5sum docs/problems/open/200-sample-problem.md | cut -d' ' -f1)
-  [ "$first_hash" = "$second_hash" ]
-}
-
-@test "helper: HTML path uses literal data-attribute grep (NOT inline-style match)" {
-  # Architect finding 5 (Prohibition reinforcement): the helper MUST
-  # grep on `<meta name="problems" content="...">` literal, not on any
-  # `style=` attribute. Verify by injecting a fake inline-style on a
-  # data-bearing element and asserting the helper's extraction is
-  # unaffected (the prohibition is enforced separately by a doc-lint
-  # bats; this test asserts the helper's parsing is style-agnostic).
-  cd "$WORKSPACE"
-  # The fixture's HTML map already lacks any `style=""` — that's the
-  # canonical shape. The helper must extract the same set whether the
-  # map has style or not. Adding a benign body-level style to the
-  # fixture (NOT on a data-bearing element) and re-running the helper
-  # must yield the same Story Maps section.
-  bash "$SCRIPT" docs/problems/open/200-sample-problem.md "Story Maps"
-  local first_body
-  first_body=$(grep -A 5 '^## Story Maps$' docs/problems/open/200-sample-problem.md)
-  # Inject benign body-level style — NOT on a data-bearing element
-  sed -i.bak 's|<body>|<body style="font-family: sans-serif">|' docs/story-maps/in-progress/STORY-MAP-050-sample-map.html
-  rm -f docs/story-maps/in-progress/STORY-MAP-050-sample-map.html.bak
-  bash "$SCRIPT" docs/problems/open/200-sample-problem.md "Story Maps"
-  local second_body
-  second_body=$(grep -A 5 '^## Story Maps$' docs/problems/open/200-sample-problem.md)
-  [ "$first_body" = "$second_body" ]
-}
-
-@test "helper: multi-line section inserts before ## Fix Released under host awk (P392 BSD-awk getline fix)" {
-  # P392 — the insert-before-## Fix Released branch passed the multi-line
-  # new_section via `awk -v section=...`; BSD awk (macOS) rejects embedded
-  # newlines in a -v assignment and aborts (`awk: newline in string`),
-  # silently dropping the section refresh. This exercises that branch under
-  # the host awk: it must exit 0 AND place the rendered ## RFCs table
-  # immediately before ## Fix Released with the table rows intact.
-  cd "$WORKSPACE"
-  cat > docs/problems/open/202-released-problem.md <<'EOF'
-# Problem 202: Released problem ticket
-
-**Status**: Verifying
-
-## Description
-
-Sample description.
-
-## Fix Released
-
-Released in v1.2.3.
-EOF
-  # RFC tracing problem 202 so a non-empty multi-line section is rendered
-  cat > docs/rfcs/RFC-100-sample-rfc.in-progress.md <<'EOF'
----
-status: in-progress
-rfc-id: sample-rfc
-problems: [P202]
-adrs: []
-jtbd: []
----
-
-# RFC-100: Sample RFC
-EOF
-  run bash "$SCRIPT" docs/problems/open/202-released-problem.md RFCs
-  [ "$status" -eq 0 ]
-  grep -q '^## RFCs$' docs/problems/open/202-released-problem.md
-  grep -q 'RFC-100' docs/problems/open/202-released-problem.md
-  grep -q '^## Fix Released$' docs/problems/open/202-released-problem.md
-  # ## RFCs must precede ## Fix Released (inserted at the anchor, not at EOF)
-  local rfcs_line fix_line
-  rfcs_line=$(grep -n '^## RFCs$' docs/problems/open/202-released-problem.md | cut -d: -f1)
-  fix_line=$(grep -n '^## Fix Released$' docs/problems/open/202-released-problem.md | cut -d: -f1)
-  [ "$rfcs_line" -lt "$fix_line" ]
-  # The multi-line table row must survive intact
-  grep -q '| RFC-100 |' docs/problems/open/202-released-problem.md
-}
-
-@test "helper: body does NOT contain a per-section-name branch (architect finding 4)" {
-  # Structural test (tdd-review: structural-permitted —
-  # justification: P176 SKILL.md I-invariant harness gap is the
-  # canonical pattern for asserting no-branching contracts via
-  # source grep; behavioural enforcement awaits the master harness
-  # at P012). Asserts the helper body does NOT carry a literal
-  # `case "$section_name"` or `if [ "$section_name" = "..." ]`
-  # branch keyed on the section-name value.
-  ! grep -E 'case[[:space:]]+"\$\{?section[_-]?name\}?"|if[[:space:]]+\[[[:space:]]+"\$\{?section[_-]?name\}?"[[:space:]]+=' "$SCRIPT"
-}

package/scripts/test/update-problem-rfcs-section.bats

@@ -1,242 +0,0 @@
-#!/usr/bin/env bats
-
-# @problem P170 — Slice 3 second half (B5.T8): the auto-maintained
-# `## RFCs` section refresh contract on problem ticket bodies. Library
-# helper called inline by /wr-itil:capture-rfc Step 6 and
-# /wr-itil:manage-rfc Step 7+9 so the cross-tier reverse-trace stays
-# current at every commit per ADR-014 single-commit grain.
-#
-# Behavioural per ADR-052: assert on file output state (idempotent
-# table; lazy empty discipline; placement) — not on script source
-# content (no structural greps per P081).
-#
-# Contract (per architect Q3 verdict):
-#   - Section position: between `## Related` and `## Fix Released`
-#     (or at EOF if neither sentinel present).
-#   - Table format: `| RFC | Status | Title |` with separator row.
-#   - Sort: RFC ID asc.
-#   - Lazy empty: zero traced RFCs → section absent (no header,
-#     no `_None._` prose).
-#   - Idempotent: re-run over current state is a no-op (cmp -s holds).
-#
-# @adr ADR-060 (Phase 1 item 10 + Confirmation criterion 3)
-# @adr ADR-052 (behavioural bats default)
-# @adr ADR-022 (`## Fix Released` is the trailing closure section)
-# @jtbd JTBD-008 (Decompose a Fix Into Coordinated Changes — reverse
-#   trace surface)
-# @jtbd JTBD-101 (atomic-fix-adopter friction guard — lazy empty)
-
-setup() {
-  SCRIPTS_DIR="$(cd "$(dirname "$BATS_TEST_FILENAME")/.." && pwd)"
-  HELPER="$SCRIPTS_DIR/update-problem-rfcs-section.sh"
-  RFCS_DIR="$(mktemp -d)"
-  PROBLEMS_DIR="$(mktemp -d)"
-}
-
-teardown() {
-  rm -rf "$RFCS_DIR" "$PROBLEMS_DIR"
-}
-
-write_rfc() {
-  local id="$1" slug="$2" status="$3"
-  local problems="${4:-[P168]}"
-  cat > "$RFCS_DIR/RFC-${id}-${slug}.${status}.md" <<EOF
----
-status: ${status}
-rfc-id: ${slug}
-reported: 2026-05-05
-decision-makers: [test]
-problems: ${problems}
----
-
-# RFC-${id}: ${slug}
-
-stub
-EOF
-}
-
-write_problem() {
-  local num="$1" slug="$2" trailing="${3:-}"
-  local file="$PROBLEMS_DIR/${num}-${slug}.open.md"
-  cat > "$file" <<EOF
-# Problem ${num}: ${slug}
-
-**Status**: Open
-
-## Description
-
-stub
-
-## Related
-
-stub
-EOF
-  if [ -n "$trailing" ]; then
-    printf '\n%s\n' "$trailing" >> "$file"
-  fi
-  echo "$file"
-}
-
-# ── Existence + executable ──────────────────────────────────────────────────
-
-@test "helper exists" {
-  [ -f "$HELPER" ]
-}
-
-@test "helper is executable" {
-  [ -x "$HELPER" ]
-}
-
-# ── Lazy-empty discipline (JTBD-101 friction guard) ─────────────────────────
-
-@test "no RFCs trace → section absent (lazy empty)" {
-  pf=$(write_problem "168" "p168")
-  bash "$HELPER" "$pf" "$RFCS_DIR"
-  ! grep -q '^## RFCs' "$pf"
-}
-
-@test "no RFCs trace and section exists → section removed" {
-  # A pre-existing stale section gets cleaned out when zero RFCs claim.
-  pf=$(write_problem "168" "p168" $'## RFCs\n\n| RFC | Status | Title |\n|-----|--------|-------|\n| RFC-001 | accepted | foo |')
-  bash "$HELPER" "$pf" "$RFCS_DIR"
-  ! grep -q '^## RFCs' "$pf"
-}
-
-# ── Single-RFC trace ────────────────────────────────────────────────────────
-
-@test "one RFC traces P → section appears with one row" {
-  write_rfc "001" "foo" "accepted"
-  pf=$(write_problem "168" "p168")
-  bash "$HELPER" "$pf" "$RFCS_DIR"
-  grep -q '^## RFCs' "$pf"
-  grep -q '| RFC-001 | accepted | foo |' "$pf"
-}
-
-@test "table includes header + separator + data row" {
-  write_rfc "001" "foo" "accepted"
-  pf=$(write_problem "168" "p168")
-  bash "$HELPER" "$pf" "$RFCS_DIR"
-  grep -q '| RFC | Status | Title |' "$pf"
-  grep -q '|-----|--------|-------|' "$pf"
-  grep -q '| RFC-001 | accepted | foo |' "$pf"
-}
-
-# ── Multi-RFC trace + sort order ─────────────────────────────────────────────
-
-@test "multiple RFCs trace P → all rows present, sorted by RFC ID asc" {
-  write_rfc "002" "second" "proposed"
-  write_rfc "001" "first" "accepted"
-  pf=$(write_problem "168" "p168")
-  bash "$HELPER" "$pf" "$RFCS_DIR"
-  # Both rows present.
-  grep -q '| RFC-001 | accepted | first |' "$pf"
-  grep -q '| RFC-002 | proposed | second |' "$pf"
-  # RFC-001 appears before RFC-002.
-  rfc_001_line=$(grep -n '| RFC-001 |' "$pf" | head -1 | cut -d: -f1)
-  rfc_002_line=$(grep -n '| RFC-002 |' "$pf" | head -1 | cut -d: -f1)
-  [ "$rfc_001_line" -lt "$rfc_002_line" ]
-}
-
-# ── Idempotency ─────────────────────────────────────────────────────────────
-
-@test "re-running with no claim change is a no-op (idempotent)" {
-  write_rfc "001" "foo" "accepted"
-  pf=$(write_problem "168" "p168")
-  bash "$HELPER" "$pf" "$RFCS_DIR"
-  hash1=$(shasum "$pf" | cut -d' ' -f1)
-  bash "$HELPER" "$pf" "$RFCS_DIR"
-  hash2=$(shasum "$pf" | cut -d' ' -f1)
-  [ "$hash1" = "$hash2" ]
-}
-
-# ── Status update on existing row ────────────────────────────────────────────
-
-@test "RFC status changes (proposed → accepted) → table row reflects new status" {
-  write_rfc "001" "foo" "proposed"
-  pf=$(write_problem "168" "p168")
-  bash "$HELPER" "$pf" "$RFCS_DIR"
-  grep -q '| RFC-001 | proposed | foo |' "$pf"
-  # Now transition the RFC to accepted (simulate by renaming on disk).
-  mv "$RFCS_DIR/RFC-001-foo.proposed.md" "$RFCS_DIR/RFC-001-foo.accepted.md"
-  bash "$HELPER" "$pf" "$RFCS_DIR"
-  grep -q '| RFC-001 | accepted | foo |' "$pf"
-  # Old status should no longer be present for that RFC row.
-  ! grep -q '| RFC-001 | proposed |' "$pf"
-}
-
-# ── Re-trace add/remove ─────────────────────────────────────────────────────
-
-@test "RFC newly added trace → row appended" {
-  write_rfc "001" "foo" "accepted"
-  pf=$(write_problem "168" "p168")
-  bash "$HELPER" "$pf" "$RFCS_DIR"
-  grep -q '| RFC-001 |' "$pf"
-
-  # Add a second RFC traced to P168.
-  write_rfc "002" "bar" "proposed"
-  bash "$HELPER" "$pf" "$RFCS_DIR"
-  grep -q '| RFC-001 |' "$pf"
-  grep -q '| RFC-002 |' "$pf"
-}
-
-@test "RFC trace removed (frontmatter no longer claims P) → row drops" {
-  write_rfc "001" "foo" "accepted" "[P168]"
-  write_rfc "002" "bar" "proposed" "[P168]"
-  pf=$(write_problem "168" "p168")
-  bash "$HELPER" "$pf" "$RFCS_DIR"
-  grep -q '| RFC-001 |' "$pf"
-  grep -q '| RFC-002 |' "$pf"
-
-  # Re-trace RFC-002 to P169 only.
-  rm -f "$RFCS_DIR/RFC-002-bar.proposed.md"
-  write_rfc "002" "bar" "proposed" "[P169]"
-  bash "$HELPER" "$pf" "$RFCS_DIR"
-  grep -q '| RFC-001 |' "$pf"
-  ! grep -q '| RFC-002 |' "$pf"
-}
-
-# ── Section placement ───────────────────────────────────────────────────────
-
-@test "## RFCs section sits before ## Fix Released when present" {
-  write_rfc "001" "foo" "verifying"
-  pf=$(write_problem "168" "p168" $'## Fix Released\n\nReleased trailer prose.')
-  bash "$HELPER" "$pf" "$RFCS_DIR"
-  rfcs_line=$(grep -n '^## RFCs' "$pf" | head -1 | cut -d: -f1)
-  fix_released_line=$(grep -n '^## Fix Released' "$pf" | head -1 | cut -d: -f1)
-  [ "$rfcs_line" -lt "$fix_released_line" ]
-}
-
-@test "## RFCs section appears at EOF when no ## Fix Released section" {
-  write_rfc "001" "foo" "accepted"
-  pf=$(write_problem "168" "p168")
-  bash "$HELPER" "$pf" "$RFCS_DIR"
-  # ## RFCs is the last `## ` heading in the file.
-  last_section=$(grep -E '^## ' "$pf" | tail -1)
-  [[ "$last_section" == "## RFCs" ]]
-}
-
-# ── Multi-problem RFC composition ────────────────────────────────────────────
-
-@test "RFC tracing two problems updates both ## RFCs sections" {
-  write_rfc "001" "foo" "accepted" "[P168, P169]"
-  pf168=$(write_problem "168" "p168")
-  pf169=$(write_problem "169" "p169")
-  bash "$HELPER" "$pf168" "$RFCS_DIR"
-  bash "$HELPER" "$pf169" "$RFCS_DIR"
-  grep -q '| RFC-001 |' "$pf168"
-  grep -q '| RFC-001 |' "$pf169"
-}
-
-# ── ## Related preservation ─────────────────────────────────────────────────
-
-@test "existing ## Related section is preserved when ## RFCs is added" {
-  write_rfc "001" "foo" "accepted"
-  pf=$(write_problem "168" "p168")
-  bash "$HELPER" "$pf" "$RFCS_DIR"
-  grep -q '^## Related' "$pf"
-  grep -q '^## RFCs' "$pf"
-  related_line=$(grep -n '^## Related' "$pf" | head -1 | cut -d: -f1)
-  rfcs_line=$(grep -n '^## RFCs' "$pf" | head -1 | cut -d: -f1)
-  # ## Related comes before ## RFCs.
-  [ "$related_line" -lt "$rfcs_line" ]
-}