claude-code-autoconfig 1.0.188 → 1.0.191

package/.claude/commands/autoconfig.md

@@ -270,12 +270,7 @@ Run `/show-docs` to view the interactive documentation (requires full install vi
 
 **IMPORTANT**: Do not add any additional text, summaries, or details after this message. The finale should be clean and punchy - end here.
 
-### Windows Cleanup
-
-On Windows, if a `nul` file was accidentally created in the project root (a common artifact from bash/Unix command translation), delete it silently using the Bash tool:
-
-```bash
-[ -f nul ] && rm nul
-```
-
-Do this cleanup silently without any output to the user.
+> Note: any stray `nul` file (a Windows bash-translation artifact) is cleaned up
+> automatically by `bin/cli.js` (`cleanupNulFile()` runs on startup and on Claude
+> exit). Do NOT instruct the model to `rm nul` here — a Bash cleanup after the
+> finale only triggers a permission prompt and contradicts the "end here" rule above.

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

@@ -953,6 +953,11 @@
                                 <span class="tree-file-icon">📄</span>
                                 <span class="file">migrate-feedback.js</span>
                             </div>
+                            <div class="tree-item indent-3 hidden" data-info="terminal-title-hook" data-parent="hooks">
+                                <span class="tree-spacer"></span>
+                                <span class="tree-file-icon">📄</span>
+                                <span class="file">terminal-title.js</span>
+                            </div>
                             <div class="tree-item indent-2 folder-row hidden collapsed" data-info="docs" data-folder="docs-folder" data-parent="claude-dir">
                                 <span class="tree-chevron">›</span>
                                 <span class="tree-folder-icon">📁</span>
@@ -1348,6 +1353,11 @@
                 desc: 'On session start, migrates custom FEEDBACK.md content to',
                 trigger: 'SessionStart'
             },
+            'terminal-title-hook': {
+                title: 'terminal-title.js',
+                desc: 'Use-case-framed terminal tab titles with live working / idle / awaiting state indicators, so multiple Claude sessions are easy to tell apart',
+                trigger: 'SessionStart, UserPromptSubmit, PostToolUse, Notification, Stop'
+            },
             'feedback-feedback': {
                 title: 'FEEDBACK.md',
                 desc: 'Human-authored corrections and guidance for Claude. Reserved for team feedback only — Claude must not write here. This directory persists across /autoconfig runs.'

package/.claude/hooks/.titles/25869694-a68e-449f-8240-f1ff2b80c1d4.txt

@@ -0,0 +1 @@
+terminal-title indicator — Ship hook to npm

package/.claude/hooks/.titles/_debug.log

@@ -0,0 +1,43 @@
+2026-06-24T21:04:44.135Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Add state-paint logging
+2026-06-24T21:05:20.044Z  Notification     awaiting ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Add state-paint logging
+2026-06-24T21:06:38.854Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Add state-paint logging
+2026-06-24T21:07:32.793Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Add state-paint logging
+2026-06-24T21:08:11.474Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Add state-paint logging
+2026-06-24T21:08:34.425Z  Stop             idle     ring=0 note=idle     sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Add state-paint logging
+2026-06-24T21:09:29.128Z  UserPromptSubmit working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Add state-paint logging
+2026-06-24T21:10:28.948Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:10:29.615Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:10:47.307Z  Notification     awaiting ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:11:11.991Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:11:26.335Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:12:01.200Z  Notification     awaiting ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:13:50.152Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:14:05.826Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:14:43.748Z  Notification     awaiting ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:15:28.698Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:16:51.777Z  Notification     awaiting ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:16:53.117Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:17:35.995Z  Notification     awaiting ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:17:45.796Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:18:33.037Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:18:59.216Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:19:58.103Z  Notification     awaiting ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:20:40.272Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:22:39.312Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:22:59.865Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:23:01.457Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:23:24.084Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:24:38.813Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-24T21:25:48.233Z  Notification     awaiting ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-25T04:33:43.177Z  UserPromptSubmit working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Audit migration & deploy status
+2026-06-25T04:34:48.715Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Ship hook to npm
+2026-06-25T04:34:49.532Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Ship hook to npm
+2026-06-25T04:35:01.572Z  Notification     awaiting ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Ship hook to npm
+2026-06-25T04:36:15.708Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Ship hook to npm
+2026-06-25T04:36:54.790Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Ship hook to npm
+2026-06-25T04:38:01.871Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Ship hook to npm
+2026-06-25T04:38:38.209Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Ship hook to npm
+2026-06-25T04:39:09.841Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Ship hook to npm
+2026-06-25T04:39:40.870Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Ship hook to npm
+2026-06-25T04:40:25.526Z  PostToolUse      working  ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Ship hook to npm
+2026-06-25T04:40:46.587Z  Notification     awaiting ring=0 note=-        sid=25869694-a68e-449f-8240-f1ff2b80c1d4 | Terminal-title indicator — Ship hook to npm

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

@@ -0,0 +1,71 @@
+<!--
+  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
+    {{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: if you END this turn by asking the user a question they must answer
+before you can proceed, phrase it so your FINAL line ends with a question mark ('?') -- the tab
+indicator then flips to the AWAITING half-circle automatically (instead of the idle asterisk).
+Make the closing question self-contained: answerable from the question alone, without re-reading
+the response above it. Only end on a '?' for a genuine blocking question, never a rhetorical one.
+<!-- /DIRECTIVE:PENDING -->

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

@@ -0,0 +1,235 @@
+#!/usr/bin/env node
+/**
+ * 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 into the model's context
+ *   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)
+ *
+ * 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
+ * `terminalSequence` (honored on the other events). node writes UTF-8 natively, so glyphs go out as-is.
+ *
+ * Title files are PROJECT-SCOPED at <cwd>/.claude/hooks/.titles/<session_id>.txt — the model authors
+ * them; the directive injected each prompt tells it the path + format. Optional forensic log (one line
+ * per paint, for tracing an out-of-sync tab) is gated behind CLAUDE_TITLE_DEBUG=1 — default OFF,
+ * ~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);
+
+// State glyphs, built from code points so an editor can't strip the invisible variation selector.
+//   working  = U+26AB MEDIUM BLACK CIRCLE + U+FE0E VS15 (text presentation, not emoji)
+//   awaiting = U+25D0 half-filled circle — paused, awaiting your approval/answer
+//   idle     = U+273B teardrop-spoked asterisk (Claude Code brand mark) while idle/done
+const GLYPH = {
+  working: String.fromCodePoint(0x26AB, 0xFE0E),
+  awaiting: String.fromCodePoint(0x25D0),
+  idle: String.fromCodePoint(0x273B),
+};
+
+// Per-invocation context for the optional debug log (populated in handle, read by titleLog).
+let logCtx = null;
+
+let input = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', chunk => (input += chunk));
+process.stdin.on('end', () => {
+  try {
+    handle(JSON.parse(input));
+  } catch (err) {
+    process.exit(0); // never break the turn on a title error — emit nothing
+  }
+});
+
+function handle(data) {
+  const event = data.hook_event_name || '';
+  const sid = data.session_id || '';
+  const cwd = data.cwd || process.cwd();
+  // 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');
+  const file = path.join(dir, `${sid}.txt`);
+  logCtx = { event, sid, dir, note: '' };
+
+  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.
+    try { fs.mkdirSync(dir, { recursive: true }); } catch (_) { /* ignore */ }
+    const title = normalize(readTitle(file) || folderName(cwd));
+    const out = setTitle(GLYPH.working, title);
+    out.hookSpecificOutput = {
+      hookEventName: 'UserPromptSubmit',
+      additionalContext: buildDirective(data, file, cwd),
+    };
+    emit(out);
+    return;
+  }
+
+  if (event === 'PostToolUse') {
+    // Only refresh once a real title exists; don't stamp the bare folder over what UPS showed.
+    const raw = readTitle(file);
+    if (!raw) process.exit(0);
+    emit(setTitle(GLYPH.working, normalize(raw)));
+    return;
+  }
+
+  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));
+    return;
+  }
+
+  if (event === 'Notification') {
+    // A permission prompt is open. Single BEL only — CC already rings its own bell here (tab already gold).
+    emit(setTitle(GLYPH.awaiting, normalize(readTitle(file) || folderName(cwd))));
+    return;
+  }
+
+  // Stop: idle, UNLESS the turn ended on a question the user must answer — then awaiting + a 2nd BEL
+  // so VS Code paints the (otherwise bell-less) tab gold. "Ended on a question" = last visible
+  // assistant text ends in '?' (transcript heuristic) OR an explicit {sid}.ask flag (consumed here).
+  const askFile = path.join(dir, `${sid}.ask`);
+  let pending = lastResponseEndsWithQuestion(data.transcript_path);
+  let note = pending ? 'q-mark' : 'idle';
+  if (!pending && fileExists(askFile)) { pending = true; note = 'ask-flag'; }
+  if (fileExists(askFile)) { try { fs.unlinkSync(askFile); } catch (_) { /* ignore */ } }
+  if (logCtx) logCtx.note = note;
+  const glyph = pending ? GLYPH.awaiting : GLYPH.idle;
+  emit(setTitle(glyph, normalize(readTitle(file) || folderName(cwd)), pending));
+}
+
+// Set the tab title two ways and return the hook payload. `process.title` is the instant flip and the
+// only mechanism CC honors on UserPromptSubmit. `ring` appends a second BEL (Stop-awaiting only) →
+// VS Code renders a gold "needs you" tab.
+function setTitle(glyph, title, ring) {
+  const text = `${glyph} ${title}`;
+  try { process.title = text; } catch (_) { /* ignore */ }
+  let seq = `${ESC}]0;${text}${BEL}`;
+  if (ring) seq += BEL;
+  titleLog(glyph, title, ring);
+  return { terminalSequence: seq };
+}
+
+// Optional forensic log (default OFF — gate: CLAUDE_TITLE_DEBUG=1). One line per paint, so a tab that
+// ends up out of sync (e.g. a ◐ that never cleared to ✻) can be traced to the exact event + glyph that
+// last painted it. Bounded to ~512KB with a single rotation; wrapped so it can never break a turn.
+function titleLog(glyph, title, ring) {
+  if (process.env.CLAUDE_TITLE_DEBUG !== '1' || !logCtx) return;
+  try {
+    const name = glyph === GLYPH.working ? 'working'
+      : glyph === GLYPH.awaiting ? 'awaiting'
+      : glyph === GLYPH.idle ? 'idle' : 'other';
+    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}\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);
+  } catch (_) { /* logging must never throw */ }
+}
+
+function fileExists(file) {
+  try { return fs.existsSync(file); } catch (_) { return false; }
+}
+
+// Stop heuristic: did the turn end on a question? Read the JSONL transcript, find the most-recent
+// assistant message with VISIBLE text (skip pure tool_use turns so a final title/memory Write doesn't
+// mask the question), test whether it ends in '?' (allowing trailing whitespace / ) * _ "). Any error → false.
+function lastResponseEndsWithQuestion(transcriptPath) {
+  if (!transcriptPath) return false;
+  let content;
+  try {
+    content = fs.readFileSync(transcriptPath, 'utf8');
+  } catch (_) {
+    return false;
+  }
+  const lines = content.split('\n');
+  for (let i = lines.length - 1; i >= 0; i--) {
+    const line = lines[i].trim();
+    if (!line) continue;
+    let obj;
+    try { obj = JSON.parse(line); } catch (_) { continue; }
+    if (!obj || obj.type !== 'assistant' || !obj.message) continue;
+    const c = obj.message.content;
+    let text = '';
+    if (typeof c === 'string') {
+      text = c;
+    } else if (Array.isArray(c)) {
+      text = c
+        .filter(b => b && b.type === 'text' && typeof b.text === 'string')
+        .map(b => b.text)
+        .join('\n');
+    }
+    if (text.trim()) return /\?[\s)*_"]*$/.test(text);
+  }
+  return false;
+}
+
+function readTitle(file) {
+  try {
+    if (fs.existsSync(file)) return fs.readFileSync(file, 'utf8').trim();
+  } catch (_) { /* ignore */ }
+  return '';
+}
+
+function folderName(cwd) {
+  const base = cwd ? path.basename(cwd) : '';
+  return base || 'Claude Code';
+}
+
+// Normalize ' - ' to ' — ' and capitalize the first letter of each segment.
+function normalize(title) {
+  const sep = ` ${EMDASH} `;
+  return title
+    .split(' - ').join(sep)
+    .split(sep)
+    .map(s => s.replace(/^(\P{L}*)(\p{L})/u, (_, lead, ch) => lead + ch.toUpperCase()))
+    .join(sep);
+}
+
+function emit(obj) {
+  process.stdout.write(JSON.stringify(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.
+function buildDirective(data, file, cwd) {
+  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
+    .split('{{TITLE_FILE}}').join(file)
+    .split('{{FOLDER}}').join(folderName(cwd))
+    .split('{{EMDASH}}').join(EMDASH)
+    .split('{{CMD}}').join(cmd);
+}
+
+function extractBlock(tpl, name) {
+  const re = new RegExp(
+    `<!-- DIRECTIVE:${name} -->\\s*([\\s\\S]*?)\\s*<!-- /DIRECTIVE:${name} -->`
+  );
+  const m = tpl.match(re);
+  return m ? m[1].trim() : '';
+}