claude-code-kanban 5.3.0 → 6.0.0

package/README.md

@@ -19,7 +19,7 @@ Watch the tour on YouTube: [light](https://youtu.be/QbvDBFyfC7s), [dark](https:/
 
 ## Getting started
 
-You need Node.js 20 or later, the `claude` CLI, and `jq` for the hook scripts.
+You need Node.js 20 or later and the `claude` CLI.
 
 ### 1. Install the integration (one time)
 
@@ -27,7 +27,7 @@ You need Node.js 20 or later, the `claude` CLI, and `jq` for the hook scripts.
 npx claude-code-kanban --install
 ```
 
-The installer adds a Claude Code plugin with hooks and skills, and a statusLine script for context use and cost. It asks before each change and keeps your other settings. Without the hooks, the board shows tasks only: no agent log, no live activity, no waiting prompts.
+The installer adds a Claude Code plugin with hooks, skills and a mod for context use and cost (Claude Code 2.1.287 or later). It asks before it installs and keeps your other settings. Without the hooks, the board shows tasks only: no agent log, no live activity, no waiting prompts.
 
 To remove it, run `npx claude-code-kanban --uninstall`. For another Claude config dir, pass the same `--dir=<path>` (or set `CLAUDE_CONFIG_DIR`) to `--install`, `--uninstall` and the server. See [Getting started](https://nikiforovall.blog/claude-code-kanban/getting-started/) for each install step.
 
@@ -71,7 +71,7 @@ Run `claude` in any project. You do not configure anything per project. Claude C
 - **Answer prompts from the board.** When Claude asks for permission, asks a question or waits for plan approval, the session gets an amber highlight and the ask shows with Allow and Deny buttons or an answer form. The terminal prompt stays open, and the first answer wins. [Answer prompts from the board](https://nikiforovall.blog/claude-code-kanban/guides/waiting-prompts/)
 - **Embedded terminal.** Run a real Claude Code process for any session next to its board (<kbd>Ctrl</kbd>+<kbd>&#96;</kbd>). <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>R</kbd> resumes a past session and <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>S</kbd> swaps to the previous one. The terminal is off by default when the board runs alone. Start it with `--enable-terminal` and open the `#t=<token>` link the server prints. [Embedded terminal](https://nikiforovall.blog/claude-code-kanban/guides/embedded-terminal/)
 - **New session.** <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>N</kbd> opens a dialog to pick a folder, a name, a model, an optional git worktree and a first prompt. Needs the terminal.
-- **Dispatch.** Hand a written task to a new session with `claude-code-kanban dispatch start`, or ask Claude to do it with the `dispatch` skill. Add `--report` to get the outcome back. Needs the terminal. [Dispatch tasks to other sessions](https://nikiforovall.blog/claude-code-kanban/guides/dispatch/)
+- **Dispatch.** Hand a written task to a new session with `claude-code-kanban dispatch start`, or ask Claude to do it with the `dispatch` skill. Args after `--` go to `claude` as they are, and the started session reports back with `SendMessage`. Needs the terminal. [Dispatch tasks to other sessions](https://nikiforovall.blog/claude-code-kanban/guides/dispatch/)
 - **Steer with card moves.** Run `/claude-code-kanban:follow` in a session, then drag its cards. Claude starts, parks or stops the task. [Claude Code plugin skills](https://nikiforovall.blog/claude-code-kanban/guides/plugin-skills/)
 - **Review comments.** Select text in a previewed file or the plan, add comments and send them to the session in one step. [Review comments](https://nikiforovall.blog/claude-code-kanban/guides/review-comments/)
 
@@ -100,7 +100,7 @@ With no subcommand, `claude-code-kanban` starts the server. Subcommands talk to
 - `session list|search|open|view|plan|agents|pin|pins|peek` to read and focus sessions.
 - `task list` and `project list` to read tasks and projects.
 - `preview-doc` and `link-doc` to show or link a file on the board.
-- `dispatch start|done|wait|list` to start sessions with a task and collect their reports.
+- `dispatch start|list` to start sessions with a task in the board's terminal.
 
 Run `claude-code-kanban --help` or see the [CLI reference](https://nikiforovall.blog/claude-code-kanban/reference/cli/).
 

package/cli.js

@@ -180,58 +180,30 @@ const COMMANDS = {
     },
   },
   dispatch: {
-    summary: 'Start a Claude Code session for a task in cck and collect its report',
+    summary: 'Start a Claude Code session for a task in cck\'s terminal',
     verbs: {
       start: {
-        summary: 'Start a session with a task; prints the dispatch id',
-        usage: 'claude-code-kanban dispatch start --cwd <dir> (--spec <text> | --spec-file <path>) [--name <n>] [--group <g>] [--report] [--peer <name>] [--model <m>] [--worktree [name]] [--json]',
+        summary: 'Start claude in cck\'s terminal with a task; prints the session id',
+        usage: 'claude-code-kanban dispatch start --cwd <dir> (--spec <text> | --spec-file <path>) [--name <n>] [--group <g>] [--model <m>] [--worktree [name]] [--json] [-- <claude args>...]',
         flags: {
           '--cwd <dir>': 'Folder to run in (a known project, default: current dir)',
-          '--spec <text>': 'The task, self-contained',
+          '--spec <text>': 'The task, self-contained; sent as the first message',
           '--spec-file <path>': 'Read the task from a file',
-          '--name <n>': 'Session name',
+          '--name <n>': 'Session name; also its peer name for SendMessage',
           '--group <g>': 'Show it with this session in a kebab-case group (default: this session\'s group)',
-          '--report': 'Ask it to report its outcome back to this session',
-          '--peer <name>': 'This session\'s peer name; it sends questions and findings there with SendMessage',
           '--model <m>': 'fable, opus, sonnet or haiku',
           '--worktree [name]': 'Run in a new git worktree',
           '--json': 'Output JSON',
+          '-- <claude args>': 'Passed to claude as they are, e.g. --permission-mode auto. No quotes, % or control characters; cck sets --session-id, --name, --model and --worktree',
         },
-        notes: 'Needs the terminal token, so it runs on the machine of the cck server. Run `claude-code-kanban skills get dispatch` for how to write the spec.',
+        notes: 'Needs the terminal token, so it runs on the machine of the cck server. cck sends no report: say in the spec how the session reports back. Run `claude-code-kanban skills get dispatch` for how to write the spec.',
         examples: [
-          'claude-code-kanban dispatch start --cwd . --spec-file spec.md --name fix-login-redirect --group auth-refactor --peer my-peer --report --json',
+          'claude-code-kanban dispatch start --cwd . --spec-file spec.md --name fix-login-redirect --group auth-refactor --model sonnet -- --permission-mode auto',
         ],
         run: runDispatchStartCli,
       },
-      done: {
-        summary: 'Report the outcome of a dispatch (run by the started session)',
-        usage: 'claude-code-kanban dispatch done <id> --cap <cap> --outcome succeeded|failed (--summary <text> | --summary-file <path>)',
-        flags: {
-          '<id>': 'Dispatch id from the preamble',
-          '--cap <cap>': 'Capability from the preamble',
-          '--outcome <o>': 'succeeded or failed',
-          '--summary <text>': 'What changed, what was found, what remains',
-          '--summary-file <path>': 'Read the summary from a file',
-        },
-        examples: [
-          'claude-code-kanban dispatch done d_1a2b3c --cap <cap> --outcome succeeded --summary-file summary.md',
-        ],
-        run: runDispatchDoneCli,
-      },
-      wait: {
-        summary: 'Wait until a dispatch settles; a timeout is a checkpoint, not a failure',
-        usage: 'claude-code-kanban dispatch wait [<id>...] [--timeout <dur>] [--json]',
-        flags: {
-          '<id>': 'Dispatches to wait on (default: all started by this session)',
-          '--timeout <dur>': 'How long to wait, e.g. 90s, 15m, 1h (default: 10m)',
-          '--json': 'Output JSON',
-        },
-        notes: 'Returns as soon as any watched dispatch settles, with settled, running and timeout.',
-        examples: ['claude-code-kanban dispatch wait --timeout 15m --json'],
-        run: runDispatchWaitCli,
-      },
       list: {
-        summary: 'List dispatches started by this session',
+        summary: 'List sessions this session started that still run in cck\'s terminal',
         usage: 'claude-code-kanban dispatch list [--all] [--json]',
         flags: {
           '--all': 'Every dispatch on this board',
@@ -331,8 +303,8 @@ function printTopHelp() {
   console.log('  --port <n>            Port to listen on (default 3541)');
   console.log('  --dir <path>          Override Claude config dir (default ~/.claude); also targets --install/--uninstall');
   console.log('  --open                Open browser on start');
-  console.log('  --install, --uninstall    Install or remove the plugin, context spy, and statusline');
-  console.log('  --plugin-only         With --install: refresh only the plugin, skip context spy and statusline');
+  console.log('  --install, --uninstall    Install or remove the plugin');
+  console.log('  --yes                 With --install: install without a prompt');
   console.log('\nEnvironment:');
   console.log('  CCK_URL               Server base URL, e.g. http://127.0.0.1:4795 (wins over PORT)');
   console.log('  PORT                  Server port (default: the one this config dir\'s server reports, else 3541)');
@@ -431,6 +403,8 @@ class CliUnreachable extends Error { constructor() { super(unreachable()); this.
 // connects run at once. Nothing reached the server, so even a POST is safe to send again.
 const CONNECT_RETRY_MS = [250, 500, 1000, 2000];
 const isConnectTimeout = (e) => e.cause?.code === 'ETIMEDOUT' && e.cause?.syscall === 'connect';
+// A loopback connection can also be reset after it opens. A GET is safe to send again; a write may have landed.
+const isRetryable = (e, init) => isConnectTimeout(e) || (!init?.method && e.cause?.code === 'ECONNRESET');
 
 async function cliFetch(urlPath, init) {
   const base = cliBaseUrl();
@@ -439,7 +413,7 @@ async function cliFetch(urlPath, init) {
     try {
       return await fetch(`${base}${urlPath}`, init);
     } catch (e) {
-      if (isConnectTimeout(e) && i < CONNECT_RETRY_MS.length) {
+      if (isRetryable(e, init) && i < CONNECT_RETRY_MS.length) {
         await new Promise((r) => setTimeout(r, CONNECT_RETRY_MS[i]));
         continue;
       }
@@ -810,9 +784,12 @@ async function runSessionViewCli(args) {
     ].filter(Boolean).join(' · ');
     lines.push(`  Model: ${modelName}${modelExtras ? ` (${modelExtras})` : ''}`);
     if (cw.used_percentage != null) {
-      lines.push(`  Context: ${cw.used_percentage}% used · ${fmtTok(cw.total_input_tokens)} in / ${fmtTok(cw.total_output_tokens)} out · cache ${fmtTok(cw.current_usage?.cache_read_input_tokens)} read`);
+      lines.push(`  Context: ${cw.used_percentage}% used · ${fmtTok(cw.total_input_tokens)} in${cw.total_output_tokens != null ? ` / ${fmtTok(cw.total_output_tokens)} out` : ''} · cache ${fmtTok(cw.current_usage?.cache_read_input_tokens)} read`);
     }
-    lines.push(`  Cost: ${fmtCost(cost.total_cost_usd)} · ${cost.total_api_duration_ms != null ? formatAge(cost.total_api_duration_ms) : '-'} api / ${cost.total_duration_ms != null ? formatAge(cost.total_duration_ms) : '-'} total · +${cost.total_lines_added || 0}/-${cost.total_lines_removed || 0}`);
+    const timing = cost.total_duration_ms != null
+      ? ` · ${cost.total_api_duration_ms != null ? formatAge(cost.total_api_duration_ms) : '-'} api / ${formatAge(cost.total_duration_ms)} total · +${cost.total_lines_added || 0}/-${cost.total_lines_removed || 0}`
+      : '';
+    lines.push(`  Cost: ${fmtCost(cost.total_cost_usd)}${timing}`);
     if (rl.five_hour || rl.seven_day) {
       lines.push(`  Limits: 5h ${rl.five_hour?.used_percentage ?? '-'}% · 7d ${rl.seven_day?.used_percentage ?? '-'}%`);
     }
@@ -1037,19 +1014,10 @@ function textArg(args, name) {
   return file ? fs.readFileSync(path.resolve(file), 'utf8') : getArgValue(args, name);
 }
 
-function parseDuration(raw, fallbackSec) {
-  if (!raw) return fallbackSec;
-  const m = /^(\d+(?:\.\d+)?)(s|m|h)?$/.exec(raw);
-  if (!m) return null;
-  return Number(m[1]) * ({ s: 1, m: 60, h: 3600 }[m[2] || 's']);
-}
-
-function printDispatch(r) {
-  const head = `${r.id}  ${r.status.padEnd(9)} session=${r.session}${r.name ? `  ${r.name}` : ''}`;
-  console.log(r.summary ? `${head}\n  ${r.summary}` : head);
-}
-
-async function runDispatchStartCli(args) {
+async function runDispatchStartCli(argv) {
+  const sep = argv.indexOf('--');
+  const args = sep === -1 ? argv : argv.slice(0, sep);
+  const claudeArgs = sep === -1 ? [] : argv.slice(sep + 1);
   const port = cliTargetPort();
   if (port === null) {
     console.error(unreachable());
@@ -1080,73 +1048,27 @@ async function runDispatchStartCli(args) {
     model: getArgValue(args, 'model'),
     worktree,
     group,
-    report: args.includes('--report'),
-    peer: getArgValue(args, 'peer') || null,
+    claudeArgs,
     parent: process.env.CLAUDE_CODE_SESSION_ID || null,
   };
   try {
     const out = await cliPostJson('/api/dispatch', body, 'Dispatch', { 'x-terminal-token': token });
     if (!out) return 1;
     if (args.includes('--json')) console.log(JSON.stringify(out, null, 2));
-    else console.log(`Started ${out.dispatch} (session ${out.session}) in ${out.cwd}${out.group ? ` [${out.group}]` : ''}`);
-    return 0;
-  } catch (e) { reportCliError(e); return 1; }
-}
-
-async function runDispatchDoneCli(args) {
-  const [id] = positionals(args, ['--cap', '--outcome', '--summary', '--summary-file']);
-  let summary;
-  try { summary = textArg(args, 'summary'); } catch (e) { console.error(e.message); return 1; }
-  const body = { cap: getArgValue(args, 'cap'), outcome: getArgValue(args, 'outcome'), summary };
-  if (!id || !body.cap || !body.outcome) {
-    printLeafHelp(COMMANDS.dispatch.verbs.done);
-    return 1;
-  }
-  try {
-    if (!await cliPostJson(`/api/dispatch/${encodeURIComponent(id)}/done`, body, 'Report')) return 1;
-    console.log(`Reported ${id}: ${body.outcome}`);
-    return 0;
-  } catch (e) { reportCliError(e); return 1; }
-}
-
-function dispatchQuery(ids, all = false) {
-  const q = new URLSearchParams();
-  if (ids.length) q.set('ids', ids.join(','));
-  else if (!all && process.env.CLAUDE_CODE_SESSION_ID) q.set('parent', process.env.CLAUDE_CODE_SESSION_ID);
-  return q;
-}
-
-async function runDispatchWaitCli(args) {
-  const timeoutRaw = getArgValue(args, 'timeout');
-  const timeoutSec = parseDuration(timeoutRaw, 600);
-  if (timeoutSec === null) return usageError(COMMANDS.dispatch.verbs.wait, `Invalid --timeout value: ${timeoutRaw}`);
-  const q = dispatchQuery(positionals(args, ['--timeout']));
-  const deadline = Date.now() + timeoutSec * 1000;
-  try {
-    let out;
-    do {
-      q.set('wait', String(Math.max(1, Math.min(120, Math.ceil((deadline - Date.now()) / 1000)))));
-      const res = await cliFetch(`/api/dispatch?${q}`);
-      out = await res.json();
-    } while (out.timeout && Date.now() < deadline);
-    if (args.includes('--json')) console.log(JSON.stringify(out, null, 2));
-    else {
-      for (const r of out.settled) printDispatch(r);
-      if (out.running.length) console.log(`${out.timeout ? 'Timed out; still running' : 'Still running'}: ${out.running.map(r => r.id).join(' ')}`);
-      if (!out.settled.length && !out.running.length) console.log('No dispatches to wait on.');
-    }
+    else console.log(`Started session ${out.session} in ${out.cwd}${out.group ? ` [${out.group}]` : ''}`);
     return 0;
   } catch (e) { reportCliError(e); return 1; }
 }
 
 async function runDispatchListCli(args) {
+  const q = new URLSearchParams();
+  if (!args.includes('--all') && process.env.CLAUDE_CODE_SESSION_ID) q.set('parent', process.env.CLAUDE_CODE_SESSION_ID);
   try {
-    const res = await cliFetch(`/api/dispatch?${dispatchQuery([], args.includes('--all'))}`);
-    const { settled, running } = await res.json();
-    const rows = [...running, ...settled].sort((a, b) => b.startedAt - a.startedAt);
+    const res = await cliFetch(`/api/dispatch?${q}`);
+    const rows = (await res.json()).running.sort((a, b) => b.startedAt - a.startedAt);
     if (args.includes('--json')) console.log(JSON.stringify(rows, null, 2));
     else if (!rows.length) console.log('No dispatches.');
-    else rows.forEach(printDispatch);
+    else for (const r of rows) console.log(`${r.session}${r.name ? `  ${r.name}` : ''}${r.group ? `  [${r.group}]` : ''}`);
     return 0;
   } catch (e) { reportCliError(e); return 1; }
 }

package/install.js

@@ -10,14 +10,13 @@ const { PLUGIN_ID } = require('./lib/plugin-status');
 const CLAUDE_DIR = getClaudeDir();
 const CLI_ENV = claudeCliEnv(CLAUDE_DIR);
 const CCK_DIR = path.join(CLAUDE_DIR, '.cck');
-const HOOKS_DIR = path.join(CLAUDE_DIR, 'hooks');
 const SETTINGS_PATH = path.join(CLAUDE_DIR, 'settings.json');
 const PLUGIN_SRC = path.join(__dirname, 'plugin');
 const PLUGIN_DEST = path.join(CCK_DIR, 'plugin');
+// Earlier versions piped the statusLine through this script to capture context use; the plugin's mod does it now.
 const CTX_SCRIPT_NAME = 'context-status.sh';
-const CTX_SCRIPT_SRC = path.join(PLUGIN_SRC, 'plugins', 'claude-code-kanban', 'scripts', CTX_SCRIPT_NAME);
-const CTX_SCRIPT_DEST = path.join(HOOKS_DIR, CTX_SCRIPT_NAME);
-const CTX_COMMAND = displayPath(CTX_SCRIPT_DEST);
+const CTX_SCRIPT_DEST = path.join(CLAUDE_DIR, 'hooks', CTX_SCRIPT_NAME);
+const MIN_CLAUDE_VERSION = [2, 1, 287];
 
 // ANSI helpers
 const green = s => `\x1b[32m${s}\x1b[0m`;
@@ -47,10 +46,37 @@ function runCLI(cmd, okPatterns = []) {
   }
 }
 
-function copyScript(src, dest) {
-  fs.mkdirSync(path.dirname(dest), { recursive: true });
-  fs.copyFileSync(src, dest);
-  try { fs.chmodSync(dest, 0o755); } catch {}
+function isBelowMinVersion(versionOutput) {
+  const parts = /(\d+)\.(\d+)\.(\d+)/.exec(versionOutput)?.slice(1).map(Number);
+  if (!parts) return false;
+  const i = parts.findIndex((n, k) => n !== MIN_CLAUDE_VERSION[k]);
+  return i !== -1 && parts[i] < MIN_CLAUDE_VERSION[i];
+}
+
+function removeContextSpy() {
+  if (fs.existsSync(CTX_SCRIPT_DEST)) {
+    fs.unlinkSync(CTX_SCRIPT_DEST);
+    console.log(`  Old context spy: ${green('✓')} Removed ${dim(displayPath(CTX_SCRIPT_DEST))}`);
+  }
+  if (!fs.existsSync(SETTINGS_PATH)) return;
+  let settings;
+  try {
+    settings = JSON.parse(fs.readFileSync(SETTINGS_PATH, 'utf8'));
+  } catch {
+    console.log(`  Settings: ${red('✗')} Could not parse settings.json`);
+    return;
+  }
+  const cmd = settings.statusLine?.command;
+  if (!cmd?.includes(CTX_SCRIPT_NAME)) return;
+  const stripped = cmd.replace(/\S*context-status\.sh\s*\|?\s*/, '').trim();
+  if (stripped) {
+    settings.statusLine.command = stripped;
+    console.log(`  StatusLine: ${green('✓')} Restored to "${stripped}"`);
+  } else {
+    delete settings.statusLine;
+    console.log(`  StatusLine: ${green('✓')} Removed`);
+  }
+  fs.writeFileSync(SETTINGS_PATH, `${JSON.stringify(settings, null, 2)}\n`);
 }
 
 // Deletes files but never directories: on Windows the running Claude Code process holds
@@ -80,8 +106,8 @@ function copyDirSync(src, dest) {
   }
 }
 
-async function runInstall({ pluginOnly = false } = {}) {
-  console.log(`\n  ${bold('claude-code-kanban')} — ${pluginOnly ? 'Plugin installer' : 'Plugin & StatusLine installer'}\n`);
+async function runInstall({ yes = false } = {}) {
+  console.log(`\n  ${bold('claude-code-kanban')} — Plugin installer\n`);
   console.log(`  Claude config dir: ${dim(displayPath(CLAUDE_DIR))}\n`);
   let failed = false;
 
@@ -90,23 +116,18 @@ async function runInstall({ pluginOnly = false } = {}) {
   const claude = runCLI('claude --version');
   if (claude.ok) {
     console.log(green(`✓ found (${claude.output})`));
+    if (isBelowMinVersion(claude.output)) {
+      console.log(`    ${yellow(`⚠ context use and cost tracking needs Claude Code ${MIN_CLAUDE_VERSION.join('.')} or later — run \`claude update\``)}`);
+    }
   } else {
     console.log(red('✗ claude CLI not found'));
     console.log(`    ${dim('Install Claude Code CLI first: https://docs.anthropic.com/en/docs/claude-code')}`);
     return;
   }
 
-  process.stdout.write('  Checking jq... ');
-  const jq = runCLI('jq --version');
-  if (jq.ok) {
-    console.log(green(`✓ found (${jq.output})`));
-  } else {
-    console.log(yellow('⚠ not found — hook scripts require jq for JSON parsing'));
-  }
-
   // 2. Copy plugin to stable location & register marketplace
   console.log(`\n  Plugin: ${dim(PLUGIN_DEST)}`);
-  if (pluginOnly || await prompt(`    Install claude-code-kanban plugin? [Y/n] `)) {
+  if (yes || await prompt(`    Install claude-code-kanban plugin? [Y/n] `)) {
     process.stdout.write(`    Copying plugin to ${displayPath(PLUGIN_DEST)}... `);
     try {
       clearFilesRecursive(PLUGIN_DEST);
@@ -155,75 +176,8 @@ async function runInstall({ pluginOnly = false } = {}) {
     console.log(`    ${dim('Skipped')}`);
   }
 
-  if (pluginOnly) {
-    console.log(`\n  ${dim('Context spy and statusline skipped (--plugin-only).')}`);
-    printSummary(failed);
-    return;
-  }
-
-  // 3. StatusLine setup (context-status.sh must be copied globally since statusLine is not plugin-scoped)
-  console.log(`\n  Context spy: ${dim(CTX_SCRIPT_DEST)}`);
-  let ctxInstalled = false;
-  if (fs.existsSync(CTX_SCRIPT_DEST)) {
-    const existing = fs.readFileSync(CTX_SCRIPT_DEST, 'utf8');
-    const bundled = fs.readFileSync(CTX_SCRIPT_SRC, 'utf8');
-    if (existing === bundled) {
-      console.log(`    ${green('✓')} Up to date`);
-      ctxInstalled = true;
-    } else if (await prompt(`    Different version found. Update? [Y/n] `)) {
-      copyScript(CTX_SCRIPT_SRC, CTX_SCRIPT_DEST);
-      console.log(`    ${green('✓')} Updated`);
-      ctxInstalled = true;
-    } else {
-      console.log(`    ${dim('Skipped')}`);
-    }
-  } else if (await prompt(`    Not found. Install? [Y/n] `)) {
-    copyScript(CTX_SCRIPT_SRC, CTX_SCRIPT_DEST);
-    console.log(`    ${green('✓')} Installed`);
-    ctxInstalled = true;
-  } else {
-    console.log(`    ${dim('Skipped')}`);
-  }
-
-  // 4. StatusLine config in settings.json
-  if (ctxInstalled) {
-    let settings;
-    try {
-      settings = fs.existsSync(SETTINGS_PATH)
-        ? JSON.parse(fs.readFileSync(SETTINGS_PATH, 'utf8'))
-        : {};
-    } catch {
-      console.log(`    ${red('✗')} Malformed JSON in settings.json — skipping statusline config`);
-      printSummary(true);
-      return;
-    }
-
-    const hasCtx = settings.statusLine?.command?.includes(CTX_SCRIPT_NAME);
-    if (hasCtx) {
-      console.log(`\n  StatusLine: ${green('✓')} Already configured`);
-    } else if (!settings.statusLine) {
-      console.log(`\n  StatusLine: ${dim('not configured')}`);
-      if (await prompt(`    Set up context tracking statusline? [Y/n] `)) {
-        settings.statusLine = { type: 'command', command: CTX_COMMAND };
-        fs.writeFileSync(SETTINGS_PATH, `${JSON.stringify(settings, null, 2)}\n`);
-        console.log(`    ${green('✓')} StatusLine configured`);
-      } else {
-        console.log(`    ${dim('Skipped')}`);
-      }
-    } else {
-      const existing = settings.statusLine.command;
-      console.log(`\n  StatusLine: ${dim(`current: ${existing}`)}`);
-      if (await prompt(`    Prepend context spy to existing statusline? [Y/n] `)) {
-        settings.statusLine.type = 'command';
-        settings.statusLine.command = `${CTX_COMMAND} | ${existing}`;
-        fs.writeFileSync(SETTINGS_PATH, `${JSON.stringify(settings, null, 2)}\n`);
-        console.log(`    ${green('✓')} StatusLine updated`);
-      } else {
-        console.log(`    ${dim('Skipped')}`);
-      }
-    }
-  }
-
+  console.log('');
+  removeContextSpy();
   printSummary(failed);
 }
 
@@ -265,41 +219,7 @@ async function runUninstall() {
     console.log(`  Plugin copy: ${dim('Not found')}`);
   }
 
-  // 4. Remove context-status.sh copy
-  if (fs.existsSync(CTX_SCRIPT_DEST)) {
-    fs.unlinkSync(CTX_SCRIPT_DEST);
-    console.log(`  Context spy: ${green('✓')} Removed`);
-  } else {
-    console.log(`  Context spy: ${dim('Not found')}`);
-  }
-
-  // 5. Clean up settings.json (statusLine)
-  if (fs.existsSync(SETTINGS_PATH)) {
-    try {
-      const settings = JSON.parse(fs.readFileSync(SETTINGS_PATH, 'utf8'));
-      let changed = false;
-
-      // Strip context-status.sh from statusLine
-      if (settings.statusLine?.command?.includes(CTX_SCRIPT_NAME)) {
-        const cmd = settings.statusLine.command;
-        const stripped = cmd.replace(new RegExp(`\\S*${CTX_SCRIPT_NAME.replace('.', '\\.')}\\s*\\|\\s*`), '').trim();
-        if (stripped && stripped !== cmd) {
-          settings.statusLine.command = stripped;
-          console.log(`  StatusLine: ${green('✓')} Restored to "${stripped}"`);
-        } else {
-          delete settings.statusLine;
-          console.log(`  StatusLine: ${green('✓')} Removed`);
-        }
-        changed = true;
-      }
-
-      if (changed) {
-        fs.writeFileSync(SETTINGS_PATH, `${JSON.stringify(settings, null, 2)}\n`);
-      }
-    } catch {
-      console.log(`  Settings: ${red('✗')} Could not parse settings.json`);
-    }
-  }
+  removeContextSpy();
 
   console.log(`\n  ${green('Uninstall complete.')}\n`);
 }

package/lib/approvals.js

@@ -1,18 +1,18 @@
-// UI-driven approvals (_plans/cck-ui-approvals/): approval-gate.sh writes the
+// UI-driven approvals (_plans/cck-ui-approvals/): the plugin's mod writes the
 // _waiting.json marker with a request id (D8) and polls for _decision-<id>.json.
 // buildDecision validates a board response against the live marker and shapes
-// the decision file; the route writes it. The hook deletes marker + decision on
-// consumption; orphans from a terminal deny (D13) are left for the sweep.
+// the decision file; the route writes it. Mods cannot delete files, so the mod
+// clears the marker and the sweep removes decision files.
 
-// Ids are hook-minted (uuidgen or a time-pid-random compound) — anything outside
-// this alphabet is either corruption or a path-traversal attempt (3.5).
+// Ids are mod-minted UUIDs — anything outside this alphabet is either
+// corruption or a path-traversal attempt (3.5).
 function sanitizeRequestId(raw) {
   return typeof raw === 'string' && /^[a-zA-Z0-9-]{1,64}$/.test(raw) ? raw : null;
 }
 
-// A decision whose shape doesn't match the ask's kind produces hook output
-// Claude Code rejects, surfacing as an opaque stall — reject at the API
-// boundary instead (D7). Returns { error, status } or { decision }.
+// A decision whose shape doesn't match the ask's kind cannot answer the call,
+// surfacing as an opaque stall — reject at the API boundary instead (D7).
+// Returns { error, status } or { decision }.
 function buildDecision(marker, body) {
   if (!marker || marker.status !== 'waiting') {
     return { error: 'No pending ask', status: 410 };
@@ -45,7 +45,6 @@ function buildDecision(marker, body) {
   const decision = { behavior: body.behavior };
   if (typeof body.message === 'string' && body.message) decision.message = body.message;
   if (body.updatedInput && typeof body.updatedInput === 'object') decision.updatedInput = body.updatedInput;
-  if (Array.isArray(body.updatedPermissions)) decision.updatedPermissions = body.updatedPermissions;
   return { decision };
 }
 
@@ -58,14 +57,14 @@ function isDecisionFile(name) {
   return name.startsWith('_decision-') && name.endsWith('.json');
 }
 
-// approval-gate.sh only polls for a decision for waitSeconds — after that the
-// ask belongs to the terminal. Default and clamp mirror the gate's own parse
-// (PERMISSION_TTL_MS hides the card at 30 min, so waiting longer than the UI
-// can show the ask is strictly worse — D11); keep them in sync with
-// approval-gate.sh.
+// The mod only polls for a decision for waitSeconds — after that the ask
+// belongs to the terminal. Default and clamp mirror the mod's own parse
+// (boardWaitMs in the plugin's hooks/activity.ts; PERMISSION_TTL_MS hides the
+// card at 30 min, so waiting longer than the UI can show the ask is strictly
+// worse — D11); keep them in sync.
 const WAIT_SECONDS_DEFAULT = 1800;
 const WAIT_SECONDS_MAX = 1800;
-// Small grace over the gate's own deadline so a race never 410s a live hook
+// Small grace over the mod's own deadline so a race never 410s a live ask
 const LAPSE_GRACE_MS = 5000;
 function waitSecondsFrom(cfg) {
   const raw = cfg?.waitSeconds;
@@ -75,7 +74,7 @@ function waitSecondsFrom(cfg) {
 
 // Normalizes the `approvals` section of <CCK_DIR>/config.json. The gate is on
 // by default: only an explicit `enabled: false` turns it off, and anything
-// unparseable falls back to defaults — the same parse approval-gate.sh does.
+// unparseable falls back to defaults — the same parse the mod does.
 function approvalsFrom(cfg) {
   const a = cfg && typeof cfg.approvals === 'object' && cfg.approvals ? cfg.approvals : {};
   return {
@@ -85,7 +84,7 @@ function approvalsFrom(cfg) {
   };
 }
 
-// Whether the hook waits for a board decision on a marker of this kind
+// Whether the mod waits for a board decision on a marker of this kind
 function isKindGated(kind, approvals) {
   if (!approvals.enabled) return false;
   if (kind === 'question') return approvals.mode === 'permission+question';

package/lib/dispatch-groups.js

@@ -1,6 +1,5 @@
-// Transient session groups: `dispatch start --group` (or the starter's own group) puts
-// the started session in a group. The starter is not moved: it is only remembered, so its
-// later dispatches default to the same group. A group lives while any member's claude
+// Transient session groups: `dispatch start --group` puts the started session in a group,
+// and only an explicit `--group` does. A group lives while any member's claude
 // runs, and for a grace period after; once none runs, only pinned members stay in it.
 // The map is on disk so a pinned group outlives a server restart.
 
@@ -25,39 +24,28 @@ function suggestGroupName(s) {
 
 /**
  * @param {object} o
- * @param {() => object|null} o.load returns `{sessions: {[id]: group}, starters?: {[id]: starterId}}` or null
+ * @param {() => object|null} o.load returns `{sessions: {[id]: group}}` or null
  * @param {(data: object) => void} o.save
  * @param {(id: string) => boolean} o.isAlive
  * @param {() => Set<string>} o.pinnedIds
  */
 function createGroupStore({ load, save, isAlive, pinnedIds, now = Date.now }) {
   const members = new Map();
-  const starterOf = new Map();
   const liveAt = new Map();
   const saved = load();
   if (saved?.sessions && typeof saved.sessions === 'object') {
     for (const [id, g] of Object.entries(saved.sessions)) if (isGroupName(g)) members.set(id, g);
   }
-  if (saved?.starters && typeof saved.starters === 'object') {
-    for (const [id, s] of Object.entries(saved.starters)) if (members.has(id) && typeof s === 'string') starterOf.set(id, s);
-  }
   for (const g of members.values()) liveAt.set(g, now());
 
-  const persist = () =>
-    save({ version: 1, sessions: Object.fromEntries(members), starters: Object.fromEntries(starterOf) });
+  const persist = () => save({ version: 1, sessions: Object.fromEntries(members) });
 
-  function join(group, ids, starter) {
+  function join(group, ids) {
     let changed = false;
     for (const id of ids) {
-      if (!id) continue;
-      if (members.get(id) !== group) {
-        members.set(id, group);
-        changed = true;
-      }
-      if (starter && starterOf.get(id) !== starter) {
-        starterOf.set(id, starter);
-        changed = true;
-      }
+      if (!id || members.get(id) === group) continue;
+      members.set(id, group);
+      changed = true;
     }
     liveAt.set(group, now());
     if (changed) persist();
@@ -82,7 +70,6 @@ function createGroupStore({ load, save, isAlive, pinnedIds, now = Date.now }) {
       for (const id of ids) {
         if (pinned.has(id)) continue;
         members.delete(id);
-        starterOf.delete(id);
         changed = true;
       }
       if (!ids.some((id) => pinned.has(id))) liveAt.delete(g);
@@ -90,21 +77,12 @@ function createGroupStore({ load, save, isAlive, pinnedIds, now = Date.now }) {
     if (changed) persist();
   }
 
-  // A starter is not a member; it defaults to the group of a session it started.
-  function groupOf(id) {
-    refresh();
-    if (members.has(id)) return members.get(id);
-    let group = null;
-    for (const [child, starter] of starterOf) if (starter === id) group = members.get(child);
-    return group;
-  }
-
   function snapshot() {
     refresh();
     return members;
   }
 
-  return { join, groupOf, snapshot };
+  return { join, snapshot };
 }
 
 module.exports = { createGroupStore, isGroupName, suggestGroupName, GRACE_MS };