@windyroad/itil 0.61.1 → 0.61.2

package/scripts/test/kind-a-commands.bats

@@ -1,46 +0,0 @@
-#!/usr/bin/env bats
-# P317 / RFC-009 T2 + ADR-049: the KIND A wrapper commands resolve their
-# canonical lib RELATIVE TO THE SCRIPT (`$(dirname)/../lib`), so they work in an
-# adopter install — not just the source monorepo where `source packages/...`
-# happened to resolve. Behavioural: simulate an install tree, invoke from a
-# FOREIGN cwd, assert clean lib resolution.
-
-setup() {
-  REPO_ROOT="$(cd "$(dirname "$BATS_TEST_FILENAME")/../../../.." && pwd)"
-  INSTALL="$(mktemp -d)"
-  mkdir -p "$INSTALL/scripts" "$INSTALL/lib" "$INSTALL/bin"
-  cp "$REPO_ROOT/packages/itil/scripts/run-migrate-problems-layout.sh" "$INSTALL/scripts/" 2>/dev/null || true
-  cp "$REPO_ROOT/packages/itil/scripts/run-check-upstream-cache-staleness.sh" "$INSTALL/scripts/" 2>/dev/null || true
-  cp "$REPO_ROOT/packages/itil/bin/wr-itil-migrate-problems-layout" "$INSTALL/bin/" 2>/dev/null || true
-  cp "$REPO_ROOT/packages/itil/bin/wr-itil-check-upstream-cache-staleness" "$INSTALL/bin/" 2>/dev/null || true
-  cp "$REPO_ROOT"/packages/itil/lib/*.sh "$INSTALL/lib/" 2>/dev/null || true
-  FOREIGN="$(mktemp -d)"   # adopter repo cwd — no packages/ tree
-}
-
-teardown() {
-  rm -rf "$INSTALL" "$FOREIGN"
-}
-
-@test "wr-itil-migrate-problems-layout resolves its lib from a foreign cwd, no-ops on empty dir (P317)" {
-  cd "$FOREIGN"
-  run bash "$INSTALL/bin/wr-itil-migrate-problems-layout" "$FOREIGN"
-  [ "$status" -eq 0 ]
-  [[ "$output" != *"No such file"* ]]
-  [[ "$output" != *"command not found"* ]]
-}
-
-@test "wr-itil-check-upstream-cache-staleness resolves its lib from a foreign cwd (P317)" {
-  cd "$FOREIGN"
-  run bash "$INSTALL/bin/wr-itil-check-upstream-cache-staleness" "$FOREIGN"
-  [ "$status" -eq 0 ]
-  [[ "$output" != *"No such file"* ]]
-  [[ "$output" != *"command not found"* ]]
-  [[ "$output" != *"migrate_problems_to_per_state_layout: command not found"* ]]
-}
-
-@test "the direct script (not just the shim) also resolves its lib from a foreign cwd (P317)" {
-  cd "$FOREIGN"
-  run bash "$INSTALL/scripts/run-migrate-problems-layout.sh" "$FOREIGN"
-  [ "$status" -eq 0 ]
-  [[ "$output" != *"No such file"* ]]
-}

package/scripts/test/mark-create-gate.bats

@@ -1,59 +0,0 @@
-#!/usr/bin/env bats
-# P317 / RFC-009 T1 + ADR-049: the create-gate marker commands resolve their
-# sibling libs RELATIVE TO THE SCRIPT (adopter-safe), not relative to cwd. The
-# bug they fix: SKILLs did `source packages/itil/hooks/lib/*.sh`, which only
-# resolves in the source monorepo and breaks in adopter installs.
-#
-# Behavioural — simulates an adopter install by copying the shipped script +
-# lib tree to a temp dir in the SAME relative layout, then invokes from a
-# FOREIGN cwd (an "adopter repo" with no packages/ tree) and asserts success.
-
-setup() {
-  REPO_ROOT="$(cd "$(dirname "$BATS_TEST_FILENAME")/../../../.." && pwd)"
-  INSTALL="$(mktemp -d)"
-  mkdir -p "$INSTALL/scripts" "$INSTALL/hooks/lib" "$INSTALL/bin"
-  cp "$REPO_ROOT/packages/itil/scripts/mark-create-gate.sh" "$INSTALL/scripts/" 2>/dev/null || true
-  cp "$REPO_ROOT/packages/itil/scripts/mark-rfc-capture-gate.sh" "$INSTALL/scripts/" 2>/dev/null || true
-  cp "$REPO_ROOT/packages/itil/bin/wr-itil-mark-create-gate" "$INSTALL/bin/" 2>/dev/null || true
-  cp "$REPO_ROOT/packages/itil/bin/wr-itil-mark-rfc-capture-gate" "$INSTALL/bin/" 2>/dev/null || true
-  cp "$REPO_ROOT"/packages/itil/hooks/lib/*.sh "$INSTALL/hooks/lib/" 2>/dev/null || true
-  FOREIGN="$(mktemp -d)"   # an adopter repo cwd — no packages/ tree
-  MARKERS="$(mktemp -d)"   # empty announce-marker dir so candidates = CLAUDE_SESSION_ID only
-  SID="p317-test-$$-${RANDOM}"
-}
-
-teardown() {
-  rm -rf "$INSTALL" "$FOREIGN" "$MARKERS"
-  rm -f "/tmp/manage-problem-grep-$SID" "/tmp/wr-itil-rfc-capture-grep-$SID"
-}
-
-@test "mark-create-gate.sh runs from a foreign cwd, resolving libs from its own location (P317)" {
-  cd "$FOREIGN"
-  run env CLAUDE_SESSION_ID="$SID" SESSION_MARKER_DIR="$MARKERS" bash "$INSTALL/scripts/mark-create-gate.sh"
-  [ "$status" -eq 0 ]
-  [[ "$output" != *"No such file"* ]]
-  [[ "$output" != *"command not found"* ]]
-  [ -f "/tmp/manage-problem-grep-$SID" ]
-}
-
-@test "wr-itil-mark-create-gate shim dispatches the script from a foreign cwd (P317/ADR-049)" {
-  cd "$FOREIGN"
-  run env CLAUDE_SESSION_ID="$SID" SESSION_MARKER_DIR="$MARKERS" bash "$INSTALL/bin/wr-itil-mark-create-gate"
-  [ "$status" -eq 0 ]
-  [ -f "/tmp/manage-problem-grep-$SID" ]
-}
-
-@test "mark-rfc-capture-gate.sh writes the RFC-tier marker from a foreign cwd (P317)" {
-  cd "$FOREIGN"
-  run env CLAUDE_SESSION_ID="$SID" SESSION_MARKER_DIR="$MARKERS" bash "$INSTALL/scripts/mark-rfc-capture-gate.sh"
-  [ "$status" -eq 0 ]
-  [[ "$output" != *"No such file"* ]]
-  [ -f "/tmp/wr-itil-rfc-capture-grep-$SID" ]
-}
-
-@test "wr-itil-mark-rfc-capture-gate shim dispatches from a foreign cwd (P317/ADR-049)" {
-  cd "$FOREIGN"
-  run env CLAUDE_SESSION_ID="$SID" SESSION_MARKER_DIR="$MARKERS" bash "$INSTALL/bin/wr-itil-mark-rfc-capture-gate"
-  [ "$status" -eq 0 ]
-  [ -f "/tmp/wr-itil-rfc-capture-grep-$SID" ]
-}

package/scripts/test/mark-story-oversight-confirmed.bats

@@ -1,53 +0,0 @@
-#!/usr/bin/env bats
-# Behavioural test for mark-story-oversight-confirmed.sh (ADR-090 ratify write-path).
-# Writes `confirmed` + the content fingerprint into a story (md frontmatter) or a
-# story-map (HTML meta). After marking, is_story_map_ratified is true; a later
-# content edit drifts it back to not-ratified.
-#
-# @adr ADR-090
-# @problem P404 (Phase 2)
-
-setup() {
-  REPO_ROOT="$(cd "$(dirname "$BATS_TEST_FILENAME")/../../../.." && pwd)"
-  SCRIPT="${REPO_ROOT}/packages/itil/scripts/mark-story-oversight-confirmed.sh"
-  # shellcheck source=/dev/null
-  source "${REPO_ROOT}/packages/itil/lib/story-oversight.sh"
-  TMPD="$(mktemp -d)"
-}
-teardown() { rm -rf "$TMPD"; }
-
-@test "mark: md story with no marker → ratified after mark" {
-  printf -- '---\nstatus: accepted\n---\n# body\n' > "$TMPD/s.md"
-  run bash "$SCRIPT" "$TMPD/s.md"; [ "$status" -eq 0 ]
-  run is_story_map_ratified "$TMPD/s.md"; [ "$status" -eq 0 ]
-}
-
-@test "mark: md story with existing unconfirmed marker → confirmed + ratified" {
-  printf -- '---\nstatus: accepted\nhuman-oversight: unconfirmed\n---\n# body\n' > "$TMPD/s.md"
-  bash "$SCRIPT" "$TMPD/s.md"
-  grep -qE '^human-oversight:[[:space:]]*confirmed' "$TMPD/s.md"
-  run is_story_map_ratified "$TMPD/s.md"; [ "$status" -eq 0 ]
-  # no duplicate marker line left behind
-  [ "$(grep -cE '^human-oversight:' "$TMPD/s.md")" -eq 1 ]
-}
-
-@test "mark: idempotent — marking twice stays ratified, single marker" {
-  printf -- '---\nstatus: accepted\n---\n# body\n' > "$TMPD/s.md"
-  bash "$SCRIPT" "$TMPD/s.md"; bash "$SCRIPT" "$TMPD/s.md"
-  run is_story_map_ratified "$TMPD/s.md"; [ "$status" -eq 0 ]
-  [ "$(grep -cE '^oversight-hash:' "$TMPD/s.md")" -eq 1 ]
-}
-
-@test "mark: drift — mark then edit body → not ratified" {
-  printf -- '---\nstatus: accepted\n---\n# body\n' > "$TMPD/s.md"
-  bash "$SCRIPT" "$TMPD/s.md"
-  printf -- '---\nstatus: accepted\nhuman-oversight: confirmed\n---\n# body EDITED\n' > "$TMPD/s.md"
-  run is_story_map_ratified "$TMPD/s.md"; [ "$status" -ne 0 ]
-}
-
-@test "mark: HTML map → ratified after mark" {
-  printf -- '<!doctype html>\n<head><title>map</title></head>\n<body><h1>map</h1></body>\n' > "$TMPD/m.html"
-  run bash "$SCRIPT" "$TMPD/m.html"; [ "$status" -eq 0 ]
-  grep -qE '<meta[^>]*name="human-oversight"[^>]*content="confirmed"' "$TMPD/m.html"
-  run is_story_map_ratified "$TMPD/m.html"; [ "$status" -eq 0 ]
-}

package/scripts/test/migrate-problems-add-type.bats

@@ -1,280 +0,0 @@
-#!/usr/bin/env bats
-
-# @problem P170 — Slice 4 B7.T2 (item 8b): bulk-migrate existing
-# problem tickets to the type-tag schema with default `type: technical`.
-# Script-driven, idempotent, no per-ticket judgement (per ADR-060
-# § Type-tag schema migration line; architect finding 10 split).
-#
-# @adr ADR-060 (type-tag schema introduction; Phase 1 item 8b)
-# @adr ADR-052 (behavioural bats default; observable file-state
-#   assertions, not source greps per P081)
-# @adr ADR-014 (single-purpose script; one mechanical migration)
-#
-# Contract:
-#   - Input: a problems-dir containing `<NNN>-*.<status>.md` files.
-#   - Diagnose mode (default): exit 0 if every ticket carries
-#     `**Type**: <value>` body field; exit 1 if any ticket needs
-#     migration (tickets needing migration listed on stdout, one per
-#     line, ≤150 bytes per ADR-038 progressive disclosure budget).
-#   - Apply mode (--apply flag): inserts `**Type**: technical` after
-#     the LAST present body field marker among
-#     `**Status**` / `**Reported**` / `**Priority**` / `**Effort**` /
-#     `**WSJF**`. Idempotent (re-running is no-op).
-#   - Tickets with no recognisable header field block are skipped with
-#     a `SKIP` line on stderr (does not fail the run).
-#   - Default value: `technical` per ADR-060 line 92.
-
-setup() {
-  SCRIPTS_DIR="$(cd "$(dirname "$BATS_TEST_FILENAME")/.." && pwd)"
-  SCRIPT="$SCRIPTS_DIR/migrate-problems-add-type.sh"
-  FIXTURE_DIR="$(mktemp -d)"
-}
-
-teardown() {
-  rm -rf "$FIXTURE_DIR"
-}
-
-write_ticket() {
-  local id="$1" slug="$2" status="$3" body="$4"
-  local file="$FIXTURE_DIR/${id}-${slug}.${status}.md"
-  printf '%s' "$body" > "$file"
-  echo "$file"
-}
-
-# ── Existence + executable ──────────────────────────────────────────────────
-
-@test "migrate-problems-add-type: script exists" {
-  [ -f "$SCRIPT" ]
-}
-
-@test "migrate-problems-add-type: script is executable" {
-  [ -x "$SCRIPT" ]
-}
-
-# ── Diagnose mode (default) ──────────────────────────────────────────────────
-
-@test "diagnose: exit 0 when every ticket already carries Type field" {
-  write_ticket "100" "foo" "open" "$(cat <<'EOF'
-# Problem 100: Foo
-
-**Status**: Open
-**Type**: technical
-EOF
-)"
-  run bash "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 0 ]
-}
-
-@test "diagnose: exit 1 when at least one ticket lacks Type field" {
-  write_ticket "100" "foo" "open" "$(cat <<'EOF'
-# Problem 100: Foo
-
-**Status**: Open
-**WSJF**: 5.0
-EOF
-)"
-  run bash "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 1 ]
-}
-
-@test "diagnose: lists each ticket needing migration on stdout" {
-  write_ticket "100" "foo" "open" "$(cat <<'EOF'
-# Problem 100: Foo
-
-**Status**: Open
-**WSJF**: 5.0
-EOF
-)"
-  write_ticket "101" "bar" "closed" "$(cat <<'EOF'
-# Problem 101: Bar
-
-**Status**: Closed
-**Priority**: 6
-EOF
-)"
-  run bash "$SCRIPT" "$FIXTURE_DIR"
-  [ "$status" -eq 1 ]
-  echo "$output" | grep -q '100-foo'
-  echo "$output" | grep -q '101-bar'
-}
-
-@test "diagnose: read-only — does not mutate any ticket file" {
-  ticket=$(write_ticket "100" "foo" "open" "$(cat <<'EOF'
-# Problem 100: Foo
-
-**Status**: Open
-**WSJF**: 5.0
-EOF
-)")
-  hash_before=$(shasum "$ticket" | cut -d' ' -f1)
-  run bash "$SCRIPT" "$FIXTURE_DIR"
-  hash_after=$(shasum "$ticket" | cut -d' ' -f1)
-  [ "$hash_before" = "$hash_after" ]
-}
-
-# ── Apply mode (--apply) ─────────────────────────────────────────────────────
-
-@test "apply: inserts Type: technical after WSJF line when WSJF present" {
-  ticket=$(write_ticket "100" "foo" "open" "$(cat <<'EOF'
-# Problem 100: Foo
-
-**Status**: Open
-**WSJF**: 5.0
-
-## Description
-EOF
-)")
-  run bash "$SCRIPT" --apply "$FIXTURE_DIR"
-  [ "$status" -eq 0 ]
-  grep -q '^\*\*Type\*\*: technical$' "$ticket"
-  # Type sits AFTER WSJF (highest field marker present).
-  wsjf_line=$(grep -n '^\*\*WSJF\*\*:' "$ticket" | head -1 | cut -d: -f1)
-  type_line=$(grep -n '^\*\*Type\*\*:' "$ticket" | head -1 | cut -d: -f1)
-  [ "$type_line" -gt "$wsjf_line" ]
-}
-
-@test "apply: inserts Type after Effort when WSJF absent" {
-  ticket=$(write_ticket "100" "foo" "open" "$(cat <<'EOF'
-# Problem 100: Foo
-
-**Status**: Open
-**Reported**: 2026-01-01
-**Priority**: 6
-**Effort**: M
-
-## Description
-EOF
-)")
-  run bash "$SCRIPT" --apply "$FIXTURE_DIR"
-  [ "$status" -eq 0 ]
-  effort_line=$(grep -n '^\*\*Effort\*\*:' "$ticket" | head -1 | cut -d: -f1)
-  type_line=$(grep -n '^\*\*Type\*\*:' "$ticket" | head -1 | cut -d: -f1)
-  [ "$type_line" -gt "$effort_line" ]
-}
-
-@test "apply: inserts Type after Priority when WSJF + Effort absent" {
-  ticket=$(write_ticket "100" "foo" "closed" "$(cat <<'EOF'
-# Problem 100: Foo
-
-**Status**: Closed
-**Priority**: 6
-
-## Description
-EOF
-)")
-  run bash "$SCRIPT" --apply "$FIXTURE_DIR"
-  [ "$status" -eq 0 ]
-  priority_line=$(grep -n '^\*\*Priority\*\*:' "$ticket" | head -1 | cut -d: -f1)
-  type_line=$(grep -n '^\*\*Type\*\*:' "$ticket" | head -1 | cut -d: -f1)
-  [ "$type_line" -gt "$priority_line" ]
-}
-
-@test "apply: idempotent — re-running with Type already present is no-op" {
-  ticket=$(write_ticket "100" "foo" "open" "$(cat <<'EOF'
-# Problem 100: Foo
-
-**Status**: Open
-**WSJF**: 5.0
-
-## Description
-EOF
-)")
-  bash "$SCRIPT" --apply "$FIXTURE_DIR"
-  hash1=$(shasum "$ticket" | cut -d' ' -f1)
-  bash "$SCRIPT" --apply "$FIXTURE_DIR"
-  hash2=$(shasum "$ticket" | cut -d' ' -f1)
-  [ "$hash1" = "$hash2" ]
-}
-
-@test "apply: default value is 'technical'" {
-  ticket=$(write_ticket "100" "foo" "open" "$(cat <<'EOF'
-# Problem 100: Foo
-
-**Status**: Open
-**WSJF**: 5.0
-EOF
-)")
-  bash "$SCRIPT" --apply "$FIXTURE_DIR"
-  grep -q '^\*\*Type\*\*: technical$' "$ticket"
-  ! grep -q '^\*\*Type\*\*: user-business$' "$ticket"
-}
-
-@test "apply: handles all five lifecycle file extensions" {
-  i=100
-  for state in open known-error verifying parked closed; do
-    write_ticket "$i" "t-${state}" "$state" "$(cat <<EOF
-# Problem $i: stub
-
-**Status**: stub
-**WSJF**: 5.0
-EOF
-)" > /dev/null
-    i=$((i+1))
-  done
-  bash "$SCRIPT" --apply "$FIXTURE_DIR"
-  count=$(grep -l '^\*\*Type\*\*: technical$' "$FIXTURE_DIR"/*.md | wc -l | tr -d ' ')
-  [ "$count" -eq 5 ]
-}
-
-@test "apply: preserves all original content (line-count grows by exactly 1 per migrated ticket)" {
-  # Use printf with explicit trailing newline to mirror real ticket-file
-  # convention (POSIX text-file trailing newline). awk normalizes EOF
-  # to a trailing newline; fixture must match so the +1-line invariant
-  # holds.
-  ticket="$FIXTURE_DIR/100-foo.open.md"
-  printf '%s\n' \
-    '# Problem 100: Foo' \
-    '' \
-    '**Status**: Open' \
-    '**WSJF**: 5.0' \
-    '' \
-    '## Description' \
-    '' \
-    'Body text line.' \
-    '' \
-    '## Related' \
-    '' \
-    'stub' > "$ticket"
-  before=$(wc -l < "$ticket" | tr -d ' ')
-  bash "$SCRIPT" --apply "$FIXTURE_DIR"
-  after=$(wc -l < "$ticket" | tr -d ' ')
-  [ "$after" -eq "$((before + 1))" ]
-  # Original content sentinels survive.
-  grep -q '^# Problem 100: Foo$' "$ticket"
-  grep -q '^## Description$' "$ticket"
-  grep -q '^Body text line\.$' "$ticket"
-  grep -q '^## Related$' "$ticket"
-}
-
-# ── Skip / malformed handling ────────────────────────────────────────────────
-
-@test "apply: skips ticket with no recognisable header field block (warning to stderr)" {
-  ticket=$(write_ticket "100" "foo" "open" "$(cat <<'EOF'
-# Problem 100: Foo
-
-Just a body, no field markers at all.
-EOF
-)")
-  hash_before=$(shasum "$ticket" | cut -d' ' -f1)
-  run bash "$SCRIPT" --apply "$FIXTURE_DIR"
-  [ "$status" -eq 0 ]
-  hash_after=$(shasum "$ticket" | cut -d' ' -f1)
-  [ "$hash_before" = "$hash_after" ]
-  # SKIP marker on stderr.
-  echo "$output" | grep -qi 'skip'
-}
-
-# ── Default problems-dir ─────────────────────────────────────────────────────
-
-@test "diagnose: defaults problems-dir to ./docs/problems when no arg given" {
-  cd "$FIXTURE_DIR"
-  mkdir -p docs/problems
-  cat > docs/problems/100-foo.open.md <<'EOF'
-# Problem 100: Foo
-
-**Status**: Open
-**Type**: technical
-EOF
-  run bash "$SCRIPT"
-  [ "$status" -eq 0 ]
-}

package/scripts/test/migrate-story-status-mirror.bats

@@ -1,167 +0,0 @@
-#!/usr/bin/env bats
-# Behavioural tests for migrate-story-status-mirror.sh — the P474 one-time
-# migration that removes the redundant `**Status**:` body mirror from story
-# artefacts and carries their existing ratification forward.
-#
-# Why the mirror goes rather than getting normalised out of the hash: the body
-# line only repeats the frontmatter `status:` the fingerprint already excludes,
-# and every mirror discovered otherwise costs another normaliser rule (this was
-# the fourth in a family of three). Maintainer direction 2026-07-29 — kill the
-# class, not the instance.
-#
-# The load-bearing safety property is that this RE-FINGERPRINTS, never
-# RE-RATIFIES. `human-oversight: confirmed` records that a human confirmed
-# something and is never written here; `oversight-hash` only identifies WHICH
-# content that confirmation covered. Recomputing it over content whose only
-# delta is an excluded mechanical mirror removes zero ratified substance. The
-# `stored == hash(before)` gate is what makes that provable per artefact — drop
-# the gate and this becomes a blanket re-bless, i.e. the P348 hollow-marker
-# class.
-#
-# @problem P474  @adr ADR-090 ADR-101
-
-setup() {
-  SCRIPTS="$(cd "$(dirname "$BATS_TEST_FILENAME")/.." && pwd)"
-  MIGRATE="$SCRIPTS/migrate-story-status-mirror.sh"
-  # shellcheck source=/dev/null
-  source "$SCRIPTS/../lib/story-oversight.sh"
-  TMPD="$(mktemp -d)"; cd "$TMPD"
-  mkdir -p docs/stories/draft docs/stories/accepted
-}
-teardown() { cd /; rm -rf "$TMPD"; }
-
-# Independent mode probe for assertions. Shape-validated for the same reason the
-# script's own helper is: GNU `stat -f` prints a filesystem blob with exit 0, so
-# an exit-status-only chain silently accepts garbage as a mode.
-mode_of() {
-  local m
-  for m in "$(stat -c %a "$1" 2>/dev/null)" "$(stat -f %Lp "$1" 2>/dev/null)"; do
-    case "$m" in [0-7][0-7][0-7] | [0-7][0-7][0-7][0-7]) printf '%s' "$m"; return 0 ;; esac
-  done
-  printf 'UNKNOWN'
-}
-
-# Write a story whose stored hash is valid for its current content.
-seed_ratified() {
-  local path="$1" fm_status="$2" body_status="$3"
-  printf -- '---\nstatus: %s\nstory-id: x\nhuman-oversight: confirmed\noversight-hash: PLACEHOLDER\n---\n\n# STORY-901: a story\n\n**Status**: %s\n**Reported**: 2026-07-29\n\n## User value\n\nvalue prose.\n\n## Acceptance criteria\n\n- [ ] a criterion\n' \
-    "$fm_status" "$body_status" > "$path"
-  local h; h="$(oversight_content_hash "$path")"
-  sed -i.bak "s/oversight-hash: PLACEHOLDER/oversight-hash: $h/" "$path" && rm -f "$path.bak"
-}
-
-@test "removes the body Status mirror when it agrees with frontmatter" {
-  seed_ratified docs/stories/draft/STORY-901-x.md draft draft
-  run bash "$MIGRATE" docs/stories
-  [ "$status" -eq 0 ]
-  ! grep -qE '^\*\*Status\*\*:' docs/stories/draft/STORY-901-x.md
-  # Everything else survives.
-  grep -q '^\*\*Reported\*\*: 2026-07-29' docs/stories/draft/STORY-901-x.md
-  grep -q 'value prose.' docs/stories/draft/STORY-901-x.md
-}
-
-@test "a currently-ratified story is still ratified after migration" {
-  seed_ratified docs/stories/draft/STORY-901-x.md draft draft
-  run is_story_map_ratified docs/stories/draft/STORY-901-x.md
-  [ "$status" -eq 0 ]
-  run bash "$MIGRATE" docs/stories
-  [ "$status" -eq 0 ]
-  run is_story_map_ratified docs/stories/draft/STORY-901-x.md
-  [ "$status" -eq 0 ]
-}
-
-# The whole point: after migration, the accept transition must stop drifting.
-@test "after migration an accept transition does NOT drift the hash" {
-  seed_ratified docs/stories/draft/STORY-901-x.md draft draft
-  bash "$MIGRATE" docs/stories
-  # Advance status the way manage-story does: frontmatter + a criterion tick.
-  sed -i.bak 's/^status: draft/status: accepted/; s/- \[ \] a criterion/- [x] a criterion/' \
-    docs/stories/draft/STORY-901-x.md && rm -f docs/stories/draft/STORY-901-x.md.bak
-  run is_story_map_ratified docs/stories/draft/STORY-901-x.md
-  [ "$status" -eq 0 ]
-}
-
-@test "SKIPS and REPORTS a story whose body Status carries extra information" {
-  # `superseded (was: draft)` and `in-progress (2026-07-23)` both exist in the
-  # real corpus — the line is carrying provenance the frontmatter does not, so
-  # deleting it would lose content rather than de-duplicate it.
-  seed_ratified docs/stories/draft/STORY-902-y.md superseded 'superseded (was: draft)'
-  run bash "$MIGRATE" docs/stories
-  [ "$status" -eq 0 ]
-  grep -qE '^\*\*Status\*\*: superseded \(was: draft\)' docs/stories/draft/STORY-902-y.md
-  [[ "$output" == *"STORY-902"* ]]
-  [[ "$output" == *"disagree"* ]] || [[ "$output" == *"SKIP"* ]]
-}
-
-@test "does NOT revive an already-drifted story" {
-  seed_ratified docs/stories/draft/STORY-903-z.md draft draft
-  # Real substance edit after ratification → drifted before migration runs.
-  printf '\nAn edit made after ratification.\n' >> docs/stories/draft/STORY-903-z.md
-  run is_story_map_ratified docs/stories/draft/STORY-903-z.md
-  [ "$status" -ne 0 ]
-  run bash "$MIGRATE" docs/stories
-  [ "$status" -eq 0 ]
-  run is_story_map_ratified docs/stories/draft/STORY-903-z.md
-  [ "$status" -ne 0 ]
-}
-
-@test "never writes human-oversight — an unconfirmed story stays unconfirmed" {
-  printf -- '---\nstatus: draft\nhuman-oversight: unconfirmed\n---\n\n# STORY-904\n\n**Status**: draft\n\n## User value\n\nv.\n' \
-    > docs/stories/draft/STORY-904-w.md
-  run bash "$MIGRATE" docs/stories
-  [ "$status" -eq 0 ]
-  grep -q '^human-oversight: unconfirmed' docs/stories/draft/STORY-904-w.md
-  ! grep -q '^human-oversight: confirmed' docs/stories/draft/STORY-904-w.md
-}
-
-# ADR-101: the post-hoc drain finds AFK-accepted stories via oversight-basis.
-# Migration must not strip it, or those stories stop surfacing for review.
-@test "preserves oversight-basis so the ADR-101 post-hoc drain still finds it" {
-  seed_ratified docs/stories/accepted/STORY-905-v.md accepted accepted
-  printf -- '%s\n' "$(sed 's/^human-oversight: confirmed/human-oversight: confirmed\noversight-basis: pure-decomposition/' docs/stories/accepted/STORY-905-v.md)" \
-    > docs/stories/accepted/STORY-905-v.md
-  run bash "$MIGRATE" docs/stories
-  [ "$status" -eq 0 ]
-  grep -q '^oversight-basis: pure-decomposition' docs/stories/accepted/STORY-905-v.md
-}
-
-@test "is idempotent — a second run changes nothing" {
-  seed_ratified docs/stories/draft/STORY-901-x.md draft draft
-  bash "$MIGRATE" docs/stories
-  cp docs/stories/draft/STORY-901-x.md /tmp/after-first-$$.md
-  run bash "$MIGRATE" docs/stories
-  [ "$status" -eq 0 ]
-  diff /tmp/after-first-$$.md docs/stories/draft/STORY-901-x.md
-  rm -f /tmp/after-first-$$.md
-}
-
-@test "leaves README.md alone — it documents the template, it is not a story" {
-  printf -- '# Stories\n\n**Status**: <status>\n\nTemplate docs.\n' > docs/stories/README.md
-  run bash "$MIGRATE" docs/stories
-  [ "$status" -eq 0 ]
-  grep -qE '^\*\*Status\*\*: <status>' docs/stories/README.md
-  [[ "$output" != *"README.md"* ]]
-}
-
-@test "reports the touched set so the re-fingerprint is auditable" {
-  seed_ratified docs/stories/draft/STORY-901-x.md draft draft
-  run bash "$MIGRATE" docs/stories
-  [ "$status" -eq 0 ]
-  [[ "$output" == *"STORY-901"* ]]
-}
-
-# The migration writes via mktemp+mv, and mktemp creates 0600. Without an
-# explicit mode carry-over every migrated story loses its group/other read bit.
-# `chmod --reference` is GNU-only, so the portable stat read is what makes this
-# hold on darwin — where the earlier --reference form silently fell through to a
-# hardcoded 644 while the call site claimed to preserve the mode.
-@test "preserves the story file's mode across the rewrite" {
-  seed_ratified docs/stories/draft/STORY-906-mode.md draft draft
-  chmod 640 docs/stories/draft/STORY-906-mode.md
-  before="$(mode_of docs/stories/draft/STORY-906-mode.md)"
-  [ "$before" = "640" ]
-  run bash "$MIGRATE" docs/stories
-  [ "$status" -eq 0 ]
-  after="$(mode_of docs/stories/draft/STORY-906-mode.md)"
-  [ "$after" = "640" ]
-}