@windyroad/voice-tone 0.8.7 → 0.9.0

package/.claude-plugin/plugin.json

@@ -50,6 +50,17 @@
         },
         "schema_version": "2.0"
       },
+      "assistant-voice-tone-stop": {
+        "band": "Experimental",
+        "computed_at": "2026-09-17T00:00:00Z",
+        "evidence": {
+          "breaking_change_age_days": null,
+          "closed_tickets_window": 0,
+          "days_shipped": 0,
+          "invocations_30d": null
+        },
+        "schema_version": "2.0"
+      },
       "voice-tone-enforce-edit": {
         "band": "Experimental",
         "computed_at": "2026-05-18T11:42:50Z",
@@ -109,6 +120,17 @@
         },
         "schema_version": "2.0"
       },
+      "update-assistant-guide": {
+        "band": "Experimental",
+        "computed_at": "2026-09-17T00:00:00Z",
+        "evidence": {
+          "breaking_change_age_days": null,
+          "closed_tickets_window": 0,
+          "days_shipped": 0,
+          "invocations_30d": 0
+        },
+        "schema_version": "2.0"
+      },
       "update-guide": {
         "band": "Experimental",
         "computed_at": "2026-05-18T11:42:50Z",
@@ -123,5 +145,5 @@
     }
   },
   "name": "wr-voice-tone",
-  "version": "0.8.7"
+  "version": "0.9.0"
 }

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "wr-voice-tone",
-  "version": "0.8.7",
+  "version": "0.9.0",
   "description": "Voice, tone, and external-communications governance",
   "author": {
     "name": "Windy Road Technology",

package/README.md

@@ -1,6 +1,6 @@
 # @windyroad/voice-tone
 
-**Voice and tone enforcement for Claude Code.** Reviews user-facing copy against your brand's voice and tone guide before it ships. *Maturity: Experimental (suite-bootstrap window; 169 invocations / 30d).*
+**Voice and tone guidance for Claude Code and Codex.** Reviews user-facing copy before it ships and can shape ordinary assistant responses. *Maturity: Experimental (suite-bootstrap window; 169 invocations / 30d).*
 
 Part of [Windy Road Agent Plugins](../../README.md).
 
@@ -35,13 +35,20 @@ The plugin works automatically. On first use in a project without a voice guide,
 
 This examines your existing content and asks about your brand voice, target audience, and tone preferences to generate a `docs/VOICE-AND-TONE.md` tailored to your project.
 
+### Assistant responses
+
+Run `/wr-voice-tone:update-assistant-guide` to create or update `docs/ASSISTANT-VOICE-AND-TONE.md`. The file's existence is the only enablement switch. Its prose may describe plain-language standards such as ISO 24495-1:2023 or ASD-STE100, or creative voice traits. The same assistant applies the guide and performs one semantic self-review before stopping; this adds one continuation's latency and token use, and some runtimes may briefly show the first response before its correction.
+
+This supports the plugin's Claude Code and Codex command-hook runtimes, not ordinary web ChatGPT conversations. Standards references express alignment, not certification.
+
 ## How It Works
 
 | Hook | Trigger | What it does |
 |------|---------|-------------|
-| `voice-tone-eval.sh` | Every prompt | Evaluates whether the task involves user-facing copy |
+| `voice-tone-eval.sh` | Every prompt | Evaluates copy work and injects an opted-in assistant-response guide |
 | `voice-tone-enforce-edit.sh` | Edit or Write | Blocks edits until the voice-tone agent has reviewed |
 | `voice-tone-mark-reviewed.sh` | Agent completes | Marks the review as done (TTL: 3600s) |
+| `assistant-voice-tone-stop.sh` | Response stop | Requests one guarded semantic self-review when the assistant guide exists |
 
 ## Agent
 

package/hooks/assistant-voice-tone-stop.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+# Assistant response voice-and-tone Stop hook.
+# If docs/ASSISTANT-VOICE-AND-TONE.md exists, ask the same assistant for one
+# semantic self-review continuation. The stop_hook_active guard prevents loops.
+
+INPUT=$(cat)
+
+[ -f "docs/ASSISTANT-VOICE-AND-TONE.md" ] || exit 0
+
+STOP_HOOK_ACTIVE=$(printf '%s' "$INPUT" | jq -r '.stop_hook_active // false' 2>/dev/null || echo "false")
+[ "$STOP_HOOK_ACTIVE" = "true" ] && exit 0
+
+LAST_ASSISTANT_MESSAGE=$(printf '%s' "$INPUT" | jq -r '.last_assistant_message // empty' 2>/dev/null || echo "")
+[ -n "$LAST_ASSISTANT_MESSAGE" ] || exit 0
+
+jq -n --arg reason 'Review your previous response semantically against docs/ASSISTANT-VOICE-AND-TONE.md. If the response does not align, emit one complete corrected final response in the requested voice and tone. If no correction is needed, finish without adding user-facing commentary. Do not claim standards certification; claim alignment only when relevant.' '{
+  decision: "block",
+  reason: $reason
+}'

package/hooks/hooks.json

@@ -5,7 +5,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/voice-tone-eval.sh"
+            "command": "${PLUGIN_ROOT}/hooks/voice-tone-eval.sh",
+            "additionalContextLimit": 0
           }
         ]
       },
@@ -13,7 +14,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/staleness-check.sh"
+            "command": "${PLUGIN_ROOT}/hooks/staleness-check.sh",
+            "additionalContextLimit": 0
           }
         ]
       }
@@ -33,7 +35,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/bash-write-dispatch.sh\" \"${CLAUDE_PLUGIN_ROOT}/hooks/voice-tone-enforce-edit.sh\""
+            "command": "\"${PLUGIN_ROOT}/hooks/bash-write-dispatch.sh\" \"${PLUGIN_ROOT}/hooks/voice-tone-enforce-edit.sh\""
           }
         ]
       },
@@ -89,6 +91,16 @@
         ]
       }
     ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${PLUGIN_ROOT}/hooks/assistant-voice-tone-stop.sh"
+          }
+        ]
+      }
+    ],
     "SubagentStop": [
       {
         "matcher": "^wr-voice-tone:agent$",

package/hooks/voice-tone-eval.sh

@@ -1,6 +1,8 @@
 #!/bin/bash
 # Voice & Tone - UserPromptSubmit hook (P095 / ADR-038)
 # Detects VOICE-AND-TONE.md in the project and injects delegation instruction.
+# Also injects docs/ASSISTANT-VOICE-AND-TONE.md when a project opts into
+# assistant-response voice guidance.
 # If the file doesn't exist, instructs Claude to create it via the agent.
 #
 # Progressive disclosure (ADR-038): full MANDATORY block on first
@@ -9,9 +11,45 @@
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # shellcheck source=lib/session-marker.sh
 source "$SCRIPT_DIR/lib/session-marker.sh"
+# shellcheck source=lib/gate-helpers.sh
+source "$SCRIPT_DIR/lib/gate-helpers.sh"
 
 INPUT=$(cat)
 SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // empty' 2>/dev/null || echo "")
+ASSISTANT_GUIDE="docs/ASSISTANT-VOICE-AND-TONE.md"
+
+inject_assistant_guide() {
+  [ -f "$ASSISTANT_GUIDE" ] || return 0
+
+  local hash marker hash_file previous_hash
+  hash=$(_substance_hash_path "$ASSISTANT_GUIDE")
+  marker="/tmp/assistant-voice-tone-announced-${SESSION_ID}"
+  hash_file="${marker}.hash"
+
+  if [ -n "$SESSION_ID" ] && [ -f "$marker" ] && [ -f "$hash_file" ]; then
+    previous_hash=$(cat "$hash_file" 2>/dev/null || echo "")
+    [ "$previous_hash" = "$hash" ] && return 0
+  fi
+
+  cat <<'HOOK_OUTPUT'
+INSTRUCTION: ASSISTANT VOICE AND TONE GUIDE ACTIVE.
+The project has opted into assistant-response voice guidance with docs/ASSISTANT-VOICE-AND-TONE.md.
+
+Apply the guide to ordinary assistant responses. Treat named standards and style references as prose guidance for alignment, not as a certification claim.
+
+<assistant-voice-and-tone-guide>
+HOOK_OUTPUT
+  cat "$ASSISTANT_GUIDE"
+  cat <<'HOOK_OUTPUT'
+</assistant-voice-and-tone-guide>
+HOOK_OUTPUT
+
+  if [ -n "$SESSION_ID" ]; then
+    _atomic_mark_with_hash "$marker" "$hash" || return 1
+  fi
+}
+
+inject_assistant_guide
 
 if [ -f "docs/VOICE-AND-TONE.md" ]; then
   if has_announced "voice-tone" "$SESSION_ID"; then

package/hooks-codex/hooks.json

@@ -5,7 +5,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/voice-tone-eval.sh"
+            "command": "${PLUGIN_ROOT}/hooks/voice-tone-eval.sh",
+            "additionalContextLimit": 0
           }
         ]
       },
@@ -13,7 +14,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/staleness-check.sh"
+            "command": "${PLUGIN_ROOT}/hooks/staleness-check.sh",
+            "additionalContextLimit": 0
           }
         ]
       }
@@ -33,7 +35,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/bash-write-dispatch.sh\" \"${CLAUDE_PLUGIN_ROOT}/hooks/voice-tone-enforce-edit.sh\""
+            "command": "\"${PLUGIN_ROOT}/hooks/bash-write-dispatch.sh\" \"${PLUGIN_ROOT}/hooks/voice-tone-enforce-edit.sh\""
           }
         ]
       },
@@ -89,6 +91,16 @@
         ]
       }
     ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${PLUGIN_ROOT}/hooks/assistant-voice-tone-stop.sh"
+          }
+        ]
+      }
+    ],
     "SubagentStop": [
       {
         "matcher": "^wr-voice-tone:agent$",

package/package.json

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

package/skills/update-assistant-guide/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: wr-voice-tone:update-assistant-guide
+description: Create or update docs/ASSISTANT-VOICE-AND-TONE.md for project-specific assistant response voice, tone, and plain-language guidance.
+allowed-tools: Read, Write, Edit, Bash, Glob, Grep, request_user_input
+---
+
+<!-- Generated from the runtime-neutral skill source. Do not edit. -->
+
+> Codex runtime note: invoke installed skills directly, use
+> `request_user_input` only when the contract requires a human decision, and
+> use native Codex subagents for agent delegation. Resolve bundled files from
+> this installed plugin instead of the adopter repository.
+
+
+# Assistant Voice and Tone Guide Generator
+
+Create or update `docs/ASSISTANT-VOICE-AND-TONE.md`. This guide governs the assistant's ordinary responses in this project when the file exists.
+
+This is separate from `docs/VOICE-AND-TONE.md`, which governs project-authored copy and external communications.
+
+## Contract
+
+- File existence is the only opt-in switch.
+- The guide body is prose. Do not add profiles, enabled flags, enforcement settings, deterministic rule tables, or a standards registry.
+- Formal standards such as ISO 24495-1:2023 or ASD-STE100 may be named or described in prose, but the feature claims alignment, not certification.
+- Creative voices should be described as traits and response qualities. Do not promise literal impersonation of a living person.
+- When the user's direction is explicit, write the guide immediately. Do not add another confirmation or consent gate.
+- Preserve unrelated existing prose. Replace or remove conflicting guidance only after confirming that exact change with the user.
+- Never delete the guide unless the user explicitly asks to opt out.
+
+## Workflow
+
+Inspect the current project conventions and any existing `docs/ASSISTANT-VOICE-AND-TONE.md`. Draft concise prose that tells the assistant how responses should read, including any standards or creative traits the user asked for.
+
+Before writing a new guide or materially changing an existing one, use `request_user_input` to confirm the proposed direction when the user's intent is not already explicit.
+
+Write or update the file with:
+
+- a short title;
+- the response voice and tone guidance;
+- any named standards or creative traits expressed as prose;
+- a short note that this is assistant-response guidance and does not certify conformance to external standards.
+
+If updating, report the meaningful changes after writing.
+
+$ARGUMENTS

package/skills/update-assistant-guide/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "WR Voice Tone: Update Assistant Guide"
+  short_description: "Update assistant response voice guidance"