@telora/daemon 0.21.26 → 0.21.82

package/dist/focus/focus-executor.js

@@ -0,0 +1,421 @@
+/**
+ * Focus executor - manages Agent Team lifecycle per focus.
+ *
+ * Replaces the per-delivery agent spawning model. When a focus has
+ * an assigned agent role and queued deliveries, the executor spawns
+ * a single Agent Team (one lead agent process) scoped to the entire focus.
+ *
+ * The lead agent:
+ * 1. Reads all deliveries + issues for the focus
+ * 2. Builds a task DAG with dependencies
+ * 3. Spawns worker teammates to execute issues in parallel
+ * 4. Advances delivery stages as their issues complete
+ * 5. Terminates when all work is done; fresh team spawned for new work
+ *
+ * PARTIAL FACADE -- this module owns the live spawn path (spawnFocusTeam,
+ * findActionableDeliveries) but much of its import surface is re-exported
+ * from the modules where the real logic lives:
+ * - focus-team-state.ts   -- active teams map, execution-config derivation
+ *                            (getActiveTeams, hasActiveTeam, getActiveTeamCount)
+ * - focus-merge.ts        -- focus branch merge orchestration (mergeFocusBranch)
+ * - completion/           -- team completion subsystem: handleTeamCompletion,
+ *                            advanceDeliveryStatuses, terminateTeam,
+ *                            waitForTeamExit, handleCompletionEvent, ...
+ *                            (see completion/index.ts for the module map)
+ * - spawner/              -- log streams, stream handlers, process close,
+ *                            liveness, pending-spawn guards
+ * When tracing a symbol imported from this file, check those modules first;
+ * only the spawn choreography itself is implemented here.
+ */
+import { mkdirSync, existsSync } from 'node:fs';
+import { updateSession } from '../queries/sessions.js';
+import { productLabel } from '@telora/daemon-core';
+import { recordActivity } from '../shell/heartbeat.js';
+import { applyRespawnGuard } from './focus-respawn-guard.js';
+import { resolveRef } from '../git/index.js';
+import { shouldAbortReviewSpawnForUnresolvableCoverage } from '../completion/review-spawn-coverage-guard.js';
+import { resolveFocusBranchName } from './focus-branch-identity.js';
+import { setFocusBranchName } from '../queries/focuses.js';
+import { resolveResumeId } from '../session/session-lineage.js';
+// Register assembly resolvers with assembly-engine at module load (side effect). Required - do not remove.
+import { initResolvers } from '../resolvers/index.js';
+initResolvers();
+import { releaseHostByFocus } from '../host-control/index.js';
+// ── Imports from extracted modules ──────────────────────────────────────
+import { getActiveTeams, deriveExecutionConfig, } from './focus-team-state.js';
+// Import the spawn helpers from their defining module (NOT the spawner barrel):
+// the barrel re-exports spawnFocusTeam from THIS module, so importing the
+// barrel here would close a static import cycle.
+import { setupTeamLogStreams, } from '../spawn/helpers.js';
+// Model-routing seam (extracted to ./spawn/model-routing.js). Imported here for
+// the two symbols spawnFocusTeam calls directly; the full moved surface is
+// re-exported below so external importers keep resolving it from this module.
+import { resolveSpawnModel, surfaceSingleHostModelConflict } from '../spawn/model-routing.js';
+// Prompt-assembly seam (extracted to ./spawn/prompt-assembly.js). Imported here
+// for the symbols spawnFocusTeam calls directly; the full moved surface is
+// re-exported below so external importers keep resolving it from this module.
+import { buildFocusPromptContext, buildSpawnPrompt, buildSpawnMessage, resolveScopingSpawnResume, } from '../spawn/prompt-assembly.js';
+// Worktree-session seam (extracted to ./spawn/worktree-session.js). Imported here
+// for the symbols spawnFocusTeam calls directly; the full moved surface is
+// re-exported below so external importers keep resolving it from this module.
+import { createInitialTeamState, resolveSpawnWorktree, createTeamSession, resolveReviewContext, resolveEngineForPass, } from '../spawn/worktree-session.js';
+// Spawn-decision seam (extracted to ./spawn/spawn-decision.js). Imported here for
+// the symbols spawnFocusTeam calls directly; the full moved surface is re-exported
+// below so external importers keep resolving it from this module.
+import { fetchSpawnContext, resolveActionableDeliveries, resolveDirectiveOrFallback, resolveLegacyLoopContext, } from '../spawn/spawn-decision.js';
+// Process-spawn seam (extracted to ./spawn/process-spawn.js). Imported here for
+// spawnTeamProcess, which the orchestrator spawnFocusTeam calls directly; the
+// full moved surface is re-exported below so external importers (and tests) keep
+// resolving it from this module.
+import { spawnTeamProcess } from '../spawn/process-spawn.js';
+import { buildDeliveredManifest } from '../spawn/delivered-manifest.js';
+import { createLogger } from '../shell/log.js';
+const log = createLogger({ module: 'focus-executor' });
+// ── Re-exports for backward compatibility ───────────────────────────────
+export { selectLocalModelRef, codexHomeForSpawn, decideLocalModelRouting, shouldSwapForPass, resolveEffectiveModel, isClaudeModelId, isForwardSafeHostedCodexModel, FORWARD_SAFE_HOSTED_CODEX_MODELS, selectPipelineModelForSpawn, selectDirectiveModelForSpawn, resolveLocalModelConfig, surfaceSingleHostModelConflict, resolveSpawnModel, buildAgentArgs, } from '../spawn/model-routing.js';
+export { buildFocusPromptContext, buildSpawnPrompt, buildSpawnMessage, resolveScopingSpawnResume, findQueuedDeliveriesWithoutTaskIssues, buildQueuedDeliveryScopingMessage, } from '../spawn/prompt-assembly.js';
+export { createInitialTeamState, resolveSpawnWorktree, createTeamSession, resolveReviewContext, resolveEngineForPass, } from '../spawn/worktree-session.js';
+export { findActionableDeliveries, resolveActionableDeliveries, resolveDirectiveOrFallback, fetchSpawnContext, DEFAULT_LOOP_CONTEXT_RECIPE, } from '../spawn/spawn-decision.js';
+export { gateLocalModelBackendSpawn, backendUnavailableSessionUpdate, spawnCrashIsolated, persistSpawnFailureAfterRunning, closeTeamProxyQuietly, spawnTeamProcess, governorDeniedSessionUpdate, sandboxUnavailableSessionUpdate, } from '../spawn/process-spawn.js';
+export { getActiveTeams, hasActiveTeam, getActiveTeamCount, } from './focus-team-state.js';
+export { mergeFocusBranch, } from '../merge/focus-merge.js';
+export { handleTeamCompletion, advanceDeliveryStatuses, isStatusTerminal, isStatusAgentActionable, } from '../completion/index.js';
+export { terminateTeam, waitForTeamExit, terminateAllTeams, detectDeactivatedFocuses, checkAndMergeCompletedDeliveries, } from '../completion/index.js';
+// ── Resource governor (optional, injected by FocusEngine) ─────────
+let governor = null;
+/** Inject the resource governor for global concurrency limiting. */
+export function initGovernor(gov) {
+    governor = gov;
+}
+/**
+ * Get the current resource governor. Exposed for the spawner barrel surface
+ * (legacy ./team-spawner.js consumers); reads the SAME binding initGovernor
+ * sets, so callers see the governor FocusEngine actually injected.
+ */
+export function getGovernor() {
+    return governor;
+}
+// ── Team spawning ────────────────────────────────────────────────────
+// generateFocusBranchName + resolveFocusBranchName live in focus-branch-identity.ts
+// (a light module) so every consumer and the unit tests can use them without the
+// spawn graph. Re-exported here for back-compat with existing importers
+// (focus-lifecycle, focus-provisioning, the spawner barrel).
+export { generateFocusBranchName } from './focus-branch-identity.js';
+/**
+ * Log the spawn header (focus / role / model / workers / branch, plus the
+ * product line in multi-product mode). Side-effect-only; byte-identical to the
+ * original inline logging.
+ */
+export function logSpawnHeader(args) {
+    const { config, focusId, focusName, role, pipelineConfig, executionConfig, branchName, readOnly } = args;
+    const currentProduct = config.products.find(p => p.id === config.productId);
+    const productTag = config.products.length > 1 && currentProduct ? ` [${productLabel(currentProduct)}]` : '';
+    log.info(`Spawning team for focus "${focusName}"${readOnly ? ' [READ-ONLY]' : ''}${productTag}`, { focusId, productId: config.productId });
+    log.info(`  Role: ${role.name}`);
+    log.info(`  Model: ${pipelineConfig?.model ?? '(CLI default)'}`);
+    log.info(`  Max workers: ${executionConfig.maxWorkers}`);
+    log.info(`  Branch: ${branchName}`);
+    if (config.products.length > 1) {
+        log.info(`  Product: ${currentProduct ? productLabel(currentProduct) : config.productId.slice(0, 8)}`);
+        log.info(`  Repo: ${config.repoPath}`);
+    }
+}
+/**
+ * Spawn a focus team to execute all deliveries in a focus.
+ *
+ * Creates a single Agent Team (lead process) that reads all deliveries
+ * and issues, builds a task DAG, and coordinates worker execution.
+ */
+export async function spawnFocusTeam(params) {
+    const { config, focusId, focusName, role, pipelineConfig, readOnly = false, claudeSessionIds, engineOverride, localModelOverride, orgDefaultEngine, pinnedBranch, forceSpawn = false } = params;
+    const activeTeams = getActiveTeams();
+    // The agent backend is resolved per-pass below, once the spawn's lineage
+    // (coding vs review) is known -- see resolveBackend() after lineage resolution.
+    // Prevent double-spawn
+    if (activeTeams.has(focusId)) {
+        log.warn(`Team already active for focus "${focusName}", skipping spawn`);
+        return;
+    }
+    if (await applyRespawnGuard(focusId, focusName))
+        return;
+    const executionConfig = deriveExecutionConfig(pipelineConfig);
+    // Read the PINNED branch identity if the focus has one; otherwise derive it
+    // from the current role and persist it below (write-once, on first creation).
+    // Reading the pin is what makes the branch immune to a mid-flight role rename.
+    const resolvedBranch = resolveFocusBranchName({ pinnedBranch, role, focusName, focusId });
+    const branchName = resolvedBranch.branchName;
+    if (!resolvedBranch.pinned) {
+        // First creation: capture the identity so every later spawn (and worktree
+        // resolution, review coverage, provenance) reads this exact name regardless
+        // of any subsequent role change. Best-effort -- a write failure must not
+        // block the spawn; the next spawn re-derives the same name and retries the pin.
+        setFocusBranchName(focusId, branchName).catch((err) => log.warn(`[focus-executor] Failed to pin branch_name for "${focusName}": ${err.message}`));
+    }
+    // Initialize team state
+    const teamState = createInitialTeamState({
+        focusId, focusName, role, config, executionConfig, pipelineConfig, branchName, readOnly,
+    });
+    activeTeams.set(focusId, teamState);
+    logSpawnHeader({ config, focusId, focusName, role, pipelineConfig, executionConfig, branchName, readOnly });
+    // --- Phase 1: fetch all spawn context (deliveries/issues/product-context/
+    // deployment-profile/loop-context) + PRD milestone push-down. null => the
+    // context fetch rejected; tear down the freshly-inserted team and return.
+    const spawnContext = await fetchSpawnContext(config, focusId, focusName);
+    if (!spawnContext) {
+        activeTeams.delete(focusId);
+        return;
+    }
+    const { deliveries, issues, deploymentProfileSnapshot, answeredEscalations, prdMilestoneContext, prdMilestoneManifest, assemblyManifest, } = spawnContext;
+    // --- Phase 2: consume any pending directive, run the rank-ordered pre-spawn
+    // guard, and record known-delivery bookkeeping on the team state. 'skip' =>
+    // no actionable work; tear down and return (the map stays orchestrator-owned).
+    const resolution = resolveActionableDeliveries({
+        focusId, focusName, deliveries, issues, forceSpawn, teamState,
+    });
+    if (resolution.kind === 'skip') {
+        activeTeams.delete(focusId);
+        return;
+    }
+    const { pendingDirective } = resolution;
+    // Ensure log directory exists
+    if (!existsSync(config.logDir)) {
+        mkdirSync(config.logDir, { recursive: true, mode: 0o700 });
+    }
+    // --- Phase: resolve the focus worktree (reuse + rebase, or inline-create).
+    // null => cannot spawn (no commits / create failed); the helper already tore
+    // down (activeTeams.delete + recordFocusTeardown).
+    const worktreePath = await resolveSpawnWorktree({ config, focusId, focusName, branchName, readOnly });
+    if (!worktreePath)
+        return;
+    teamState.worktreePath = worktreePath;
+    // Pin the integration tip NOW -- after the worktree rebased onto integration,
+    // before any mid-flight or completion merges advance the ref. This is the diff
+    // base for the session's git output at finalize; the live integration ref
+    // cannot be used because merging the focus branch makes `integration..branch`
+    // empty (real merges preserve ancestry).
+    teamState.integrationBaseSha = resolveRef(worktreePath, config.integrationBranch);
+    recordActivity();
+    // Best-effort review context: review-filed open count + prior findings (the
+    // remediation working set) + the focus description for the prompt.
+    const { reviewFiledOpenCount, priorFindings, focusDescription, agentResolvableItems } = await resolveReviewContext({
+        config, focusId, focusName, issues,
+    });
+    // --- Phase A: resolve the directive body + spawn metadata (no prompt yet) ---
+    // The engine backend is resolved per-pass (Phase B) before the prompt is
+    // built (Phase C), so the lead prompt's orchestration vocabulary matches the
+    // engine that will actually run this pass.
+    const { directiveBody, directiveModel, directiveEngine, directiveLocalModel, pendingFocusOverrideModel, spawnStageName, spawnDirectiveDeclared, useLegacyFullPrompt, } = await resolveDirectiveOrFallback({
+        config, focusId, focusName, worktreePath, pendingDirective, assemblyManifest,
+        claudeSessionIds, deliveries, issues, readOnly,
+    });
+    // --- Phase B: resolve the session lineage (pass) and the engine backend
+    // (stamps lineage + sessionType onto the team state). The stage directive's
+    // engine is the Workflow layer of the unified Focus > Workflow > Default. ---
+    const { spawnSpec, enginePass, resolvedEngine, backend } = resolveEngineForPass({
+        spawnDirectiveDeclared, spawnStageName, engineOverride, stageDirectiveEngine: directiveEngine,
+        config, orgDefaultEngine, focusName, teamState,
+    });
+    // Pin the focus-branch tip THIS review pass is covering (spawn-tip), captured
+    // now (post-rebase, before any mid-review commits). Carried to completion so
+    // the coverage watermark is stamped from what the review actually saw, and so
+    // the auto-approve gate can detect mid-review drift (spawn-tip != exit-tip).
+    // Review lineage only; coding teams leave it null.
+    if (teamState.sessionType === 'review') {
+        const spawnTip = resolveRef(worktreePath, branchName);
+        if (shouldAbortReviewSpawnForUnresolvableCoverage(teamState.sessionType, spawnTip)) {
+            // Hard-fail: a review pass whose coverage anchor cannot be resolved must
+            // NOT open a session. If it did, the review would run to a succeeded exit
+            // with coverageComplete=false (a null spawn-tip can never be
+            // coverage-complete -- review-exit-phase.ts:233), auto-approve would be
+            // withheld as apparent drift, and a full-pass re-review armed every cycle
+            // -- structurally forever (the 224-rejection loop shape from the
+            // 2026-08-06 incident). Stop here with a specific signal naming the
+            // unresolvable ref; tear down the freshly-inserted team (the worktree is
+            // focus-owned and left intact). No session opens, so the focus never
+            // enters the unknown-coverage re-review cycle.
+            log.error(`[focus-executor] Review spawn ABORTED for "${focusName}": coverage ref ` +
+                `"${branchName}" could not be resolved in ${worktreePath}. No session opened ` +
+                `(a review over an unresolvable coverage anchor would loop as unknown-coverage drift).`);
+            activeTeams.delete(focusId);
+            return;
+        }
+        teamState.reviewSpawnTip = spawnTip;
+    }
+    // --- Phase: create the team-lead session. Opened AFTER Phase B so the
+    // (focus, lineage) pass is resolved on the authoritative lineage
+    // (teamState.sessionType), not a stale 'coding' default -- a 'review'-lineage
+    // spawn without a pending directive would otherwise open a 'coding' pass while
+    // the segment carried 'review'. null => createSession failed (the helper
+    // already removed the team from activeTeams; worktree is focus-owned). Nothing
+    // between Phase B above and here uses session.id; the first real use is the
+    // modelResolution updateSession below.
+    const session = await createTeamSession({
+        config, role, focusId, focusName, branchName, sessionType: teamState.sessionType, teamState,
+    });
+    if (!session)
+        return;
+    // Legacy loop-context: resolved ONLY when the legacy full prompt will render it
+    // (the directive path drops it, so resolving there was a dead fetch + a
+    // duplicate focus.injections resolution). Empty string on the directive path.
+    let loopContext = '';
+    if (useLegacyFullPrompt) {
+        const loopContextResult = await resolveLegacyLoopContext(config, focusId);
+        loopContext = loopContextResult.content;
+        assemblyManifest.push(...loopContextResult.manifest);
+    }
+    // --- Phase C: build the prompt with the resolved engine's vocabulary ---
+    const promptContext = buildFocusPromptContext({
+        config, focusId, focusName, focusDescription, deliveries, issues, executionConfig,
+        pipelineConfig, deploymentProfileSnapshot, readOnly, loopContext,
+        reviewFiledOpenCount, engineId: backend.id,
+        // agent_resolvable filings are CODING work: hand them only to a coding pass,
+        // never a review pass (a reviewer does not fix; it would mis-task them).
+        agentResolvableItems: teamState.sessionType === 'review' ? [] : agentResolvableItems,
+    });
+    const prompt = buildSpawnPrompt({
+        role, promptContext, useLegacyFullPrompt, directiveBody, prdMilestoneContext,
+        answeredEscalationsSection: answeredEscalations.section,
+        isReviewPass: teamState.sessionType === 'review',
+        // Hand the review agent its own Telora agent_sessions.id so it stamps the
+        // outcome with the exact id product-api validates against (review.ts).
+        agentSessionId: session.id,
+    });
+    // Set up log file streams
+    const logs = setupTeamLogStreams(config.logDir, branchName, focusName);
+    // Build args and env.
+    // Resolve the resume id from the focus's per-lineage session map (INJ-A),
+    // keyed by the spawn's declared lineage, honoring its declared continuity
+    // policy (INJ-B). continuity=fresh -> null; resume -> the lineage's stored id.
+    const rawResumeId = resolveResumeId({
+        sessionMap: claudeSessionIds,
+        lineage: spawnSpec.lineage,
+        continuity: spawnSpec.continuity,
+    });
+    // Force the spawn FRESH when an executable focus has queued CG-only deliveries
+    // that need scoping: the scoping directive must land on a NEW session, not
+    // resume a concluded one that no-ops (the spawn-loop wedge). resumeId is nulled
+    // BEFORE arg-building so no --resume flag reaches the process. Discovery-only
+    // (readOnly) focuses pass through unchanged.
+    const scopingResume = resolveScopingSpawnResume({
+        readOnly,
+        deliveries,
+        issues,
+        resumeId: rawResumeId,
+    });
+    const resumeId = scopingResume.resumeId;
+    if (scopingResume.isScopingSpawn) {
+        log.info(`[focus-executor] Forcing fresh scoping spawn for "${focusName}" ` +
+            `(dropping resume id ${rawResumeId ?? 'none'}; queued CG-only deliveries need Task/Bug scoping)`);
+    }
+    // --- Phase: resolve CODEX_HOME + per-pass local-model routing + model
+    // selection + CLI args.
+    // Surface (do not silently thrash) two different local models pinned to the
+    // coding vs review pass on one GPU host (#9). Best-effort + deduped per focus;
+    // never blocks the spawn. Runs before model resolution so the operator sees the
+    // conflict regardless of which pass spawns first.
+    await surfaceSingleHostModelConflict({
+        focusId, focusName,
+        organizationId: config.organizationId,
+        productId: config.productId,
+        localModelOverride,
+    }).catch(err => {
+        log.warn(`single-host model-conflict check failed for "${focusName}":`, err.message);
+    });
+    const modelResolution = await resolveSpawnModel({
+        resolvedEngine, enginePass, localModelOverride, stageDirectiveLocalModel: directiveLocalModel,
+        config, directiveModel,
+        pendingFocusOverrideModel, pipelineConfig, backend, worktreePath, resumeId,
+        role, readOnly, focusName, focusId,
+    });
+    if (modelResolution.kind === 'skip_load') {
+        // Host-control swap failed (D2): do NOT spawn against a not-yet-loaded model.
+        // Conservative -- mark the just-created session terminal (transient host-swap
+        // failure, NOT a key/config defect) and release the in-memory slot so the 30s
+        // poll cleanly re-attempts. No escalation: the failure is operationally
+        // transient (host unreachable / model not yet loaded) and self-healing.
+        const { coords, dbMessage } = modelResolution;
+        await updateSession(session.id, {
+            status: 'failed',
+            exit_reason: `Host-control model swap failed for "${coords.name}": ${dbMessage}`,
+            exit_category: 'local_model_swap_failed',
+            ended_at: new Date().toISOString(),
+        }).catch(updateErr => {
+            log.warn(`Failed to update session after local-model swap failure:`, updateErr.message);
+        });
+        // Reset host-control state: a failed/timed-out load must not leave a residency
+        // lock pinned to this focus (the swap-manager clears its own entry on the
+        // failed observe; this is the defense-in-depth release on the spawn-teardown
+        // path, which -- unlike a normal team completion -- never reaches
+        // handleTeamCompletion). The next poll then re-evaluates the host cleanly.
+        releaseHostByFocus(focusId);
+        activeTeams.delete(focusId);
+        return;
+    }
+    if (modelResolution.kind === 'still_loading') {
+        // The per-host model swap is running OFF the poll loop (#3), or the host is
+        // held by another focus's running pass (#4). This is NOT a failure: mark the
+        // just-created session benign-terminal and release the in-memory slot so the
+        // 30s poll cleanly re-attempts -- the detached load keeps running and a later
+        // tick spawns once the model is ready / the host frees. The poll loop is not
+        // stalled because the load was never awaited here. No escalation.
+        const { coords, reason } = modelResolution;
+        await updateSession(session.id, {
+            status: 'failed',
+            exit_reason: `Host-control swap deferred for "${coords.name}" (${reason}); retrying next poll`,
+            exit_category: 'local_model_swap_deferred',
+            ended_at: new Date().toISOString(),
+        }).catch(updateErr => {
+            log.warn(`Failed to update session after local-model swap deferral:`, updateErr.message);
+        });
+        activeTeams.delete(focusId);
+        return;
+    }
+    const { args, effectiveModel, spawnCodexHome, spawnLocalModelKey, isLocalModelPass } = modelResolution;
+    // Attach the local-model translating proxy (if engaged) to the team state so
+    // every teardown path can close it and the close handler can read its
+    // reception guard. Null for hosted/Claude/flag-off spawns.
+    teamState.mcpProxy = modelResolution.mcpProxy ?? null;
+    // On resume, send an incremental delta instead of the full prompt (INJ-D);
+    // a fresh spawn sends the composed prompt unchanged. The git.diff manifest the
+    // resume delta delivers is captured here for the delivered-manifest record.
+    const gitDiffManifest = [];
+    const messageToSend = await buildSpawnMessage({
+        prompt, resumeId, readOnlyFocus: readOnly, role, promptContext, spawnSpec, config, focusId, focusName, deliveries, issues, worktreePath, priorFindings,
+        answeredEscalationsSection: answeredEscalations.section,
+        gitDiffManifestSink: gitDiffManifest,
+        // Hand a RESUMED review pass its own active Telora session id too (the
+        // fresh-prompt shape already carries it) so a review that runs across resumes
+        // stamps focus_review_complete with the exact id product-api validates,
+        // instead of a stale/completed one it cannot discover.
+        agentSessionId: session.id,
+    });
+    // Assemble the DELIVERED manifest: the sources actually composed into the
+    // message just built, per its shape (agent_context_assembly truthfulness).
+    // assemblyManifest already carries only the directive recipe (fresh directive)
+    // or the loop-context recipe (fresh legacy) -- empty on resume-delta / scoping.
+    const spawnShape = scopingResume.isScopingSpawn
+        ? 'scoping'
+        : resumeId != null
+            ? 'resume-delta'
+            : useLegacyFullPrompt
+                ? 'fresh-legacy'
+                : 'fresh-directive';
+    const deliveredManifest = buildDeliveredManifest({
+        shape: spawnShape,
+        promptRecipeManifest: assemblyManifest,
+        answeredEscalationsSection: answeredEscalations.section,
+        prdMilestoneManifest,
+        gitDiffManifest,
+    });
+    // --- Final phase: build the spawn env, persist the manifest, write the
+    // session lifecycle, acquire the governor slot, sandbox-wrap, spawn the child,
+    // write stdin, and attach handlers. Owns its governor-denied / sandbox-
+    // unavailable cleanups (session failed-write + slot release + activeTeams.delete).
+    await spawnTeamProcess({
+        config, focusId, focusName, session, teamState, backend, args, messageToSend,
+        logs, worktreePath, resumeId, assemblyManifest: deliveredManifest, spawnCodexHome, spawnLocalModelKey, isLocalModelPass,
+        effectiveModel, pendingDirective, spawnStageName, params, governor, spawnFocusTeam,
+        answeredEscalationIds: answeredEscalations.ids,
+    });
+}
+//# sourceMappingURL=focus-executor.js.map

package/dist/focus/focus-executor.js.map

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

package/dist/focus/focus-lifecycle.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Focus lifecycle management.
+ *
+ * Handles persistent worktree provisioning for active focuses and
+ * coordinated teardown when focuses are deactivated. Replaces the
+ * separate detectDeactivatedFocuses() and checkQaForDeactivatedFocuses()
+ * flows with a single unified lifecycle.
+ */
+import type { DaemonConfig, AgentRole } from '../types/index.js';
+/**
+ * Ensure persistent worktrees exist for all active focuses.
+ *
+ * Called each poll cycle BEFORE processReadyFocuses(). Creates
+ * worktrees for active focuses that don't have one yet.
+ * Syncs integration with main once per cycle (not per focus).
+ */
+export declare function ensureFocusWorktrees(config: DaemonConfig, roles: Map<string, AgentRole>): Promise<void>;
+/**
+ * Tear down a single focus: terminate team and remove worktree.
+ *
+ * Each step is independently try/caught so a failure in one
+ * does not prevent the others from running.
+ */
+export declare function teardownFocus(config: DaemonConfig, focusId: string, focusName: string): Promise<void>;
+/**
+ * Detect deactivated focuses and tear them down.
+ *
+ * Replaces detectDeactivatedFocuses() from focus-executor.ts.
+ * A single pass handles team termination for deactivated focuses.
+ */
+export declare function checkForDeactivatedFocuses(config: DaemonConfig): Promise<void>;
+/**
+ * Rebuild the focus-worktree-state after a daemon restart.
+ *
+ * Two-phase approach:
+ *   Phase 1 (DB-first): If hydrateFromDb() populated the Map, validate
+ *     each entry against disk and enrich with focus names. Removes
+ *     stale entries (worktree deleted from disk) and cleans up entries
+ *     for deactivated focuses.
+ *   Phase 2 (disk fallback): Scans for agent-* directories NOT already
+ *     in the Map. Covers first-run after migration and manually created
+ *     worktrees. Matches by ID prefix against active focuses.
+ *
+ * Also removes legacy qa-* directories from the pre-persistent worktree era.
+ *
+ * Must run AFTER hydrateFromDb() and crash recovery but BEFORE startListeners().
+ */
+export declare function rebuildFocusWorktreeState(config: DaemonConfig): Promise<void>;
+/**
+ * Reconcile git state for active focus worktrees after startup.
+ *
+ * Checks all rebuilt focus worktrees and re-reports `worktree_active`
+ * for deliveries in coding/queued status. This ensures the DB reflects
+ * accurate git state even if previous reportGitState calls were lost
+ * (network blip, circuit breaker, daemon crash).
+ *
+ * Must run AFTER rebuildFocusWorktreeState().
+ */
+export declare function reconcileGitState(_config: DaemonConfig): Promise<void>;
+//# sourceMappingURL=focus-lifecycle.d.ts.map

package/dist/focus/focus-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-lifecycle.d.ts","sourceRoot":"","sources":["../../src/focus/focus-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AA4BjE;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CA0If;AAID;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAgFf;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CA0Df;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CAuLf;AAID;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CAiCf"}