@telora/daemon 0.22.245 → 0.22.289

package/dist/backends/claude/one-shot-model.js

@@ -0,0 +1,388 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/backends/claude/one-shot-model.test.ts,
+//   packages/daemon/src/verify/effect-reconciliation/judge-invoker.test.ts,
+//   packages/daemon/src/verify/effect-reconciliation/judge-question.test.ts,
+//   packages/daemon/src/verify/effect-reconciliation/judge-workspace.test.ts,
+//   packages/daemon/src/verify/effect-reconciliation/verify-reconciliation.test.ts,
+//   packages/daemon/src/verify/effect-reconciliation/verify-restatement.test.ts,
+//   packages/daemon/src/verify/engine/reconciliation-step.test.ts,
+//   packages/daemon/src/verify/engine/verification-engine.test.ts,
+//   packages/daemon/src/verify/outcome-routing/incurable-model-hold.test.ts,
+//   packages/daemon/src/verify/outcome-routing/verification-model-unavailable-hold.test.ts,
+//   packages/daemon/src/verify/run-selection/verification-default-on.test.ts,
+//   packages/daemon/src/verify/shortfalls/pre-judge-rulings.test.ts
+// PINNED-BY-END
+import { createLogger } from '../../log/daemon-log.js';
+import { trackChildProcess } from '../../daemon-state/worker-registry.js';
+import { parseRateLimitInfo } from './rate-limit.js';
+import { CLAUDE_PROVIDER, openProviderWindow, providerWindowHoldUntilMs } from '../../daemon-state/provider-window.js';
+import { stopFires } from '../../supervision/stop-registry.js';
+const log = createLogger({ module: 'one-shot-model' });
+const DEFAULT_TIMEOUT_MS = 2 * 60 * 1000;
+/** How much of each stream a failure carries (enough to read the reason, never the whole transcript). */
+const STREAM_TAIL_CHARS = 2000;
+/**
+ * Whether retrying the SAME input can never cure this kind. An input too large
+ * for the model is refused every time; a BOUNDED judge session (`maxTurns`)
+ * that used every turn of its budget on an input will use them again on the
+ * same one, at the full cost of the session every retry. A rate limit clears
+ * with its window, a timeout (bounded session or not: a slow provider is not a
+ * property of the input) or an unclassified exit may pass, auth and
+ * a missing CLI are cured on the host, and a verdict whose citations did not
+ * resolve (`unresolved_citations`, raised by the verify judge, not this wrapper)
+ * may cite correctly on the next attempt. Pure.
+ */
+export function retryCannotCure(kind) {
+    return kind === 'input_too_large' || kind === 'session_exhausted';
+}
+/**
+ * The default input budget, in characters of system prompt + user message.
+ * One-shots run the CLI's default model, a 1M-token context, which refuses a
+ * ~3.3 MB prompt (~1M tokens of diff). 2.4M characters is ~700k
+ * tokens of code at ~3.3 characters a token: the refusal lands before the
+ * CLI's, without refusing a prompt the model would take. The CLI's own "Prompt
+ * is too long" still classifies anything between. A caller whose model has a
+ * smaller window passes its own budget.
+ */
+export const DEFAULT_INPUT_BUDGET_CHARS = 2_400_000;
+/** The size of a prompt, or null when it fits its budget. Pure. */
+export function overInputBudget(systemPrompt, userMessage, budgetChars) {
+    const chars = systemPrompt.length + userMessage.length;
+    return chars > budgetChars ? { chars, budgetChars } : null;
+}
+/**
+ * A model invocation that could not COMPLETE. Never a judgment: the model was
+ * not reached, was refused, or did not answer in time. Callers hold or retry on
+ * it; none of them may record it as a verdict, a shortfall or an attempt.
+ */
+export class ModelUnavailable extends Error {
+    kind;
+    label;
+    exitCode;
+    /** Epoch ms when the provider says capacity returns (rate_limit only, when it said). */
+    resetAtMs;
+    stdoutTail;
+    stderrTail;
+    /** The input's size and budget (input_too_large only). */
+    inputSize;
+    /** The turn budget the session used up (session_exhausted only). */
+    maxTurns;
+    constructor(args) {
+        super(formatModelUnavailable(args));
+        this.name = 'ModelUnavailable';
+        this.kind = args.kind;
+        this.label = args.label;
+        this.exitCode = args.exitCode ?? null;
+        this.resetAtMs = args.resetAtMs ?? null;
+        this.stdoutTail = args.stdoutTail ?? '';
+        this.stderrTail = args.stderrTail ?? '';
+        this.inputSize = args.inputSize ?? null;
+        this.maxTurns = args.maxTurns ?? null;
+    }
+}
+function formatModelUnavailable(args) {
+    const parts = [`${args.label}: model unavailable (${args.kind}`];
+    if (args.exitCode !== undefined && args.exitCode !== null)
+        parts.push(`, exit ${args.exitCode}`);
+    if (args.inputSize)
+        parts.push(`, input ${args.inputSize.chars} chars, budget ${args.inputSize.budgetChars}`);
+    if (args.maxTurns !== undefined && args.maxTurns !== null)
+        parts.push(`, all ${args.maxTurns} turns used`);
+    if (args.resetAtMs !== undefined && args.resetAtMs !== null) {
+        parts.push(`, resets ${new Date(args.resetAtMs).toISOString()}`);
+    }
+    parts.push(')');
+    const reason = args.detail
+        ?? lastLine(args.stderrTail ?? '')
+        ?? lastLine(args.stdoutTail ?? '');
+    if (reason)
+        parts.push(`: ${reason}`);
+    return parts.join('');
+}
+function lastLine(text) {
+    const lines = text.split('\n').map((l) => l.trim()).filter((l) => l !== '');
+    return lines.length > 0 ? lines[lines.length - 1] : null;
+}
+/** Type guard: the thrown value is a typed unavailability, not a model judgment. */
+export function isModelUnavailable(err) {
+    return err instanceof ModelUnavailable;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+/**
+ * Parse a `--output-format stream-json` transcript. One JSON object per line;
+ * lines that are not JSON (or not events we read) are skipped, so a partial
+ * transcript from a killed child still yields what it had. Pure.
+ */
+export function parseOneShotStream(stdout) {
+    const summary = {};
+    for (const line of stdout.split('\n')) {
+        const trimmed = line.trim();
+        if (trimmed === '' || !trimmed.startsWith('{'))
+            continue;
+        let event;
+        try {
+            event = JSON.parse(trimmed);
+        }
+        catch {
+            continue;
+        }
+        if (!isRecord(event))
+            continue;
+        const type = event['type'];
+        if (type === 'system' && event['subtype'] === 'init' && typeof event['model'] === 'string') {
+            summary.initModel = event['model'];
+            continue;
+        }
+        if (type === 'rate_limit_event') {
+            const info = parseRateLimitInfo(event);
+            if (info && info.status === 'rejected') {
+                summary.rateLimitRejected = { resetAtMs: info.resetsAtMs, rateLimitType: info.rateLimitType };
+            }
+            continue;
+        }
+        if (type === 'result') {
+            const usage = isRecord(event['usage']) ? event['usage'] : undefined;
+            const modelUsage = event['modelUsage'];
+            const modelUsageKey = isRecord(modelUsage) ? Object.keys(modelUsage)[0] : undefined;
+            const status = event['api_error_status'];
+            summary.result = {
+                isError: event['is_error'] === true,
+                subtype: typeof event['subtype'] === 'string' ? event['subtype'] : null,
+                text: typeof event['result'] === 'string' ? event['result'] : null,
+                apiErrorStatus: typeof status === 'number' ? status : null,
+                ...(usage ? { usage } : {}),
+                ...(modelUsageKey ? { modelUsageKey } : {}),
+                costUsd: typeof event['total_cost_usd'] === 'number' ? event['total_cost_usd'] : null,
+            };
+        }
+    }
+    return summary;
+}
+/** The CLI's prose for a limit, when the typed event was not in the transcript (text mode, older CLI). */
+const RATE_LIMIT_PROSE = /hit your (session|usage|weekly) limit|rate limit(ed)? (reached|exceeded)|usage limit|too many requests/i;
+/** The CLI's prose for a refused credential. */
+const AUTH_PROSE = /not logged in|unauthori[sz]ed|invalid api key|authentication (failed|required)/i;
+/** The CLI's prose for an input the model cannot take ("Prompt is too long", 2026-09-28). */
+const INPUT_TOO_LARGE_PROSE = /prompt is too long|input is too long|context (window|length) exceeded|exceeds the (model'?s? )?context (window|length)/i;
+/** Whether the CLI's PROSE says the input is too large for the model (never an event line). Pure. */
+export function inputTooLargeInProse(prose) {
+    return INPUT_TOO_LARGE_PROSE.test(prose);
+}
+/**
+ * The provider refusal the CLI's PROSE names, or null. One classifier for every
+ * spawner (the routing decider reads its result text through this too), so a CLI
+ * build whose rejection carries words but no status is read the same way
+ * everywhere. Callers pass prose only -- never a stream-json event line. Pure.
+ */
+export function providerRefusalInProse(prose) {
+    if (RATE_LIMIT_PROSE.test(prose))
+        return 'rate_limit';
+    if (AUTH_PROSE.test(prose))
+        return 'auth';
+    return null;
+}
+/**
+ * The human-readable part of what the child wrote: the result text, stderr, and
+ * any stdout line that is NOT a stream-json event. The event lines are never
+ * scanned -- every healthy transcript carries the literal `rate_limit_event`
+ * (status allowed), and an assistant text block about "authentication" is the
+ * model's answer, not the provider's refusal. Pure.
+ */
+function proseOf(summary, stdout, stderr) {
+    const plain = stdout.split('\n').filter((line) => !line.trim().startsWith('{'));
+    return [summary.result?.text ?? '', ...plain, stderr].join('\n');
+}
+/**
+ * Classify a finished child that did NOT complete an answer. Pure: takes what
+ * was observed, names the kind. Order matters: a typed rate-limit event beats
+ * every other signal, a status beats prose, and a timeout with no provider
+ * signal is a timeout (the prose is only consulted when nothing typed explains
+ * the exit).
+ */
+export function classifyOneShotFailure(args) {
+    if (args.summary.rateLimitRejected) {
+        return { kind: 'rate_limit', resetAtMs: args.summary.rateLimitRejected.resetAtMs };
+    }
+    const status = args.summary.result?.apiErrorStatus ?? null;
+    if (status === 429)
+        return { kind: 'rate_limit', resetAtMs: null };
+    if (status === 401 || status === 403)
+        return { kind: 'auth', resetAtMs: null };
+    if (status === 413)
+        return { kind: 'input_too_large', resetAtMs: null };
+    const outOfTurns = args.summary.result?.subtype === 'error_max_turns';
+    if (args.boundedSession && outOfTurns)
+        return { kind: 'session_exhausted', resetAtMs: null };
+    if (args.timedOut)
+        return { kind: 'timeout', resetAtMs: null };
+    const prose = proseOf(args.summary, args.stdout, args.stderr);
+    if (inputTooLargeInProse(prose))
+        return { kind: 'input_too_large', resetAtMs: null };
+    const refusal = providerRefusalInProse(prose);
+    return { kind: refusal ?? 'unknown', resetAtMs: null };
+}
+// ---------------------------------------------------------------------------
+// Invocation
+// ---------------------------------------------------------------------------
+/** The argv every one-shot uses. Exported so a test can pin it without spawning. */
+export function buildOneShotArgs(systemPrompt, extraArgs = []) {
+    return [
+        '--print',
+        '--output-format', 'stream-json',
+        '--verbose',
+        '--no-session-persistence',
+        '--system-prompt', systemPrompt,
+        ...extraArgs,
+    ];
+}
+/** One log line per open window, not one per held call (verify ticks every ~90s per delivery). */
+let lastLoggedHoldUntilMs = null;
+/** The typed refusal for a call made inside an open provider window, or null when no window is open. */
+function heldByProviderWindow(label, nowMs) {
+    // Every one-shot here is `claude --print`: it runs on the claude backend's provider.
+    const holdUntil = providerWindowHoldUntilMs(CLAUDE_PROVIDER, nowMs);
+    const held = stopFires('provider_rate_limit_window', { spawnProvider: CLAUDE_PROVIDER, windowHoldUntilMs: holdUntil });
+    if (!held || holdUntil === null)
+        return null;
+    if (lastLoggedHoldUntilMs !== holdUntil) {
+        lastLoggedHoldUntilMs = holdUntil;
+        log.info(`[one-shot] ${label}: not spawning -- provider rate limit holds every call until ` +
+            `${new Date(holdUntil).toISOString()}`);
+    }
+    return new ModelUnavailable({
+        kind: 'rate_limit',
+        label,
+        resetAtMs: holdUntil,
+        detail: 'provider rate-limit window open; no subprocess spawned',
+    });
+}
+/**
+ * The refusal a call gets without spawning, or null to spawn: an input over its
+ * budget (checked FIRST -- no provider window, however long, cures it), then an
+ * open provider window.
+ */
+function refusedBeforeSpawn(label, systemPrompt, userMessage, budgetChars, nowMs) {
+    const oversize = overInputBudget(systemPrompt, userMessage, budgetChars);
+    if (oversize) {
+        return new ModelUnavailable({
+            kind: 'input_too_large', label, inputSize: oversize,
+            detail: `the prompt is ${oversize.chars} characters, over the ${oversize.budgetChars}-character input budget; not spawned`,
+        });
+    }
+    return heldByProviderWindow(label, nowMs);
+}
+/** The completed answer a parsed transcript amounts to. Pure. */
+function completedResult(summary) {
+    const result = summary.result;
+    const model = summary.initModel ?? result.modelUsageKey;
+    return {
+        text: result.text ?? '',
+        ...(result.usage ? { usage: result.usage } : {}),
+        ...(model ? { model } : {}),
+        costUsd: result.costUsd,
+    };
+}
+/**
+ * Invoke the model once. The user message goes on stdin; the system prompt on
+ * argv. Resolves with the completed answer; rejects with ModelUnavailable when
+ * the model could not be reached, was refused or did not answer in time. Any
+ * other rejection is a programming error in this wrapper, not a model outcome.
+ */
+export function invokeOneShotModel(systemPrompt, userMessage, opts) {
+    const label = opts.label;
+    const { nowMs, spawnFn } = opts;
+    const claudeBin = opts.claudeBin ?? 'claude';
+    const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const budgetChars = opts.inputBudgetChars ?? DEFAULT_INPUT_BUDGET_CHARS;
+    const refused = refusedBeforeSpawn(label, systemPrompt, userMessage, budgetChars, nowMs());
+    if (refused)
+        return Promise.reject(refused);
+    return new Promise((resolve, reject) => {
+        let child;
+        try {
+            const turnCap = opts.maxTurns !== undefined ? ['--max-turns', String(opts.maxTurns)] : [];
+            child = spawnFn(claudeBin, buildOneShotArgs(systemPrompt, [...(opts.extraArgs ?? []), ...turnCap]), {
+                stdio: ['pipe', 'pipe', 'pipe'], ...(opts.cwd ? { cwd: opts.cwd } : {}), ...(opts.env ? { env: opts.env } : {}),
+            });
+        }
+        catch (err) {
+            reject(new ModelUnavailable({ kind: 'spawn', label, detail: `spawn failed: ${err.message}` }));
+            return;
+        }
+        // Register so a graceful stop reaps this one-shot if it is still running.
+        trackChildProcess(child, label);
+        let stdout = '';
+        let stderr = '';
+        let timedOut = false;
+        let settled = false;
+        child.stdout?.on('data', (chunk) => { stdout += chunk.toString('utf8'); });
+        child.stderr?.on('data', (chunk) => { stderr += chunk.toString('utf8'); });
+        // A child that exits before draining stdin emits EPIPE on the stdin socket
+        // asynchronously; unhandled, that would crash the daemon. The close handler
+        // classifies the exit; the write error itself carries nothing more.
+        child.stdin?.on?.('error', () => { });
+        // The timeout SETTLES the call: 'close' waits for every stdio pipe, and a
+        // grandchild (an MCP server the CLI started) that inherited stdout can hold
+        // it open after the CLI is dead. The child stays in the worker registry for
+        // the teardown reap; a late 'close' is ignored (settled).
+        const timer = setTimeout(() => {
+            timedOut = true;
+            try {
+                child.kill('SIGKILL');
+            }
+            catch { /* ignore */ }
+            const { kind, resetAtMs } = classifyOneShotFailure({
+                exitCode: null, timedOut, summary: parseOneShotStream(stdout), stdout, stderr, boundedSession: opts.maxTurns !== undefined,
+            });
+            fail(kind, null, resetAtMs, `no answer within ${Math.round(timeoutMs / 1000)}s; killed`);
+        }, timeoutMs);
+        const fail = (kind, exitCode, resetAtMs, detail) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            if (kind === 'rate_limit' && resetAtMs !== null)
+                openProviderWindow(CLAUDE_PROVIDER, resetAtMs, nowMs());
+            reject(new ModelUnavailable({
+                kind,
+                label,
+                exitCode,
+                resetAtMs,
+                stdoutTail: stdout.slice(-STREAM_TAIL_CHARS),
+                stderrTail: stderr.slice(-STREAM_TAIL_CHARS),
+                ...(detail ? { detail } : {}),
+                ...(kind === 'input_too_large' ? { inputSize: { chars: systemPrompt.length + userMessage.length, budgetChars } } : {}),
+                ...(kind === 'session_exhausted' && opts.maxTurns !== undefined ? { maxTurns: opts.maxTurns } : {}),
+            }));
+        };
+        child.on('error', (err) => {
+            fail('spawn', null, null, `spawn error: ${err.message}`);
+        });
+        child.on('close', (code) => {
+            if (settled)
+                return;
+            const summary = parseOneShotStream(stdout);
+            const completed = code === 0 && summary.result !== undefined && !summary.result.isError;
+            if (!completed) {
+                const { kind, resetAtMs } = classifyOneShotFailure({
+                    exitCode: code, timedOut, summary, stdout, stderr, boundedSession: opts.maxTurns !== undefined,
+                });
+                fail(kind, code, resetAtMs, summary.result?.text ?? undefined);
+                return;
+            }
+            settled = true;
+            clearTimeout(timer);
+            resolve(completedResult(summary));
+        });
+        try {
+            child.stdin?.write(userMessage);
+            child.stdin?.end();
+        }
+        catch (err) {
+            fail('spawn', null, null, `stdin write failed: ${err.message}`);
+        }
+    });
+}
+//# sourceMappingURL=one-shot-model.js.map

package/dist/backends/claude/one-shot-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"one-shot-model.js","sourceRoot":"","sources":["../../../src/backends/claude/one-shot-model.ts"],"names":[],"mappings":"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"}

package/dist/backends/claude/one-shot-scoping-spawn.d.ts

@@ -0,0 +1,57 @@
+import type { DaemonConfig } from '../../types/index.js';
+/**
+ * Kill a scoping agent that has not exited within this window (15 minutes).
+ *
+ * A caller's staleness window (the interval after which it will spawn a
+ * REPLACEMENT) must be strictly greater than this plus the SIGKILL grace, or a
+ * healthy long-running agent is double-spawned right as it finishes.
+ */
+export declare const SCOPING_AGENT_TIMEOUT_MS: number;
+/** Grace between SIGTERM and SIGKILL when the kill timeout fires. */
+export declare const SCOPING_AGENT_SIGKILL_GRACE_MS = 10000;
+/**
+ * The process spawn. Required: each caller's outermost wiring picks it (the
+ * composition root for the PRD frontier, the nexus intake deps for intake);
+ * tests hand in a fake.
+ */
+export interface ScopingSpawnSeam {
+    spawnProcess: (command: string, args: string[], cwd: string, env: NodeJS.ProcessEnv) => {
+        pid?: number;
+        on: (event: string, cb: (arg?: unknown) => void) => void;
+        stdin?: {
+            end: () => void;
+        } | null;
+    };
+}
+/** The production spawn: node:child_process with piped stdio. */
+export declare const childProcessScopingSpawnSeam: ScopingSpawnSeam;
+/** One scoping agent to spawn: what to say to it, and who is asking. */
+export interface OneShotScopingSpawn {
+    /**
+     * What this run is scoping, for the log line -- e.g. `request <uuid>` or
+     * `PRD overcome <uuid> (focus <uuid>)`. Never a UUID on its own: a log line
+     * that names only an id cannot be read without a second query.
+     */
+    label: string;
+    /** The fully-built prompt (a PURE builder's output), passed as a CLI arg. */
+    prompt: string;
+    /** Logger module name, so each caller's lines stay greppable under its own tag. */
+    logModule: string;
+    /** Kill timeout override (defaults to SCOPING_AGENT_TIMEOUT_MS). */
+    timeoutMs?: number;
+    /**
+     * Called once the process CLOSES, with its exit code (null when the code is
+     * unknown -- a signal kill, or a close event carrying no code). This is how a
+     * caller learns the run ended; the returned promise deliberately does not
+     * carry it, because it resolves minutes earlier.
+     */
+    onExit?: (code: number | null) => void;
+}
+/**
+ * Spawn a one-shot scoping agent. Resolves once the process has SPAWNED
+ * (fire-and-forget); rejects only if the process fails to spawn. The
+ * close/error handlers log the outcome and invoke `onExit`; the kill timeout
+ * bounds a hung agent.
+ */
+export declare function spawnOneShotScopingAgent(config: DaemonConfig, request: OneShotScopingSpawn, seam: ScopingSpawnSeam): Promise<void>;
+//# sourceMappingURL=one-shot-scoping-spawn.d.ts.map

package/dist/backends/claude/one-shot-scoping-spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"one-shot-scoping-spawn.d.ts","sourceRoot":"","sources":["../../../src/backends/claude/one-shot-scoping-spawn.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,QAAiB,CAAC;AAEvD,qEAAqE;AACrE,eAAO,MAAM,8BAA8B,QAAS,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK;QACtF,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,KAAK,IAAI,CAAC;QACzD,KAAK,CAAC,EAAE;YAAE,GAAG,EAAE,MAAM,IAAI,CAAA;SAAE,GAAG,IAAI,CAAC;KACpC,CAAC;CACH;AAED,iEAAiE;AACjE,eAAO,MAAM,4BAA4B,EAAE,gBAG1C,CAAC;AAEF,wEAAwE;AACxE,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACxC;AAOD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAgFf"}

package/dist/backends/claude/one-shot-scoping-spawn.js

@@ -0,0 +1,152 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/backends/claude/one-shot-scoping-spawn.test.ts,
+//   packages/daemon/src/prd/prd-frontier-arming.test.ts
+// PINNED-BY-END
+/**
+ * The ONE-SHOT SCOPING AGENT spawn seam.
+ *
+ * A scoping agent is a short-lived `claude --print` process whose whole job is
+ * to AUTHOR intent through the telora_* MCP tools and exit -- it writes no
+ * application code, makes no git changes, and runs in the product repo (where
+ * the per-product .mcp.json + CLAUDE.md live) rather than an isolated worktree.
+ *
+ * WHY THIS MODULE EXISTS (the choice a reviewer should check). Nexus intake
+ * (`nexus/intake-spawn.ts`) and the PRD frontier need the SAME process shape --
+ * same kill timeout, same fire-and-forget settle, same cleaned env, same
+ * close/error logging -- for different prompts. The machinery lives here once
+ * rather than as a per-caller copy: a copy is precisely where two spawners
+ * drift (one grows an unref'd timer, one does not; one resolves on 'spawn', one
+ * on 'close'), and the drift is invisible until a hung agent holds the daemon's
+ * event loop. What each caller keeps is its own PURE prompt builder -- the part
+ * that genuinely differs and is worth unit-testing on its own
+ * (`nexus/intake-spawn.ts` `buildIntakeScopingPrompt`, `prd/scoping-prompt.ts`
+ * `buildPrdScopingPrompt`).
+ *
+ * FIRE-AND-FORGET: a scoping agent runs for minutes. `spawnOneShotScopingAgent`
+ * resolves the moment the process is up (the 'spawn' event), NOT on close, so a
+ * daemon poll loop is never blocked. The caller's own in-flight guard (intake's
+ * `intake_scoping_started_at` stamp; the PRD controller's scoping-run ledger)
+ * is what prevents a re-spawn -- never this promise.
+ *
+ * History: docs/daemon/history-team-lifecycle.md (backends/claude/one-shot-scoping-spawn.ts).
+ */
+import { spawn } from 'node:child_process';
+import { stripClaudeCodeEnvVars } from '@telora/daemon-core';
+import { createLogger } from '../../log/daemon-log.js';
+/**
+ * Kill a scoping agent that has not exited within this window (15 minutes).
+ *
+ * A caller's staleness window (the interval after which it will spawn a
+ * REPLACEMENT) must be strictly greater than this plus the SIGKILL grace, or a
+ * healthy long-running agent is double-spawned right as it finishes.
+ */
+export const SCOPING_AGENT_TIMEOUT_MS = 15 * 60 * 1000;
+/** Grace between SIGTERM and SIGKILL when the kill timeout fires. */
+export const SCOPING_AGENT_SIGKILL_GRACE_MS = 10_000;
+/** The production spawn: node:child_process with piped stdio. */
+export const childProcessScopingSpawnSeam = {
+    spawnProcess: (command, args, cwd, env) => spawn(command, args, { cwd, env, stdio: ['pipe', 'pipe', 'pipe'] }),
+};
+/** Normalize a close event's argument to an exit code or null. */
+function toExitCode(code) {
+    return typeof code === 'number' ? code : null;
+}
+/**
+ * Spawn a one-shot scoping agent. Resolves once the process has SPAWNED
+ * (fire-and-forget); rejects only if the process fails to spawn. The
+ * close/error handlers log the outcome and invoke `onExit`; the kill timeout
+ * bounds a hung agent.
+ */
+export function spawnOneShotScopingAgent(config, request, seam) {
+    const log = createLogger({ module: request.logModule });
+    const timeoutMs = request.timeoutMs ?? SCOPING_AGENT_TIMEOUT_MS;
+    const args = [
+        '--print',
+        '--dangerously-skip-permissions',
+        '--setting-sources', 'project,local',
+        request.prompt,
+    ];
+    const env = stripClaudeCodeEnvVars(process.env);
+    const cwd = config.repoPath ?? process.cwd();
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        let exitReported = false;
+        let proc;
+        try {
+            proc = seam.spawnProcess(config.claudeCodePath, args, cwd, env);
+        }
+        catch (err) {
+            reject(err instanceof Error ? err : new Error(String(err)));
+            return;
+        }
+        // Prompt is a CLI arg; close stdin immediately.
+        proc.stdin?.end?.();
+        const timeout = setTimeout(() => {
+            log.warn(`scoping agent for ${request.label} timed out after ${timeoutMs / 1000}s, killing`);
+            if (proc.pid) {
+                try {
+                    process.kill(proc.pid, 'SIGTERM');
+                }
+                catch { /* ignore */ }
+                setTimeout(() => {
+                    if (proc.pid) {
+                        try {
+                            process.kill(proc.pid, 'SIGKILL');
+                        }
+                        catch { /* ignore */ }
+                    }
+                }, SCOPING_AGENT_SIGKILL_GRACE_MS);
+            }
+        }, timeoutMs);
+        // Do not let the kill timer keep the daemon event loop alive.
+        timeout.unref?.();
+        // The exit is reported at most ONCE, on whichever of close/error fires
+        // first: a caller's ledger moves the run out of 'in flight' on this
+        // callback, and a second report would clear a ledger entry a LATER spawn
+        // had already replaced.
+        const reportExit = (code) => {
+            if (exitReported)
+                return;
+            exitReported = true;
+            try {
+                request.onExit?.(code);
+            }
+            catch (err) {
+                // A caller's bookkeeping must never take down the daemon from a
+                // child-process event handler.
+                log.warn(`scoping agent exit handler for ${request.label} threw: ${err.message}`);
+            }
+        };
+        proc.on('spawn', () => {
+            // Process is up -- the daemon poll continues; the agent runs to completion
+            // in the background.
+            log.info(`scoping agent spawned for ${request.label} (PID: ${proc.pid ?? '?'})`);
+            if (!settled) {
+                settled = true;
+                resolve();
+            }
+        });
+        proc.on('close', (code) => {
+            clearTimeout(timeout);
+            log.info(`scoping agent for ${request.label} exited (code: ${code ?? '?'})`);
+            reportExit(toExitCode(code));
+            // If 'spawn' never fired (very early exit), still resolve -- the caller's
+            // in-flight guard already prevents an immediate re-spawn.
+            if (!settled) {
+                settled = true;
+                resolve();
+            }
+        });
+        proc.on('error', (err) => {
+            clearTimeout(timeout);
+            const message = err instanceof Error ? err.message : String(err);
+            log.error(`scoping agent spawn error for ${request.label}: ${message}`);
+            reportExit(null);
+            if (!settled) {
+                settled = true;
+                reject(new Error(message));
+            }
+        });
+    });
+}
+//# sourceMappingURL=one-shot-scoping-spawn.js.map

package/dist/backends/claude/one-shot-scoping-spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"one-shot-scoping-spawn.js","sourceRoot":"","sources":["../../../src/backends/claude/one-shot-scoping-spawn.ts"],"names":[],"mappings":"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"}