@windyroad/style-guide 0.3.1 → 0.4.0-preview.303

package/.claude-plugin/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "wr-style-guide",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Style guide enforcement for Claude Code"
 }

package/README.md

@@ -45,6 +45,22 @@ This examines your existing CSS, components, and design patterns, then asks abou
 
 The `wr-style-guide:agent` reads your `docs/STYLE-GUIDE.md` and reviews proposed changes against your documented design system.
 
+## Jobs to be Done
+
+This plugin serves the [Jobs to be Done](../../docs/jtbd/) below. Per [ADR-051](../../docs/decisions/051-jtbd-anchored-readme-with-drift-advisory.proposed.md), the persona-grouped JTBD anchor is the canonical source of truth for the README's value framing.
+
+### Solo developer
+
+- **[JTBD-001 Enforce Governance Without Slowing Down](../../docs/jtbd/solo-developer/JTBD-001-enforce-governance.proposed.md)** — style-guide review fires automatically on every CSS or component edit; the project's own design system is the policy source.
+
+### Tech lead / consultant
+
+- **[JTBD-202 Run Pre-Flight Governance Checks Before Release or Handover](../../docs/jtbd/tech-lead/JTBD-202-pre-flight-governance-check.proposed.md)** — style-guide alignment is reviewable on demand before a release or client handover.
+
+### Plugin user
+
+- **[JTBD-302 Trust That the README Describes the Plugin I Just Installed](../../docs/jtbd/plugin-user/JTBD-302-trust-readme-describes-installed-behaviour.proposed.md)** — this README is anchored on current JTBD job IDs; drift between prose and shipped behaviour is detectable at retro time per ADR-051.
+
 ## Updating and Uninstalling
 
 ```bash

package/hooks/style-guide-enforce-edit.sh

@@ -45,6 +45,18 @@ case "$FILE_PATH" in
     ;;
 esac
 
+# Governance-managed surface exemptions — ADR-060 § Phase 2 amendment
+# 2026-05-12 lines 481-496 (P170 Phase 2 Slice 2.5). Mirrors the
+# docs/problems / docs/jtbd peer-plugin policy exemptions in
+# architect-enforce-edit.sh + jtbd-enforce-edit.sh. Short-circuits before
+# the *.html extension check below would otherwise fire on story-map HTML.
+case "$FILE_PATH" in
+  */docs/story-maps/*|docs/story-maps/*)
+    exit 0 ;;
+  */docs/stories/*|docs/stories/*)
+    exit 0 ;;
+esac
+
 # Gate all UI source files (CSS and component files)
 case "$FILE_PATH" in
   *.css|*.html|*.jsx|*.tsx|*.vue|*.svelte|*.ejs|*.hbs) ;;

package/hooks/test/style-guide-enforce-scope.bats

@@ -0,0 +1,71 @@
+#!/usr/bin/env bats
+
+# Tests for style-guide-enforce-edit.sh — verifies the path-based exemption
+# for governance-managed surfaces (docs/story-maps/, docs/stories/) per
+# ADR-060 § Phase 2 amendment 2026-05-12 lines 481-496 (P170 Phase 2 Slice 2.5).
+#
+# The style-guide hook is opt-in (gates only *.css|*.html|*.jsx|*.tsx|*.vue|
+# *.svelte|*.ejs|*.hbs). Story-map HTML files would otherwise be blocked at
+# `*.html` matching when docs/STYLE-GUIDE.md is absent OR review-gate is open.
+# The exemption short-circuits before the extension check.
+
+setup() {
+  SCRIPT_DIR="$(cd "$(dirname "$BATS_TEST_FILENAME")/.." && pwd)"
+  HOOK="$SCRIPT_DIR/style-guide-enforce-edit.sh"
+  ORIG_DIR="$PWD"
+  TEST_DIR=$(mktemp -d)
+  cd "$TEST_DIR"
+}
+
+teardown() {
+  cd "$ORIG_DIR"
+  rm -rf "$TEST_DIR"
+}
+
+run_hook_with_file() {
+  local file_path="$1"
+  local json="{\"tool_input\":{\"file_path\":\"${file_path}\"},\"session_id\":\"test-session-$$\"}"
+  echo "$json" | bash "$HOOK"
+}
+
+assert_path_allowed() {
+  local file_path="$1"
+  run run_hook_with_file "$file_path"
+  [ "$status" -eq 0 ]
+  [[ "$output" != *"BLOCKED"* ]]
+}
+
+assert_path_blocked() {
+  local file_path="$1"
+  run run_hook_with_file "$file_path"
+  [ "$status" -eq 0 ]
+  [[ "$output" == *"BLOCKED"* ]]
+}
+
+# --- Story maps + stories exemptions (P170 Phase 2 Slice 2.5 / ADR-060) ---
+
+@test "style-guide: exempts docs/story-maps/ HTML in per-state subdir" {
+  assert_path_allowed "$PWD/docs/story-maps/draft/STORY-MAP-001-foo.html"
+}
+
+@test "style-guide: exempts docs/story-maps/ HTML in completed subdir" {
+  assert_path_allowed "$PWD/docs/story-maps/completed/STORY-MAP-002-bar.html"
+}
+
+@test "style-guide: exempts docs/stories/ files even though .md isn't normally gated" {
+  # Markdown isn't in the opt-in extension list anyway, so this passes by
+  # virtue of the extension filter — but the explicit exemption documents
+  # intent and survives a hypothetical future scope-widening.
+  assert_path_allowed "$PWD/docs/stories/draft/STORY-001-foo.md"
+}
+
+# --- Regression: non-exempt UI files still gate ---
+
+@test "style-guide: still blocks an unrelated .html file when no policy exists" {
+  # No docs/STYLE-GUIDE.md created — hook should still block this HTML.
+  assert_path_blocked "$PWD/public/index.html"
+}
+
+@test "style-guide: still blocks a .tsx component file when no policy exists" {
+  assert_path_blocked "$PWD/src/Component.tsx"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windyroad/style-guide",
-  "version": "0.3.1",
+  "version": "0.4.0-preview.303",
   "description": "Style guide enforcement for CSS and UI components",
   "bin": {
     "windyroad-style-guide": "./bin/install.mjs"