@windyroad/itil 0.61.1 → 0.61.2

package/skills/work-problems/test/work-problems-step-0-iter-error-staleness.bats

@@ -1,93 +0,0 @@
-#!/usr/bin/env bats
-# Contract-assertion bats for work-problems Step 0 session-continuity
-# detection — staleness filter on .afk-run-state/iter-*.json error markers
-# (per P333).
-#
-# Per ADR-037 SKILL.md is a contract document; these assertions check the
-# contract strings the skill prose authoritatively pins for the staleness
-# filter that distinguishes load-bearing partial-work markers from stale
-# residuals. Companion to work-problems-preflight-session-continuity.bats
-# (which covers the broader signal-enumeration + interactive/AFK routing
-# invariants from P109).
-#
-# Cross-reference:
-#   @problem P333 (Step 0 session-continuity has no staleness filter on
-#                  .afk-run-state/iter-*.json error markers — stale residuals
-#                  indefinitely false-positive the halt/ask gate)
-#   @problem P109 (parent session-continuity detection extension)
-#   ADR-019 (AFK orchestrator preflight — extension surface)
-#   ADR-032 (subprocess artefact contract — iter-*.json shape)
-#   ADR-037 (skill testing strategy — contract-assertion framing)
-#   @jtbd JTBD-006 (Progress the Backlog While I'm Away — false-positive
-#                   halts violate the AFK forward-progress outcome)
-
-setup() {
-  SKILL_DIR="$(cd "$(dirname "$BATS_TEST_FILENAME")/.." && pwd)"
-  SKILL_FILE="${SKILL_DIR}/SKILL.md"
-}
-
-@test "SKILL.md exists" {
-  [ -f "$SKILL_FILE" ]
-}
-
-@test "SKILL.md Step 0 cites P333 as the staleness-filter driver" {
-  # Contract criterion: the staleness predicate is traceable to its
-  # driver ticket so a reader can find the failure mode the filter
-  # closes.
-  run grep -nE "P333" "$SKILL_FILE"
-  [ "$status" -eq 0 ]
-}
-
-@test "SKILL.md Step 0 names the staleness filter for iter-*.json markers" {
-  # Contract criterion: the iter-*.json error-marker row names a
-  # staleness / freshness predicate (not merely the is_error /
-  # api_error_status field check).
-  run grep -niE "stale|staleness|freshness|fresh per" "$SKILL_FILE"
-  [ "$status" -eq 0 ]
-}
-
-@test "SKILL.md Step 0 names mtime + HEAD-commit-time as the staleness primitive" {
-  # Contract criterion: the staleness predicate is specified as mtime
-  # vs HEAD-commit-time (the engineering primitive). The "more
-  # permissive of two" disjunction is asserted in a sibling test below.
-  run grep -niE "mtime" "$SKILL_FILE"
-  [ "$status" -eq 0 ]
-  run grep -niE "HEAD.commit|HEAD's commit|commit.time" "$SKILL_FILE"
-  [ "$status" -eq 0 ]
-}
-
-@test "SKILL.md Step 0 names the 24h fallback for the staleness predicate" {
-  # Contract criterion: the "OR within 24h" disjunction protects the
-  # fresh-repo-no-commits-since-marker edge case.
-  run grep -niE "24h|24 hour|last 24" "$SKILL_FILE"
-  [ "$status" -eq 0 ]
-}
-
-@test "SKILL.md Step 0 names the silent-skip directive for stale residuals" {
-  # Contract criterion: the action on stale-classified markers is
-  # silent-skip, not halt-with-report. This is the directional
-  # asymmetry the contract pins (fresh = halt, stale = skip).
-  run grep -niE "skip.*silent|silently.*skip|silent skip" "$SKILL_FILE"
-  [ "$status" -eq 0 ]
-}
-
-@test "SKILL.md Step 0 retains the is_error / api_error_status field names alongside the staleness filter" {
-  # Contract criterion: the existing P109 signal field-name contract
-  # MUST coexist with the new staleness predicate — the staleness
-  # filter narrows the load-bearing signal, it does not replace the
-  # field check.
-  run grep -niE "is_error.*true|api_error_status" "$SKILL_FILE"
-  [ "$status" -eq 0 ]
-}
-
-@test "SKILL.md Step 0 names the iter-summary annotation for skipped stale markers" {
-  # Contract criterion per JTBD-006 audit-trail outcome (line 34 of
-  # docs/jtbd/developer/JTBD-006.md): "every action taken during AFK
-  # mode should be traceable via git history and the progress
-  # summary". A silent-skip without an iter-summary annotation drops
-  # an action from the audit trail; the contract names the annotation
-  # shape so a stale-skipped-but-actually-load-bearing marker is
-  # recoverable on user return.
-  run grep -niE "stale iter.error|stale.*marker.*skip|iter.error.markers? skipped" "$SKILL_FILE"
-  [ "$status" -eq 0 ]
-}

package/skills/work-problems/test/work-problems-step-0b-cache-staleness-behavioural.bats

@@ -1,138 +0,0 @@
-#!/usr/bin/env bats
-
-# Step 0b behavioural fixture per ADR-062 § JTBD-006 driver:
-# work-problems pre-flights /wr-itil:review-problems when the
-# upstream inbound-discovery cache is stale or missing. The
-# staleness decision lives in
-# `packages/itil/lib/check-upstream-cache-staleness.sh::should_promote_inbound_discovery_preflight`
-# so the SKILL.md Step 0b prose is a thin source-and-call wrapper
-# around a behaviorally-testable shell function (P081 / user
-# feedback: prefer behavioural over structural-grep tests).
-#
-# Cases covered:
-#   1. No channels-config file → "no-channels-config" (downstream-adopter non-obligation, ADR-062 § Downstream-adopter contract).
-#   2. Channels-config present, cache file absent → "first-run-cache-absent".
-#   3. Channels-config present, cache present, last_checked null → "first-run-last-checked-null".
-#   4. Channels-config present, cache fresh within TTL → "fresh-within-ttl".
-#   5. Channels-config present, cache older than TTL → "ttl-expiry" (with age + ttl in the reason).
-#   6. Custom ttl_seconds in channels-config is respected (not hardcoded default).
-
-setup() {
-  REPO_ROOT="$(cd "$(dirname "$BATS_TEST_FILENAME")/../../../../.." && pwd)"
-  HELPER="$REPO_ROOT/packages/itil/lib/check-upstream-cache-staleness.sh"
-
-  FIXTURE="$(mktemp -d)"
-  mkdir -p "$FIXTURE/docs/problems"
-}
-
-teardown() {
-  rm -rf "$FIXTURE"
-}
-
-@test "helper exists at the contracted path" {
-  [ -f "$HELPER" ]
-}
-
-@test "case 1: no channels-config → no-channels-config" {
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_inbound_discovery_preflight "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [ "$output" = "no-channels-config" ]
-}
-
-@test "case 2: channels-config present, cache absent → first-run-cache-absent" {
-  cat > "$FIXTURE/docs/problems/.upstream-channels.json" <<'EOF'
-{ "channels": [], "ttl_seconds": 86400 }
-EOF
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_inbound_discovery_preflight "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [ "$output" = "first-run-cache-absent" ]
-}
-
-@test "case 3: cache present, last_checked null → first-run-last-checked-null" {
-  cat > "$FIXTURE/docs/problems/.upstream-channels.json" <<'EOF'
-{ "channels": [], "ttl_seconds": 86400 }
-EOF
-  cat > "$FIXTURE/docs/problems/.upstream-cache.json" <<'EOF'
-{ "last_checked": null, "channels": [] }
-EOF
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_inbound_discovery_preflight "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [ "$output" = "first-run-last-checked-null" ]
-}
-
-@test "case 4: cache fresh within TTL → fresh-within-ttl (silent-pass)" {
-  cat > "$FIXTURE/docs/problems/.upstream-channels.json" <<'EOF'
-{ "channels": [], "ttl_seconds": 86400 }
-EOF
-  # last_checked 1 hour ago — well within 24h TTL.
-  local recent_iso
-  recent_iso="$(python3 -c "import datetime; print((datetime.datetime.now(datetime.timezone.utc) - datetime.timedelta(hours=1)).strftime('%Y-%m-%dT%H:%M:%SZ'))")"
-  cat > "$FIXTURE/docs/problems/.upstream-cache.json" <<EOF
-{ "last_checked": "$recent_iso", "channels": [] }
-EOF
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_inbound_discovery_preflight "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [ "$output" = "fresh-within-ttl" ]
-}
-
-@test "case 5: cache older than TTL → ttl-expiry with age + ttl in the reason" {
-  cat > "$FIXTURE/docs/problems/.upstream-channels.json" <<'EOF'
-{ "channels": [], "ttl_seconds": 86400 }
-EOF
-  # last_checked 2 days ago — past 24h TTL.
-  local stale_iso
-  stale_iso="$(python3 -c "import datetime; print((datetime.datetime.now(datetime.timezone.utc) - datetime.timedelta(days=2)).strftime('%Y-%m-%dT%H:%M:%SZ'))")"
-  cat > "$FIXTURE/docs/problems/.upstream-cache.json" <<EOF
-{ "last_checked": "$stale_iso", "channels": [] }
-EOF
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_inbound_discovery_preflight "$FIXTURE"
-  [ "$status" -eq 0 ]
-  # Format: "ttl-expiry age=<N>s ttl=<M>s"
-  [[ "$output" =~ ^ttl-expiry\ age=[0-9]+s\ ttl=86400s$ ]]
-}
-
-@test "case 6: custom ttl_seconds is honored (not hardcoded default)" {
-  # 1-hour TTL; last_checked 90 minutes ago → stale under the custom TTL,
-  # but would be FRESH under the 86400s default. Confirms the helper reads
-  # ttl_seconds from channels-config rather than hardcoding 86400.
-  cat > "$FIXTURE/docs/problems/.upstream-channels.json" <<'EOF'
-{ "channels": [], "ttl_seconds": 3600 }
-EOF
-  local mid_iso
-  mid_iso="$(python3 -c "import datetime; print((datetime.datetime.now(datetime.timezone.utc) - datetime.timedelta(minutes=90)).strftime('%Y-%m-%dT%H:%M:%SZ'))")"
-  cat > "$FIXTURE/docs/problems/.upstream-cache.json" <<EOF
-{ "last_checked": "$mid_iso", "channels": [] }
-EOF
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_inbound_discovery_preflight "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [[ "$output" =~ ^ttl-expiry\ age=[0-9]+s\ ttl=3600s$ ]]
-}
-
-@test "case 7: missing ttl_seconds field defaults to 86400 (24h)" {
-  cat > "$FIXTURE/docs/problems/.upstream-channels.json" <<'EOF'
-{ "channels": [] }
-EOF
-  # last_checked 1 hour ago — fresh under the default 86400s TTL.
-  local recent_iso
-  recent_iso="$(python3 -c "import datetime; print((datetime.datetime.now(datetime.timezone.utc) - datetime.timedelta(hours=1)).strftime('%Y-%m-%dT%H:%M:%SZ'))")"
-  cat > "$FIXTURE/docs/problems/.upstream-cache.json" <<EOF
-{ "last_checked": "$recent_iso", "channels": [] }
-EOF
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_inbound_discovery_preflight "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [ "$output" = "fresh-within-ttl" ]
-}

package/skills/work-problems/test/work-problems-step-0c-deferred-placeholder-staleness-behavioural.bats

@@ -1,238 +0,0 @@
-#!/usr/bin/env bats
-
-# Step 0c behavioural fixture per P271:
-# work-problems pre-flights /wr-itil:review-problems when deferred-placeholder
-# tickets accumulate AND the docs/problems/README.md "Last reviewed" line is
-# stale. Mirrors the Step 0b cache-staleness shape (helper-in-lib + 5-outcome
-# enum + behavioural bats) so the SKILL.md Step 0c prose stays a thin
-# source-and-call wrapper around a behaviorally-testable shell function.
-#
-# Trigger rule — two-axis AND per P271 § Recommended fix shape (architect
-# Condition 2 — both axes are load-bearing; either alone over-fires):
-#   - count of deferred-placeholder tickets ≥ 3 (signal: there is work to
-#     re-rate), AND
-#   - README.md "Last reviewed" line-3 age > 7 days (signal: cadence has
-#     slipped).
-#
-# Cases covered:
-#   1. No deferred placeholders → "no-deferred-placeholders"
-#   2. Count below threshold (1 or 2) → "below-threshold count=<N> threshold=3"
-#   3. Count ≥ 3 + README absent → "no-readme count=<N>"
-#   4. Count ≥ 3 + README fresh (< 7 days) → "fresh-readme count=<N> age=<X>s threshold=<Y>s"
-#   5. Count ≥ 3 + README stale (> 7 days) → "stale-readme count=<N> age=<X>s threshold=<Y>s"
-#   6. Dual-tolerant glob (per ADR-031 RFC-002 migration window — both flat
-#      docs/problems/<NNN>-*.<state>.md AND per-state docs/problems/<state>/<NNN>-*.md
-#      contribute to count)
-
-setup() {
-  REPO_ROOT="$(cd "$(dirname "$BATS_TEST_FILENAME")/../../../../.." && pwd)"
-  HELPER="$REPO_ROOT/packages/itil/lib/check-deferred-placeholder-staleness.sh"
-
-  FIXTURE="$(mktemp -d)"
-  mkdir -p "$FIXTURE/docs/problems/open"
-  mkdir -p "$FIXTURE/docs/problems/known-error"
-}
-
-teardown() {
-  rm -rf "$FIXTURE"
-}
-
-# Helper — write a problem ticket with the deferred-placeholder marker.
-write_deferred_ticket() {
-  local path="$1"
-  cat > "$path" <<'EOF'
-# Problem 999: test
-
-**Status**: Open
-**Priority**: 3 (Medium) — Impact: 3 x Likelihood: 1 (deferred — re-rate at next /wr-itil:review-problems)
-**Effort**: M (deferred — re-rate at next /wr-itil:review-problems)
-
-## Description
-
-test fixture
-EOF
-}
-
-# Helper — write a non-deferred (already-rated) ticket.
-write_rated_ticket() {
-  local path="$1"
-  cat > "$path" <<'EOF'
-# Problem 998: test
-
-**Status**: Open
-**Priority**: 6 (Medium) — Impact: 3 x Likelihood: 2
-**Effort**: S
-
-## Description
-
-test fixture
-EOF
-}
-
-# Helper — write a README.md with a known "Last reviewed" date on line 3.
-write_readme_with_date() {
-  local path="$1"
-  local iso_date="$2"
-  cat > "$path" <<EOF
-# Problem Backlog
-
-> Last reviewed: $iso_date **review** — test fixture
-> Run \`/wr-itil:review-problems\` to refresh WSJF rankings.
-
-## WSJF Rankings
-EOF
-}
-
-@test "helper exists at the contracted path" {
-  [ -f "$HELPER" ]
-}
-
-@test "case 1: no deferred placeholders → no-deferred-placeholders" {
-  write_rated_ticket "$FIXTURE/docs/problems/open/001-foo.md"
-  write_rated_ticket "$FIXTURE/docs/problems/open/002-bar.md"
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_review_problems_dispatch "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [ "$output" = "no-deferred-placeholders" ]
-}
-
-@test "case 2: count below threshold (1) → below-threshold" {
-  write_deferred_ticket "$FIXTURE/docs/problems/open/001-foo.md"
-  write_rated_ticket "$FIXTURE/docs/problems/open/002-bar.md"
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_review_problems_dispatch "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [[ "$output" =~ ^below-threshold\ count=1\ threshold=3$ ]]
-}
-
-@test "case 2b: count below threshold (2) → below-threshold" {
-  write_deferred_ticket "$FIXTURE/docs/problems/open/001-foo.md"
-  write_deferred_ticket "$FIXTURE/docs/problems/open/002-bar.md"
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_review_problems_dispatch "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [[ "$output" =~ ^below-threshold\ count=2\ threshold=3$ ]]
-}
-
-@test "case 3: count ≥ 3 + README absent → no-readme (first-run dispatch trigger)" {
-  write_deferred_ticket "$FIXTURE/docs/problems/open/001-foo.md"
-  write_deferred_ticket "$FIXTURE/docs/problems/open/002-bar.md"
-  write_deferred_ticket "$FIXTURE/docs/problems/open/003-baz.md"
-  # No README written.
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_review_problems_dispatch "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [[ "$output" =~ ^no-readme\ count=3$ ]]
-}
-
-@test "case 4: count ≥ 3 + README fresh (< 7 days) → fresh-readme silent-pass" {
-  write_deferred_ticket "$FIXTURE/docs/problems/open/001-foo.md"
-  write_deferred_ticket "$FIXTURE/docs/problems/open/002-bar.md"
-  write_deferred_ticket "$FIXTURE/docs/problems/open/003-baz.md"
-  # README dated 3 days ago — fresh under 7-day threshold.
-  local recent_iso
-  recent_iso="$(python3 -c "import datetime; print((datetime.datetime.now(datetime.timezone.utc) - datetime.timedelta(days=3)).strftime('%Y-%m-%d'))")"
-  write_readme_with_date "$FIXTURE/docs/problems/README.md" "$recent_iso"
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_review_problems_dispatch "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [[ "$output" =~ ^fresh-readme\ count=3\ age=[0-9]+s\ threshold=604800s$ ]]
-}
-
-@test "case 5: count ≥ 3 + README stale (> 7 days) → stale-readme (dispatch trigger)" {
-  write_deferred_ticket "$FIXTURE/docs/problems/open/001-foo.md"
-  write_deferred_ticket "$FIXTURE/docs/problems/open/002-bar.md"
-  write_deferred_ticket "$FIXTURE/docs/problems/open/003-baz.md"
-  # README dated 14 days ago — stale under 7-day threshold.
-  local stale_iso
-  stale_iso="$(python3 -c "import datetime; print((datetime.datetime.now(datetime.timezone.utc) - datetime.timedelta(days=14)).strftime('%Y-%m-%d'))")"
-  write_readme_with_date "$FIXTURE/docs/problems/README.md" "$stale_iso"
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_review_problems_dispatch "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [[ "$output" =~ ^stale-readme\ count=3\ age=[0-9]+s\ threshold=604800s$ ]]
-}
-
-@test "case 6: dual-tolerant glob — per-state subdir layout (ADR-031 post-migration)" {
-  # Per-state subdir tickets (post-RFC-002-migration shape — the dominant
-  # shape in this monorepo).
-  write_deferred_ticket "$FIXTURE/docs/problems/open/100-foo.md"
-  write_deferred_ticket "$FIXTURE/docs/problems/open/101-bar.md"
-  write_deferred_ticket "$FIXTURE/docs/problems/known-error/102-baz.md"
-  # No README → first-run dispatch.
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_review_problems_dispatch "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [[ "$output" =~ ^no-readme\ count=3$ ]]
-}
-
-@test "case 6b: dual-tolerant glob — flat layout (ADR-031 pre-migration window)" {
-  # Flat-layout tickets (pre-RFC-002-migration shape — the legacy shape).
-  write_deferred_ticket "$FIXTURE/docs/problems/200-foo.open.md"
-  write_deferred_ticket "$FIXTURE/docs/problems/201-bar.open.md"
-  write_deferred_ticket "$FIXTURE/docs/problems/202-baz.known-error.md"
-  # No README → first-run dispatch.
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_review_problems_dispatch "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [[ "$output" =~ ^no-readme\ count=3$ ]]
-}
-
-@test "case 6c: dual-tolerant glob — mixed layout (RFC-002 migration in progress)" {
-  # Mixed-layout tickets — both shapes contribute to the count.
-  write_deferred_ticket "$FIXTURE/docs/problems/open/100-foo.md"
-  write_deferred_ticket "$FIXTURE/docs/problems/200-bar.open.md"
-  write_deferred_ticket "$FIXTURE/docs/problems/known-error/300-baz.md"
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_review_problems_dispatch "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [[ "$output" =~ ^no-readme\ count=3$ ]]
-}
-
-@test "case 7: README missing 'Last reviewed' line → no-readme (defensive fallback)" {
-  write_deferred_ticket "$FIXTURE/docs/problems/open/001-foo.md"
-  write_deferred_ticket "$FIXTURE/docs/problems/open/002-bar.md"
-  write_deferred_ticket "$FIXTURE/docs/problems/open/003-baz.md"
-  # README exists but no "Last reviewed:" marker on line 3.
-  cat > "$FIXTURE/docs/problems/README.md" <<'EOF'
-# Problem Backlog
-
-Some other line that does not have the Last reviewed marker.
-
-## WSJF Rankings
-EOF
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_review_problems_dispatch "$FIXTURE"
-  [ "$status" -eq 0 ]
-  # Defensive: parse failure routes to no-readme (forces a fresh dispatch
-  # rather than silently silent-passing on malformed README).
-  [[ "$output" =~ ^no-readme\ count=3$ ]]
-}
-
-@test "case 8: closed and verifying tickets do NOT contribute to count" {
-  # Only open + known-error tickets are eligible re-rate candidates.
-  # .verifying.md and .closed.md tickets carry no WSJF (excluded from
-  # dev-work ranking per ADR-022); their deferred-placeholders must not
-  # influence the dispatch.
-  mkdir -p "$FIXTURE/docs/problems/closed"
-  mkdir -p "$FIXTURE/docs/problems/verifying"
-  write_deferred_ticket "$FIXTURE/docs/problems/closed/100-foo.md"
-  write_deferred_ticket "$FIXTURE/docs/problems/verifying/101-bar.md"
-  write_deferred_ticket "$FIXTURE/docs/problems/open/102-baz.md"
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_review_problems_dispatch "$FIXTURE"
-  [ "$status" -eq 0 ]
-  # Only the open/ ticket counts → below threshold.
-  [[ "$output" =~ ^below-threshold\ count=1\ threshold=3$ ]]
-}

package/skills/work-problems/test/work-problems-step-0d-outbound-responses-staleness-behavioural.bats

@@ -1,174 +0,0 @@
-#!/usr/bin/env bats
-
-# Step 0d behavioural fixture per P220 + ADR-062 § JTBD-006 driver:
-# work-problems pre-flights /wr-itil:check-upstream-responses when the
-# outbound-responses cache is stale or missing AND there exist local
-# tickets carrying `## Reported Upstream` back-link sections. The
-# staleness decision lives in
-# `packages/itil/lib/check-outbound-responses-staleness.sh::should_promote_outbound_responses_preflight`
-# so the SKILL.md Step 0d prose is a thin source-and-call wrapper
-# around a behaviorally-testable shell function (P081 / user feedback:
-# prefer behavioural over structural-grep tests).
-#
-# Cases covered (symmetric to Step 0b cases plus the back-link discovery
-# axis that replaces channels-config):
-#   1. No tickets with `## Reported Upstream` section → "no-back-link-tickets"
-#      (downstream-adopter non-obligation; analogue to no-channels-config).
-#   2. Back-link ticket present, cache absent → "first-run-cache-absent".
-#   3. Back-link ticket present, cache present, last_checked null → "first-run-last-checked-null".
-#   4. Back-link ticket present, cache fresh within TTL → "fresh-within-ttl".
-#   5. Back-link ticket present, cache older than TTL → "ttl-expiry" (with age + ttl in the reason).
-#   6. Custom ttl_seconds in cache honored (not hardcoded default).
-#   7. Missing ttl_seconds field defaults to 86400 (24h symmetric with inbound).
-
-setup() {
-  REPO_ROOT="$(cd "$(dirname "$BATS_TEST_FILENAME")/../../../../.." && pwd)"
-  HELPER="$REPO_ROOT/packages/itil/lib/check-outbound-responses-staleness.sh"
-
-  FIXTURE="$(mktemp -d)"
-  mkdir -p "$FIXTURE/docs/problems"
-}
-
-teardown() {
-  rm -rf "$FIXTURE"
-}
-
-# Helper: write a back-link ticket fixture under docs/problems/.
-_write_backlink_ticket() {
-  local ticket_path="$1"
-  cat > "$ticket_path" <<'EOF'
-# Problem 999: example back-link fixture
-
-**Status**: Open
-
-## Description
-
-Fixture for Step 0d behavioural test.
-
-## Reported Upstream
-
-- **Repo**: example/upstream
-- **URL**: https://github.com/example/upstream/issues/999
-- **Filed**: 2026-06-08
-EOF
-}
-
-@test "helper exists at the contracted path" {
-  [ -f "$HELPER" ]
-}
-
-@test "case 1: no back-link tickets → no-back-link-tickets" {
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_outbound_responses_preflight "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [ "$output" = "no-back-link-tickets" ]
-}
-
-@test "case 1b: tickets without ## Reported Upstream section → no-back-link-tickets" {
-  cat > "$FIXTURE/docs/problems/100-no-back-link.open.md" <<'EOF'
-# Problem 100: no upstream link
-
-## Description
-
-Local-only ticket.
-EOF
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_outbound_responses_preflight "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [ "$output" = "no-back-link-tickets" ]
-}
-
-@test "case 2: back-link ticket present, cache absent → first-run-cache-absent" {
-  _write_backlink_ticket "$FIXTURE/docs/problems/100-back-link.open.md"
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_outbound_responses_preflight "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [ "$output" = "first-run-cache-absent" ]
-}
-
-@test "case 2b: back-link in per-state subdir layout (RFC-002) is discovered" {
-  mkdir -p "$FIXTURE/docs/problems/known-error"
-  _write_backlink_ticket "$FIXTURE/docs/problems/known-error/220-cadence-gap.md"
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_outbound_responses_preflight "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [ "$output" = "first-run-cache-absent" ]
-}
-
-@test "case 3: cache present, last_checked null → first-run-last-checked-null" {
-  _write_backlink_ticket "$FIXTURE/docs/problems/100-back-link.open.md"
-  cat > "$FIXTURE/docs/problems/.outbound-responses-cache.json" <<'EOF'
-{ "last_checked": null, "tickets": {} }
-EOF
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_outbound_responses_preflight "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [ "$output" = "first-run-last-checked-null" ]
-}
-
-@test "case 4: cache fresh within TTL → fresh-within-ttl (silent-pass)" {
-  _write_backlink_ticket "$FIXTURE/docs/problems/100-back-link.open.md"
-  # last_checked 1 hour ago — well within 24h default TTL.
-  local recent_iso
-  recent_iso="$(python3 -c "import datetime; print((datetime.datetime.now(datetime.timezone.utc) - datetime.timedelta(hours=1)).strftime('%Y-%m-%dT%H:%M:%SZ'))")"
-  cat > "$FIXTURE/docs/problems/.outbound-responses-cache.json" <<EOF
-{ "last_checked": "$recent_iso", "tickets": {} }
-EOF
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_outbound_responses_preflight "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [ "$output" = "fresh-within-ttl" ]
-}
-
-@test "case 5: cache older than TTL → ttl-expiry with age + ttl in the reason" {
-  _write_backlink_ticket "$FIXTURE/docs/problems/100-back-link.open.md"
-  # last_checked 2 days ago — past 24h default TTL.
-  local stale_iso
-  stale_iso="$(python3 -c "import datetime; print((datetime.datetime.now(datetime.timezone.utc) - datetime.timedelta(days=2)).strftime('%Y-%m-%dT%H:%M:%SZ'))")"
-  cat > "$FIXTURE/docs/problems/.outbound-responses-cache.json" <<EOF
-{ "last_checked": "$stale_iso", "tickets": {} }
-EOF
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_outbound_responses_preflight "$FIXTURE"
-  [ "$status" -eq 0 ]
-  # Format: "ttl-expiry age=<N>s ttl=<M>s"
-  [[ "$output" =~ ^ttl-expiry\ age=[0-9]+s\ ttl=86400s$ ]]
-}
-
-@test "case 6: custom ttl_seconds in cache is honored (not hardcoded default)" {
-  # 1-hour TTL; last_checked 90 minutes ago → stale under the custom TTL,
-  # but would be FRESH under the 86400s default. Confirms the helper reads
-  # ttl_seconds from cache rather than hardcoding 86400.
-  _write_backlink_ticket "$FIXTURE/docs/problems/100-back-link.open.md"
-  local mid_iso
-  mid_iso="$(python3 -c "import datetime; print((datetime.datetime.now(datetime.timezone.utc) - datetime.timedelta(minutes=90)).strftime('%Y-%m-%dT%H:%M:%SZ'))")"
-  cat > "$FIXTURE/docs/problems/.outbound-responses-cache.json" <<EOF
-{ "last_checked": "$mid_iso", "tickets": {}, "ttl_seconds": 3600 }
-EOF
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_outbound_responses_preflight "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [[ "$output" =~ ^ttl-expiry\ age=[0-9]+s\ ttl=3600s$ ]]
-}
-
-@test "case 7: missing ttl_seconds defaults to 86400 (symmetric with inbound)" {
-  _write_backlink_ticket "$FIXTURE/docs/problems/100-back-link.open.md"
-  local recent_iso
-  recent_iso="$(python3 -c "import datetime; print((datetime.datetime.now(datetime.timezone.utc) - datetime.timedelta(hours=1)).strftime('%Y-%m-%dT%H:%M:%SZ'))")"
-  cat > "$FIXTURE/docs/problems/.outbound-responses-cache.json" <<EOF
-{ "last_checked": "$recent_iso", "tickets": {} }
-EOF
-  # shellcheck disable=SC1090
-  source "$HELPER"
-  run should_promote_outbound_responses_preflight "$FIXTURE"
-  [ "$status" -eq 0 ]
-  [ "$output" = "fresh-within-ttl" ]
-}