@telora/daemon 0.19.47 → 0.19.82

package/dist/spawn/prompt-assembly.js

@@ -0,0 +1,272 @@
+/**
+ * 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 { getActiveFocuses } from '../queries/deliveries.js';
+import { consumeForceFullPassReview } from '../completion/review-exit-phase.js';
+import { buildRoleFrameworkPrompt, buildRemediationFramingSection, buildReviewOutcomeStampingSection, buildReviewSensorAuditSection, buildResumeDeltaMessage, } from '../team-prompt-base.js';
+import { buildFocusTeamPrompt } from '../focus-prompt-builder.js';
+import { resolveAssemblyRecipeWithManifest } from '../assembly-engine.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 function buildFocusPromptContext(args) {
+    const { config, focusId, focusName, focusDescription, deliveries, issues, executionConfig, pipelineConfig, deploymentProfileSnapshot, readOnly, loopContext, reviewFiledOpenCount, engineId, } = args;
+    return {
+        focusId,
+        focusName,
+        focusDescription,
+        organizationId: config.organizationId,
+        productId: config.productId,
+        deliveries,
+        issues,
+        executionConfig,
+        pipelineConfig,
+        deploymentProfileSnapshot,
+        readOnly,
+        loopContext,
+        reviewFiledOpenCount,
+        engineId,
+    };
+}
+/**
+ * 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 function buildSpawnPrompt(args) {
+    const { role, promptContext, useLegacyFullPrompt, directiveBody, prdMilestoneContext, answeredEscalationsSection = '', isReviewPass, agentSessionId } = args;
+    let prompt;
+    if (!useLegacyFullPrompt && directiveBody !== null) {
+        const framing = buildRemediationFramingSection(directiveBody).join('\n');
+        prompt = buildRoleFrameworkPrompt(role, promptContext)
+            + '\n\n'
+            + (framing ? framing + '\n' : '')
+            + directiveBody;
+    }
+    else {
+        prompt = buildFocusTeamPrompt(role, promptContext);
+    }
+    // Answered directed escalations (first-class): appended so BOTH the directive
+    // and legacy prompt paths carry answered intent. On the legacy path the same
+    // content also appears via the loop-context section; the fresh directive path
+    // has no other channel for it, which is the loss this closes.
+    if (answeredEscalationsSection.trim()) {
+        prompt += '\n\n' + answeredEscalationsSection;
+    }
+    // Review passes carry two review-only obligations. The sensor-audit charge
+    // (weak-sensor audit injection #8) makes the independent review frame
+    // interrogate the tests, not just the code; the outcome-stamping obligation
+    // is the terminal step, so it is appended LAST. Both reach the directive and
+    // legacy prompt paths and are emitted for review spawns only.
+    if (isReviewPass) {
+        prompt += '\n\n' + buildReviewSensorAuditSection().join('\n');
+        prompt += '\n\n' + buildReviewOutcomeStampingSection(agentSessionId).join('\n');
+    }
+    // Append PRD milestone context (push-down) so a PRD-armed focus team inherits
+    // the milestone's goal/expansion/vision + frontier position. Appended to the
+    // final prompt so it reaches BOTH the directive and legacy prompt paths; empty
+    // for any focus not armed by a PRD (no change to ordinary focus spawns).
+    if (prdMilestoneContext.trim()) {
+        prompt += '\n\n' + prdMilestoneContext;
+    }
+    return prompt;
+}
+/**
+ * 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 async function buildSpawnMessage(args) {
+    const { prompt, resumeId, readOnlyFocus, role, promptContext, spawnSpec, config, focusId, focusName, deliveries, issues, worktreePath, priorFindings, answeredEscalationsSection = '', gitDiffManifestSink } = args;
+    const answersSuffix = answeredEscalationsSection.trim() ? `\n\n${answeredEscalationsSection}` : '';
+    // Scoping directive takes priority over the fresh/resume split, but ONLY for
+    // executable (non-discovery) focuses. It is returned even when resumeId is
+    // null because the caller forces this spawn fresh for exactly this case.
+    if (!readOnlyFocus) {
+        const unscopedDeliveries = findQueuedDeliveriesWithoutTaskIssues(deliveries, issues);
+        if (unscopedDeliveries.length > 0) {
+            // Prepend the role framework (identity, Scoping Mandate, MANDATORY
+            // status-update rules, worker-management, escalation) so the FORCED-FRESH
+            // scoping session receives its operating contract -- the audit/kickoff
+            // DIRECTIVE body in `prompt` is the only part intentionally dropped, not the
+            // role framework. On a fresh session stdin is the sole first-turn message,
+            // so omitting the framework would leave the team lead with no identity.
+            const roleFramework = buildRoleFrameworkPrompt(role, promptContext);
+            const scopingDirective = buildQueuedDeliveryScopingMessage({
+                lineage: spawnSpec.lineage,
+                focusName,
+                deliveries: unscopedDeliveries,
+            });
+            const messageToSend = `${roleFramework}\n\n${scopingDirective}${answersSuffix}`;
+            console.log(`[focus-executor] Spawning fresh scoping session for "${focusName}" ` +
+                `-- role framework + explicit scoping directive for ${unscopedDeliveries.length} queued ` +
+                `zero-issue deliver${unscopedDeliveries.length === 1 ? 'y' : 'ies'} ` +
+                `(lineage ${spawnSpec.lineage}, ${messageToSend.length} chars)`);
+            return messageToSend;
+        }
+    }
+    if (!resumeId)
+        return prompt;
+    // Review resume delta is computed from the coverage watermark, not "since
+    // last spawn": a resumed reviewer sees reviewed_through_sha..tip when a
+    // completed cycle set the watermark, and the FULL branch diff (with an
+    // explicit full-pass demand) when none exists (first review, or the prior
+    // cycle aborted). Non-review resumes keep the integration-base diff.
+    let reviewCoverage;
+    let diffBaseOverride;
+    if (spawnSpec.lineage === 'review') {
+        try {
+            // A prior review under-covered (the branch drifted mid-review), so the
+            // review-exit handler armed a full pass: the incremental watermark cannot
+            // be trusted this cycle. consumeForceFullPassReview clears the one-shot arm.
+            if (consumeForceFullPassReview(focusId)) {
+                reviewCoverage = { mode: 'full-pass' };
+            }
+            else {
+                const focuses = await getActiveFocuses(config.organizationId, config.productId);
+                const watermark = focuses.find(f => f.focus_id === focusId)?.reviewed_through_sha ?? null;
+                if (watermark) {
+                    diffBaseOverride = watermark;
+                    reviewCoverage = { mode: 'incremental', baseSha: watermark };
+                }
+                else {
+                    reviewCoverage = { mode: 'full-pass' };
+                }
+            }
+        }
+        catch (err) {
+            // On a resolve failure, default to a full pass -- the safe direction
+            // (re-cover everything rather than silently skip an unreviewed range).
+            console.debug(`[focus-executor] Review coverage watermark resolve failed (non-fatal):`, err.message);
+            reviewCoverage = { mode: 'full-pass' };
+        }
+    }
+    let gitDiff = '';
+    try {
+        const diffCtx = {
+            focusId,
+            deliveryIds: deliveries.map(d => d.id),
+            worktreePath,
+            config,
+            organizationId: config.organizationId,
+            productId: config.productId,
+            ...(diffBaseOverride ? { diffBaseOverride } : {}),
+        };
+        const { content, manifest } = await resolveAssemblyRecipeWithManifest(['git.diff_against_base'], diffCtx);
+        gitDiff = content;
+        if (gitDiffManifestSink)
+            gitDiffManifestSink.push(...manifest);
+    }
+    catch (err) {
+        console.debug(`[focus-executor] Resume-delta diff assembly failed (non-fatal):`, err.message);
+    }
+    const messageToSend = buildResumeDeltaMessage({
+        lineage: spawnSpec.lineage,
+        focusName,
+        gitDiff,
+        priorFindings,
+        ...(reviewCoverage ? { reviewCoverage } : {}),
+    }) + answersSuffix;
+    console.log(`[focus-executor] Resuming Claude session ${resumeId} for "${focusName}" ` +
+        `-- sending incremental delta (lineage ${spawnSpec.lineage}, ${messageToSend.length} chars, ` +
+        `${priorFindings.length} prior finding(s))`);
+    return messageToSend;
+}
+/**
+ * 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 function resolveScopingSpawnResume(args) {
+    const { readOnly, deliveries, issues, resumeId } = args;
+    if (readOnly)
+        return { resumeId, isScopingSpawn: false };
+    const isScopingSpawn = findQueuedDeliveriesWithoutTaskIssues(deliveries, issues).length > 0;
+    return {
+        resumeId: isScopingSpawn ? null : resumeId,
+        isScopingSpawn,
+    };
+}
+export function findQueuedDeliveriesWithoutTaskIssues(deliveries, issues) {
+    const taskIssueCounts = new Map();
+    for (const issue of issues) {
+        if (issue.issueType !== 'Task' && issue.issueType !== 'Bug')
+            continue;
+        taskIssueCounts.set(issue.deliveryId, (taskIssueCounts.get(issue.deliveryId) ?? 0) + 1);
+    }
+    return deliveries.filter(delivery => (delivery.executionStatus ?? '') === 'queued' &&
+        (taskIssueCounts.get(delivery.id) ?? 0) === 0);
+}
+export function buildQueuedDeliveryScopingMessage(args) {
+    const deliverySections = args.deliveries
+        .slice()
+        .sort((a, b) => a.priorityRank - b.priorityRank)
+        .map((delivery, index) => [
+        `### ${index + 1}. ${delivery.name}`,
+        `- Delivery ID: ${delivery.id}`,
+        `- Priority rank: ${delivery.priorityRank}`,
+        '',
+        '**Description**',
+        delivery.description?.trim() || '(none)',
+        '',
+        '**Acceptance Criteria**',
+        delivery.acceptanceCriteria?.trim() || '(none)',
+        '',
+        '**Technical Context**',
+        delivery.techContext?.trim() || '(none)',
+    ].join('\n'))
+        .join('\n\n');
+    return [
+        `# Scoping Required for Newly Queued Deliveries`,
+        '',
+        `You are the team lead for lineage "${args.lineage}" on focus "${args.focusName}". This is a FRESH scoping turn (not an incremental coding-resume): the role framework above is your operating contract for it.`,
+        '',
+        `The focus has queued deliveries with zero Task/Bug issues. Decompose each delivery below into Task/Bug issues before doing code work. For each delivery, create agent-satisfiable issues from its acceptance criteria, then move at least one Task/Bug issue to In Progress. The daemon advances the delivery queued -> coding (single-writer reconciler) the moment a work issue is In Progress.`,
+        '',
+        `Do not acknowledge and stop after reading this message. The required output of this turn is scoped issues on every listed delivery, with issue statuses kept current via Telora.`,
+        '',
+        deliverySections,
+    ].join('\n');
+}
+//# sourceMappingURL=prompt-assembly.js.map

package/dist/spawn/prompt-assembly.js.map

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

package/dist/spawn/shared.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Shared spawn-path types used by BOTH focus-executor.ts and the extracted
+ * spawn/ seams (prompt-assembly.ts).
+ *
+ * Lives here to break the import cycle: a type referenced by an extracted seam
+ * AND by code that remains in focus-executor.ts cannot be defined in
+ * focus-executor.ts (that would force a back-edge import from the seam to
+ * '../focus-executor.js'), so it is hoisted here where both sides import it
+ * without a cycle.
+ *
+ * Cycle rule: this module must NOT import from '../focus-executor.js'.
+ */
+import type { getFocusDeliveries, getFocusIssues, getProductDeploymentProfileSnapshot } from '../queries/focuses.js';
+import type { AssemblyManifestEntry } from '../assembly-engine.js';
+import type { SessionContinuity } from '../session-lineage.js';
+/**
+ * Phase 1 contract: everything the spawn needs that comes from the DB / assembly
+ * layer, fetched up front. `assemblyManifest` is the live accumulator the later
+ * phases keep appending to (directive assembly, etc.) before it is persisted.
+ */
+export interface SpawnContext {
+    deliveries: Awaited<ReturnType<typeof getFocusDeliveries>>;
+    issues: Awaited<ReturnType<typeof getFocusIssues>>;
+    deploymentProfileSnapshot: Awaited<ReturnType<typeof getProductDeploymentProfileSnapshot>> | null;
+    /**
+     * The answered-directed-escalation section rendered first-class + the ids it
+     * delivers. Delivered on EVERY message shape (directive prompt, resume delta,
+     * scoping) and stamped consumed only AFTER the message is dispatched -- decoupled
+     * from resolution so answered intent is never lost on a path that drops the
+     * loop-context recipe. See resolvers/escalation-answers.resolveAnsweredEscalations.
+     */
+    answeredEscalations: {
+        section: string;
+        ids: string[];
+    };
+    prdMilestoneContext: string;
+    /**
+     * Manifest for the PRD milestone context, kept SEPARATE from assemblyManifest
+     * because it is delivered only on the fresh-prompt shapes (buildSpawnPrompt
+     * appends it; the resume-delta / scoping messages drop it). Folded into the
+     * delivered manifest per shape by the spawn orchestrator.
+     */
+    prdMilestoneManifest: AssemblyManifestEntry[];
+    /**
+     * The directive / legacy-loop-context manifest accumulator. Entries are pushed
+     * ONLY on the paths that actually render them: directive-recipe entries on a
+     * fresh directive spawn (resolveDirectiveOrFallback skips assembly otherwise),
+     * loop-context entries on the legacy path (resolveLegacyLoopContext). Empty on
+     * resume-delta / scoping spawns -- so it already tracks delivered sources for
+     * those two families.
+     */
+    assemblyManifest: AssemblyManifestEntry[];
+}
+/**
+ * Phase A contract: the resolved directive body + the spawn metadata derived
+ * with it, BEFORE the prompt is built. Covers all three paths -- pending
+ * directive, current-stage directive, legacy fallback -- in one typed result.
+ *
+ * Hoisted here to break the import cycle: referenced by both the worktree-session
+ * seam (resolveEngineForPass consumes spawnDirectiveDeclared) AND by code that
+ * remains in focus-executor.ts (resolveDirectiveOrFallback returns it), so it
+ * cannot live in either without a back-edge.
+ */
+export interface DirectiveResolution {
+    /** Directive content appended after the role framework; null => legacy prompt. */
+    directiveBody: string | null;
+    /** Directive-declared model (legacy fallback only; filtered downstream). */
+    directiveModel: string | null;
+    /**
+     * Workflow stage directive engine + local-model for this spawn (the Workflow
+     * layer of Focus > Workflow > Default on those two axes), or null. Threaded
+     * into resolveEngineForPass (engine) and resolveSpawnModel (local model) so all
+     * three axes inherit the stage directive when the focus does not override.
+     */
+    directiveEngine: string | null;
+    directiveLocalModel: string | null;
+    /**
+     * Focus model override captured when a pending spawn directive (respawn) was
+     * stored, or null. Threaded into resolveSpawnModel so respawn resolves the
+     * team model under the SAME precedence as initial spawn (focus override ->
+     * stage -> CLI). Null when this spawn did not come from a pending directive
+     * (initial spawn / stage-directive path), where the live pipeline_config.model
+     * already carries the override.
+     */
+    pendingFocusOverrideModel: string | null;
+    /** Workflow stage active at spawn -- stamped as the .stage telemetry lever. */
+    spawnStageName: string | null;
+    /** Lineage + continuity declared by whatever fired this spawn (resolved later). */
+    spawnDirectiveDeclared: {
+        lineage?: string | null;
+        continuity?: SessionContinuity | null;
+    } | null;
+    /** True => no usable directive; build the legacy full focus prompt. */
+    useLegacyFullPrompt: boolean;
+}
+//# sourceMappingURL=shared.d.ts.map

package/dist/spawn/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/spawn/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,mCAAmC,EACpC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC;IAC3D,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC;IACnD,yBAAyB,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,mCAAmC,CAAC,CAAC,GAAG,IAAI,CAAC;IAClG;;;;;;OAMG;IACH,mBAAmB,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACxD,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,oBAAoB,EAAE,qBAAqB,EAAE,CAAC;IAC9C;;;;;;;OAOG;IACH,gBAAgB,EAAE,qBAAqB,EAAE,CAAC;CAC3C;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,mBAAmB;IAClC,kFAAkF;IAClF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,4EAA4E;IAC5E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;;;OAKG;IACH,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC;;;;;;;OAOG;IACH,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,+EAA+E;IAC/E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,mFAAmF;IACnF,sBAAsB,EAClB;QAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAA;KAAE,GAClE,IAAI,CAAC;IACT,uEAAuE;IACvE,mBAAmB,EAAE,OAAO,CAAC;CAC9B"}

package/dist/spawn/shared.js

@@ -0,0 +1,14 @@
+/**
+ * Shared spawn-path types used by BOTH focus-executor.ts and the extracted
+ * spawn/ seams (prompt-assembly.ts).
+ *
+ * Lives here to break the import cycle: a type referenced by an extracted seam
+ * AND by code that remains in focus-executor.ts cannot be defined in
+ * focus-executor.ts (that would force a back-edge import from the seam to
+ * '../focus-executor.js'), so it is hoisted here where both sides import it
+ * without a cycle.
+ *
+ * Cycle rule: this module must NOT import from '../focus-executor.js'.
+ */
+export {};
+//# sourceMappingURL=shared.js.map

package/dist/spawn/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/spawn/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/spawn/spawn-decision.d.ts

@@ -0,0 +1,239 @@
+/**
+ * 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 type { DaemonConfig, AgentRole, FocusTeamState, PipelineConfig } from '../types.js';
+import { getFocusDeliveries, getFocusIssues } from '../queries/focuses.js';
+import { consumePendingSpawnDirective } from '../directive-executor.js';
+import { type AssemblyManifestEntry } from '../assembly-engine.js';
+import { type EngineOverride } from '../backends/index.js';
+import type { SessionContinuity } from '../session-lineage.js';
+import type { SpawnContext, DirectiveResolution } from './shared.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 declare const DEFAULT_LOOP_CONTEXT_RECIPE: string[];
+/**
+ * Result of the pre-spawn guard. Discriminated union so the caller can
+ * distinguish between "no work yet, spawn a planning team" and "actionable
+ * deliveries are queued, run them" without conflating null with empty.
+ */
+export type SpawnDecision = {
+    kind: 'planning';
+} | {
+    kind: 'execute';
+    deliveries: Awaited<ReturnType<typeof getFocusDeliveries>>;
+} | {
+    kind: 'skip';
+};
+/**
+ * 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 declare function findActionableDeliveries(deliveries: Awaited<ReturnType<typeof getFocusDeliveries>>, focusName: string): SpawnDecision;
+export interface SpawnFocusTeamParams {
+    config: DaemonConfig;
+    focusId: string;
+    focusName: string;
+    role: AgentRole;
+    pipelineConfig: PipelineConfig | null;
+    readOnly?: boolean;
+    /** Previous Claude Code session ID for --resume support (legacy single slot). */
+    lastClaudeSessionId?: string | null;
+    /**
+     * Per-lineage session-id map from the focus (INJ-A). The spawn resolves its
+     * resume id from the slot matching the lineage being spawned, so a coding
+     * spawn never reads a slot a review spawn wrote.
+     */
+    claudeSessionIds?: Record<string, string> | null;
+    /**
+     * Per-focus engine override (per-pass map {coding, review}); null/absent =
+     * inherit the org default. Fed into resolveBackend() (D3).
+     */
+    engineOverride?: EngineOverride | null;
+    /**
+     * Per-focus selected local model (per-pass map {coding?, review?} of
+     * local_models ids); null/absent = no specific local model selected. When the
+     * resolved engine for a pass is codex and this carries a ref for that pass,
+     * the daemon resolves the ref to coordinates and routes the spawn to that
+     * model's endpoint (D3).
+     */
+    localModelOverride?: Record<string, string | null> | null;
+    /** Org-level default engine id; null/absent = the global default ('claude'). */
+    orgDefaultEngine?: string | null;
+    /**
+     * Force a spawn even when findActionableDeliveries would return 'skip' (all
+     * deliveries verify/done). Set for the escalation answer re-arm path: the
+     * spawn's purpose is to consume a pending answer (delivered by the
+     * escalation.answers resolver in the standard recipe), not to advance a
+     * delivery -- so an idle/exited focus must still spawn. Mirrors the
+     * pending-spawn-directive bypass, which likewise spawns past a 'skip'.
+     */
+    forceSpawn?: boolean;
+}
+/**
+ * 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 declare function fetchSpawnContext(config: DaemonConfig, focusId: string, focusName: string): Promise<SpawnContext | null>;
+/**
+ * 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 declare function resolveLegacyLoopContext(config: DaemonConfig, focusId: string): Promise<{
+    content: string;
+    manifest: AssemblyManifestEntry[];
+}>;
+/**
+ * Phase 2 contract: the actionable-delivery decision. 'skip' tells the caller to
+ * tear down (activeTeams.delete + return); 'proceed' carries the consumed
+ * pending directive (used downstream in Phase A + spawn-phase tagging), the
+ * collected actionable deliveries, and the planning-spawn flag.
+ */
+export type ActionableResolution = {
+    kind: 'skip';
+} | {
+    kind: 'proceed';
+    pendingDirective: ReturnType<typeof consumePendingSpawnDirective>;
+    actionableDeliveries: Awaited<ReturnType<typeof getFocusDeliveries>>;
+    isPlanningSpawn: boolean;
+};
+/**
+ * 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 declare function resolveActionableDeliveries(args: {
+    focusId: string;
+    focusName: string;
+    deliveries: Awaited<ReturnType<typeof getFocusDeliveries>>;
+    issues: Awaited<ReturnType<typeof getFocusIssues>>;
+    forceSpawn: boolean;
+    teamState: FocusTeamState;
+}): ActionableResolution;
+/**
+ * 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 declare function willSendDirectiveBody(args: {
+    declared: {
+        lineage?: string | null;
+        continuity?: SessionContinuity | null;
+    } | null;
+    stageName: string | null;
+    claudeSessionIds: Record<string, string> | null | undefined;
+    deliveries: Awaited<ReturnType<typeof getFocusDeliveries>>;
+    issues: Awaited<ReturnType<typeof getFocusIssues>>;
+    readOnly: boolean;
+}): boolean;
+export declare function resolveDirectiveOrFallback(args: {
+    config: DaemonConfig;
+    focusId: string;
+    focusName: string;
+    worktreePath: string;
+    pendingDirective: ReturnType<typeof consumePendingSpawnDirective>;
+    assemblyManifest: AssemblyManifestEntry[];
+    /**
+     * The focus's per-lineage session map, deliveries, issues, and read-only flag
+     * -- used ONLY to decide whether the current-stage directive body will actually
+     * be sent (INJ-D). On a resume-delta or forced-fresh scoping spawn the composed
+     * directive body is discarded (buildSpawnMessage sends the delta / scoping
+     * message), so its expensive assembly recipe (focus.context, wiki.search,
+     * git.diff, ...) is skipped -- directive METADATA (model/engine/localModel/
+     * lineage/stage) is still resolved. Absent map/deliveries => treat as a fresh
+     * spawn (assemble), preserving prior behavior.
+     */
+    claudeSessionIds?: Record<string, string> | null;
+    deliveries: Awaited<ReturnType<typeof getFocusDeliveries>>;
+    issues: Awaited<ReturnType<typeof getFocusIssues>>;
+    readOnly: boolean;
+}): Promise<DirectiveResolution>;
+//# sourceMappingURL=spawn-decision.d.ts.map

package/dist/spawn/spawn-decision.d.ts.map

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