@windyroad/voice-tone 0.3.1 → 0.4.0-preview.303

package/.claude-plugin/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "wr-voice-tone",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Voice and tone enforcement for Claude Code"
 }

package/README.md

@@ -50,6 +50,22 @@ The `wr-voice-tone:agent` reads your `docs/VOICE-AND-TONE.md` and reviews propos
 - Banned words and patterns
 - Preferred terminology
 
+## 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)** — voice-and-tone review fires automatically on every user-facing copy edit; the project's own voice guide is the policy source rather than the agent's defaults.
+
+### 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)** — voice-and-tone 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/test/voice-tone-enforce-scope.bats

@@ -0,0 +1,76 @@
+#!/usr/bin/env bats
+
+# Tests for voice-tone-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 voice-tone hook is opt-in (gates *.html|*.jsx|*.tsx|*.vue|*.svelte|
+# *.ejs|*.hbs) and blocks outright when docs/VOICE-AND-TONE.md is absent.
+# Story-map HTML files would otherwise be blocked even when no policy
+# exists — this is the empirical block P170 line 297 documented when the
+# STORY-MAP-001 bootstrap was attempted. The exemption short-circuits before
+# the extension check.
+
+setup() {
+  SCRIPT_DIR="$(cd "$(dirname "$BATS_TEST_FILENAME")/.." && pwd)"
+  HOOK="$SCRIPT_DIR/voice-tone-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 "voice-tone: exempts docs/story-maps/ HTML in per-state subdir" {
+  assert_path_allowed "$PWD/docs/story-maps/draft/STORY-MAP-001-foo.html"
+}
+
+@test "voice-tone: exempts docs/story-maps/ HTML in completed subdir" {
+  assert_path_allowed "$PWD/docs/story-maps/completed/STORY-MAP-002-bar.html"
+}
+
+@test "voice-tone: exempts docs/story-maps/ even when no VOICE-AND-TONE.md exists" {
+  # P170 line 297: STORY-MAP-001 bootstrap was blocked here exactly because
+  # this exemption did not exist. Behavioural regression-guard.
+  [ ! -f docs/VOICE-AND-TONE.md ]
+  assert_path_allowed "$PWD/docs/story-maps/in-progress/STORY-MAP-001-rfc-framework.html"
+}
+
+@test "voice-tone: exempts docs/stories/ files even though .md isn't normally gated" {
+  assert_path_allowed "$PWD/docs/stories/draft/STORY-001-foo.md"
+}
+
+# --- Regression: non-exempt HTML still gate ---
+
+@test "voice-tone: still blocks an unrelated .html file when no policy exists" {
+  assert_path_blocked "$PWD/public/index.html"
+}
+
+@test "voice-tone: still blocks a .tsx component file when no policy exists" {
+  assert_path_blocked "$PWD/src/Component.tsx"
+}

package/hooks/voice-tone-enforce-edit.sh

@@ -45,6 +45,20 @@ 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). Story-map HTML and
+# story Markdown are governed by capture-story-map / manage-story-map and
+# capture-story / manage-story skills (peer-plugin pattern, mirrors the
+# docs/problems and docs/jtbd exemptions on architect + jtbd gates).
+# Short-circuits before the *.html opt-in match below would otherwise fire
+# on story-map HTML — the empirical block documented at P170 line 297.
+case "$FILE_PATH" in
+  */docs/story-maps/*|docs/story-maps/*)
+    exit 0 ;;
+  */docs/stories/*|docs/stories/*)
+    exit 0 ;;
+esac
+
 # Gate copy-bearing files
 case "$FILE_PATH" in
   *.html|*.jsx|*.tsx|*.vue|*.svelte|*.ejs|*.hbs) ;;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windyroad/voice-tone",
-  "version": "0.3.1",
+  "version": "0.4.0-preview.303",
   "description": "Voice and tone enforcement for user-facing copy",
   "bin": {
     "windyroad-voice-tone": "./bin/install.mjs"