@windyroad/itil 0.47.2 → 0.47.3

package/.claude-plugin/plugin.json

@@ -497,5 +497,5 @@
     }
   },
   "name": "wr-itil",
-  "version": "0.47.2"
+  "version": "0.47.3"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windyroad/itil",
-  "version": "0.47.2",
+  "version": "0.47.3",
   "description": "ITIL-aligned IT service management for Claude Code (problem, and future incident/change skills)",
   "bin": {
     "windyroad-itil": "./bin/install.mjs"

package/scripts/reconcile-rfcs.sh

@@ -251,8 +251,16 @@ if [ -d "$PROBLEMS_DIR" ]; then
   # problem_rfc_ids["P168"] = "RFC-001 RFC-002 ..."
   declare -A problem_rfc_rows
   declare -A problem_rfc_ids
+  # P312 / ADR-031: scan both flat docs/problems/<NNN>-*.md AND per-state
+  # subdir docs/problems/<state>/<NNN>-*.md layouts so the reverse-trace
+  # remains valid post-migration. Mirrors reconcile-readme.sh lines 74-110.
   shopt -s nullglob
-  for pf in "$PROBLEMS_DIR"/[0-9][0-9][0-9]-*.md; do
+  problem_files=( "$PROBLEMS_DIR"/[0-9][0-9][0-9]-*.md )
+  for ticket_status in open known-error verifying closed parked; do
+    problem_files+=( "$PROBLEMS_DIR"/"$ticket_status"/[0-9][0-9][0-9]-*.md )
+  done
+  shopt -u nullglob
+  for pf in "${problem_files[@]}"; do
     pbase="$(basename "$pf")"
     pnum="${pbase%%-*}"
     pid="P${pnum}"
@@ -274,7 +282,6 @@ if [ -d "$PROBLEMS_DIR" ]; then
     done < <(awk -v start="$sec_start" 'NR>start { if (/^## /) exit; print }' "$pf")
     problem_rfc_ids["$pid"]="$rfcs_in_p"
   done
-  shopt -u nullglob
 
   # 1. MISSING_REVERSE_TRACE: RFC claims P, P does not list RFC.
   for rfc_id in "${!rfc_problems_claim[@]}"; do

package/scripts/test/reconcile-rfcs.bats

@@ -131,6 +131,40 @@ EOF
   fi
 }
 
+# Helper: write a problem ticket under the per-state subdir layout per
+# ADR-031 (state is the parent directory; filename has NO `.state.md` suffix).
+# Args: <pid-num> <slug> <state> <rfcs-rows-block>
+# Used to regression-test P312 — reconcile-rfcs reverse-trace must traverse
+# docs/problems/<state>/<NNN>-*.md, not just flat docs/problems/<NNN>-*.<state>.md.
+write_problem_subdir() {
+  local num="$1" slug="$2" state="$3" rfcs_rows="${4:-}"
+  mkdir -p "$PROBLEMS_DIR/$state"
+  local file="$PROBLEMS_DIR/$state/${num}-${slug}.md"
+  cat > "$file" <<EOF
+# Problem ${num}: ${slug}
+
+**Status**: ${state}
+
+## Description
+
+stub
+
+## Related
+
+stub
+EOF
+  if [ -n "$rfcs_rows" ]; then
+    cat >> "$file" <<EOF
+
+## RFCs
+
+| RFC | Status | Title |
+|-----|--------|-------|
+${rfcs_rows}
+EOF
+  fi
+}
+
 # ── Existence + executable ──────────────────────────────────────────────────
 
 @test "reconcile-rfcs: script exists" {
@@ -413,6 +447,35 @@ EOF
   done <<< "$output"
 }
 
+# ── P312: per-state subdir reverse-trace (ADR-031 layout) ───────────────────
+# Closes P312 — reconcile-rfcs reported spurious MISSING_REVERSE_TRACE for
+# tickets that live under docs/problems/<state>/<NNN>-*.md because the
+# reverse-trace pass only globbed the flat docs/problems/<NNN>-*.md layout.
+# RFC-002-class dual-tolerant-glob fix mirroring the sibling already shipped
+# in reconcile-readme.sh (P118).
+
+@test "P312: reverse-trace clean when problem ticket lives in per-state subdir" {
+  write_rfc "001" "foo" "accepted"
+  write_minimal_readme "| 2.0 | RFC-001 | foo | 3 Med | Accepted | M | 2026-05-05 |"
+  # Ticket lives under docs/problems/verifying/168-p168.md (no .state suffix).
+  write_problem_subdir "168" "p168" "verifying" "| RFC-001 | accepted | foo |"
+  run bash "$SCRIPT" "$FIXTURE_DIR" "$PROBLEMS_DIR"
+  [ "$status" -eq 0 ]
+  [[ "$output" != *"MISSING_REVERSE_TRACE"* ]]
+}
+
+@test "P312: reverse-trace detects missing trace when problem ticket lives in per-state subdir" {
+  write_rfc "001" "foo" "accepted"
+  write_minimal_readme "| 2.0 | RFC-001 | foo | 3 Med | Accepted | M | 2026-05-05 |"
+  # Subdir ticket WITHOUT a `## RFCs` section → MISSING_REVERSE_TRACE must fire.
+  write_problem_subdir "168" "p168" "verifying" ""
+  run bash "$SCRIPT" "$FIXTURE_DIR" "$PROBLEMS_DIR"
+  [ "$status" -eq 1 ]
+  [[ "$output" == *"MISSING_REVERSE_TRACE"* ]]
+  [[ "$output" == *"RFC-001"* ]]
+  [[ "$output" == *"P168"* ]]
+}
+
 # ── ADR-049 bin shim contract ───────────────────────────────────────────────
 
 @test "wr-itil-reconcile-rfcs bin shim exists" {