@telora/daemon 0.19.47 → 0.19.82

package/dist/spawn/process-spawn.js

@@ -0,0 +1,385 @@
+/**
+ * Process-spawn seam for the focus-team spawn path.
+ *
+ * Extracted verbatim from focus-executor.ts (behavior-preserving): the final
+ * phase that takes a fully-resolved spawn (env constituents, args, message,
+ * session, backend) and actually launches the team-lead child process, plus its
+ * fail-closed backend/sandbox/governor gates, the crash-isolated spawn wrapper,
+ * and the terminal session-update payload builders. focus-executor.ts re-exports
+ * this surface for backward compatibility, so external importers keep resolving
+ * these symbols from '../focus-executor.js'.
+ *
+ * Cycle rule: this module must NOT import from '../focus-executor.js'. The two
+ * symbols this seam would otherwise reach back for -- the resource governor and
+ * the orchestrator spawnFocusTeam (staying in focus-executor.ts) -- are threaded
+ * in via SpawnTeamProcessArgs instead.
+ */
+import { spawn } from 'node:child_process';
+import { hostname } from 'node:os';
+import { withRetry } from '@telora/daemon-core';
+import { updateSession, } from '../supabase.js';
+import { buildLeveredSpawnEnvironment, fetchBackendEnvExtras } from '../spawn-environment.js';
+import { wrapSpawnCommand, SandboxUnavailableError } from '../spawn-sandbox.js';
+import { recordWorkerPid, removeWorkerPid } from '../worker-pidfile.js';
+import { insertAssemblyManifest } from '../queries/context-assembly.js';
+import { markDirectedAnswersConsumed } from '../resolvers/escalation-answers.js';
+import { TELORA_LOCAL_API_KEY_ENV } from '../cli/codex-provision.js';
+import { preflightLocalModelMcp } from '../backends/codex/mcp-preflight.js';
+import { getActiveTeams } from '../focus-team-state.js';
+import { attachStreamHandlers, handleTeamProcessClose, } from '../spawner/helpers.js';
+import { terminateTeam, handleCompletionEvent, } from '../completion/index.js';
+/**
+ * The terminal session-update payload written when the resource governor denies a
+ * slot for this spawn. Pure -- the caller adds `ended_at` and calls updateSession.
+ * Exported so the governor-denied exit_category contract is unit-pinned (the
+ * apply-side -- updateSession + governor.releaseSlot + activeTeams.delete -- stays
+ * in spawnTeamProcess, exercised by spawn-path-unified.test.ts).
+ */
+export function governorDeniedSessionUpdate() {
+    return {
+        status: 'failed',
+        exit_reason: 'Governor denied slot',
+        exit_category: 'governor_denied',
+    };
+}
+/**
+ * The terminal session-update payload written when a required OS sandbox cannot
+ * initialize and the spawn is refused (fail-closed). Pure -- the caller adds
+ * `ended_at` and calls updateSession. Exported so the sandbox-unavailable
+ * exit_category contract is unit-pinned.
+ */
+export function sandboxUnavailableSessionUpdate(message) {
+    return {
+        status: 'failed',
+        exit_reason: message,
+        exit_category: 'sandbox_unavailable',
+    };
+}
+/**
+ * Local-model passes depend on a host CLI, so refuse the process launch when
+ * the backend's existing availability probe says it cannot run. Cloud passes
+ * retain their existing behavior because their authentication can be supplied
+ * by the per-spawn environment after the host-level probe runs.
+ */
+export async function gateLocalModelBackendSpawn(backend, config, isLocalModelPass, host = hostname()) {
+    if (!isLocalModelPass)
+        return { allowed: true };
+    const availability = await backend.probeAvailability(config);
+    if (availability.available)
+        return { allowed: true };
+    // A routed local model supplies its own provider key in the child env. The
+    // host probe cannot see that key yet, so only binary absence is terminal for
+    // this Codex path; host-auth absence is intentionally superseded.
+    if (backend.id === 'codex' && availability.detail?.includes('but not authenticated')) {
+        return { allowed: true };
+    }
+    const binaryMissing = backend.id === 'codex' && availability.detail?.includes('not found');
+    const prefix = binaryMissing
+        ? `Codex CLI not found on ${host} / not on PATH`
+        : `${backend.displayName} unavailable on ${host}`;
+    return {
+        allowed: false,
+        reason: availability.detail ? `${prefix}. ${availability.detail}` : prefix,
+    };
+}
+export function backendUnavailableSessionUpdate(reason, category = 'backend_unavailable') {
+    return {
+        status: 'failed',
+        exit_reason: reason,
+        exit_category: category,
+    };
+}
+/** Attach the error listener in the same synchronous stack frame as spawn(). */
+export function spawnCrashIsolated(command, args, options, onError, spawnFn = spawn) {
+    const proc = spawnFn(command, args, {
+        ...options,
+        // Own process group (setsid on POSIX): the team lead becomes its own
+        // group leader (pgid == lead pid). This is what makes the reap's
+        // group-first signal (spawner/lifecycle.signalWorker: kill(-pid)) actually
+        // reap the lead AND any host children it sub-spawns as one group -- without
+        // detachment the lead shares the daemon's group and kill(-leadPid) ESRCHs,
+        // falling back to the bare pid (lead only). We deliberately do NOT unref():
+        // the daemon must still observe the lead's 'close'/'exit' to drive
+        // completion + delivery advancement. On a hard daemon kill the CLI reaps
+        // these groups from the persisted worker pidfile (see daemon-process reap).
+        detached: true,
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    proc.on('error', onError);
+    // A failed exec can also tear down stdin with EPIPE after the process-level
+    // error/close. Consume that duplicate stream error; forward other stdin
+    // failures through the pass-scoped handler.
+    proc.stdin.on('error', (error) => {
+        if (error.code !== 'EPIPE')
+            onError(error);
+    });
+    return proc;
+}
+/** Ensure a terminal spawn failure is persisted after any in-flight running transition. */
+export async function persistSpawnFailureAfterRunning(runningTransition, persistFailure) {
+    if (runningTransition)
+        await runningTransition.catch(() => undefined);
+    await persistFailure();
+}
+/**
+ * Final phase: build the levered spawn environment, persist the assembly
+ * manifest, write the session lifecycle (starting -> running), acquire the
+ * governor slot, wrap the command in the sandbox (fail-closed), spawn the
+ * child, write its stdin, and attach the completion/close/error handlers.
+ *
+ * Owns ALL of its early-return cleanups so the team-state map and governor slot
+ * never leak: governor-denied (exit_category 'governor_denied') and
+ * sandbox-unavailable (exit_category 'sandbox_unavailable') both mark the
+ * session terminal, release the governor slot where one was held, remove the
+ * team from activeTeams, and return without spawning. Behavior byte-identical
+ * to the original inline tail of spawnFocusTeam.
+ */
+/**
+ * Close a team's local-model translating proxy if one is engaged, and null it so
+ * the call is idempotent across the multiple teardown paths. No-op for every
+ * hosted/Claude/flag-off team (mcpProxy undefined/null).
+ */
+export function closeTeamProxyQuietly(teamState) {
+    const proxy = teamState.mcpProxy;
+    if (!proxy)
+        return;
+    teamState.mcpProxy = null;
+    proxy.close().catch(() => undefined);
+}
+export async function spawnTeamProcess(spec) {
+    const { config, focusId, focusName, session, teamState, backend, args, messageToSend, logs, worktreePath, resumeId, assemblyManifest, spawnCodexHome, spawnLocalModelKey, isLocalModelPass, effectiveModel, pendingDirective, spawnStageName, params, governor, spawnFocusTeam, answeredEscalationIds = [], } = spec;
+    const activeTeams = getActiveTeams();
+    // Two fail-closed gates for local-model passes, both refusing the spawn into a
+    // durable terminal session rather than launching a team that cannot work:
+    //   1. backend availability (host CLI present) -- 'backend_unavailable'
+    //   2. read-only MCP preflight (required Telora tools callable) -- 'mcp_preflight_failed'
+    // The preflight runs only after availability passes (no point probing MCP when
+    // the binary is missing). Cloud/claude passes short-circuit both gates.
+    const availabilityGate = await gateLocalModelBackendSpawn(backend, config, isLocalModelPass);
+    const spawnGate = !availabilityGate.allowed
+        ? { ...availabilityGate, category: 'backend_unavailable' }
+        : await preflightLocalModelMcp(config, isLocalModelPass);
+    if (!spawnGate.allowed) {
+        const reason = spawnGate.reason ?? `${backend.displayName} unavailable`;
+        const category = spawnGate.category ?? 'backend_unavailable';
+        console.error(`[focus-executor] Refusing spawn for "${focusName}" (${category}): ${reason}`);
+        await updateSession(session.id, {
+            ...backendUnavailableSessionUpdate(reason, category),
+            ended_at: new Date().toISOString(),
+        }).catch(updateErr => {
+            console.warn(`[focus-executor] Failed to update refused-spawn session:`, updateErr.message);
+        });
+        logs.stdoutLogStream.end();
+        logs.stderrStream.end();
+        logs.jsonlStream.end();
+        closeTeamProxyQuietly(teamState);
+        teamState.phase = 'terminated';
+        activeTeams.delete(focusId);
+        return;
+    }
+    // Tag spend with the lever: the team-lead spawn runs the focus's execute
+    // phase (review directives run the gate); the workflow stage is carried
+    // separately. The audit phase tags its own spawn elsewhere.
+    const spawnPhase = (pendingDirective?.sessionType ?? 'coding') === 'review' ? 'gate' : 'execute';
+    // Stage: prefer the resolved workflow-stage name; when the stage could not be
+    // resolved (legacy-prompt fallback, or a non-review directive that carried no
+    // stage), fall back to the phase-appropriate default so the lever is never
+    // dropped. 'reviewing' for the gate phase, 'coding' for execute.
+    const spawnStage = spawnStageName ?? (spawnPhase === 'gate' ? 'reviewing' : 'coding');
+    // Levered spawn: buildLeveredSpawnEnvironment requires phase + stage, so this
+    // path cannot regress to dropping the telemetry lever.
+    const spawnEnv = buildLeveredSpawnEnvironment(config, {
+        orgId: config.organizationId,
+        focusId,
+        sessionId: session.id,
+        phase: spawnPhase,
+        stage: spawnStage,
+    });
+    // Inject backend-specific org secrets (e.g. CODEX_API_KEY for the codex backend).
+    // Non-fatal: fetchBackendEnvExtras returns {} on any error, falling back to host creds.
+    Object.assign(spawnEnv, await fetchBackendEnvExtras(backend.id));
+    // Per-product local-model isolation: point this codex spawn at the product's
+    // provisioned CODEX_HOME (no-invisible-cascading -- the override is logged).
+    // Cloud/claude spawns leave CODEX_HOME unset (spawnCodexHome === undefined).
+    if (spawnCodexHome) {
+        spawnEnv.CODEX_HOME = spawnCodexHome;
+        console.log(`[focus-executor] CODEX_HOME set for "${focusName}" (product ${config.productId.slice(0, 8)}): ` +
+            `${spawnCodexHome}` +
+            (effectiveModel ? ` (model: ${effectiveModel})` : ''));
+    }
+    // Per-pass local-model bearer (D8): inject the Telora-resolved key VALUE into
+    // the spawn env under the fixed name codex's config.toml references (env_key).
+    // The value lives only in this child process env -- never on disk, never on the
+    // local_models row. Set only for a routed local-model pass; cloud/claude and
+    // non-local codex spawns leave it untouched.
+    if (spawnLocalModelKey) {
+        spawnEnv[TELORA_LOCAL_API_KEY_ENV] = spawnLocalModelKey;
+    }
+    // Persist the assembly manifest for this spawn (best-effort -- never blocks
+    // the spawn). One row per resolved source, attributed to org + session +
+    // focus, so injected context becomes a queryable lever on token spend.
+    void insertAssemblyManifest({
+        sessionId: session.id,
+        focusId,
+        deliveryId: null,
+        manifest: assemblyManifest,
+    });
+    // Update session to starting
+    await updateSession(session.id, {
+        status: 'starting',
+        started_at: new Date().toISOString(),
+        stdout_path: logs.stdoutPath,
+        stderr_path: logs.stderrPath,
+    });
+    // Acquire governor slot (if governor is configured)
+    if (governor) {
+        try {
+            await governor.acquireSlot('focus');
+        }
+        catch (err) {
+            console.warn(`[focus-executor] Governor denied slot for "${focusName}":`, err.message);
+            // Mark session as failed so it doesn't linger in `starting` status
+            await updateSession(session.id, {
+                ...governorDeniedSessionUpdate(),
+                ended_at: new Date().toISOString(),
+            }).catch(updateErr => {
+                console.warn(`[focus-executor] Failed to update session after governor denial:`, updateErr.message);
+            });
+            closeTeamProxyQuietly(teamState);
+            activeTeams.delete(focusId);
+            return;
+        }
+    }
+    // Wrap the spawn in the OS sandbox (D3). Default mode is 'off' (no change);
+    // an explicit sandbox.mode="bwrap" confines the agent's filesystem to its
+    // worktree + an explicit read-only allowlist. FAIL-CLOSED: if a required
+    // sandbox cannot initialize, refuse the spawn rather than run unconfined.
+    let spawnCommand;
+    let spawnArgs;
+    try {
+        const wrapped = wrapSpawnCommand(config, {
+            command: backend.resolveCommand(config),
+            args,
+            worktreePath,
+        });
+        spawnCommand = wrapped.command;
+        spawnArgs = wrapped.args;
+    }
+    catch (err) {
+        if (err instanceof SandboxUnavailableError) {
+            console.error(`[focus-executor] Refusing spawn for "${focusName}": ${err.message}`);
+            await updateSession(session.id, {
+                ...sandboxUnavailableSessionUpdate(err.message),
+                ended_at: new Date().toISOString(),
+            }).catch(updateErr => {
+                console.warn(`[focus-executor] Failed to update session after sandbox refusal:`, updateErr.message);
+            });
+            if (governor)
+                governor.releaseSlot('focus');
+            closeTeamProxyQuietly(teamState);
+            activeTeams.delete(focusId);
+            return;
+        }
+        throw err;
+    }
+    // Spawn the team lead process
+    let processErrorHandled = false;
+    let runningTransition = null;
+    let completionDetectorForError = null;
+    const handleProcessError = (err) => {
+        if (processErrorHandled)
+            return;
+        processErrorHandled = true;
+        console.error(`[focus-executor] Team lead for "${focusName}" error:`, err.message);
+        governor?.releaseSlot('focus');
+        const missingCliReason = err.code === 'ENOENT'
+            ? `${backend.displayName} not found on ${hostname()} / not on PATH: ${err.message}`
+            : `Process error: ${err.message}`;
+        void persistSpawnFailureAfterRunning(runningTransition, () => withRetry(() => updateSession(session.id, {
+            status: 'failed',
+            exit_reason: missingCliReason,
+            exit_category: err.code === 'ENOENT' ? 'backend_unavailable' : 'error',
+            ended_at: new Date().toISOString(),
+        }), { maxAttempts: 3, baseDelayMs: 1000, label: 'session-update-error' })).catch(updateErr => {
+            console.warn(`[focus-executor] Failed to update session after retries:`, updateErr.message);
+        });
+        completionDetectorForError?.destroy();
+        logs.stdoutLogStream.end();
+        logs.stderrStream.end();
+        logs.jsonlStream.end();
+        closeTeamProxyQuietly(teamState);
+        teamState.phase = 'terminated';
+        activeTeams.delete(focusId);
+    };
+    const proc = spawnCrashIsolated(spawnCommand, spawnArgs, {
+        cwd: worktreePath,
+        env: spawnEnv,
+    }, handleProcessError);
+    teamState.leadPid = proc.pid ?? null;
+    teamState.leadStdin = proc.stdin;
+    teamState.phase = 'executing';
+    // Persist the detached lead pid so a hard daemon kill (stop --force / timeout
+    // / external kill -9) can group-reap it from the pidfile -- the in-memory
+    // activeTeams map dies with the daemon. Auto-removed on the lead's exit.
+    if (typeof proc.pid === 'number') {
+        const leadPid = proc.pid;
+        recordWorkerPid(leadPid, focusName);
+        proc.once('close', () => removeWorkerPid(leadPid));
+        proc.once('error', () => removeWorkerPid(leadPid));
+    }
+    // Attach stream parser, completion detector, activity tracker, event handlers
+    const { completionDetector, activityTracker } = attachStreamHandlers({
+        proc, backend, teamState, focusId, focusName, sessionId: session.id, logs,
+    });
+    completionDetectorForError = completionDetector;
+    // Send the message via stdin: the full composed prompt on a fresh spawn, or
+    // the incremental delta when resuming a lineage (INJ-D). Engine-specific input
+    // encoding lives in the backend.
+    proc.stdin.write(backend.encodeInput(messageToSend));
+    if (backend.closeStdinAfterInput) {
+        proc.stdin.end();
+        teamState.leadStdin = null;
+    }
+    // Post-dispatch closure: the answered-escalation section is now in the agent's
+    // stdin, so stamp those answers consumed (best-effort; a failure degrades to
+    // at-least-once re-surfacing, never loss). Deferred to HERE -- after the write
+    // succeeds -- so a spawn that tore down earlier (governor-denied / sandbox /
+    // model-swap) never consumes an answer it did not deliver.
+    void markDirectedAnswersConsumed(answeredEscalationIds);
+    // Update session to running
+    runningTransition = updateSession(session.id, {
+        status: 'running',
+        pid: proc.pid,
+    });
+    await runningTransition;
+    console.log(`[focus-executor] Team lead spawned for "${focusName}" (PID: ${proc.pid}, session: ${session.id})`);
+    // Handle completion -- check for more work or terminate.
+    // No idle phase: if actionable work remains, send it immediately (mid-focus
+    // handoff). If all work is done, terminate. A fresh team is spawned if new
+    // deliveries arrive later (~$0.50-1.00 exploration cost, but clean context).
+    completionDetector.on('complete', (info) => {
+        console.log(`[focus-executor] Team lead for "${focusName}" completed work cycle: ` +
+            `${info.turnCount} turns, $${info.totalCostUsd.toFixed(4)}`);
+        handleCompletionEvent({ config, focusId, focusName, teamState, completionDetector, proc, completionInfo: info }).catch(err => {
+            console.warn(`[focus-executor] Failed to check delivery state for "${focusName}":`, err.message);
+            // Fallback: terminate to avoid idle money burn.
+            terminateTeam(focusId, 'handoff');
+        });
+    });
+    // Handle process exit
+    const spawnedAt = Date.now();
+    proc.on('close', (code, signal) => {
+        // Node emits close after a spawn error. The error path already persisted
+        // the terminal reason; do not let normal completion overwrite it.
+        if (processErrorHandled)
+            return;
+        handleTeamProcessClose({
+            code, signal, focusName, focusId, resumeId, spawnedAt,
+            teamState, sessionId: session.id, config, completionDetector,
+            activityTracker, logs, params, governor, spawnFocusTeam,
+        }).catch(err => {
+            console.error(`[focus-executor] handleTeamProcessClose failed for "${focusName}":`, err.message);
+        });
+    });
+}
+//# sourceMappingURL=process-spawn.js.map

package/dist/spawn/process-spawn.js.map

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

package/dist/spawn/prompt-assembly.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Prompt-assembly seam for the focus-team spawn path.
+ *
+ * Extracted verbatim from focus-executor.ts (behavior-preserving): the pure
+ * prompt-context factory, the composed team-lead prompt builder, the stdin
+ * message selector (fresh prompt vs resume-delta vs scoping directive), and the
+ * scoping helpers they depend on. focus-executor.ts re-exports this surface for
+ * backward compatibility, so external importers keep resolving these symbols
+ * from '../focus-executor.js'.
+ *
+ * Cycle rule: this module must NOT import from '../focus-executor.js'.
+ */
+import type { DaemonConfig, AgentRole, FocusTeamState, PipelineConfig } from '../types.js';
+import { getFocusDeliveries, getFocusIssues } from '../queries/focuses.js';
+import { type FocusTeamPromptContext } from '../team-prompt-base.js';
+import { resolveLineageSpec } from '../session-lineage.js';
+import { type AssemblyManifestEntry } from '../assembly-engine.js';
+import type { SpawnContext } from './shared.js';
+/**
+ * Phase C input: assemble the FocusTeamPromptContext threaded into both the
+ * directive and legacy prompt builders. Pure factory -- byte-identical to the
+ * original inline object literal; extracted so the orchestrator reads as ordered
+ * phase calls rather than inlining the context shape.
+ */
+export declare function buildFocusPromptContext(args: {
+    config: DaemonConfig;
+    focusId: string;
+    focusName: string;
+    focusDescription: string | null;
+    deliveries: Awaited<ReturnType<typeof getFocusDeliveries>>;
+    issues: Awaited<ReturnType<typeof getFocusIssues>>;
+    executionConfig: FocusTeamState['executionConfig'];
+    pipelineConfig: PipelineConfig | null;
+    deploymentProfileSnapshot: SpawnContext['deploymentProfileSnapshot'];
+    readOnly: boolean;
+    /** Legacy loop-context (empty on the directive path -- resolved only for the legacy prompt). */
+    loopContext: string;
+    reviewFiledOpenCount: number;
+    engineId: string;
+}): FocusTeamPromptContext;
+/**
+ * Phase C: compose the final team-lead message -- role framework + remediation
+ * framing + directive body (or the legacy full focus prompt), then the PRD
+ * milestone push-down appended last so it reaches BOTH prompt paths. Pure +
+ * testable. Byte-identical to the original inline composition.
+ */
+export declare function buildSpawnPrompt(args: {
+    role: AgentRole;
+    promptContext: FocusTeamPromptContext;
+    useLegacyFullPrompt: boolean;
+    directiveBody: string | null;
+    prdMilestoneContext: string;
+    /**
+     * The answered-directed-escalation section (first-class). Appended to BOTH the
+     * directive and legacy prompt paths so a fresh spawn always carries answered
+     * intent -- the legacy loopContext render dropped it on the directive path.
+     * Empty string when there are no answered escalations. Optional (defaults to
+     * '') so prompt-composition unit tests need not thread it; the production
+     * spawn path always passes it.
+     */
+    answeredEscalationsSection?: string;
+    /**
+     * True when this spawn is a review-lineage pass (reviewing stage). The
+     * outcome-stamping obligation is appended ONLY for review passes -- a coding
+     * team has nothing to stamp.
+     */
+    isReviewPass?: boolean;
+    /**
+     * The review session's Telora agent_sessions.id (from createTeamSession).
+     * Threaded into the outcome-stamping section so the review agent receives the
+     * exact id product-api validates against -- no reverse-engineering it from the
+     * Claude --resume session id. Only emitted on review passes; ignored otherwise.
+     */
+    agentSessionId?: string;
+}): string;
+/**
+ * Phase: choose the stdin message. A fresh spawn sends the full composed prompt;
+ * a resume sends an incremental delta (git diff + prior findings to verify) since
+ * the resumed session already holds its role + accumulated context (INJ-D).
+ *
+ * The scoping case is the one exception that overrides the fresh-vs-resume split:
+ * when a NON-read_only (executable) focus has queued deliveries carrying only
+ * Context Group issues and zero Task/Bug issues, this returns the role framework
+ * PLUS `buildQueuedDeliveryScopingMessage` REGARDLESS of resumeId. The caller pairs
+ * this with `resolveScopingSpawnResume`, which forces the spawn fresh (resumeId
+ * null) so the directive lands on a new session instead of no-opping a concluded
+ * one. Because the fresh session holds no accumulated context, the role framework
+ * (identity + Scoping Mandate + status-update rules) is prepended here; only the
+ * audit/kickoff DIRECTIVE body carried in `prompt` is dropped, per AC. `readOnlyFocus`
+ * focuses are discovery-only (audit-playbook origin): their CG-only deliveries are
+ * INTENTIONALLY unscoped, so they are never driven into scoping here --
+ * delivery-lifecycle terminalizes them instead.
+ */
+export declare function buildSpawnMessage(args: {
+    prompt: string;
+    resumeId: string | null;
+    readOnlyFocus: boolean;
+    /**
+     * The team-lead role + context, used to rebuild JUST the role-framework prefix
+     * (`buildRoleFrameworkPrompt`, WITHOUT the audit/kickoff directive body) for the
+     * forced-fresh scoping message. The scoping spawn lands on a NEW session with no
+     * accumulated context, and stdin is that session's only first-turn instruction
+     * (there is no --system-prompt channel and the worktree CLAUDE.md carries no role
+     * framework), so the scoping directive must carry the role framework itself or
+     * the fresh team lead has no identity / status-update contract / scoping mandate.
+     */
+    role: AgentRole;
+    promptContext: FocusTeamPromptContext;
+    spawnSpec: ReturnType<typeof resolveLineageSpec>;
+    config: DaemonConfig;
+    focusId: string;
+    focusName: string;
+    deliveries: Awaited<ReturnType<typeof getFocusDeliveries>>;
+    issues: Awaited<ReturnType<typeof getFocusIssues>>;
+    worktreePath: string;
+    priorFindings: Awaited<ReturnType<typeof getFocusIssues>>;
+    /**
+     * The first-class answered-escalations section. The fresh-prompt shape already
+     * carries it (it is baked into `prompt` by buildSpawnPrompt); the resume-delta
+     * and forced-fresh scoping shapes build their own message and must append it
+     * here so answered intent reaches EVERY message shape. '' when none. Optional
+     * (defaults to '') so message-shape unit tests need not thread it; the
+     * production spawn path always passes it.
+     */
+    answeredEscalationsSection?: string;
+    /**
+     * Optional out-param: on a resume-delta spawn, the git.diff_against_base
+     * manifest (the ONE assembly source the delta delivers) is pushed here so the
+     * delivered-manifest assembly can record it. Untouched on the fresh / scoping
+     * shapes (which do not resolve git.diff). Optional so existing callers/tests
+     * that only need the message string are unaffected.
+     */
+    gitDiffManifestSink?: AssemblyManifestEntry[];
+}): Promise<string>;
+/**
+ * Decide whether this spawn must be forced fresh to deliver a scoping directive,
+ * and return the resume id the spawn should actually use.
+ *
+ * The wedge this closes: a queued delivery carrying only Context Group issues and
+ * zero Task/Bug issues can never cross the queued->coding gate. The daemon
+ * re-spawns the focus every poll, but the resume lands on a session that already
+ * considers the audit "done" and no-ops in one turn. The fix is to force the
+ * scoping spawn FRESH (resumeId null) so `buildQueuedDeliveryScopingMessage`
+ * primes a new session as its first instruction rather than a resume-delta a
+ * concluded session ignores.
+ *
+ * Only executable focuses are driven into scoping. A `readOnly` (discovery-only,
+ * audit-playbook) focus's CG-only deliveries are intentionally unscoped, so this
+ * never forces them fresh -- their resume id passes through unchanged and the
+ * delivery reaches a terminal state via the reconciler's discovery-only path.
+ *
+ * Pure and exported so the fresh-spawn contract is unit-testable without a live
+ * spawn.
+ */
+export declare function resolveScopingSpawnResume(args: {
+    readOnly: boolean;
+    deliveries: Awaited<ReturnType<typeof getFocusDeliveries>>;
+    issues: Awaited<ReturnType<typeof getFocusIssues>>;
+    resumeId: string | null;
+}): {
+    resumeId: string | null;
+    isScopingSpawn: boolean;
+};
+export declare function findQueuedDeliveriesWithoutTaskIssues(deliveries: Awaited<ReturnType<typeof getFocusDeliveries>>, issues: Awaited<ReturnType<typeof getFocusIssues>>): Awaited<ReturnType<typeof getFocusDeliveries>>;
+export declare function buildQueuedDeliveryScopingMessage(args: {
+    lineage: string;
+    focusName: string;
+    deliveries: Awaited<ReturnType<typeof getFocusDeliveries>>;
+}): string;
+//# sourceMappingURL=prompt-assembly.d.ts.map

package/dist/spawn/prompt-assembly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-assembly.d.ts","sourceRoot":"","sources":["../../src/spawn/prompt-assembly.ts"],"names":[],"mappings":"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"}