@windyroad/jtbd 0.12.11 → 0.12.12-preview.885

package/.claude-plugin/plugin.json

@@ -90,5 +90,5 @@
     }
   },
   "name": "wr-jtbd",
-  "version": "0.12.11"
+  "version": "0.12.12"
 }

package/hooks/test/jtbd-oversight-marker-discipline.bats

@@ -192,6 +192,21 @@ mk_existing_artefact() {
   [ -f "$(expected_marker "$art")" ]
 }
 
+# P368: genuine cold path — no CLAUDE_SESSION_ID and no announce markers at all.
+# The shim correctly writes zero markers but must NOT do so SILENTLY: a loud
+# stderr diagnostic explains why the subsequent discipline-hook deny happens,
+# breaking the confusing "you didn't run the shim" loop. Exit stays 0 (contract:
+# do not crash SKILL flows before any hook has fired this session).
+@test "mark-oversight-confirmed.sh emits a loud stderr diagnostic on the no-candidate cold path (P368)" {
+  mk_existing_artefact "developer/JTBD-342-coldpath.proposed.md"
+  art="$DIR/docs/jtbd/developer/JTBD-342-coldpath.proposed.md"
+  run env -u CLAUDE_SESSION_ID bash "$MARK_SCRIPT" "$art"
+  [ "$status" -eq 0 ]                              # contract: cold path still exits 0
+  [ ! -f "$(expected_marker "$art")" ]             # no marker written
+  [[ "$output" == *"no candidate session id"* ]]   # loud, not silent
+  [[ "$output" == *"P368"* ]]
+}
+
 @test "tool_name=Bash exits 0 silently regardless of file path" {
   json=$(jq -nc --arg s "$SID" \
     '{tool_name:"Bash",session_id:$s,tool_input:{command:"echo human-oversight: confirmed"}}')

package/hooks/test/jtbd-oversight-nudge.bats

@@ -11,6 +11,11 @@ setup() {
   PLUGIN_ROOT="$REPO_ROOT/packages/jtbd"
   DIR="$(mktemp -d)"
   mkdir -p "$DIR/docs/jtbd/solo-developer"
+  # Hermeticity (P391): the AFK work-problems orchestrator exports
+  # WR_SUPPRESS_OVERSIGHT_NUDGE=1, which the hook self-suppresses on. Unset it so
+  # count-emitting tests assert real behaviour; guard-specific tests set it
+  # per-invocation via `run env WR_SUPPRESS_OVERSIGHT_NUDGE=...`.
+  unset WR_SUPPRESS_OVERSIGHT_NUDGE
 }
 
 teardown() { rm -rf "$DIR"; }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windyroad/jtbd",
-  "version": "0.12.11",
+  "version": "0.12.12-preview.885",
   "description": "Jobs-to-be-done enforcement for UI changes",
   "bin": {
     "windyroad-jtbd": "./bin/install.mjs"

package/scripts/mark-oversight-confirmed.sh

@@ -36,7 +36,10 @@
 #
 # Exit codes:
 #   0 — marker(s) written for at least one candidate SID, OR no candidate
-#       SID was discoverable (cold-path: no announce markers yet).
+#       SID was discoverable (cold path: no announce markers yet). The latter
+#       writes no marker and prints a loud stderr diagnostic (P368) explaining
+#       the downstream hook deny, then exits 0 so SKILL flows do not crash
+#       before any hook has fired in the session.
 #   2 — bad argument (missing or empty artefact-path).
 #
 # @adr ADR-068 (JTBD/persona human-oversight marker)
@@ -93,7 +96,23 @@ candidates=$(
   } | awk 'NF && !seen[$0]++'
 )
 
-[ -n "$candidates" ] || exit 0
+# No candidate SID — cold path. Emit a loud stderr diagnostic (P368) and still
+# exit 0. Exit 0 preserves the documented contract (do not crash SKILL flows
+# before any announce marker has fired this session); the diagnostic replaces the
+# prior SILENT no-op, which masqueraded as success and left the caller to hit the
+# oversight-marker-discipline hook's deny with no idea why — the confusing loop
+# P368 documents (the deny points back at this shim, which the caller already ran).
+if [ -z "$candidates" ]; then
+  {
+    echo "wr-jtbd-mark-oversight-confirmed: no candidate session id discoverable"
+    echo "  (CLAUDE_SESSION_ID empty and no *-announced-* markers in ${MARKER_DIR} within ${WINDOW_MINS}min)."
+    echo "  NO oversight marker was written for: ${ABS_PATH}"
+    echo "  The oversight-marker-discipline hook will DENY the 'human-oversight: confirmed' Edit"
+    echo "  until a session announce marker exists. Start a fresh session, or point SESSION_MARKER_DIR"
+    echo "  at a dir containing a *-announced-<sid> file, then re-run this shim (P368)."
+  } >&2
+  exit 0
+fi
 
 while IFS= read -r sid; do
   [ -n "$sid" ] || continue