claude-code-autoconfig 1.0.201 → 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.js

@@ -95,6 +95,16 @@ async function handle(data) {
   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.
@@ -224,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);
@@ -381,6 +392,14 @@ const SOLICIT_STRONG = [
   /\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;

package/CHANGELOG.md

@@ -1,5 +1,8 @@
 # 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.
@@ -147,6 +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
-

package/bin/cli.js

@@ -165,7 +165,8 @@ if (process.argv.includes('--pull-updates')) {
 //   2. mergeSettingsInto dedups by EXACT command string, so without this rewrite an upgrade
 //      would ADD the anchored template entry alongside the user's old relative one -> the
 //      hook runs twice per event.
-// Only known autoconfig-managed hook filenames are rewritten; user-authored commands are
+// Any .claude/hooks/*.js relative command is rewritten — anchored resolution is identical at
+// the project root and cd-proof everywhere else — while commands outside .claude/hooks are
 // never touched.
 function migrateLegacyHookCommands(userSettings) {
   if (!userSettings || !userSettings.hooks) return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-autoconfig",
-  "version": "1.0.201",
+  "version": "1.0.202",
   "description": "Intelligent, self-configuring setup for Claude Code. One command analyzes your project, configures Claude, and shows you what it did.",
   "author": "ADAC 1001 <info@adac1001.com>",
   "license": "MIT",
@@ -22,7 +22,7 @@
     "cli"
   ],
   "scripts": {
-    "test": "node test/box-alignment.test.js && node test/cli-install.test.js && node test/update-system.test.js && node test/plugin-system.test.js && node test/terminal-title.test.js && node test/update-summary.test.js && node test/changelog-gen.test.js",
+    "test": "node test/box-alignment.test.js && node test/cli-install.test.js && node test/update-system.test.js && node test/plugin-system.test.js && node test/terminal-title.test.js && node test/golden-endings.test.js && node test/live-twin-parity.test.js && node test/update-summary.test.js && node test/changelog-gen.test.js",
     "pub": "npm whoami && npm publish",
     "test:box": "node test/box-alignment.test.js",
     "test:install": "node test/cli-install.test.js",