@telora/daemon 0.19.47 → 0.19.82

package/dist/spawn/spawn-decision.js

@@ -0,0 +1,437 @@
+/**
+ * Spawn-decision seam for the focus-team spawn path.
+ *
+ * Extracted verbatim from focus-executor.ts (behavior-preserving): the
+ * rank-ordered pre-spawn guard (findActionableDeliveries), the Phase 1 context
+ * fetch (fetchSpawnContext), the Phase 2 actionable-delivery resolution
+ * (resolveActionableDeliveries), and the Phase A directive-or-fallback resolver
+ * (resolveDirectiveOrFallback) -- plus the SpawnFocusTeamParams input contract
+ * and the DEFAULT_LOOP_CONTEXT_RECIPE these consume. 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 { getActiveFocuses, } from '../supabase.js';
+import { getFocusDeliveries, getFocusIssues, getProductDeploymentProfileSnapshot, fetchFocusWorkflow, } from '../queries/focuses.js';
+import { consumePendingSpawnDirective, assembleDirectiveContentWithManifest, syncFocusPhase, isAgentlessDirective, } from '../directive-executor.js';
+import { resolveAssemblyRecipeWithManifest } from '../assembly-engine.js';
+import { resolveAnsweredEscalations } from '../resolvers/escalation-answers.js';
+import { resolveLineageSpec, resolveResumeId } from '../session-lineage.js';
+import { resolveScopingSpawnResume } from './prompt-assembly.js';
+import { resolveFocusMilestoneContext } from '../prd/index.js';
+import { isStatusAgentActionable, isStatusBlocking } from '../stage-classifier.js';
+/**
+ * Default loop-context assembly recipe for a focus-team spawn.
+ *
+ * Composed once per spawn into the team prompt. `focus.endpoint_catalog`
+ * is placed right after `focus.injections` so the exposed/consumed endpoint
+ * catalog reads alongside the tree context -- surfacing cross-product
+ * interrelations at scoping time (shift-left) so a dependency on another
+ * product can be mapped into the reality tree as an externally-owned obstacle
+ * rather than surfacing reactively as a blocked_by_external escalation.
+ */
+export const DEFAULT_LOOP_CONTEXT_RECIPE = [
+    'loop.context',
+    'focus.injections',
+    'focus.endpoint_catalog',
+];
+/**
+ * Pre-spawn guard: rank-ordered walk that collects every agent-actionable
+ * delivery into the spawn set.
+ *
+ * "Actionable" and "blocking" are independent properties of a status:
+ *
+ * - actionable = `isStatusAgentActionable(status)` -- queued | coding |
+ *   verify_failed. Work the team can pick up.
+ * - blocking   = `isStatusBlocking(status)` -- statuses that gate
+ *   subsequent ranks (queued, coding, planning, paused).
+ *
+ * A delivery may be actionable and blocking (queued, coding -- the common
+ * case), actionable and non-blocking (`verify_failed` -- has remediation
+ * work from a review pass, but the next-ranked queued delivery should not
+ * wait on it), or non-actionable and blocking (planning, paused -- gates
+ * the queue and the team has nothing to do here).
+ *
+ * Walk semantics:
+ * - Collect every actionable delivery into the spawn set.
+ * - Stop the walk when we hit the first blocking-and-not-actionable status
+ *   (planning, paused). Lower-ranked deliveries past this point are gated.
+ * - Skip past non-blocking non-actionable statuses (done, cancelled, verify)
+ *   without breaking the walk.
+ *
+ * Returns:
+ * - 'planning' when the focus has zero deliveries (agent will scope them).
+ * - 'execute' with the collected actionable deliveries.
+ * - 'skip' when the walk found zero actionable deliveries.
+ *
+ * Why verify_failed must be in the spawn set: the auto-review loop
+ * routes a delivery from `verify` -> `verify_failed` when the review
+ * agent finds remediation work, clears `review_requested_at`, and emits a
+ * `review_completed` loop trigger. The next poll re-derives phase from
+ * `ACTIVE_STATUSES` (which includes verify_failed), so the focus is
+ * eligible to spawn. If this guard then skips past `verify_failed`, no
+ * team ever picks up the remediation issues and the loop dies after the
+ * first pass. See delivery ac5c69f7.
+ */
+export function findActionableDeliveries(deliveries, focusName) {
+    if (deliveries.length === 0) {
+        return { kind: 'planning' };
+    }
+    const actionable = [];
+    for (const d of deliveries) {
+        const status = d.executionStatus ?? '';
+        if (isStatusAgentActionable(status)) {
+            actionable.push(d);
+            continue;
+        }
+        if (isStatusBlocking(status)) {
+            console.log(`[focus-executor] Delivery "${d.name}" (rank ${d.priorityRank}) ` +
+                `is in "${status}" state -- blocking subsequent deliveries in focus "${focusName}"`);
+            break;
+        }
+        // non-blocking + non-actionable (done, cancelled, verify):
+        // skip past without gating
+    }
+    if (actionable.length === 0) {
+        console.log(`[focus-executor] No actionable deliveries for focus "${focusName}" -- skipping spawn`);
+        return { kind: 'skip' };
+    }
+    return { kind: 'execute', deliveries: actionable };
+}
+/**
+ * Phase 1: fetch all spawn context (deliveries / issues / product-context /
+ * deployment-profile / loop-context) in one Promise.all, then resolve the PRD
+ * milestone push-down. Returns null when the context fetch rejects -- the
+ * caller treats null as "tear down the freshly-inserted team and return"
+ * (activeTeams.delete). The PRD push-down deliberately propagates on throw,
+ * matching the pre-extraction behavior (it sits after the try/catch).
+ *
+ * Behavior-preserving extraction of the original inline block; the log lines,
+ * the deployment-profile .catch fallback, the loop-context try/catch fallback,
+ * and the manifest accumulation order are byte-identical.
+ */
+export async function fetchSpawnContext(config, focusId, focusName) {
+    // Accumulates the assembly manifest (one entry per resolved source) across
+    // every recipe composed for this spawn, persisted after the session exists.
+    const assemblyManifest = [];
+    // Fetch deliveries, issues, deployment profile, and the first-class
+    // answered-escalations section (rendered but NOT consumed here -- consumption
+    // is deferred to post-dispatch).
+    //
+    // The DEFAULT_LOOP_CONTEXT_RECIPE (loopContext) is NOT resolved here: its
+    // rendered output is emitted only by the legacy buildFocusTeamPrompt, so on the
+    // directive path it was a pure dead fetch (and a second focus.injections
+    // resolution on top of the directive's own assembly). It is now resolved lazily
+    // via resolveLegacyLoopContext, gated on the legacy path (see focus-executor).
+    let deliveries;
+    let issues;
+    let deploymentProfileSnapshot;
+    let answeredEscalations;
+    try {
+        [deliveries, issues, deploymentProfileSnapshot, answeredEscalations] = await Promise.all([
+            getFocusDeliveries(focusId),
+            getFocusIssues(focusId),
+            getProductDeploymentProfileSnapshot(config.productId).catch((err) => {
+                console.debug(`[focus-executor] Could not fetch deployment profile snapshot (non-fatal):`, err.message);
+                return null;
+            }),
+            resolveAnsweredEscalations(focusId),
+        ]);
+    }
+    catch (err) {
+        console.error(`[focus-executor] Failed to fetch context for focus "${focusName}":`, err.message);
+        return null;
+    }
+    // PRD push-down: if this focus was armed by a PRD, resolve the parent PRD's
+    // prd.context (milestone goal/expansion/vision + frontier position) and carry
+    // it into the team prompt so the focus inherits coherent milestone intent.
+    // Context ONLY -- the steward persona is never pushed to a coder team. A focus
+    // not under a PRD yields '' and is unaffected (best-effort, never blocks spawn).
+    let prdMilestoneContext = '';
+    let prdMilestoneManifest = [];
+    {
+        const milestoneCtx = {
+            focusId,
+            deliveryIds: [],
+            worktreePath: null,
+            config,
+            organizationId: config.organizationId,
+            productId: config.productId,
+        };
+        const milestoneResult = await resolveFocusMilestoneContext(focusId, milestoneCtx);
+        prdMilestoneContext = milestoneResult.content;
+        // Kept SEPARATE (not merged into assemblyManifest): the PRD milestone context
+        // is appended to the composed prompt by buildSpawnPrompt, so it is delivered
+        // ONLY on the fresh-prompt shapes -- a resume-delta / scoping message drops it.
+        // The delivered-manifest assembly (focus-executor) folds it in per shape.
+        prdMilestoneManifest = milestoneResult.manifest;
+    }
+    return { deliveries, issues, deploymentProfileSnapshot, answeredEscalations, prdMilestoneContext, prdMilestoneManifest, assemblyManifest };
+}
+/**
+ * Resolve the legacy loop-context recipe (loop.context + focus.injections +
+ * focus.endpoint_catalog). Called ONLY on the legacy prompt path
+ * (useLegacyFullPrompt), where buildFocusTeamPrompt renders it -- the directive
+ * path drops loopContext entirely, so resolving it there was wasted work (and a
+ * duplicate focus.injections resolution on top of the directive's own assembly).
+ * Fails soft to empty content, never blocking the spawn.
+ */
+export async function resolveLegacyLoopContext(config, focusId) {
+    try {
+        const assemblyCtx = {
+            focusId,
+            deliveryIds: [],
+            worktreePath: null,
+            config,
+            organizationId: config.organizationId,
+            productId: config.productId,
+        };
+        return await resolveAssemblyRecipeWithManifest(DEFAULT_LOOP_CONTEXT_RECIPE, assemblyCtx);
+    }
+    catch (err) {
+        console.debug(`[focus-executor] Could not fetch loop context (non-fatal):`, err.message);
+        return { content: '', manifest: [] };
+    }
+}
+/**
+ * Phase 2: consume any pending spawn directive, enforce the rank-ordered
+ * pre-spawn guard, and record known-delivery bookkeeping on the team state.
+ *
+ * Mutates `teamState` exactly as the original inline block did
+ * (lastConsumedDirectiveHash, sessionType, planningPhase, knownDeliveryIds,
+ * deliveryStageIds, mergedDeliveryIds) and emits the same log lines. Returns
+ * 'skip' for the findActionableDeliveries skip case (the caller owns the
+ * activeTeams.delete + return so the team-state map stays the orchestrator's
+ * responsibility). Behavior byte-identical.
+ */
+export function resolveActionableDeliveries(args) {
+    const { focusId, focusName, deliveries, issues, forceSpawn, teamState } = args;
+    // Check for pending spawn directive (e.g., review stage spawn).
+    // Record its content hash on team state so the spawn-guard in
+    // executeSpawnDirective can detect divergent directives within the 60s
+    // skip window.
+    const pendingDirective = consumePendingSpawnDirective(focusId);
+    if (pendingDirective) {
+        teamState.lastConsumedDirectiveHash = pendingDirective.contentHash;
+        teamState.sessionType = pendingDirective.sessionType;
+    }
+    // Pre-spawn guard: enforce rank-ordered execution.
+    // Skip when a pending spawn directive exists -- the directive has its own intent.
+    let actionableDeliveries = [];
+    let isPlanningSpawn = false;
+    if (pendingDirective) {
+        actionableDeliveries = deliveries.filter(d => isStatusAgentActionable(d.executionStatus ?? ''));
+    }
+    else if (forceSpawn) {
+        // Escalation answer re-arm: spawn to consume a pending answer even when no
+        // delivery is actionable. Carry whatever deliveries ARE actionable (usually
+        // none -- the focus exited because everything is verify/done); the
+        // escalation.answers resolver in the standard recipe injects the answer.
+        actionableDeliveries = deliveries.filter(d => isStatusAgentActionable(d.executionStatus ?? ''));
+        console.log(`[focus-executor] Focus "${focusName}" force-spawning to consume escalation answer ` +
+            `(${actionableDeliveries.length} actionable deliver${actionableDeliveries.length === 1 ? 'y' : 'ies'})`);
+    }
+    else {
+        const decision = findActionableDeliveries(deliveries, focusName);
+        if (decision.kind === 'skip') {
+            return { kind: 'skip' };
+        }
+        if (decision.kind === 'planning') {
+            isPlanningSpawn = true;
+            teamState.planningPhase = true;
+            console.log(`[focus-executor] Focus "${focusName}" has no deliveries -- spawning planning team`);
+        }
+        else {
+            actionableDeliveries = decision.deliveries;
+        }
+    }
+    // Track known deliveries, pre-populate already-completed ones.
+    // Empty deliveries (planning spawn) yields zero iterations: knownDeliveryIds
+    // stays empty until the wake-cycle refresh in handleCompletionEvent picks
+    // up MCP-written deliveries, at which point planningPhase is cleared.
+    for (const d of deliveries) {
+        teamState.knownDeliveryIds.add(d.id);
+        teamState.deliveryStageIds.set(d.id, d.currentWorkflowStageId);
+        if (!isStatusAgentActionable(d.executionStatus ?? '') && !isStatusBlocking(d.executionStatus ?? '')) {
+            teamState.mergedDeliveryIds.add(d.id);
+        }
+    }
+    if (isPlanningSpawn) {
+        console.log(`  Deliveries: 0 (planning required)`);
+    }
+    else {
+        console.log(`  Deliveries: ${deliveries.length} (${actionableDeliveries.length} queued)`);
+    }
+    console.log(`  Issues: ${issues.length}`);
+    return { kind: 'proceed', pendingDirective, actionableDeliveries, isPlanningSpawn };
+}
+/**
+ * Phase A: resolve the team-lead directive body + spawn metadata (no prompt
+ * yet). Priority: pending spawn directive > current-stage directive > legacy
+ * full prompt. Pushes any assembled directive manifest entries onto the shared
+ * `assemblyManifest` accumulator.
+ *
+ * Behavior-preserving extraction of the original inline Phase A block -- the
+ * "Using pending spawn directive" / "Using stage directive" log lines, the
+ * "LEGACY PROMPT FALLBACK" warning and every fallbackReason string, and the
+ * directive-manifest accumulation are byte-identical.
+ */
+/**
+ * Will the composed directive body actually be SENT on this spawn?
+ *
+ * buildSpawnMessage sends the full composed prompt (which carries the directive
+ * body) ONLY on a fresh spawn -- not scoping, no resume id. A forced-fresh
+ * scoping spawn sends role-framework + scoping directive, and a resume sends an
+ * incremental delta; both discard the directive body. So this returns false for
+ * those two shapes, letting resolveDirectiveOrFallback skip the body's expensive
+ * assembly recipe (INJ-D). Pure -- mirrors buildSpawnMessage's shape selection
+ * (resolveScopingSpawnResume + resolveResumeId) so the skip is unit-testable
+ * without a live spawn.
+ */
+export function willSendDirectiveBody(args) {
+    const spec = resolveLineageSpec({ declared: args.declared, stageName: args.stageName });
+    const rawResumeId = resolveResumeId({
+        sessionMap: args.claudeSessionIds ?? null,
+        lineage: spec.lineage,
+        continuity: spec.continuity,
+    });
+    const { isScopingSpawn } = resolveScopingSpawnResume({
+        readOnly: args.readOnly, deliveries: args.deliveries, issues: args.issues, resumeId: rawResumeId,
+    });
+    return !isScopingSpawn && rawResumeId == null;
+}
+export async function resolveDirectiveOrFallback(args) {
+    const { config, focusId, focusName, worktreePath, pendingDirective, assemblyManifest, claudeSessionIds, deliveries, issues, readOnly } = args;
+    let directiveBody = null; // appended after the role framework
+    let useLegacyFullPrompt = false; // legacy full prompt (no directive)
+    let directiveModel = null;
+    // Stage directive engine + local-model (Workflow layer of the unified
+    // precedence for those two axes); null when the stage pins neither.
+    let directiveEngine = null;
+    let directiveLocalModel = null;
+    // Focus override snapshotted on the pending directive (respawn path only).
+    let pendingFocusOverrideModel = null;
+    // Workflow stage active at spawn -- stamped onto telemetry as the .stage lever.
+    let spawnStageName = null;
+    // Lineage + continuity declared by whatever is firing this spawn (pending
+    // directive, current stage directive, or none). Resolved uniformly later
+    // (INJ-B). For a pending directive these are already resolved upstream, so
+    // resolveLineageSpec is idempotent.
+    let spawnDirectiveDeclared = null;
+    if (pendingDirective && pendingDirective.message.trim()) {
+        // Spawn directive from directive-executor (e.g., review stage transition)
+        directiveBody = pendingDirective.message;
+        directiveModel = pendingDirective.model;
+        directiveEngine = pendingDirective.engine ?? null;
+        directiveLocalModel = pendingDirective.localModel ?? null;
+        pendingFocusOverrideModel = pendingDirective.focusOverrideModel;
+        spawnStageName = pendingDirective.sessionType === 'review' ? 'reviewing' : null;
+        spawnDirectiveDeclared = { lineage: pendingDirective.lineage, continuity: pendingDirective.continuity };
+        console.log(`[focus-executor] Using pending spawn directive for "${focusName}" ` +
+            `(${pendingDirective.message.length} chars directive, model: ${directiveModel ?? 'default'})`);
+    }
+    else {
+        // Sync the focus's execution phase from its delivery aggregate, then
+        // assemble the matching stage directive. Every focus workflow stage is
+        // expected to carry an agent_directive (populated by migration
+        // 20260503140420_focus_phase_directives); the legacy hardcoded prompt
+        // path below is a safety net that should not fire under normal
+        // operation. When it does fire, the warning identifies which guard
+        // tripped so the gap can be fixed.
+        let stageDirectiveContent = null;
+        let stageDirectiveModel = null;
+        let fallbackReason = null;
+        // True when the stage HAS a usable directive but its content assembly is
+        // skipped because the sent message will discard the body (resume-delta /
+        // scoping). Distinct from the legacy-fallback path: metadata is resolved, the
+        // body is simply not needed -- do NOT flip to the legacy full prompt.
+        let directiveContentSkipped = false;
+        try {
+            const activeFocuses = await getActiveFocuses(config.organizationId, config.productId);
+            const focusRecord = activeFocuses.find(s => s.focus_id === focusId);
+            const syncedStageId = focusRecord
+                ? await syncFocusPhase(focusRecord)
+                : null;
+            const workflow = await fetchFocusWorkflow(focusId);
+            const currentStage = syncedStageId
+                ? workflow.stages.find(s => s.id === syncedStageId)
+                : workflow.stages.find(s => s.is_initial);
+            if (!currentStage) {
+                fallbackReason = syncedStageId
+                    ? `no stage matching synced id ${syncedStageId.slice(0, 8)} in workflow`
+                    : 'no synced stage and no is_initial stage in workflow';
+            }
+            else if (!currentStage.agentDirective || isAgentlessDirective(currentStage.agentDirective)) {
+                // NULL directive OR an explicit agentless hold (execution: 'none') --
+                // treat identically: no stage directive drives the spawn, fall back to
+                // the legacy focus-team prompt. Parity keeps a deliberately-agentless
+                // stage from being handed to directive assembly.
+                spawnStageName = currentStage.name ?? null;
+                fallbackReason = currentStage.agentDirective
+                    ? `stage "${currentStage.name}" is an explicit agentless hold (execution=none)`
+                    : `stage "${currentStage.name}" has no agent_directive populated`;
+            }
+            else {
+                spawnStageName = currentStage.name ?? null;
+                // The current stage's directive declares its own lineage + continuity
+                // (INJ-B); resolved uniformly later.
+                spawnDirectiveDeclared = currentStage.agentDirective;
+                // Will the composed directive body actually be SENT? A resume-delta or
+                // forced-fresh scoping spawn discards it -- so skip the expensive assembly
+                // recipe there and resolve directive metadata only.
+                const willSend = willSendDirectiveBody({
+                    declared: currentStage.agentDirective,
+                    stageName: currentStage.name ?? null,
+                    claudeSessionIds, deliveries, issues, readOnly,
+                });
+                if (willSend) {
+                    const { content: directiveContent, manifest: directiveManifest } = await assembleDirectiveContentWithManifest(config, focusId, currentStage.agentDirective, worktreePath);
+                    if (directiveContent.trim()) {
+                        stageDirectiveContent = directiveContent;
+                        stageDirectiveModel = currentStage.agentDirective.model;
+                        // The stage is the Workflow layer for engine + local model too.
+                        directiveEngine = currentStage.agentDirective.engine ?? null;
+                        directiveLocalModel = currentStage.agentDirective.localModel ?? null;
+                        assemblyManifest.push(...directiveManifest);
+                    }
+                    else {
+                        fallbackReason = `assembly returned empty content for stage "${currentStage.name}"`;
+                    }
+                }
+                else {
+                    // Resume-delta / scoping: the body is discarded downstream, so skip the
+                    // assembly entirely. Resolve metadata so model/engine/local-model
+                    // precedence (Focus > Workflow > Default) still holds this pass.
+                    directiveContentSkipped = true;
+                    stageDirectiveModel = currentStage.agentDirective.model;
+                    directiveEngine = currentStage.agentDirective.engine ?? null;
+                    directiveLocalModel = currentStage.agentDirective.localModel ?? null;
+                    console.log(`[focus-executor] Skipping directive content assembly for "${focusName}" ` +
+                        `(resume-delta / scoping spawn -- body discarded; metadata resolved)`);
+                }
+            }
+        }
+        catch (err) {
+            fallbackReason = `directive lookup threw: ${err.message}`;
+        }
+        if (stageDirectiveContent) {
+            directiveBody = stageDirectiveContent;
+            directiveModel = stageDirectiveModel;
+            console.log(`[focus-executor] Using stage directive for "${focusName}" (${stageDirectiveContent.length} chars)`);
+        }
+        else if (directiveContentSkipped) {
+            // Body intentionally not assembled (discarded on resume-delta / scoping).
+            // Leave directiveBody null and useLegacyFullPrompt false: the composed
+            // prompt is thrown away by buildSpawnMessage, so it must NOT trigger the
+            // legacy full prompt. Carry the stage model forward for model resolution.
+            directiveModel = stageDirectiveModel;
+        }
+        else {
+            console.warn(`[focus-executor] LEGACY PROMPT FALLBACK for "${focusName}": ${fallbackReason ?? 'unknown reason'}`);
+            useLegacyFullPrompt = true;
+        }
+    }
+    return { directiveBody, directiveModel, directiveEngine, directiveLocalModel, pendingFocusOverrideModel, spawnStageName, spawnDirectiveDeclared, useLegacyFullPrompt };
+}
+//# sourceMappingURL=spawn-decision.js.map

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

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

package/dist/spawn/worktree-session.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Worktree + session seam for the focus-team spawn path.
+ *
+ * Extracted verbatim from focus-executor.ts (behavior-preserving): the initial
+ * team-state factory, the worktree resolver (reuse+rebase or inline-create), the
+ * team-lead session creator, the best-effort review-context resolver, and the
+ * lineage/engine-for-pass resolver. 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 { createSession, type SessionType } from '../supabase.js';
+import { getFocusIssues } from '../queries/focuses.js';
+import { resolveLineageSpec } from '../session-lineage.js';
+import { resolveBackend, type AgentBackend, type EngineOverride, type EnginePass } from '../backends/index.js';
+import type { DirectiveResolution } from './shared.js';
+/**
+ * Build the initial FocusTeamState for a spawn. Pure factory -- no side effects;
+ * the caller inserts it into the activeTeams map.
+ */
+export declare function createInitialTeamState(args: {
+    focusId: string;
+    focusName: string;
+    role: AgentRole;
+    config: DaemonConfig;
+    executionConfig: FocusTeamState['executionConfig'];
+    pipelineConfig: PipelineConfig | null;
+    branchName: string;
+    readOnly: boolean;
+}): FocusTeamState;
+/**
+ * Phase: resolve the focus worktree to spawn into. Reuses the persistent
+ * worktree (rebasing onto integration + re-asserting read-only guards) when one
+ * exists, else creates one inline. Returns null when the spawn cannot proceed
+ * (repo has no commits, or inline creation failed) -- owning its own teardown
+ * (activeTeams.delete + recordFocusTeardown) so the caller just returns.
+ * Behavior byte-identical to the original inline block.
+ */
+export declare function resolveSpawnWorktree(args: {
+    config: DaemonConfig;
+    focusId: string;
+    focusName: string;
+    branchName: string;
+    readOnly: boolean;
+}): Promise<string | null>;
+/**
+ * Phase: create the team-lead session row + register it with the telemetry
+ * persistence gate, stamping its id onto the team state. Returns null when
+ * createSession fails (owning its own activeTeams.delete teardown). The worktree
+ * is focus-owned and persists even when session creation fails.
+ *
+ * `sessionType` is the AUTHORITATIVE lineage (resolved by resolveEngineForPass,
+ * matching teamState.sessionType), so the (focus, lineage) pass this segment is
+ * opened against is on the SAME lineage the segment carries -- never a stale
+ * 'coding' default while the lineage actually resolved to 'review'.
+ */
+export declare function createTeamSession(args: {
+    config: DaemonConfig;
+    role: AgentRole;
+    focusId: string;
+    focusName: string;
+    branchName: string;
+    sessionType: SessionType;
+    teamState: FocusTeamState;
+}): Promise<Awaited<ReturnType<typeof createSession>> | null>;
+/**
+ * Phase: best-effort review context. When the focus has a recorded
+ * review_requested_at, count the open review-filed issues (the remediation
+ * directive's working set) and carry the prior findings; also resolve the focus
+ * description. A fetch failure leaves the count at zero (normal execution team).
+ */
+export declare function resolveReviewContext(args: {
+    config: DaemonConfig;
+    focusId: string;
+    focusName: string;
+    issues: Awaited<ReturnType<typeof getFocusIssues>>;
+}): Promise<{
+    reviewFiledOpenCount: number;
+    priorFindings: Awaited<ReturnType<typeof getFocusIssues>>;
+    focusDescription: string | null;
+}>;
+/**
+ * Phase B: resolve the session lineage (pass) and the engine backend for it,
+ * stamping lineage + sessionType onto the team state. Returns the lineage spec,
+ * the derived engine pass, the resolved engine, and the backend object.
+ */
+export declare function resolveEngineForPass(args: {
+    spawnDirectiveDeclared: DirectiveResolution['spawnDirectiveDeclared'];
+    spawnStageName: string | null;
+    engineOverride: EngineOverride | null | undefined;
+    /** Stage directive engine (Workflow layer of the unified engine precedence). */
+    stageDirectiveEngine?: string | null;
+    config: DaemonConfig;
+    orgDefaultEngine: string | null | undefined;
+    focusName: string;
+    teamState: FocusTeamState;
+}): {
+    spawnSpec: ReturnType<typeof resolveLineageSpec>;
+    enginePass: EnginePass;
+    resolvedEngine: ReturnType<typeof resolveBackend>;
+    backend: AgentBackend;
+};
+//# sourceMappingURL=worktree-session.d.ts.map

package/dist/spawn/worktree-session.d.ts.map

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