@windyroad/itil 1.2.0 → 2.0.0-preview.1111

package/scripts/effort-tally.sh

@@ -1,16 +1,16 @@
 #!/usr/bin/env bash
-# wr-itil — per-ticket effort tally from AFK iteration cost metadata (ADR-067, P248)
+# wr-itil — per-ticket effort tally from AFK iteration cost metadata (cost-based-wsjf-effort-capture-time-cost-actuals-tally-per-ticket-retro-driven-rms-calibration-tally-first-architecture-rule, use-time-and-token-cost-not-t-shirt-sizing-for-wsjf-effort-with-retro-driven-estimation-refinement-problem)
 #
-# @jtbd JTBD-006 (Progress the Backlog While I'm Away — AFK actuals feed WSJF calibration + audit trail)
-# @jtbd JTBD-202 (Run Pre-Flight Governance Checks — structured, auditable effort tally)
+# @jtbd progress-the-backlog-while-i-m-away-user-outcome (Progress the Backlog While I'm Away — AFK actuals feed WSJF calibration + audit trail)
+# @jtbd run-pre-flight-governance-checks-before-release-or-handover-user-outcome (Run Pre-Flight Governance Checks — structured, auditable effort tally)
 #
 # Attributes `.afk-run-state/iter*.json` actuals back to their source ticket
 # (the `pNNN` token in the filename) and emits the `## Effort Tally` schema. The
 # reusable core shared by:
-#   - the backfill (seed historical tickets — ADR-067 Decision Outcome item 4)
-#   - go-forward per-iter append (work-problems — ADR-067 item 2)
+#   - the backfill (seed historical tickets — cost-based-wsjf-effort-capture-time-cost-actuals-tally-per-ticket-retro-driven-rms-calibration-tally-first-architecture-rule Decision Outcome item 4)
+#   - go-forward per-iter append (work-problems — cost-based-wsjf-effort-capture-time-cost-actuals-tally-per-ticket-retro-driven-rms-calibration-tally-first-architecture-rule item 2)
 #
-# Authority hierarchy (P089 Gap 2 — load-bearing): `total_cost_usd` is the
+# Authority hierarchy (problem-089-work-problems-step-5-dispatch-has-two-robustness-gaps-stdin-warning-pollutes-json-output-and-cost-metadata-undercounts-when-subprocess-exits-via-background-task-notification-ack-problem Gap 2 — load-bearing): `total_cost_usd` is the
 # AUTHORITATIVE actual (session-cumulative by CLI contract; reliable token-spend
 # proxy). `duration_ms` is reliable wall-clock. Raw `usage.*` token counts are
 # BEST-EFFORT (undercount when a subprocess exits on a background-ack turn) and
@@ -26,15 +26,15 @@
 #     Idempotently inject/replace that section in the ticket file (lazy-empty:
 #     zero iters → section removed). Mirrors update-problem-references-section.sh.
 #
-#   --source defaults to afk-backfill (ADR-067 item 2a — every row generated from
+#   --source defaults to afk-backfill (cost-based-wsjf-effort-capture-time-cost-actuals-tally-per-ticket-retro-driven-rms-calibration-tally-first-architecture-rule item 2a — every row generated from
 #   pre-existing .afk-run-state data is a historical backfill until a go-forward
 #   per-iter append wires `--source live-iter`).
 #
-# Phase bucketing (ADR-067 item 2 — RCA vs RFC): derived from the ticket's
+# Phase bucketing (cost-based-wsjf-effort-capture-time-cost-actuals-tally-per-ticket-retro-driven-rms-calibration-tally-first-architecture-rule item 2 — RCA vs RFC): derived from the ticket's
 # **Status** body line — `Open` → RCA, anything else → RFC.
 #   ponytail: single-phase attribution; a ticket that accrued iters while Open
 #   then more while Known Error buckets ALL iters to its current phase. Named
-#   upgrade path = per-iter git-log status discrimination (ADR-067 item 2 Phase
+#   upgrade path = per-iter git-log status discrimination (cost-based-wsjf-effort-capture-time-cost-actuals-tally-per-ticket-retro-driven-rms-calibration-tally-first-architecture-rule item 2 Phase
 #   2 design). Correct for the common single-phase case; the ceiling travels in
 #   the AUTO-GENERATED marker below.
 #
@@ -157,7 +157,7 @@ if [ -n "$line" ]; then
   tokens="$(echo "$line"  | sed -E 's/.*tokens=~([0-9.]+M).*/\1/')"
   new_section="## Effort Tally"$'\n\n'
   new_section+="<!-- AUTO-GENERATED by wr-itil-effort-tally; do not hand-edit. source: ${SOURCE}."$'\n'
-  new_section+="     Phase bucketed from current **Status** (single-phase ceiling — ADR-067 item 2). -->"$'\n\n'
+  new_section+="     Phase bucketed from current **Status** (single-phase ceiling — cost-based-wsjf-effort-capture-time-cost-actuals-tally-per-ticket-retro-driven-rms-calibration-tally-first-architecture-rule item 2). -->"$'\n\n'
   new_section+="| Phase | Iters | Cost (USD, authoritative) | Time (min) | Tokens (best-effort) |"$'\n'
   new_section+="|---|---|---|---|---|"$'\n'
   new_section+="| ${PHASE} | ${iters} | \$${cost} | ${minutes} | ~${tokens} |"$'\n'

package/scripts/evaluate-relevance.sh

@@ -2,8 +2,8 @@
 # packages/itil/scripts/evaluate-relevance.sh
 #
 # Evaluate whether a problem ticket has become "no longer relevant" by
-# checking observable evidence per ADR-026 grounding. Implements 5
-# evidence shapes per ADR-079 (Phase 1 + Phase 2):
+# checking observable evidence per agent-output-grounding-no-fabricated-quantitative-estimates-cite-persist-uncertainty-architecture-rule grounding. Implements 5
+# evidence shapes per evidence-based-relevance-close-pass-for-the-problem-backlog-phase-1-file-no-longer-exists-phase-2-adr-shipped-confirmed-named-skill-exists-self-marker-in-body-driver-child-closed-phase-1-false-positive-fixes-architecture-rule (Phase 1 + Phase 2):
 #
 #   Shape 1 — file-no-longer-exists  (Phase 1, original)
 #   Shape 2 — ADR-shipped with `human-oversight: confirmed`  (Phase 2)
@@ -12,9 +12,9 @@
 #   Shape 5 — driver-child-ticket-closed  (Phase 2)
 #
 # Phase 1 false-positive fixes (Phase 2):
-#   - state-suffix detection (P180): per-state subdirs + .<state>.md
-#   - sibling-file detection (P244): dir-glob slug-prefix
-#   - rename detection (P251): git log --follow --diff-filter=AD
+#   - state-suffix detection (agent-defers-mitigation-selection-to-user-during-active-incident-surfaces-mitigation-choice-as-user-authority-when-skill-contract-empowers-agent-driven-reversible-mitigations-problem): per-state subdirs + .<state>.md
+#   - sibling-file detection (phase-3-f9-wr-itil-plugin-maturity-list-in-suite-display-shim-reads-installed-plugins-plugin-json-maturity-field-emits-ndjson-per-surface-rollup-per-plugin-problem): dir-glob slug-prefix
+#   - rename detection (rfc-first-trace-invariant-not-enforced-fixes-start-without-rfc-story-map-or-jtbd-trace-problem): git log --follow --diff-filter=AD
 #
 # Usage:
 #   evaluate-relevance.sh <ticket-file> [<min-age-days>]
@@ -35,13 +35,13 @@
 #   2 = SKIP
 #   3 = error
 #
-# Set LC_ALL=C for portable byte-grep per P328 (BSD grep on macOS
+# Set LC_ALL=C for portable byte-grep per bsd-grep-sed-awk-on-macos-silently-fail-or-error-on-utf-8-without-lc-all-en-us-utf-8-problem (BSD grep on macOS
 # silently misbehaves on UTF-8 without an explicit locale).
 #
-# ADR-049: invoked via the `wr-itil-evaluate-relevance` PATH shim.
-# ADR-026: every CLOSE-CANDIDATE verdict cites the evidence per shape.
-# ADR-052: behavioural bats at scripts/test/evaluate-relevance.bats.
-# ADR-079: design (Phase 1 + Phase 2).
+# plugin-bundled-scripts-invoked-from-skill-md-resolve-via-bin-on-path-architecture-rule: invoked via the `wr-itil-evaluate-relevance` PATH shim.
+# agent-output-grounding-no-fabricated-quantitative-estimates-cite-persist-uncertainty-architecture-rule: every CLOSE-CANDIDATE verdict cites the evidence per shape.
+# behavioural-tests-default-for-skill-testing-architecture-rule: behavioural bats at scripts/test/evaluate-relevance.bats.
+# evidence-based-relevance-close-pass-for-the-problem-backlog-phase-1-file-no-longer-exists-phase-2-adr-shipped-confirmed-named-skill-exists-self-marker-in-body-driver-child-closed-phase-1-false-positive-fixes-architecture-rule: design (Phase 1 + Phase 2).
 
 set -euo pipefail
 export LC_ALL=C
@@ -96,7 +96,7 @@ path_exists() {
   return 1
 }
 
-# Detect state-suffix variants of an incident/problem/RFC path (P180 fix).
+# Detect state-suffix variants of an incident/problem/RFC path (agent-defers-mitigation-selection-to-user-during-active-incident-surfaces-mitigation-choice-as-user-authority-when-skill-contract-empowers-agent-driven-reversible-mitigations-problem fix).
 # Given a path like `docs/incidents/I002-foo.investigating.md`, also checks
 # `docs/incidents/I002-foo.{restored,mitigating,closed}.md`. Returns 0 if
 # any sibling state-suffix variant exists.
@@ -108,7 +108,7 @@ state_suffix_variant_exists() {
   # Strip trailing .<state>.md to a slug-prefix and recombine with each
   # state. Conservative — only fires for paths in docs/incidents/,
   # docs/problems/, docs/rfcs/, docs/stories/, docs/story-maps/ where the
-  # state-suffix convention applies (ADR-031 / ADR-060).
+  # state-suffix convention applies (problem-ticket-directory-layout-per-state-subdirectories-under-docs-problems-architecture-rule / problem-rfc-story-framework-with-mandatory-problem-trace-and-unified-problem-ontology-architecture-rule).
   case "$dir" in
     docs/incidents|docs/problems|docs/problems/*|docs/rfcs|docs/rfcs/*|docs/stories|docs/stories/*|docs/story-maps|docs/story-maps/*)
       ;;
@@ -122,7 +122,7 @@ state_suffix_variant_exists() {
   if [ "$slug" = "$base" ]; then
     return 1
   fi
-  # Also try the per-state subdir layout (RFC-002 migration window).
+  # Also try the per-state subdir layout (docs-problems-flat-layout-migration-per-state-subdirs-adopter-auto-migration-release-design migration window).
   local parent
   parent=$(dirname "$dir")
   local entity
@@ -152,7 +152,7 @@ state_suffix_variant_exists() {
 }
 
 # Detect sibling files with similar slug-prefix in the same parent dir
-# (P244 fix). Given `packages/foo/scripts/bar-list.sh`, finds
+# (phase-3-f9-wr-itil-plugin-maturity-list-in-suite-display-shim-reads-installed-plugins-plugin-json-maturity-field-emits-ndjson-per-surface-rollup-per-plugin-problem fix). Given `packages/foo/scripts/bar-list.sh`, finds
 # `packages/foo/scripts/bar-render.sh` / `bar-populate.sh` etc.
 # Returns 0 (and echoes the matched sibling) if a sibling exists.
 sibling_file_exists() {
@@ -195,7 +195,7 @@ sibling_file_exists() {
   return 1
 }
 
-# Detect rename via git log --follow (P251 fix). Returns 0 (and echoes the
+# Detect rename via git log --follow (rfc-first-trace-invariant-not-enforced-fixes-start-without-rfc-story-map-or-jtbd-trace-problem fix). Returns 0 (and echoes the
 # detected new name) if the file was renamed away from <path>.
 rename_detected() {
   local p="$1"
@@ -242,7 +242,7 @@ record_shape() {
 # Shape 1 — file-no-longer-exists (Phase 1 original).
 # Extracts candidate paths, drops self-refs, runs path_exists per
 # candidate. Detects state-suffix / sibling-file / rename to avoid Phase 1
-# false-positives (P180/P244/P251); on detection routes to KEEP-WITH-NOTE.
+# false-positives (agent-defers-mitigation-selection-to-user-during-active-incident-surfaces-mitigation-choice-as-user-authority-when-skill-contract-empowers-agent-driven-reversible-mitigations-problem/phase-3-f9-wr-itil-plugin-maturity-list-in-suite-display-shim-reads-installed-plugins-plugin-json-maturity-field-emits-ndjson-per-surface-rollup-per-plugin-problem/rfc-first-trace-invariant-not-enforced-fixes-start-without-rfc-story-map-or-jtbd-trace-problem); on detection routes to KEEP-WITH-NOTE.
 
 candidates=$(grep -oE '(packages|docs|\.changeset|src|test|scripts)/[A-Za-z0-9._/-]+\.(md|sh|ts|tsx|js|jsx|json|yml|yaml|bats|py|txt|html)' "$ticket_file" 2>/dev/null \
   | sort -u \

package/scripts/mark-create-gate.sh

@@ -1,14 +1,14 @@
 #!/usr/bin/env bash
-# wr-itil — write the problem-tier create-gate marker (P119) under every
-# candidate session SID (P260 / ADR-050 Option C).
+# wr-itil — write the problem-tier create-gate marker (agent-bypasses-wr-itil-manage-problem-step-2-duplicate-check-by-writing-tickets-directly-to-docs-problems-problem) under every
+# candidate session SID (create-gate-marker-race-between-concurrent-claude-sessions-via-shared-runtime-sid-file-problem / capture-the-runtime-stdin-session-id-via-a-pretooluse-hook-so-the-create-gate-marker-binds-to-the-same-sid-the-runtime-hook-will-see-architecture-rule Option C).
 #
 # Internalises the source+pipe that capture-problem / manage-problem Step 2
 # previously ran INLINE with repo-relative `source packages/itil/hooks/lib/*.sh`
 # — which only resolved in the source monorepo and broke in adopter installs
-# (P317 / RFC-009). This script resolves its sibling libs RELATIVE TO ITS OWN
+# (capture-problem-capture-rfc-manage-problem-step-2-create-gate-marker-step-sources-repo-relative-packages-itil-hooks-lib-sh-fails-in-adopter-installs-recurring-published-path-class-problem / adopter-safe-path-resolution-in-shipped-skills-24-repo-relative-references-release-design). This script resolves its sibling libs RELATIVE TO ITS OWN
 # LOCATION (`$(dirname)/../hooks/lib`), so it works wherever the plugin is
 # installed. SKILLs invoke it by name via the `wr-itil-mark-create-gate` PATH
-# shim (ADR-049) instead of sourcing repo-relative lib files.
+# shim (plugin-bundled-scripts-invoked-from-skill-md-resolve-via-bin-on-path-architecture-rule) instead of sourcing repo-relative lib files.
 set -uo pipefail
 
 LIB="$(cd "$(dirname "${BASH_SOURCE[0]}")/../hooks/lib" 2>/dev/null && pwd)" || {

package/scripts/mark-story-oversight-confirmed.sh

@@ -1,14 +1,14 @@
 #!/usr/bin/env bash
-# mark-story-oversight-confirmed.sh — ADR-090 ratify write-path.
+# mark-story-oversight-confirmed.sh — story-maps-and-stories-carry-a-drift-invalidated-human-oversight-marker-architecture-rule ratify write-path.
 #
 # Writes `human-oversight: confirmed` + an `oversight-hash` fingerprint of the
 # current content into a story (markdown frontmatter) or story-map (HTML meta).
 # Idempotent: re-running recomputes the hash and replaces any existing marker
 # (never duplicates). A later content edit changes the content hash, so the
 # stored fingerprint no longer matches → the artefact reads as drifted /
-# unratified until re-ratified (ADR-090 drift-invalidation).
+# unratified until re-ratified (story-maps-and-stories-carry-a-drift-invalidated-human-oversight-marker-architecture-rule drift-invalidation).
 #
-# ADR-103 retired the ADR-101 `--pure-decomposition` flag and its
+# a-release-row-is-the-rfc-and-the-map-is-the-approval-surface-architecture-rule retired the an-afk-loop-may-accept-and-implement-a-story-that-only-decomposes-already-ratified-substance-architecture-rule `--pure-decomposition` flag and its
 # `oversight-basis:` record. Nothing here strips a stale one: the only writer
 # that did was the markdown leg, and markdown is a story, which is now refused
 # outright. No artefact in the corpus carries the field.
@@ -16,10 +16,10 @@
 # Usage: mark-story-oversight-confirmed.sh <story-or-map-file>
 # Exit:  0 = ratified; 2 = usage / file error.
 #
-# Authority: ADR-090, ADR-103. Driver: P404 Phase 2, P456. Test: mark-story-oversight-confirmed.bats.
+# Authority: story-maps-and-stories-carry-a-drift-invalidated-human-oversight-marker-architecture-rule, a-release-row-is-the-rfc-and-the-map-is-the-approval-surface-architecture-rule. Driver: implement-in-the-skills-and-tests-1-story-per-rfc-story-map-story-ratification-problem Phase 2, afk-iter-cannot-progress-a-ratified-known-error-when-the-fix-vehicle-rfc-has-empty-stories-problem. Test: mark-story-oversight-confirmed.bats.
 set -euo pipefail
 
-# Adopter-safe: source the shared hash lib RELATIVE TO THIS SCRIPT (P317), never
+# Adopter-safe: source the shared hash lib RELATIVE TO THIS SCRIPT (capture-problem-capture-rfc-manage-problem-step-2-create-gate-marker-step-sources-repo-relative-packages-itil-hooks-lib-sh-fails-in-adopter-installs-recurring-published-path-class-problem), never
 # repo-relative.
 LIB="$(cd "$(dirname "${BASH_SOURCE[0]}")/../lib" 2>/dev/null && pwd)" || {
   echo "mark-story-oversight-confirmed: cannot locate lib dir" >&2; exit 2; }
@@ -33,21 +33,21 @@ if [ -z "$f" ]; then
 fi
 [ -f "$f" ] || { echo "mark-story-oversight-confirmed: file not found: $f" >&2; exit 2; }
 
-# ADR-103: only a story MAP is ratified. A story carries no oversight marker at
+# a-release-row-is-the-rfc-and-the-map-is-the-approval-surface-architecture-rule: only a story MAP is ratified. A story carries no oversight marker at
 # all — its approval is its map's. Marking a story would re-create the second
-# approval surface ADR-103 removed, so refuse rather than silently write one.
-# What ADR-103 removes is the STORY-tier marker, and a story is markdown. So the
+# approval surface a-release-row-is-the-rfc-and-the-map-is-the-approval-surface-architecture-rule removed, so refuse rather than silently write one.
+# What a-release-row-is-the-rfc-and-the-map-is-the-approval-surface-architecture-rule removes is the STORY-tier marker, and a story is markdown. So the
 # refusal is keyed on the encoding, not on a `docs/stories/` path substring: a
 # caller working outside that tree — a test fixture, an adopter with a different
 # layout — must get the same answer.
 #
-# Deliberately NOT keyed on the ADR-102 data island, tempting as that is. A map
-# predating ADR-102 has no island, and an island test would lock those out of
+# Deliberately NOT keyed on the story-maps-render-from-json-through-a-canonical-template-architecture-rule data island, tempting as that is. A map
+# predating story-maps-render-from-json-through-a-canonical-template-architecture-rule has no island, and an island test would lock those out of
 # ratification entirely. Marking some unrelated .html file is a user error; a
 # story marker is a governance hole, and only the second one is worth refusing.
 case "$f" in
   *.md|*.markdown)
-    echo "mark-story-oversight-confirmed: refusing to mark $f (ADR-103). Only a story MAP is ratified. A story carries no oversight marker; its approval is derived from the maps named in its \`story-maps:\` field, so ratify the map instead." >&2
+    echo "mark-story-oversight-confirmed: refusing to mark $f (a-release-row-is-the-rfc-and-the-map-is-the-approval-surface-architecture-rule). Only a story MAP is ratified. A story carries no oversight marker; its approval is derived from the maps named in its \`story-maps:\` field, so ratify the map instead." >&2
     exit 2 ;;
 esac
 
@@ -57,7 +57,7 @@ tmp="$(mktemp)"
 case "$f" in
   *.html)
     if grep -qF '<script id="story-map-data"' "$f"; then
-      # ADR-102 map: the data island is the source of truth and every <meta> is
+      # story-maps-render-from-json-through-a-canonical-template-architecture-rule map: the data island is the source of truth and every <meta> is
       # GENERATED from it. Writing the marker to <meta> alone would be undone by
       # the next render, silently destroying a human ratification — so the
       # marker goes into the island and the <meta> follows on render.
@@ -124,10 +124,10 @@ PYMARK
     ;;
   *)
     # The markdown-frontmatter writer that used to live here was a working
-    # writer for the story-level marker ADR-103 removed. It is deleted rather
+    # writer for the story-level marker a-release-row-is-the-rfc-and-the-map-is-the-approval-surface-architecture-rule removed. It is deleted rather
     # than left unreachable behind the guard above, so that a later relaxation
     # of that guard fails loudly instead of silently restoring story markers.
-    echo "mark-story-oversight-confirmed: refusing to mark $f (ADR-103) — no recognised story-map encoding (expected a <script id=\"story-map-data\"> island, or a legacy HTML map)." >&2
+    echo "mark-story-oversight-confirmed: refusing to mark $f (a-release-row-is-the-rfc-and-the-map-is-the-approval-surface-architecture-rule) — no recognised story-map encoding (expected a <script id=\"story-map-data\"> island, or a legacy HTML map)." >&2
     rm -f "$tmp"; exit 2
     ;;
 esac

package/scripts/migrate-story-status-mirror.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# migrate-story-status-mirror.sh — P474 one-time migration.
+# migrate-story-status-mirror.sh — oversight-hash-treats-the-status-body-mirror-as-substance-so-an-accept-transition-self-invalidates-its-own-ratification-problem one-time migration.
 #
 # Removes the redundant `**Status**:` body line from story artefacts and carries
 # each artefact's existing ratification forward.
@@ -20,13 +20,13 @@
 # identifies WHICH content the confirmation covered. Recomputing that pointer,
 # over content whose sole delta is a mechanical mirror of an already-excluded
 # field, removes zero ratified substance from coverage. That argument is what
-# distinguishes this from the P348 hollow-marker class, and it holds ONLY
+# distinguishes this from the iter-subprocesses-set-human-oversight-confirmed-marker-on-adrs-personas-jtbds-without-an-actual-user-confirmation-event-problem hollow-marker class, and it holds ONLY
 # because of two guards:
 #
 #   1. Per-artefact validity gate — re-fingerprint only when the stored hash
 #      still matches the content as it stands. An artefact that had already
 #      drifted stays drifted; nothing is silently revived. Without this the
-#      migration is a blanket re-bless, which IS P348.
+#      migration is a blanket re-bless, which IS iter-subprocesses-set-human-oversight-confirmed-marker-on-adrs-personas-jtbds-without-an-actual-user-confirmation-event-problem.
 #   2. Mirror-agreement precondition — if the body line disagrees with the
 #      frontmatter, it is carrying independent information (the real corpus had
 #      `superseded (was: draft)` and `in-progress (2026-07-23)`), so deleting it
@@ -40,8 +40,8 @@
 # Usage: migrate-story-status-mirror.sh [<stories-dir>...]   (default: docs/stories)
 # Exit:  0 = completed (including "nothing to do"); 2 = usage / missing lib.
 #
-# Authority: ADR-090 (oversight fingerprint), ADR-103 (stories carry no marker).
-# Driver: P474. Test: migrate-story-status-mirror.bats.
+# Authority: story-maps-and-stories-carry-a-drift-invalidated-human-oversight-marker-architecture-rule (oversight fingerprint), a-release-row-is-the-rfc-and-the-map-is-the-approval-surface-architecture-rule (stories carry no marker).
+# Driver: oversight-hash-treats-the-status-body-mirror-as-substance-so-an-accept-transition-self-invalidates-its-own-ratification-problem. Test: migrate-story-status-mirror.bats.
 
 set -euo pipefail
 
@@ -106,7 +106,7 @@ for d in "${dirs[@]}"; do
     # Was this artefact ratified-and-valid BEFORE we touch it? Decide now: once
     # the line is gone the pre-migration hash is unreproducible.
     #
-    # ADR-103: a story carries no fingerprint of its own, so this is always 0 on
+    # a-release-row-is-the-rfc-and-the-map-is-the-approval-surface-architecture-rule: a story carries no fingerprint of its own, so this is always 0 on
     # the story tier and the re-point branch below never runs there. The branch
     # is retained for any artefact that does carry one.
     was_valid=0

package/scripts/next-rfc-id.sh

@@ -36,12 +36,12 @@
 # working tree, for hermetic tests; outside a git repository the history half
 # is skipped automatically.
 #
-# @adr ADR-119 (a fix proposal draws a release row, never a document; the
+# @adr a-fix-proposal-draws-a-release-row-never-a-document-architecture-rule (a fix proposal draws a release row, never a document; the
 #   identity is allocated by scanning row identities including git history)
-# @adr ADR-115 (identities are never reused — hence highest+1, not lowest gap)
-# @adr ADR-049 (invoked via the wr-itil-next-rfc-id bin shim on $PATH)
-# @adr ADR-052 (behavioural bats in packages/itil/scripts/test/next-rfc-id.bats)
-# @problem P508
+# @adr story-map-ids-are-never-reused-architecture-rule (identities are never reused — hence highest+1, not lowest gap)
+# @adr plugin-bundled-scripts-invoked-from-skill-md-resolve-via-bin-on-path-architecture-rule (invoked via the wr-itil-next-rfc-id bin shim on $PATH)
+# @adr behavioural-tests-default-for-skill-testing-architecture-rule (behavioural bats in packages/itil/scripts/test/next-rfc-id.bats)
+# @problem the-fix-proposal-still-instantiates-a-standalone-rfc-document-after-made-it-a-release-row-problem
 
 set -uo pipefail
 

package/scripts/plugin-exercise-index.sh

@@ -1,14 +1,14 @@
 #!/usr/bin/env bash
 # packages/itil/scripts/plugin-exercise-index.sh
 #
-# Phase 2b (P087) git-axis maturity-measurement script.
+# Phase 2b (problem-087-no-maturity-battle-hardening-signal-on-plugins-skills-agents-or-hooks-readmes-don-t-tell-users-which-features-are-stable-vs-experimental-problem) git-axis maturity-measurement script.
 #
 # Runs `git log --since=<window>d --name-only --pretty=format:%H|%aI|%s`
 # once at the project root, auto-discovers plugins by listing `packages/*/`,
 # and emits one NDJSON record per plugin with the v1.0 schema fields per
-# ADR-058 §Script contracts (line 87-113).
+# windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule §Script contracts (line 87-113).
 #
-# Schema (per ADR-058 line 95-110):
+# Schema (per windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule line 95-110):
 #   {"schema_version":"1.0","axis":"plugin-exercise-index","plugin":"<name>",
 #    "commits_window":<N>,"window_days":<N>,"days_shipped":<N>,
 #    "closed_tickets_window":<N>,"tickets_window_days":<N>,
@@ -17,7 +17,7 @@
 # composite_index = log10(commits_window+1)
 #                 + log10(closed_tickets_window+1)
 #                 + (days_shipped >= 60 ? 1.0 : 0.0)
-# (ADR-058 line 112, Option E6 "MAY emit alongside band" carve-out.)
+# (windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule line 112, Option E6 "MAY emit alongside band" carve-out.)
 #
 # Usage:
 #   wr-itil-plugin-exercise-index [--window-days=N] [--tickets-window-days=N]
@@ -25,19 +25,19 @@
 #                                  [--category-overrides=FILE]
 #
 # Defaults:
-#   --window-days           60   (ADR-058 line 89)
-#   --tickets-window-days   90   (ADR-058 line 93)
+#   --window-days           60   (windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule line 89)
+#   --tickets-window-days   90   (windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule line 93)
 #   --project-root          $PWD
 #
 # Exit codes:
-#   0 = always — ADR-013 Rule 6 fail-safe. Outside-git-repo, missing
+#   0 = always — structured-user-interaction-for-governance-skill-decisions-architecture-rule Rule 6 fail-safe. Outside-git-repo, missing
 #                `packages/`, opt-out marker all hit the zero-records path
 #                with stderr-comment.
 #
-# Privacy (ADR-035 clauses adopted verbatim, adapted for the git axis):
+# Privacy (centralised-review-reports-for-cross-project-skill-improvement-jsonl-at-claude-review-reports-architecture-rule clauses adopted verbatim, adapted for the git axis):
 #   - Opt-out marker `.claude/.skill-metrics-opt-out` disables reads.
 #   - No network egress — the script body invokes no exfiltration
-#     primitives. ADR-058 §Confirmation 3 enforces via negative-grep on
+#     primitives. windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule §Confirmation 3 enforces via negative-grep on
 #     this file (banned-token list lives in the bats fixture, not here,
 #     to avoid self-matching).
 #   - Content sanitisation — commit subjects are parsed ONLY for
@@ -46,16 +46,16 @@
 #     only plugin-attribution surface is the `packages/<plugin>/` path
 #     prefix extracted from `--name-only` output.
 #
-# @problem P087 (Phase 2b — git axis)
-# @adr ADR-058 (Plugin maturity measurement mechanism)
-# @adr ADR-049 (Shim grammar — bin/wr-itil-plugin-exercise-index on $PATH)
-# @adr ADR-035 (Privacy posture adopted verbatim)
-# @adr ADR-052 (Behavioural tests default; ADR-058 §Confirmation 6-8)
-# @adr ADR-013 Rule 6 (non-interactive fail-safe — exit 0 always)
-# @adr ADR-023 (Performance — ≤1.0s warm-cache; 60-day window default)
-# @jtbd JTBD-101 (Extend the Suite — hardening-prioritisation outcome,
+# @problem problem-087-no-maturity-battle-hardening-signal-on-plugins-skills-agents-or-hooks-readmes-don-t-tell-users-which-features-are-stable-vs-experimental-problem (Phase 2b — git axis)
+# @adr windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule (Plugin maturity measurement mechanism)
+# @adr plugin-bundled-scripts-invoked-from-skill-md-resolve-via-bin-on-path-architecture-rule (Shim grammar — bin/wr-itil-plugin-exercise-index on $PATH)
+# @adr centralised-review-reports-for-cross-project-skill-improvement-jsonl-at-claude-review-reports-architecture-rule (Privacy posture adopted verbatim)
+# @adr behavioural-tests-default-for-skill-testing-architecture-rule (Behavioural tests default; windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule §Confirmation 6-8)
+# @adr structured-user-interaction-for-governance-skill-decisions-architecture-rule Rule 6 (non-interactive fail-safe — exit 0 always)
+# @adr wr-architect-agent-performance-review-scope-prompt-amendment-performance-budget-adr-template-architecture-rule (Performance — ≤1.0s warm-cache; 60-day window default)
+# @jtbd extend-the-suite-with-new-plugins-user-outcome (Extend the Suite — hardening-prioritisation outcome,
 #   2026-05-04 amendment serves Phase 2 NDJSON as data source)
-# @jtbd JTBD-201 (Restore Service Fast — audit-trail composition)
+# @jtbd restore-service-fast-with-an-audit-trail-user-outcome (Restore Service Fast — audit-trail composition)
 
 set -uo pipefail
 
@@ -82,7 +82,7 @@ for arg in "$@"; do
   esac
 done
 
-# ── Opt-out marker check (ADR-035 / ADR-058 §Privacy posture) ───────────────
+# ── Opt-out marker check (centralised-review-reports-for-cross-project-skill-improvement-jsonl-at-claude-review-reports-architecture-rule / windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule §Privacy posture) ───────────────
 
 OPT_OUT_MARKER="${PROJECT_ROOT}/.claude/.skill-metrics-opt-out"
 if [ -e "$OPT_OUT_MARKER" ]; then
@@ -90,14 +90,14 @@ if [ -e "$OPT_OUT_MARKER" ]; then
   exit 0
 fi
 
-# ── Git-repo check (ADR-013 Rule 6 fail-safe) ───────────────────────────────
+# ── Git-repo check (structured-user-interaction-for-governance-skill-decisions-architecture-rule Rule 6 fail-safe) ───────────────────────────────
 
 if [ ! -d "${PROJECT_ROOT}/.git" ] && ! git -C "$PROJECT_ROOT" rev-parse --git-dir >/dev/null 2>&1; then
   echo "# wr-itil-plugin-exercise-index: not a git repository at ${PROJECT_ROOT}" >&2
   exit 0
 fi
 
-# ── packages/ discovery check (ADR-013 Rule 6 fail-safe) ────────────────────
+# ── packages/ discovery check (structured-user-interaction-for-governance-skill-decisions-architecture-rule Rule 6 fail-safe) ────────────────────
 
 if [ ! -d "${PROJECT_ROOT}/packages" ]; then
   echo "# wr-itil-plugin-exercise-index: no packages/ directory at ${PROJECT_ROOT}" >&2
@@ -115,7 +115,7 @@ if [ "$PLUGIN_COUNT" -eq 0 ]; then
   exit 0
 fi
 
-# ── --category-overrides validation (ADR-058 §Per-category override hook) ───
+# ── --category-overrides validation (windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule §Per-category override hook) ───
 # Forward-extension flag; ships unused in Phase 2.
 
 if [ -n "$CATEGORY_OVERRIDES" ] && [ ! -f "$CATEGORY_OVERRIDES" ]; then
@@ -160,13 +160,13 @@ closed_tickets_window = defaultdict(int)
 BREAKING_RE = re.compile(r"\b(BREAKING)\b|(?:^|\s)(feat!|fix!|chore!|refactor!)")
 
 # ── Single git log pass with in-Python window filter ────────────────────────
-# ADR-058 line 89 pins `git log --since=<window>d --name-only
+# windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule line 89 pins `git log --since=<window>d --name-only
 # --pretty=format:%H|%aI|%s`. Git's `--since=Nd` was observed unreliable on
 # 2026-05-16 against the test fixture (returned empty even for commits well
 # within the window — likely a date-parser quirk with future-year commit
 # dates), so the window filter is applied in-Python against the `%aI`
 # author-date field that is already extracted for `breaking_change_age_days`
-# and `days_shipped`. The `git log` invocation otherwise matches the ADR-058
+# and `days_shipped`. The `git log` invocation otherwise matches the windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule
 # contract verbatim (--name-only, the literal `|` separator). Single pass
 # instead of two — pass-2 (oldest-commit) and pass-1 (in-window) collapse
 # into one walk because we already iterate every commit's date.
@@ -245,7 +245,7 @@ for sha, iso_ts, subject, paths in parse_log_all():
         del subject
         continue
 
-    # days_shipped: track min(author_date) per plugin. ADR-058 line 91 says
+    # days_shipped: track min(author_date) per plugin. windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule line 91 says
     # "days since the OLDEST git commit"; oldest is interpreted as min by
     # author-date rather than min by commit-topology so the value is stable
     # against commit-reordering and rebase. (Topological --reverse can
@@ -257,7 +257,7 @@ for sha, iso_ts, subject, paths in parse_log_all():
         if cur is None or ts < cur:
             oldest_commit_ts[plug] = ts
 
-    # In-window filter — applied in Python (ADR-058 line 89 contract for the
+    # In-window filter — applied in Python (windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule line 89 contract for the
     # git invocation; window cutoff in-process for portability).
     if ts < cutoff:
         del subject