claude-code-autoconfig 1.0.196 → 1.0.198

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

@@ -0,0 +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."
+```

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

@@ -0,0 +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."
+```

package/.claude/docs/autoconfig.docs.html

@@ -878,6 +878,16 @@
                                 <span class="tree-file-icon">📄</span>
                                 <span class="file">commit-and-push.md</span>
                             </div>
+                            <div class="tree-item indent-3 hidden" data-info="disable-arcade-beeps" data-parent="commands">
+                                <span class="tree-spacer"></span>
+                                <span class="tree-file-icon">📄</span>
+                                <span class="file">disable-arcade-beeps.md</span>
+                            </div>
+                            <div class="tree-item indent-3 hidden" data-info="enable-arcade-beeps" data-parent="commands">
+                                <span class="tree-spacer"></span>
+                                <span class="tree-file-icon">📄</span>
+                                <span class="file">enable-arcade-beeps.md</span>
+                            </div>
                             <div class="tree-item indent-3 hidden" data-info="extract-rules" data-parent="commands">
                                 <span class="tree-spacer"></span>
                                 <span class="tree-file-icon">📄</span>
@@ -933,6 +943,11 @@
                                 <span class="tree-folder-icon">📁</span>
                                 <span class="folder">hooks</span>
                             </div>
+                            <div class="tree-item indent-3 hidden" data-info="arcade-beeps-hook" data-parent="hooks">
+                                <span class="tree-spacer"></span>
+                                <span class="tree-file-icon">📄</span>
+                                <span class="file">arcade-beeps.js</span>
+                            </div>
                             <div class="tree-item indent-3 hidden" data-info="feedback-rule-check-hook" data-parent="hooks">
                                 <span class="tree-spacer"></span>
                                 <span class="tree-file-icon">📄</span>
@@ -1263,7 +1278,7 @@
                 title: '.claude/ Directory',
                 desc: 'Commands, rules, settings, and these docs. Keeps configuration organized as your project grows.'
             },
-                                                                                                                                                                                                                                                                                                                                                                                    'rules': {
+                                                                                                                                                                                                                                                                                                                                                                                                                        'rules': {
                 title: 'rules/',
                 desc: 'Path-scoped context that loads when Claude works on matching files.'
             },
@@ -1298,6 +1313,16 @@
                 desc: 'Runs tests, then stages all changes, generates a conventional commit message, commits, and pushes.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0; white-space: nowrap;">Status</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Changes committed and pushed to current branch.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>test-failure</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Tests failed — no commit made.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Runs test suite, stages all changes, creates git commit, pushes to remote</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/commit-and-push</code> <span style="opacity: 0.6;">— Run tests, commit, and push</span></div></div></div>',
                 trigger: '/commit-and-push'
             },
+            'disable-arcade-beeps': {
+                title: 'disable-arcade-beeps.md',
+                desc: 'disable-arcade-beeps.md in commands/<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div>',
+                trigger: '/disable-arcade-beeps'
+            },
+            'enable-arcade-beeps': {
+                title: 'enable-arcade-beeps.md',
+                desc: 'enable-arcade-beeps.md in commands/<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div>',
+                trigger: '/enable-arcade-beeps'
+            },
             'extract-rules': {
                 title: 'extract-rules.md',
                 desc: 'Scan Claude artifacts and extract structured rules into .claude/rules/<div style="margin-top: 12px;"><strong>Parameters</strong><table style="margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0; white-space: nowrap;">Name</th><th style="padding: 4px 8px 4px 0; white-space: nowrap;">Type</th><th style="padding: 4px 8px 4px 0; white-space: nowrap;">Required</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>select</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>string</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">optional</td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Write only specific rules by number: "1,3,5". Default: all.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>keep-sources</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>boolean</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">optional</td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Write rules but skip source cleanup (Step 8)</td></tr></table></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0; white-space: nowrap;">Status</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Rules extracted, written, and sources cleaned up.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>no-rules</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">No extractable rules found in scanned sources.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Creates .claude/rules/ files and removes extracted content from source files</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/extract-rules</code> <span style="opacity: 0.6;">— Scan, propose, prompt for approval, write, and clean up</span></div><div><code>/extract-rules --keep-sources</code> <span style="opacity: 0.6;">— Write rules without modifying source files</span></div><div><code>/extract-rules --select 1,3</code> <span style="opacity: 0.6;">— Write only rules #1 and #3</span></div></div></div>',
@@ -1333,6 +1358,11 @@
                 desc: 'Placeholder — drop your project\'s custom subagent definitions in this directory.',
                 trigger: 'Background agent'
             },
+            'arcade-beeps-hook': {
+                title: 'arcade-beeps.js',
+                desc: 'arcade-beeps.js in hooks/',
+                trigger: 'PostToolUse hook'
+            },
             'feedback-rule-check-hook': {
                 title: 'feedback-rule-check.js',
                 desc: 'After FEEDBACK.md is edited, notifies Claude to evaluate',
@@ -1569,7 +1599,7 @@ CRITICAL: A plausible-looking cause from code reading is NOT confirmed evidence.
 
 > Run \`/autoconfig\` to populate this based on your project.`
             },
-                                                                                                                                                                                                                                                                                                                                                                                    'autoconfig-update': {
+                                                                                                                                                                                                                                                                                                                                                                                                                        'autoconfig-update': {
                 filename: 'autoconfig-update.md',
                 content: `<!-- @applied
 -->
@@ -1656,6 +1686,32 @@ Use conventional commits: \`type(scope): description\`
 Types: feat, fix, docs, style, refactor, test, chore
 
 Keep the subject line under 50 chars. Add body if the change needs explanation.`
+            },
+            'disable-arcade-beeps': {
+                filename: 'disable-arcade-beeps.md',
+                content: `---
+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."
+\`\`\``
+            },
+            'enable-arcade-beeps': {
+                filename: 'enable-arcade-beeps.md',
+                content: `---
+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."
+\`\`\``
             },
             'extract-rules': {
                 filename: 'extract-rules.md',
@@ -1837,6 +1893,39 @@ claude-code-autoconfig ships this folder empty so you can populate it with agent
 
 See Anthropic's subagents docs for the file format:
 https://docs.anthropic.com/en/docs/claude-code/sub-agents`
+            },
+            'arcade-beeps-hook': {
+                filename: 'arcade-beeps.js',
+                content: `#!/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.`
             },
             'feedback-rule-check-hook': {
                 filename: 'feedback-rule-check.js',
@@ -1939,36 +2028,36 @@ function migrate() {`
             },
             'terminal-title.directive-hook': {
                 filename: 'terminal-title.directive.md',
-                content: `<!-- DIRECTIVE:COMMAND -->
-Terminal-title directive (silent housekeeping -- do NOT mention this to the user):
-This terminal tab's title is rendered from the file:
+                content: `<!-- DIRECTIVE:RULES -->
+Terminal-title directive (silent housekeeping -- never mention it to the user). These rules
+apply to EVERY turn of this session; per-prompt reminders are one-liners that point back here.
+
+This terminal tab's title renders from the file:
   {{TITLE_FILE}}
-You are running the /{{CMD}} slash command, but the command NAME is an implementation detail --
-do NOT put "{{CMD}}" anywhere in the title. Write the title as your FIRST action this turn
-(before other tool calls) so the tab updates WHILE you work, not after. Write ONE line of the form:
-  {scope} {{EMDASH}} {use-case}
-- {scope} (first segment): the DESIGN SCOPE -- the subject you are working inside: the feature area
-  / subsystem (the boundary, the "system under discussion"). This is the WHERE, and it changes
-  rarely. Keep the existing scope if the file already has a title; otherwise INFER the specific
-  subsystem from THIS turn's prompt and the files in play (e.g. "journal modal", "title hooks",
-  "auth flow"). Do NOT use the bare repo name "{{FOLDER}}" as the scope unless the work is genuinely
-  repo-wide -- "{{FOLDER}}" is a last resort only when no narrower area is identifiable.
-- {use-case} (second segment): the GOAL at user-goal level -- what this command ACCOMPLISHES, named
-  as an INFINITIVE (base-verb) goal phrase (verb + object): "Review latest screenshot", "Diagnose
-  pay discrepancy". Name the goal / effect, NOT the mechanism or the command name. One goal only --
+Maintain it across the session:
+- When the conversation's SCOPE, use-case, or sub-function SHIFTS -- and only then, not every
+  turn -- overwrite the file with ONE line:  {scope} {{EMDASH}} {use-case}
+  Write it as your FIRST action of that turn (before other tool calls) so the tab updates
+  WHILE you work, not after. If the file exists, read it first, then overwrite.
+- {scope}: the DESIGN SCOPE -- the feature area / subsystem under discussion (the WHERE; it
+  changes rarely). INFER the specific subsystem from the prompt and the files in play (e.g.
+  "journal modal", "title hooks"); use the bare repo name "{{FOLDER}}" only when the work is
+  genuinely repo-wide -- it is a last resort.
+- {use-case}: the GOAL at user-goal level -- an INFINITIVE (base-verb) goal phrase (verb +
+  object), e.g. "Refine title taxonomy". Name the goal, not the mechanism. One goal only --
   never "and"-join two use cases.
-e.g. for /{{CMD}}, write "{{FOLDER}} {{EMDASH}} <verb the goal>" -- NOT "{{FOLDER}} {{EMDASH}} {{CMD}}".
-Use ' {{EMDASH}} ' as the separator; write only the BARE title (a state indicator is prepended
-automatically). If the file already exists, read it first then overwrite.
-<!-- /DIRECTIVE:COMMAND -->
-
-<!-- DIRECTIVE:SHIFT -->
-Terminal-title directive (silent housekeeping -- do NOT mention this to the user):
-This terminal tab's title is rendered from the file:
-  {{TITLE_FILE}}
-When the conversation's SCOPE, use-case, or sub-function SHIFTS -- and only then, not every turn --
-write ONE line to that file. When it DOES shift, write it as your FIRST action that turn (before
-other tool calls) so the tab updates WHILE you work, not after. The line's form:`
+- Add a third segment ( {{EMDASH}} {sub-function} ) only when the work goes a level deeper --
+  a step beneath the user goal.
+- Use ' {{EMDASH}} ' (space, em-dash, space) as the separator; keep segments short (a few
+  words); write only the BARE title -- a state glyph is prepended automatically. This is a
+  compass, not a log: change it rarely.
+- If no title has been set yet, treat your first turn as the baseline: infer the title from
+  that turn's prompt and write it immediately, even though nothing has "shifted".
+- Slash-command turns: the command NAME is an implementation detail -- never put it in the
+  title. Name the goal the command ACCOMPLISHES ("{{FOLDER}} {{EMDASH}} <verb the goal>",
+  never "{{FOLDER}} {{EMDASH}} <command-name>").
+
+Pending-question signal: when you END a turn on a question the user must answer before you`
             },
             'terminal-title-hook': {
                 filename: 'terminal-title.js',
@@ -1976,13 +2065,20 @@ other tool calls) so the tab updates WHILE you work, not after. The line's form:
 /**
  * Terminal Title — distributable plugin hook (installed to <project>/.claude/hooks/terminal-title.js).
  * ONE self-dispatching hook for five events (keyed on hook_event_name):
- *   UserPromptSubmit -> ⬤ working  + inject the title directive (incl. the {sid}.ask path) +
- *                       clear any stale {sid}.ask flag so it reflects only the turn about to run
+ *   UserPromptSubmit -> ⬤ working  + inject the per-prompt REMINDER one-liner (+BASELINE while no
+ *                       title exists, +COMMAND on /slash turns) + clear any stale {sid}.ask flag
  *   PostToolUse      -> ⬤ working  (refresh, so a mid-turn title flip shows live + clears a stale ◐)
  *   Notification     -> ◐ awaiting your approval (permission_prompt matcher only)
  *   Stop             -> ✻ idle / done — OR ◐ awaiting (+ a 2nd BEL = gold tab) when the turn ended
  *                       on a question (last visible response text ends in '?', or a {sid}.ask flag)
  *   SessionStart     -> ✻ idle "Claude Code — New session" (or an existing title on resume/compact)
+ *                       + inject the FULL RULES block — once per session instead of every prompt
+ *                       (~90% less directive overhead); resume/compact re-inject so a squeezed
+ *                       context re-learns the rules.
+ *
+ * Dedupe: when this file is the USER-LEVEL copy (~/.claude/hooks) and the project ships its own
+ * managed copy (<cwd>/.claude/hooks/terminal-title.js), this copy stands down entirely — otherwise
+ * both hooks inject directives naming two different title files (double tokens, double Writes).
  *
  * The title is set TWO ways on every event: \`process.title\` (= SetConsoleTitleW on Windows — the ONLY
  * mechanism that flips the tab on UserPromptSubmit, where Claude Code drops \`terminalSequence\`) AND
@@ -1994,13 +2090,7 @@ other tool calls) so the tab updates WHILE you work, not after. The line's form:
  * ~512KB-capped, written to .titles/_debug.log — so it never ships a growing log.
  *
  * Requires \`env.CLAUDE_CODE_DISABLE_TERMINAL_TITLE = "1"\` (set by plugin.json), or CC's own writer races.
- */
-const fs = require('fs');
-const path = require('path');
-
-const ESC = '\\x1b';
-const BEL = '\\x07';
-const EMDASH = String.fromCodePoint(0x2014);`
+ */`
             },
             'feedback-feedback': {
                 filename: 'FEEDBACK.md',
@@ -2081,6 +2171,10 @@ Claude reads this file but must never write to it. When Claude discovers project
           {
             "type": "command",
             "command": "node .claude/hooks/terminal-title.js"
+          },
+          {
+            "type": "command",
+            "command": "node .claude/hooks/arcade-beeps.js"
           }
         ]
       }
@@ -2092,6 +2186,10 @@ Claude reads this file but must never write to it. When Claude discovers project
           {
             "type": "command",
             "command": "node .claude/hooks/terminal-title.js"
+          },
+          {
+            "type": "command",
+            "command": "node .claude/hooks/arcade-beeps.js"
           }
         ]
       }

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

@@ -0,0 +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 };

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

@@ -1,82 +1,86 @@
-<!--
-  terminal-title.directive.md — the instruction terminal-title.js injects into the
-  model's context on every prompt. THIS is the tunable "product" surface: reword it
-  freely without touching the hook's logic.
-
-  Blocks below:
-    COMMAND — used when the turn starts with a /slash-command
-    SHIFT   — used on a normal turn
-    PENDING — appended to WHICHEVER of the above was selected (shared tail)
-  terminal-title.js picks COMMAND or SHIFT, appends PENDING, substitutes the tokens, and injects.
-
-  Tokens (substituted at runtime):
-    {{TITLE_FILE}} — absolute path to this session's title file the model writes
-    {{ASK_FILE}}   — absolute path to this session's one-shot {sid}.ask flag (PENDING block)
-    {{FOLDER}}     — the working-directory folder name (scope fallback)
-    {{EMDASH}}     — the ' — ' segment separator
-    {{CMD}}        — the slash-command name (COMMAND block only)
--->
-
-<!-- DIRECTIVE:COMMAND -->
-Terminal-title directive (silent housekeeping -- do NOT mention this to the user):
-This terminal tab's title is rendered from the file:
-  {{TITLE_FILE}}
-You are running the /{{CMD}} slash command, but the command NAME is an implementation detail --
-do NOT put "{{CMD}}" anywhere in the title. Write the title as your FIRST action this turn
-(before other tool calls) so the tab updates WHILE you work, not after. Write ONE line of the form:
-  {scope} {{EMDASH}} {use-case}
-- {scope} (first segment): the DESIGN SCOPE -- the subject you are working inside: the feature area
-  / subsystem (the boundary, the "system under discussion"). This is the WHERE, and it changes
-  rarely. Keep the existing scope if the file already has a title; otherwise INFER the specific
-  subsystem from THIS turn's prompt and the files in play (e.g. "journal modal", "title hooks",
-  "auth flow"). Do NOT use the bare repo name "{{FOLDER}}" as the scope unless the work is genuinely
-  repo-wide -- "{{FOLDER}}" is a last resort only when no narrower area is identifiable.
-- {use-case} (second segment): the GOAL at user-goal level -- what this command ACCOMPLISHES, named
-  as an INFINITIVE (base-verb) goal phrase (verb + object): "Review latest screenshot", "Diagnose
-  pay discrepancy". Name the goal / effect, NOT the mechanism or the command name. One goal only --
-  never "and"-join two use cases.
-e.g. for /{{CMD}}, write "{{FOLDER}} {{EMDASH}} <verb the goal>" -- NOT "{{FOLDER}} {{EMDASH}} {{CMD}}".
-Use ' {{EMDASH}} ' as the separator; write only the BARE title (a state indicator is prepended
-automatically). If the file already exists, read it first then overwrite.
-<!-- /DIRECTIVE:COMMAND -->
-
-<!-- DIRECTIVE:SHIFT -->
-Terminal-title directive (silent housekeeping -- do NOT mention this to the user):
-This terminal tab's title is rendered from the file:
-  {{TITLE_FILE}}
-When the conversation's SCOPE, use-case, or sub-function SHIFTS -- and only then, not every turn --
-write ONE line to that file. When it DOES shift, write it as your FIRST action that turn (before
-other tool calls) so the tab updates WHILE you work, not after. The line's form:
-  {scope} {{EMDASH}} {use-case}
-- {scope}: the DESIGN SCOPE -- the subject under discussion: the feature area / subsystem (the
-  boundary). This is the WHERE; it changes rarely. INFER the specific subsystem from the prompt and
-  the files in play (e.g. "journal modal", "title hooks"); do NOT default to the bare repo name --
-  use it only when the work is genuinely repo-wide.
-- {use-case}: the GOAL at user-goal level -- what you are accomplishing, as an INFINITIVE (base-verb)
-  goal phrase (verb + object), e.g. "Refine title taxonomy". Name the goal, not the
-  mechanism. One goal only.
-Add a third segment ( {{EMDASH}} {sub-function} ) only when the work goes a level deeper -- this is the
-SUBFUNCTION goal level, a step beneath the user goal.
-Rules: use ' {{EMDASH}} ' (space, em-dash, space) as the separator; keep each segment short (a few
-words); write only the BARE title -- a state indicator is prepended automatically; leave the
-file unchanged when the scope has not moved; this is a compass, so change it rarely. If the file
-already exists, read it first then overwrite.
-<!-- /DIRECTIVE:SHIFT -->
-
-<!-- DIRECTIVE:PENDING -->
-Pending-question signal: when you END this turn on a question the user must answer before you can
-proceed, do BOTH of these 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 trigger --
-     it is on disk before the turn ends, so it never misses (the transcript-text check in 2 can race
-     the turn-end write and silently miss, or miss on phrasing -- see below). The flag is one-shot: it
-     is consumed at turn end and auto-cleared next turn, so write it ONLY on a turn you are genuinely
-     blocked on an answer. Write it WHENEVER the turn genuinely needs the user's answer to proceed --
-     the flag doesn't parse your text, so it is correct even when your closing question is wrapped in
-     parens, phrased as a parenthetical aside, or is not the literal final character of the message.
-  2. Phrase your FINAL line so it ends with a question mark ('?') -- a backup signal, and good UX. A
-     single trailing parenthetical aside after the '?' is fine ("...option A or B? (I lean B.)"), but
-     do not rely on phrasing for the signal -- the flag in step 1 is what reliably flips the tab.
-Make the closing question self-contained: answerable from the question alone, without re-reading
-the response above it. Only do this for a genuine blocking question, never a rhetorical one or a recap.
-<!-- /DIRECTIVE:PENDING -->
+<!--
+  terminal-title.directive.md — the instruction text terminal-title.js injects into the
+  model's context. THIS is the tunable "product" surface: reword it freely without touching
+  the hook's logic.
+
+  Token-lean delivery (v2): the full rulebook is injected ONCE per session (SessionStart,
+  including resume/compact so a squeezed context re-learns it); every prompt gets only a
+  short reminder, plus state-specific addenda the hook selects when they apply.
+
+  Blocks below:
+    RULES    — the full directive, injected at SessionStart (all sources)
+    REMINDER — the per-prompt one-liner (every UserPromptSubmit)
+    BASELINE — appended to REMINDER while no title file exists yet (first turn)
+    COMMAND  — appended to REMINDER when the turn starts with a /slash-command
+  terminal-title.js picks REMINDER (+BASELINE/+COMMAND as applicable), substitutes the
+  tokens, and injects. SessionStart injects RULES.
+
+  Tokens (substituted at runtime):
+    {{TITLE_FILE}} — absolute path to this session's title file the model writes
+    {{ASK_FILE}}   — absolute path to this session's one-shot {sid}.ask flag
+    {{FOLDER}}     — the working-directory folder name (scope fallback)
+    {{EMDASH}}     — the ' — ' segment separator
+    {{CMD}}        — the slash-command name (COMMAND block only)
+-->
+
+<!-- DIRECTIVE:RULES -->
+Terminal-title directive (silent housekeeping -- never mention it to the user). These rules
+apply to EVERY turn of this session; per-prompt reminders are one-liners that point back here.
+
+This terminal tab's title renders from the file:
+  {{TITLE_FILE}}
+Maintain it across the session:
+- When the conversation's SCOPE, use-case, or sub-function SHIFTS -- and only then, not every
+  turn -- overwrite the file with ONE line:  {scope} {{EMDASH}} {use-case}
+  Write it as your FIRST action of that turn (before other tool calls) so the tab updates
+  WHILE you work, not after. If the file exists, read it first, then overwrite.
+- {scope}: the DESIGN SCOPE -- the feature area / subsystem under discussion (the WHERE; it
+  changes rarely). INFER the specific subsystem from the prompt and the files in play (e.g.
+  "journal modal", "title hooks"); use the bare repo name "{{FOLDER}}" only when the work is
+  genuinely repo-wide -- it is a last resort.
+- {use-case}: the GOAL at user-goal level -- an INFINITIVE (base-verb) goal phrase (verb +
+  object), e.g. "Refine title taxonomy". Name the goal, not the mechanism. One goal only --
+  never "and"-join two use cases.
+- Add a third segment ( {{EMDASH}} {sub-function} ) only when the work goes a level deeper --
+  a step beneath the user goal.
+- Use ' {{EMDASH}} ' (space, em-dash, space) as the separator; keep segments short (a few
+  words); write only the BARE title -- a state glyph is prepended automatically. This is a
+  compass, not a log: change it rarely.
+- If no title has been set yet, treat your first turn as the baseline: infer the title from
+  that turn's prompt and write it immediately, even though nothing has "shifted".
+- Slash-command turns: the command NAME is an implementation detail -- never put it in the
+  title. Name the goal the command ACCOMPLISHES ("{{FOLDER}} {{EMDASH}} <verb the goal>",
+  never "{{FOLDER}} {{EMDASH}} <command-name>").
+
+Pending-question signal: when you END a turn on a question the user must answer before you
+can proceed, 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
+     trigger -- it is on disk before the turn ends, so it never misses on phrasing or timing.
+     The flag is one-shot (consumed at turn end, auto-cleared next turn), so write it ONLY on
+     a turn genuinely blocked on an answer -- but ALWAYS then, even when the closing question
+     is wrapped in parens or is not the literal final character of the message.
+  2. Phrase your FINAL line to end with a question mark ('?') -- the backup signal, and good
+     UX. A single trailing parenthetical aside after the '?' is fine.
+Make the closing question self-contained: answerable without re-reading the response above
+it. Never signal for a rhetorical question or a recap.
+<!-- /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}". If you END this turn blocked on a
+question, write the flag file {{ASK_FILE}} and end your final line with '?'.
+<!-- /DIRECTIVE:REMINDER -->
+
+<!-- DIRECTIVE:BASELINE -->
+No title is set yet -- treat THIS turn as the baseline: infer {scope} {{EMDASH}} {use-case}
+from this prompt and the files in play, and write {{TITLE_FILE}} NOW (first action). Do not
+default to the bare folder name "{{FOLDER}}" unless the work is genuinely repo-wide.
+<!-- /DIRECTIVE:BASELINE -->
+
+<!-- DIRECTIVE:COMMAND -->
+This turn runs the /{{CMD}} slash command -- the command NAME is an implementation detail:
+never put "{{CMD}}" in the title. If the scope shifted, name the goal the command
+ACCOMPLISHES (e.g. "<area> {{EMDASH}} <verb the goal>").
+<!-- /DIRECTIVE:COMMAND -->

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

@@ -2,13 +2,20 @@
 /**
  * Terminal Title — distributable plugin hook (installed to <project>/.claude/hooks/terminal-title.js).
  * ONE self-dispatching hook for five events (keyed on hook_event_name):
- *   UserPromptSubmit -> ⬤ working  + inject the title directive (incl. the {sid}.ask path) +
- *                       clear any stale {sid}.ask flag so it reflects only the turn about to run
+ *   UserPromptSubmit -> ⬤ working  + inject the per-prompt REMINDER one-liner (+BASELINE while no
+ *                       title exists, +COMMAND on /slash turns) + clear any stale {sid}.ask flag
  *   PostToolUse      -> ⬤ working  (refresh, so a mid-turn title flip shows live + clears a stale ◐)
  *   Notification     -> ◐ awaiting your approval (permission_prompt matcher only)
  *   Stop             -> ✻ idle / done — OR ◐ awaiting (+ a 2nd BEL = gold tab) when the turn ended
  *                       on a question (last visible response text ends in '?', or a {sid}.ask flag)
  *   SessionStart     -> ✻ idle "Claude Code — New session" (or an existing title on resume/compact)
+ *                       + inject the FULL RULES block — once per session instead of every prompt
+ *                       (~90% less directive overhead); resume/compact re-inject so a squeezed
+ *                       context re-learns the rules.
+ *
+ * Dedupe: when this file is the USER-LEVEL copy (~/.claude/hooks) and the project ships its own
+ * managed copy (<cwd>/.claude/hooks/terminal-title.js), this copy stands down entirely — otherwise
+ * both hooks inject directives naming two different title files (double tokens, double Writes).
  *
  * The title is set TWO ways on every event: `process.title` (= SetConsoleTitleW on Windows — the ONLY
  * mechanism that flips the tab on UserPromptSubmit, where Claude Code drops `terminalSequence`) AND
@@ -23,6 +30,7 @@
  */
 const fs = require('fs');
 const path = require('path');
+const os = require('os');
 
 const ESC = '\x1b';
 const BEL = '\x07';
@@ -61,6 +69,10 @@ 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'))) {
+    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');
@@ -96,7 +108,14 @@ async function handle(data) {
   if (event === 'SessionStart') {
     // Fresh-session placeholder; on resume/compact an existing model-authored title is preferred.
     const title = normalize(readTitle(file) || 'Claude Code - New session');
-    emit(setTitle(GLYPH.idle, title));
+    const out = setTitle(GLYPH.idle, title);
+    // Inject the FULL rulebook here — once per session — instead of on every prompt. All sources
+    // get it: startup/clear teach a fresh context, resume/compact re-teach a squeezed one.
+    const rules = buildBlocks(['RULES'], file, cwd, '');
+    if (rules) {
+      out.hookSpecificOutput = { hookEventName: 'SessionStart', additionalContext: rules };
+    }
+    emit(out);
     return;
   }
 
@@ -281,28 +300,47 @@ function emit(obj) {
   process.exit(0);
 }
 
-// Build the injected directive from terminal-title.directive.md (COMMAND block for a /slash-command
-// turn, SHIFT otherwise; PENDING tail appended). Wording lives in the .md so it tunes without code edits.
+// Build the per-prompt injection: the REMINDER one-liner, plus BASELINE while no title file
+// exists yet (first turn), plus COMMAND on a /slash-command turn. The full rulebook (RULES) is
+// injected by SessionStart, not here. Wording lives in the .md so it tunes without code edits.
 function buildDirective(data, file, cwd) {
+  const prompt = typeof data.prompt === 'string' ? data.prompt : '';
+  const m = prompt.match(/^\s*\/([A-Za-z0-9][\w:.-]*)/);
+  const blocks = ['REMINDER'];
+  if (!fileExists(file)) blocks.push('BASELINE');
+  if (m) blocks.push('COMMAND');
+  return buildBlocks(blocks, file, cwd, m ? m[1] : '');
+}
+
+// Extract the named blocks from terminal-title.directive.md, join them, substitute the tokens.
+function buildBlocks(names, file, cwd, cmd) {
   let tpl = '';
   try {
     tpl = fs.readFileSync(path.join(__dirname, 'terminal-title.directive.md'), 'utf8');
   } catch (_) {
     return '';
   }
-  const prompt = typeof data.prompt === 'string' ? data.prompt : '';
-  const m = prompt.match(/^\s*\/([A-Za-z0-9][\w:.-]*)/);
-  const cmd = m ? m[1] : '';
-  const block = extractBlock(tpl, cmd ? 'COMMAND' : 'SHIFT');
-  if (!block) return '';
-  const pending = extractBlock(tpl, 'PENDING');
-  const combined = pending ? `${block}\n\n${pending}` : block;
-  return combined
+  const parts = names.map(n => extractBlock(tpl, n)).filter(Boolean);
+  if (!parts.length) return '';
+  return parts.join('\n')
     .split('{{TITLE_FILE}}').join(file)
     .split('{{ASK_FILE}}').join(file.replace(/\.txt$/, '.ask'))
     .split('{{FOLDER}}').join(folderName(cwd))
     .split('{{EMDASH}}').join(EMDASH)
-    .split('{{CMD}}').join(cmd);
+    .split('{{CMD}}').join(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) {
+  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');
+    return fs.existsSync(projectCopy) && path.resolve(projectCopy) !== path.resolve(selfFile);
+  } catch (_) {
+    return false;
+  }
 }
 
 function extractBlock(tpl, name) {
@@ -314,4 +352,4 @@ function extractBlock(tpl, name) {
 }
 
 // Exported for tests (require()'d when require.main !== module). The hook itself never reads these.
-module.exports = { inspectLastResponse, normalize, GLYPH };
+module.exports = { inspectLastResponse, normalize, GLYPH, shouldDefer };

package/.claude/settings.json

@@ -42,6 +42,10 @@
           {
             "type": "command",
             "command": "node .claude/hooks/terminal-title.js"
+          },
+          {
+            "type": "command",
+            "command": "node .claude/hooks/arcade-beeps.js"
           }
         ]
       }
@@ -53,6 +57,10 @@
           {
             "type": "command",
             "command": "node .claude/hooks/terminal-title.js"
+          },
+          {
+            "type": "command",
+            "command": "node .claude/hooks/arcade-beeps.js"
           }
         ]
       }

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## v1.0.198
+- feat(arcade-beeps): ship opt-in Pole Position status beeps via CCA
+
+## v1.0.197
+- perf(terminal-title): deliver the directive once per session; dedupe user/project hooks
+
 ## v1.0.196
 - fix(terminal-title): stop at the turn boundary when grading the closing '?' (stale-awaiting race)
 - fix(cli): require non-TTY stdout for inside-Claude block (env var alone false-positives in inherited terminals)
@@ -142,9 +148,3 @@
 ## v1.0.149
 - style: consolidate inside-Claude message to two lines
 
-## v1.0.148
-- fix: refine inside-Claude error wording
-
-## v1.0.147
-- fix: make inside-Claude error message more specific
-

package/CLAUDE.md

@@ -42,17 +42,13 @@ See `.claude/feedback/` for corrections and guidance from the team.
 ## Discoveries
 <!-- Claude: append project-specific learnings, gotchas, and context below. This section persists across /autoconfig runs. -->
 
-### Publishing to npm — web-auth (passkey) flow, run by the human
+### Publishing to npm — bypass-2FA token flow (web-auth publish is a DEAD END)
 
-`npm publish` for this package is a **two-actor** flow; a bare in-agent `npm publish` will FAIL. (Supersedes the auto-generated "## Publishing" one-liner above.)
+(Supersedes the auto-generated "## Publishing" one-liner above.)
 
-- The npm account has **2FA**. A sandboxed/agent shell can't open a browser, so `npm publish` there dies with `npm error code EOTP`. Don't retry it in-agent; don't default to asking for a typed OTP.
-- **Working flow:** the agent runs `npm test` + `npm version patch` (commit + tag), then the **human runs the publish in their own terminal** (needs a browser):
-  ```
-  cd C:\CODE\claude-code-autoconfig && npm login --auth-type=web && npm publish
-  ```
-  → browser opens → pick the Google passkey → close it → `+ claude-code-autoconfig@<version>`.
-- **After** the success line, the agent pushes: `git push origin main --follow-tags`. Never double-bump if the version is already bumped. Full procedure: `.claude/commands/deploy-to-npmjs.md` (`/deploy-to-npmjs`).
+- **Primary flow (agent can do it end-to-end):** `npm test` + `npm version patch` (commit + tag) → `npm whoami` to verify the Bypass-2FA granular token in `~/.npmrc` still authenticates → plain `npm publish` (works headless, no OTP) → after the `+ claude-code-autoconfig@<version>` line, `git push origin main --follow-tags`. Never double-bump if the version is already bumped.
+- **If `npm whoami` returns E401**, the token is dead/expired (90-day cap). The human rotates it (npmjs.com → Access Tokens → Granular → "Bypass 2FA", read-write, scoped to this package only) and pastes it into `~/.npmrc` in an editor — never via a command. Stopgap without a token: `npm publish --otp=<recovery-code>` in the human's own terminal.
+- **Do NOT use `npm login --auth-type=web && npm publish`:** login succeeds but publish still dies `EOTP` — the npm CLI can't route publish-time 2FA to the browser on this webauthn-only account (confirmed 2026-07-03, npm 10.9.2). Don't retry it in-agent, and don't ask for a typed TOTP (none exists). Full procedure: `.claude/commands/deploy-to-npmjs.md` (`/deploy-to-npmjs`).
 
 ## Debugging Methodology — Evidence Before Solutions
 

package/README.md

@@ -61,7 +61,8 @@ your-project/
     ├── hooks/                         # Hook scripts
     │   ├── format.js                  #   Auto-format on Write/Edit
     │   ├── terminal-title.js          #   Use-case terminal tab titles + live state
-    │   └── terminal-title.directive.md # Injected title directive (tunable wording)
+    │   ├── terminal-title.directive.md # Injected title directive (tunable wording)
+    │   └── arcade-beeps.js            #   Optional Pole Position status beeps (opt-in)
     ├── docs/                          # Interactive documentation
     │   └── autoconfig.docs.html       #   Open with /show-docs
     ├── updates/                       # Pending config updates
@@ -70,6 +71,9 @@ your-project/
     │   └── readme-sync.md             #   Sync README & docs before publish
     ├── scripts/                       # Utility scripts
     │   └── sync-docs.js               #   Regenerate interactive HTML docs
+    ├── sounds/                        # Status-cue audio for arcade-beeps
+    │   ├── pp3-getready-G4.wav        #   Awaiting tone (get-ready tick)
+    │   └── pp3-go-F#5.wav             #   Complete tone (GO beep)
     ├── .mcp.json                      # MCP server configs (empty placeholder)
     └── settings.json                  # Permissions & security
 ```
@@ -110,6 +114,8 @@ Autoconfig is **self-configuring**. Run `/autoconfig` and Claude:
 | `/gls` | Views latest screenshot for visual context |
 | `/validate-cca-install` | Validates installation against latest published version |
 | `/extract-rules` | Scan Claude artifacts and extract structured rules |
+| `/enable-arcade-beeps` | Turn on opt-in Pole Position status beeps |
+| `/disable-arcade-beeps` | Turn off the status beeps |
 
 ### Updates
 
@@ -135,6 +141,10 @@ Autoconfig writes a debug methodology to Claude's persistent memory (`MEMORY.md`
 
 Run several Claude Code sessions at once and the tabs all look alike. Autoconfig retitles each tab as `{scope} — {what you're working on}` with a live state indicator — ⬤ working, ◐ waiting on you, ✻ idle — so you can tell sessions apart at a glance. Claude updates the title itself as the work shifts; nothing to configure.
 
+### Status Beeps (opt-in)
+
+Prefer your ears to your eyes? Run `/enable-arcade-beeps` for Pole Position–style tab cues that mirror the title glyph: a low get-ready tick when a session is **waiting on you** and a higher GO tone when it **finishes**. Cross-platform (Windows / macOS / Linux) and off by default — toggle back off any time with `/disable-arcade-beeps`.
+
 ### Team Feedback
 
 When Claude makes a mistake, add an entry to `.claude/feedback/FEEDBACK.md`:

package/bin/cli.js

@@ -27,7 +27,7 @@ const WINDOWS_RESERVED = ['CON', 'PRN', 'AUX', 'NUL', 'COM1', 'COM2', 'COM3', 'C
   'LPT6', 'LPT7', 'LPT8', 'LPT9'];
 
 // Files/folders installed by autoconfig - don't backup these
-const AUTOCONFIG_FILES = ['commands', 'docs', 'agents', 'migration', 'hooks', 'scripts', 'rules', 'feedback', 'settings.json', 'settings.local.json', '.mcp.json', '.autoconfig-version', '.autoconfig-plugins.json'];
+const AUTOCONFIG_FILES = ['commands', 'docs', 'agents', 'migration', 'hooks', 'scripts', 'sounds', 'rules', 'feedback', 'settings.json', 'settings.local.json', '.mcp.json', '.autoconfig-version', '.autoconfig-plugins.json'];
 
 function isReservedName(name) {
   const baseName = name.replace(/\.[^.]*$/, '').toUpperCase();
@@ -775,7 +775,7 @@ if (fs.existsSync(feedbackSrc)) {
 // (copyDirIfMissing), BUT the cca-managed title-hook files are ALWAYS refreshed so bug-fixes
 // reach existing installs — without this, copyDirIfMissing leaves stale hooks in place forever
 // (same always-overwrite rationale as scripts/ below). --force already overwrites everything.
-const MANAGED_HOOKS = ['terminal-title.js', 'terminal-title.directive.md'];
+const MANAGED_HOOKS = ['terminal-title.js', 'terminal-title.directive.md', 'arcade-beeps.js'];
 if (fs.existsSync(hooksSrc)) {
   const copyFn = forceMode ? copyDir : copyDirIfMissing;
   copyFn(hooksSrc, path.join(claudeDest, 'hooks'));
@@ -793,6 +793,12 @@ if (fs.existsSync(scriptsSrc)) {
   copyDir(scriptsSrc, path.join(claudeDest, 'scripts'));
 }
 
+// Copy sounds directory (binary status-cue assets for arcade-beeps; always overwrite)
+const soundsSrc = path.join(packageDir, '.claude', 'sounds');
+if (fs.existsSync(soundsSrc)) {
+  copyDir(soundsSrc, path.join(claudeDest, 'sounds'));
+}
+
 // Note: updates directory is no longer copied to user projects.
 // Update files are only used by --pull-updates (for /autoconfig-update).
 // On fresh install, all updates are pre-marked as applied and the content

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-autoconfig",
-  "version": "1.0.196",
+  "version": "1.0.198",
   "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",
@@ -23,14 +23,14 @@
   ],
   "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",
-    "pub": "npm login --auth-type=web && npm publish",
+    "pub": "npm whoami && npm publish",
     "test:box": "node test/box-alignment.test.js",
     "test:install": "node test/cli-install.test.js",
     "test:update": "node test/update-system.test.js",
     "postversion": "node scripts/generate-changelog.js --postversion"
   },
   "bin": {
-    "claude-code-autoconfig": "./bin/cli.js"
+    "claude-code-autoconfig": "bin/cli.js"
   },
   "files": [
     "bin",