/** * @fileoverview Tests for the plan-usage statusLine exporter riding an EPHEMERAL * `claude --settings` CLI flag (buildSpawnCommand's statusLineCommand option), * which superseded writing it into `.claude/settings.local.json` — see * resolveStatusLineCliCommand in hooks-config.ts and its own tests. Verified * live against a real Claude CLI (isolated tmux socket, 2026-08-31) that * `--settings` accepts this exact shape and takes precedence over a file-based * statusLine. * * Extracting and re-parsing the `--settings` argument goes through a REAL * shell (bash -c) rather than a hand-rolled unescaper: the exporter command * itself embeds both single and double quotes, so trusting anything but the * shell's own quoting rules to reverse shellescape() would just be testing * this file's guess at the algorithm, not the actual behavior a spawned pane * sees. */ import { describe, it, expect } from 'vitest'; import { execFileSync } from 'node:child_process'; import { buildSpawnCommand } from '../src/tmux-manager.js'; const EXPORTER_CMD = 'curl -sfk -X POST "$CODEMAN_API_URL/api/status-telemetry" --data @- 2>/dev/null || true'; /** Extract the `--settings ` fragment from a built command and have a * real shell resolve its quoting, printing the arg back out verbatim. */ function extractSettingsJson(cmd: string): unknown { const idx = cmd.indexOf('--settings '); expect(idx).toBeGreaterThan(-1); const fragment = cmd.slice(idx); const out = execFileSync('bash', ['-c', `set -- ${fragment}; printf '%s' "$2"`]).toString(); return JSON.parse(out); } describe('buildSpawnCommand statusLineCommand (claude mode)', () => { it('omits --settings entirely when no statusLineCommand and no effort are given', () => { const cmd = buildSpawnCommand({ mode: 'claude', sessionId: 'sid-1' }); expect(cmd).not.toContain('--settings'); }); it('embeds the exporter command under a statusLine settings key', () => { const cmd = buildSpawnCommand({ mode: 'claude', sessionId: 'sid-1', statusLineCommand: EXPORTER_CMD }); expect(cmd).toContain('--settings'); expect(extractSettingsJson(cmd)).toEqual({ statusLine: { type: 'command', command: EXPORTER_CMD } }); }); it('merges statusLine and ultracode into the SAME --settings object', () => { const cmd = buildSpawnCommand({ mode: 'claude', sessionId: 'sid-1', effort: 'ultracode', statusLineCommand: EXPORTER_CMD, }); // Only one --settings flag total — never two (Claude Code accepts just one). expect(cmd.match(/--settings/g)).toHaveLength(1); expect(extractSettingsJson(cmd)).toEqual({ ultracode: true, statusLine: { type: 'command', command: EXPORTER_CMD }, }); }); it('keeps a regular --effort flag separate from --settings when both are present', () => { const cmd = buildSpawnCommand({ mode: 'claude', sessionId: 'sid-1', effort: 'high', statusLineCommand: EXPORTER_CMD, }); expect(cmd).toContain('--effort'); expect(cmd).toContain('--settings'); expect(extractSettingsJson(cmd)).toEqual({ statusLine: { type: 'command', command: EXPORTER_CMD } }); }); it('shell-escapes an exporter command containing single AND double quotes without breaking the flag', () => { // The real exporter (generateStatusLineCommand) embeds both — a naive // `'${value}'` wrap would be broken out of by the single quotes. const tricky = `echo '{}'; printf '{"a":1}' | curl -sk`; const cmd = buildSpawnCommand({ mode: 'claude', sessionId: 'sid-1', statusLineCommand: tricky }); expect(extractSettingsJson(cmd)).toEqual({ statusLine: { type: 'command', command: tricky } }); }); it('round-trips the REAL exporter script path unmodified (ensureStatusLineExporterScript)', async () => { // What resolveStatusLineCliCommand actually hands to buildSpawnCommand at spawn // time today is a bare script PATH (see that function's doc comment for why — // never the raw curl command generateStatusLineCommand() builds, which only // backs the legacy disk-write applyStatusLineConfig path now). const { ensureStatusLineExporterScript } = await import('../src/hooks-config.js'); const real = await ensureStatusLineExporterScript(); const cmd = buildSpawnCommand({ mode: 'claude', sessionId: 'sid-1', statusLineCommand: real }); expect(extractSettingsJson(cmd)).toEqual({ statusLine: { type: 'command', command: real } }); }); it('never adds --settings for non-claude modes even if statusLineCommand is somehow set', () => { const cmd = buildSpawnCommand({ mode: 'omp', sessionId: 'sid-1', statusLineCommand: EXPORTER_CMD } as never); expect(cmd).not.toContain('--settings'); }); });