claude-code-autoconfig 1.0.200 → 1.0.202

package/.claude/commands/disable-arcade-beeps.md

@@ -1,10 +1,10 @@
----
-description: Turn OFF Pole Position tab status beeps
-allowed-tools: Bash
----
-
-Run exactly this command, then reply with a single confirmation line and nothing else:
-
-```
-rm -f ~/.claude/sounds/arcade-beeps.enabled && echo "arcade beeps DISABLED."
-```
+---
+description: Turn OFF Pole Position tab status beeps
+allowed-tools: Bash
+---
+
+Run exactly this command, then reply with a single confirmation line and nothing else:
+
+```
+rm -f ~/.claude/sounds/arcade-beeps.enabled && echo "arcade beeps DISABLED."
+```

package/.claude/commands/enable-arcade-beeps.md

@@ -1,10 +1,10 @@
----
-description: Turn ON Pole Position tab status beeps (awaiting = low tone, complete = high tone)
-allowed-tools: Bash
----
-
-Run exactly this command, then reply with a single confirmation line and nothing else:
-
-```
-mkdir -p ~/.claude/sounds && touch ~/.claude/sounds/arcade-beeps.enabled && echo "arcade beeps ENABLED (every turn-end beeps: awaiting=low, complete=high). Disable with /disable-arcade-beeps."
-```
+---
+description: Turn ON Pole Position tab status beeps (awaiting = low tone, complete = high tone)
+allowed-tools: Bash
+---
+
+Run exactly this command, then reply with a single confirmation line and nothing else:
+
+```
+mkdir -p ~/.claude/sounds && touch ~/.claude/sounds/arcade-beeps.enabled && echo "arcade beeps ENABLED (every turn-end beeps: awaiting=low, complete=high). Disable with /disable-arcade-beeps."
+```

package/.claude/hooks/arcade-beeps.js

@@ -1,136 +1,136 @@
-#!/usr/bin/env node
-/**
- * arcade-beeps — optional Pole-Position status cues for the Claude Code tab.
- * Companion to terminal-title.js. Registered (settings.json) on Stop + Notification.
- *
- * OFF unless the enable flag exists:  ~/.claude/sounds/arcade-beeps.enabled
- *   toggle via  /enable-arcade-beeps   /disable-arcade-beeps
- * The flag is GLOBAL (homedir), so one toggle covers every project you've installed into.
- *
- * Mapping (matches the ◐/✻ tab glyph that terminal-title.js paints on the SAME event):
- *   Stop, turn ended on a question   -> ◐ awaiting  -> get-ready tick (pp3-getready-G4.wav, G4/384Hz)
- *   Stop, turn ended normally         -> ✻ complete  -> GO beep        (pp3-go-F#5.wav, F#5/759Hz)
- *   Notification (permission_prompt) -> ◐ awaiting  -> get-ready tick
- *
- * Tones are an extracted+smoothed take on the Pole Position race-start cue (arcade-ping
- * envelope). LOWER tick = awaiting, HIGHER GO = complete.
- *
- * Assets resolve relative to THIS file (../sounds) so a per-project CCA install finds its own
- * copy at <project>/.claude/sounds — no dependency on a global sounds dir.
- *
- * Playback is cross-platform and best-effort: PowerShell SoundPlayer on Windows, afplay on
- * macOS, paplay||aplay on Linux. If none is present the hook simply stays silent — never errors.
- *
- * Playback BLOCKS (spawnSync) so the sound finishes inside the hook's lifetime — a detached
- * fire-and-forget child can be killed by the hook runner's job/process-group cleanup before it
- * plays. Blocking costs ~0.5s on turn-end but is reliable. Still fail-safe: wrapped so it never
- * throws into the turn, and every path ends in exit(0).
- *
- * State detection reuses terminal-title.js's exported inspectLastResponse (lazy-required only
- * when enabled) so sound and glyph agree. A tiny inline '?' check is the fallback.
- *
- * Diagnostic log (bounded ~64KB) at ~/.claude/hooks/.titles/arcade-beeps.log records every
- * invocation + choice, so we can prove whether the hook fires on a real Stop.
- */
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { spawnSync } = require('child_process');
-
-const ASSET_DIR = path.join(__dirname, '..', 'sounds');           // wavs ship beside the hook
-const FLAG = path.join(os.homedir(), '.claude', 'sounds', 'arcade-beeps.enabled'); // global toggle
-const LOG = path.join(os.homedir(), '.claude', 'hooks', '.titles', 'arcade-beeps.log');
-const DEBUG = process.env.ARCADE_BEEPS_DEBUG === '1';
-
-function logLine(msg) {
-  try {
-    try { if (fs.statSync(LOG).size > 64 * 1024) fs.renameSync(LOG, `${LOG}.1`); } catch (_) { /* none yet */ }
-    fs.appendFileSync(LOG, `${new Date().toISOString()}  ${msg}\n`);
-  } catch (_) { /* logging must never throw */ }
-}
-
-function enabled() { try { return fs.existsSync(FLAG); } catch (_) { return false; } }
-function delay(ms) { return new Promise(r => setTimeout(r, ms)); }
-
-// Pick a blocking audio player for the current OS. Returns [cmd, args].
-function playerFor(wav) {
-  if (process.platform === 'win32') {
-    return ['powershell', ['-NoProfile', '-Command', `(New-Object Media.SoundPlayer '${wav}').PlaySync()`]];
-  }
-  if (process.platform === 'darwin') {
-    return ['afplay', [wav]];
-  }
-  // linux / other: prefer paplay (PulseAudio/PipeWire), fall back to aplay (ALSA)
-  return ['sh', ['-c', `paplay "${wav}" 2>/dev/null || aplay "${wav}" 2>/dev/null`]];
-}
-
-function play(wavName, why) {
-  if (DEBUG) process.stderr.write(`arcade-beeps: chose ${wavName} (${why})\n`);
-  logLine(`play ${wavName} (${why})`);
-  try {
-    const wav = path.join(ASSET_DIR, wavName);
-    if (!fs.existsSync(wav)) { logLine(`MISSING ${wav}`); return; }
-    // Block until the sound finishes so it can't be reaped with the hook process.
-    const [cmd, cmdArgs] = playerFor(wav);
-    spawnSync(cmd, cmdArgs, { stdio: 'ignore', windowsHide: true });
-  } catch (e) { logLine(`play-error ${e && e.message}`); }
-}
-
-// Fallback: does the last visible assistant text end on a question? (Mirrors terminal-title.js's regex.)
-function endsOnQuestionInline(transcriptPath) {
-  try {
-    const lines = fs.readFileSync(transcriptPath, 'utf8').split('\n');
-    for (let i = lines.length - 1; i >= 0; i--) {
-      const l = lines[i].trim(); if (!l) continue;
-      let o; try { o = JSON.parse(l); } catch (_) { continue; }
-      if (!o || o.type !== 'assistant' || !o.message) continue;
-      const c = o.message.content; let t = '';
-      if (typeof c === 'string') t = c;
-      else if (Array.isArray(c)) t = c.filter(b => b && b.type === 'text' && typeof b.text === 'string').map(b => b.text).join('\n');
-      if (t.trim()) return /\?[\s)*_"]*(\([^()]*\)[\s.*_"]*)?$/.test(t);
-    }
-  } catch (_) { /* ignore */ }
-  return false;
-}
-
-async function main(input) {
-  let data = {};
-  try { data = JSON.parse(input); } catch (_) { /* ignore */ }
-  const event = data.hook_event_name || '?';
-  const en = enabled();
-  logLine(`invoked event=${event} enabled=${en ? 1 : 0}`);
-  if (!en) return;                               // opt-in only
-
-  if (event === 'Notification') { play('pp3-getready-G4.wav', 'notification'); return; }
-  if (event !== 'Stop') return;
-
-  // awaiting (question) vs complete — same signals terminal-title.js uses, so the tone matches the glyph.
-  const sid = data.session_id || '';
-  const askFile = path.join(os.homedir(), '.claude', 'hooks', '.titles', `${sid}.ask`);
-  let pending = false;
-  try { pending = fs.existsSync(askFile); } catch (_) { /* ignore */ }
-
-  if (!pending) {
-    let inspect = null;
-    try { ({ inspectLastResponse: inspect } = require('./terminal-title.js')); } catch (_) { /* fallback below */ }
-    if (inspect) {
-      let q = inspect(data.transcript_path);
-      let n = 0;
-      while (!q.ends && (q.suspectRace || !q.found) && n < 5) { await delay(120); q = inspect(data.transcript_path); n++; }
-      pending = q.ends;
-    } else {
-      pending = endsOnQuestionInline(data.transcript_path);
-    }
-  }
-
-  play(pending ? 'pp3-getready-G4.wav' : 'pp3-go-F#5.wav', pending ? 'awaiting' : 'complete');
-}
-
-if (require.main === module) {
-  let input = '';
-  process.stdin.setEncoding('utf8');
-  process.stdin.on('data', c => (input += c));
-  process.stdin.on('end', async () => { try { await main(input); } catch (_) { /* ignore */ } process.exit(0); });
-}
-
-module.exports = { endsOnQuestionInline };
+#!/usr/bin/env node
+/**
+ * arcade-beeps — optional Pole-Position status cues for the Claude Code tab.
+ * Companion to terminal-title.js. Registered (settings.json) on Stop + Notification.
+ *
+ * OFF unless the enable flag exists:  ~/.claude/sounds/arcade-beeps.enabled
+ *   toggle via  /enable-arcade-beeps   /disable-arcade-beeps
+ * The flag is GLOBAL (homedir), so one toggle covers every project you've installed into.
+ *
+ * Mapping (matches the ◐/✻ tab glyph that terminal-title.js paints on the SAME event):
+ *   Stop, turn ended on a question   -> ◐ awaiting  -> get-ready tick (pp3-getready-G4.wav, G4/384Hz)
+ *   Stop, turn ended normally         -> ✻ complete  -> GO beep        (pp3-go-F#5.wav, F#5/759Hz)
+ *   Notification (permission_prompt) -> ◐ awaiting  -> get-ready tick
+ *
+ * Tones are an extracted+smoothed take on the Pole Position race-start cue (arcade-ping
+ * envelope). LOWER tick = awaiting, HIGHER GO = complete.
+ *
+ * Assets resolve relative to THIS file (../sounds) so a per-project CCA install finds its own
+ * copy at <project>/.claude/sounds — no dependency on a global sounds dir.
+ *
+ * Playback is cross-platform and best-effort: PowerShell SoundPlayer on Windows, afplay on
+ * macOS, paplay||aplay on Linux. If none is present the hook simply stays silent — never errors.
+ *
+ * Playback BLOCKS (spawnSync) so the sound finishes inside the hook's lifetime — a detached
+ * fire-and-forget child can be killed by the hook runner's job/process-group cleanup before it
+ * plays. Blocking costs ~0.5s on turn-end but is reliable. Still fail-safe: wrapped so it never
+ * throws into the turn, and every path ends in exit(0).
+ *
+ * State detection reuses terminal-title.js's exported inspectLastResponse (lazy-required only
+ * when enabled) so sound and glyph agree. A tiny inline '?' check is the fallback.
+ *
+ * Diagnostic log (bounded ~64KB) at ~/.claude/hooks/.titles/arcade-beeps.log records every
+ * invocation + choice, so we can prove whether the hook fires on a real Stop.
+ */
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const ASSET_DIR = path.join(__dirname, '..', 'sounds');           // wavs ship beside the hook
+const FLAG = path.join(os.homedir(), '.claude', 'sounds', 'arcade-beeps.enabled'); // global toggle
+const LOG = path.join(os.homedir(), '.claude', 'hooks', '.titles', 'arcade-beeps.log');
+const DEBUG = process.env.ARCADE_BEEPS_DEBUG === '1';
+
+function logLine(msg) {
+  try {
+    try { if (fs.statSync(LOG).size > 64 * 1024) fs.renameSync(LOG, `${LOG}.1`); } catch (_) { /* none yet */ }
+    fs.appendFileSync(LOG, `${new Date().toISOString()}  ${msg}\n`);
+  } catch (_) { /* logging must never throw */ }
+}
+
+function enabled() { try { return fs.existsSync(FLAG); } catch (_) { return false; } }
+function delay(ms) { return new Promise(r => setTimeout(r, ms)); }
+
+// Pick a blocking audio player for the current OS. Returns [cmd, args].
+function playerFor(wav) {
+  if (process.platform === 'win32') {
+    return ['powershell', ['-NoProfile', '-Command', `(New-Object Media.SoundPlayer '${wav}').PlaySync()`]];
+  }
+  if (process.platform === 'darwin') {
+    return ['afplay', [wav]];
+  }
+  // linux / other: prefer paplay (PulseAudio/PipeWire), fall back to aplay (ALSA)
+  return ['sh', ['-c', `paplay "${wav}" 2>/dev/null || aplay "${wav}" 2>/dev/null`]];
+}
+
+function play(wavName, why) {
+  if (DEBUG) process.stderr.write(`arcade-beeps: chose ${wavName} (${why})\n`);
+  logLine(`play ${wavName} (${why})`);
+  try {
+    const wav = path.join(ASSET_DIR, wavName);
+    if (!fs.existsSync(wav)) { logLine(`MISSING ${wav}`); return; }
+    // Block until the sound finishes so it can't be reaped with the hook process.
+    const [cmd, cmdArgs] = playerFor(wav);
+    spawnSync(cmd, cmdArgs, { stdio: 'ignore', windowsHide: true });
+  } catch (e) { logLine(`play-error ${e && e.message}`); }
+}
+
+// Fallback: does the last visible assistant text end on a question? (Mirrors terminal-title.js's regex.)
+function endsOnQuestionInline(transcriptPath) {
+  try {
+    const lines = fs.readFileSync(transcriptPath, 'utf8').split('\n');
+    for (let i = lines.length - 1; i >= 0; i--) {
+      const l = lines[i].trim(); if (!l) continue;
+      let o; try { o = JSON.parse(l); } catch (_) { continue; }
+      if (!o || o.type !== 'assistant' || !o.message) continue;
+      const c = o.message.content; let t = '';
+      if (typeof c === 'string') t = c;
+      else if (Array.isArray(c)) t = c.filter(b => b && b.type === 'text' && typeof b.text === 'string').map(b => b.text).join('\n');
+      if (t.trim()) return /\?[\s)*_"]*(\([^()]*\)[\s.*_"]*)?$/.test(t);
+    }
+  } catch (_) { /* ignore */ }
+  return false;
+}
+
+async function main(input) {
+  let data = {};
+  try { data = JSON.parse(input); } catch (_) { /* ignore */ }
+  const event = data.hook_event_name || '?';
+  const en = enabled();
+  logLine(`invoked event=${event} enabled=${en ? 1 : 0}`);
+  if (!en) return;                               // opt-in only
+
+  if (event === 'Notification') { play('pp3-getready-G4.wav', 'notification'); return; }
+  if (event !== 'Stop') return;
+
+  // awaiting (question) vs complete — same signals terminal-title.js uses, so the tone matches the glyph.
+  const sid = data.session_id || '';
+  const askFile = path.join(os.homedir(), '.claude', 'hooks', '.titles', `${sid}.ask`);
+  let pending = false;
+  try { pending = fs.existsSync(askFile); } catch (_) { /* ignore */ }
+
+  if (!pending) {
+    let inspect = null;
+    try { ({ inspectLastResponse: inspect } = require('./terminal-title.js')); } catch (_) { /* fallback below */ }
+    if (inspect) {
+      let q = inspect(data.transcript_path);
+      let n = 0;
+      while (!q.ends && (q.suspectRace || !q.found) && n < 5) { await delay(120); q = inspect(data.transcript_path); n++; }
+      pending = q.ends;
+    } else {
+      pending = endsOnQuestionInline(data.transcript_path);
+    }
+  }
+
+  play(pending ? 'pp3-getready-G4.wav' : 'pp3-go-F#5.wav', pending ? 'awaiting' : 'complete');
+}
+
+if (require.main === module) {
+  let input = '';
+  process.stdin.setEncoding('utf8');
+  process.stdin.on('data', c => (input += c));
+  process.stdin.on('end', async () => { try { await main(input); } catch (_) { /* ignore */ } process.exit(0); });
+}
+
+module.exports = { endsOnQuestionInline };

package/.claude/hooks/terminal-title.directive.md

@@ -53,29 +53,37 @@ Maintain it across the session:
   never "{{FOLDER}} {{EMDASH}} <command-name>").
 
 Pending-question signal -- END-OF-TURN TEST, apply it on every turn: does your final
-paragraph ask the user something you need answered before the work can continue?
-- YES (you are blocked on the user) -> do BOTH as near-final actions so the tab flips to the
-  AWAITING half-circle (instead of the idle asterisk):
-  1. Write the flag file {{ASK_FILE}} (any short content, e.g. "1"). This is the RELIABLE
+paragraph SOLICIT a reply from the user -- a question to answer, a decision to make, or a
+go-ahead on a proposed next step (a fix you proposed, an offer to do more)?
+- YES (the turn ends waiting on the user) -> do ALL THREE as near-final actions so the tab
+  flips to the AWAITING half-circle (instead of the idle asterisk):
+  1. Phrase the solicitation as a DIRECT QUESTION. An offer IS a solicitation: write "Want
+     me to apply both fixes?" -- never its declarative twin ("Say the word and I'll apply
+     both fixes." / "I can also add tests if you want." / "Let me know."), which prompts the
+     user back while hiding the awaiting signal.
+  2. Write the flag file {{ASK_FILE}} (any short content, e.g. "1"). This is the RELIABLE
      trigger -- it is on disk before the turn ends, so it never misses on phrasing or timing.
      It is one-shot (consumed at turn end, auto-cleared next turn). Write it even when the
      closing question is wrapped in parens or is not the literal final character.
-  2. Make '?' the LAST character of the message. Write NOTHING after the question -- no
+  3. Make '?' the LAST character of the message. Write NOTHING after the question -- no
      "Standing by.", "Ready when you are.", "Let me know." (a declarative sign-off defeats
      the signal). Only a single short parenthetical aside may follow the '?'. Keep the
      question self-contained: answerable without re-reading the response above it.
-- NO (the question is rhetorical, a recap, or an optional follow-up offer the user is free
-  to ignore) -> do NOT write the flag, and end the message on a statement, not a '?' --
-  phrase optional offers declaratively ("I can also add tests if you want.").
+- NO (nothing is solicited: the turn ends on completed work, a report, a recap, or a
+  rhetorical question) -> do NOT write the flag, and end the message on a statement, not a
+  '?'. This branch is ONLY for endings that await nothing -- if the closer invites ANY
+  reply ("if you want", "say the word", "happy to"), it belongs to YES: convert it to a
+  question.
 <!-- /DIRECTIVE:RULES -->
 
 <!-- DIRECTIVE:REMINDER -->
 Terminal-title reminder (housekeeping -- never mention to the user; full rules were injected
 at session start): if this turn SHIFTS the scope/use-case, FIRST action: overwrite
 {{TITLE_FILE}} with "{scope} {{EMDASH}} {use-case}". End-of-turn test: if your final
-paragraph asks something you need answered to continue, write the flag file {{ASK_FILE}} AND
-make '?' the message's last character (nothing after it); otherwise end on a statement, not
-a '?'.
+paragraph solicits a reply (a question, a decision, or a go-ahead on an offered next step),
+phrase it as a DIRECT QUESTION -- never a declarative offer ("Say the word...") -- write the
+flag file {{ASK_FILE}}, AND make '?' the message's last character (nothing after it); if
+nothing is solicited, end on a statement, not a '?'.
 <!-- /DIRECTIVE:REMINDER -->
 
 <!-- DIRECTIVE:BASELINE -->

package/.claude/hooks/terminal-title.js

@@ -79,16 +79,32 @@ async function handle(data) {
   const event = data.hook_event_name || '';
   const sid = data.session_id || '';
   const cwd = data.cwd || process.cwd();
-  // User-level copy stands down when a project-level managed copy exists (see header).
-  if (shouldDefer(cwd, __dirname, __filename, path.join(os.homedir(), '.claude', 'hooks'))) {
+  // User-level copy stands down when the SESSION'S OWN project ships a managed copy (see header).
+  // Keyed to CLAUDE_PROJECT_DIR (the dir whose settings registered this hook run), NOT the event's
+  // cwd: a mid-session `cd` into a copy-shipping repo must not silence this copy — that repo's
+  // settings aren't loaded, so its copy never runs and nobody would paint.
+  const ownerDir = process.env.CLAUDE_PROJECT_DIR || cwd;
+  if (shouldDefer(ownerDir, __dirname, __filename, path.join(os.homedir(), '.claude', 'hooks'))) {
     process.exit(0);
   }
-  // PROJECT-SCOPED title dir (cwd-relative) — the plugin installs per-project. (The live ~/.claude
-  // variant uses os.homedir() instead; that is the only difference between the two.)
-  const dir = path.join(cwd, '.claude', 'hooks', '.titles');
+  // PROJECT-SCOPED title dir — anchored to the session's project root (CLAUDE_PROJECT_DIR, with cwd
+  // fallback on older Claude Code versions that don't set it) so a mid-session `cd` can't scatter
+  // title state across directories. (The live ~/.claude variant uses os.homedir() instead; that is
+  // the only difference between the two.)
+  const dir = path.join(ownerDir, '.claude', 'hooks', '.titles');
   const file = path.join(dir, `${sid}.txt`);
   logCtx = { event, sid, dir, note: '' };
 
+  // HARNESS-CONTRACT CANARY (debug-only surface): if Claude Code stops supplying a field the
+  // keying depends on, every fix above silently degrades to its fallback. Record the gap so the
+  // stale-glyph audit surfaces a platform change as one log line instead of the next mystery.
+  const degraded = [];
+  if (!process.env.CLAUDE_PROJECT_DIR) degraded.push('CLAUDE_PROJECT_DIR');
+  if (!data.cwd) degraded.push('cwd');
+  if (!sid) degraded.push('session_id');
+  if (event === 'Stop' && !data.transcript_path) degraded.push('transcript_path');
+  if (degraded.length) logCtx.contract = degraded.join(',');
+
   if (event === 'UserPromptSubmit') {
     // Ensure the state dir exists, but NOT the file — the model's Write tool refuses to overwrite a
     // file it hasn't read, so a pre-created empty file would make its first title write fail.
@@ -182,10 +198,15 @@ async function handle(data) {
     if (q.ends || (q.found && !q.suspectRace)) break;
   }
 
-  const pending = q.ends;
+  // LEXICAL RESCUE — no '?' on the final line, but its closing sentence is a formulaic offer
+  // ("Say the word and I'll…", "Want me to…"): the phrasing directive slipped. Paint ◐ anyway so
+  // the user still gets the awaiting signal; via=lex marks it a prose DEFECT for the miss-audit,
+  // not a working-as-intended path.
+  const lex = !q.ends && q.solicits === true;
+  const pending = q.ends || lex;
   if (logCtx) {
-    logCtx.note = pending ? 'q-mark' : 'idle';
-    logCtx.diag = `ask=0 qmark=${q.ends ? 1 : 0} via=${q.via || '-'} found=${q.found ? 1 : 0} reread=${reread} model=${q.model || '-'} tail="${q.tail}"`;
+    logCtx.note = pending ? (lex ? 'lex' : 'q-mark') : 'idle';
+    logCtx.diag = `ask=0 qmark=${q.ends ? 1 : 0} via=${lex ? 'lex' : (q.via || '-')} found=${q.found ? 1 : 0} reread=${reread} model=${q.model || '-'} tail="${q.tail}"`;
   }
   const glyph = pending ? GLYPH.awaiting : GLYPH.idle;
   emit(setTitle(glyph, normalize(readTitle(file) || folderName(cwd)), pending));
@@ -213,9 +234,10 @@ function titleLog(glyph, title, ring) {
       : glyph === GLYPH.awaiting ? 'awaiting'
       : glyph === GLYPH.idle ? 'idle' : 'other';
     const diag = logCtx.diag ? `  ${logCtx.diag}` : '';
+    const contract = logCtx.contract ? `  contract=degraded(${logCtx.contract})` : '';
     const line = `${new Date().toISOString()}  ${logCtx.event.padEnd(16)} `
       + `${name.padEnd(8)} ring=${ring ? 1 : 0} note=${(logCtx.note || '-').padEnd(8)} `
-      + `sid=${logCtx.sid} | ${title}${diag}\n`;
+      + `sid=${logCtx.sid} | ${title}${diag}${contract}\n`;
     const f = path.join(logCtx.dir, '_debug.log');
     try { if (fs.statSync(f).size > 512 * 1024) fs.renameSync(f, `${f}.1`); } catch (_) { /* none yet */ }
     fs.appendFileSync(f, line);
@@ -235,7 +257,7 @@ function fileExists(file) {
 // shows found=0 (or a stale tail), a genuine regex miss shows a tail that's present but doesn't end
 // in '?'. Any error → a blank record (treated as "no question"), matching the old false return.
 function inspectLastResponse(transcriptPath) {
-  const blank = { ends: false, via: '', found: false, tail: '', suspectRace: false, model: '' };
+  const blank = { ends: false, via: '', found: false, tail: '', suspectRace: false, model: '', solicits: false };
   if (!transcriptPath) return blank;
   let content;
   try {
@@ -301,6 +323,7 @@ function inspectLastResponse(transcriptPath) {
       return {
         ends: q.ends, via: q.via, found: true, tail,
         suspectRace: sawTextlessAssistant, model: (obj.message && obj.message.model) || '',
+        solicits: solicitsReply(text),
       };
     }
     // assistant message with no visible text = a thinking-only or tool_use-only block sitting AFTER the
@@ -352,6 +375,44 @@ function isRealUserPrompt(obj) {
 // Event-loop-friendly sleep for the Stop flush-race re-read beat (handle awaits this; no busy-wait).
 function delay(ms) { return new Promise(resolve => setTimeout(resolve, ms)); }
 
+// LEXICAL solicitation detector (the '?'-less rescue). STRONG, formulaic offer phrases only, tested
+// against the CLOSING SENTENCE of the final non-empty line. Weak/courtesy phrases ("let me know",
+// "if you want", "happy to") are deliberately absent: as sign-offs after completed work they are
+// legitimate statement endings, and enforcing them would trade a rare false-✻ for chronic false-◐.
+// "green-light"/"confirm" are imperative-anchored (sentence-initial) so a recap that merely MENTIONS
+// them ("Andrew green-lighted the batch.") can't fire.
+const SOLICIT_STRONG = [
+  /\bwant me to\b/i,
+  /\bwould you like\b/i,
+  /\bshould i\b/i,
+  /\bshall i\b/i,
+  /\bdo you want\b/i,
+  /\bsay the word\b/i,
+  /\by\/n\b/i,
+  /\bok(?:ay)? to proceed\b/i,
+  /^green-?light\b/i,
+  /^confirm\b/i,
+  // Harvested 2026-07-08 from real _debug.log flag-turn tails — the historical "flag masked the
+  // prose violation" shapes. All are unambiguous waiting-on-you closers:
+  /^tell me\b/i,
+  /\byour call\b/i,
+  /\bready when you are\b/i,
+  /\bstanding by\b/i,
+  /\bon your go\b/i,
+  /\bwhenever you say\b/i,
+];
+function solicitsReply(text) {
+  if (!text) return false;
+  const lines = String(text).trim().split('\n').filter(l => l.trim());
+  const lastLine = (lines[lines.length - 1] || '').trim();
+  // Any '?' on the final line means the question grade (qtail/signoff) owns the verdict — the
+  // lexicon exists solely for the question-less slip, and must never second-guess a graded line.
+  if (!lastLine || lastLine.includes('?')) return false;
+  const parts = lastLine.split(/[.!:;]\s+/);
+  const closing = (parts[parts.length - 1] || '').trim();
+  return SOLICIT_STRONG.some(re => re.test(closing));
+}
+
 // Deferred flag-turn grade (debug-gated). The `.ask` fast path paints ◐ without reading the
 // transcript, which blinded _debug.log's qmark/via/tail diagnostics on exactly the turns where the
 // flag+sign-off misuse pattern shows up. Grading BEFORE emit() would re-open the kill window the
@@ -460,12 +521,15 @@ function buildBlocks(names, file, cwd, cmd) {
 }
 
 // Should THIS copy of the hook stand down? True only for the user-level copy (~/.claude/hooks)
-// running inside a project that ships its own managed copy — the project copy wins, so a session
-// gets ONE directive and ONE title file. Parameterized (no ambient __dirname/homedir) for tests.
-function shouldDefer(cwd, selfDir, selfFile, homeHooksDir) {
+// when the session's OWN project (ownerDir = CLAUDE_PROJECT_DIR, cwd fallback) ships a managed
+// copy — that's the only case where the project copy is registered and will paint; the project
+// copy wins so a session gets ONE directive and ONE title file. The event's live cwd must NOT be
+// used here (mid-session cd into a copy-shipping repo would silence both copies — 2026-07-08).
+// Parameterized (no ambient __dirname/homedir) for tests.
+function shouldDefer(ownerDir, selfDir, selfFile, homeHooksDir) {
   try {
     if (path.resolve(selfDir) !== path.resolve(homeHooksDir)) return false; // we ARE the project copy
-    const projectCopy = path.join(cwd, '.claude', 'hooks', 'terminal-title.js');
+    const projectCopy = path.join(ownerDir, '.claude', 'hooks', 'terminal-title.js');
     return fs.existsSync(projectCopy) && path.resolve(projectCopy) !== path.resolve(selfFile);
   } catch (_) {
     return false;
@@ -481,4 +545,4 @@ function extractBlock(tpl, name) {
 }
 
 // Exported for tests (require()'d when require.main !== module). The hook itself never reads these.
-module.exports = { inspectLastResponse, endsOnQuestion, normalize, GLYPH, shouldDefer };
+module.exports = { inspectLastResponse, endsOnQuestion, normalize, GLYPH, shouldDefer, solicitsReply };

package/.claude/settings.json

@@ -10,7 +10,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node .claude/hooks/migrate-feedback.js"
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/migrate-feedback.js\""
           }
         ]
       },
@@ -19,7 +19,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node .claude/hooks/terminal-title.js"
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/terminal-title.js\""
           }
         ]
       }
@@ -30,7 +30,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node .claude/hooks/terminal-title.js"
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/terminal-title.js\""
           }
         ]
       }
@@ -41,11 +41,11 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node .claude/hooks/terminal-title.js"
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/terminal-title.js\""
           },
           {
             "type": "command",
-            "command": "node .claude/hooks/arcade-beeps.js"
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/arcade-beeps.js\""
           }
         ]
       }
@@ -56,11 +56,11 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node .claude/hooks/terminal-title.js"
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/terminal-title.js\""
           },
           {
             "type": "command",
-            "command": "node .claude/hooks/arcade-beeps.js"
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/arcade-beeps.js\""
           }
         ]
       }
@@ -71,7 +71,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node .claude/hooks/feedback-rule-check.js"
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/feedback-rule-check.js\""
           }
         ]
       },
@@ -80,7 +80,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node .claude/hooks/terminal-title.js"
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/terminal-title.js\""
           }
         ]
       }

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## v1.0.202
+- feat(terminal-title): The 'awaiting your reply' tab indicator now also catches sign-off style endings like 'Ready when you are', and quietly logs a warning if a Claude Code update changes the data the hooks rely on.
+
+## v1.0.201
+- fix(install): Hook commands now survive cd'ing around your project — no more 'Cannot find module' errors after changing directories, and upgrades fix existing installs automatically.
+- fix(terminal-title): The tab title no longer freezes when a session cd's into another project, and the 'awaiting your reply' half-circle now catches replies that ask for your go-ahead without a question mark.
+
 ## v1.0.200
 - feat(changelog): Release notes now written in plain language
 
@@ -143,9 +150,3 @@
 ## v1.0.153
 - style: left-align all table cells in docs info cards
 
-## v1.0.152
-- fix: warn against ! prefix workaround in inside-Claude message
-
-## v1.0.151
-- fix: scope find permission to project directory for security
-