@lumenflow/core 3.1.3 → 3.2.1

package/dist/spawn-strategy.js

@@ -0,0 +1,112 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { existsSync } from 'node:fs';
+/**
+ * Base class with shared preamble logic
+ */
+class BaseSpawnStrategy {
+    getCorePreamble(wuId) {
+        return `Load the following context in this order:
+
+1. Read LUMENFLOW.md (workflow fundamentals and critical rules)
+2. Read .lumenflow/constraints.md (non-negotiable constraints)
+3. Read README.md (project structure and tech stack)
+4. Read docs/04-operations/_frameworks/lumenflow/lumenflow-complete.md sections 1-7 (TDD, gates, Definition of Done)
+5. Read docs/04-operations/tasks/wu/${wuId}.yaml (the specific WU you're working on)
+6. Read docs/04-operations/_frameworks/lumenflow/agent/onboarding/quick-ref-commands.md (CLI tooling reference - USE THESE COMMANDS)`;
+    }
+    /**
+     * Default skill loading instruction - shared by GenericStrategy and GeminiCliStrategy
+     * ClaudeCodeStrategy overrides this with Claude-specific paths
+     */
+    getSkillLoadingInstruction() {
+        return `## Skills Selection
+
+1. Check \`.lumenflow/agents\` for available skills.
+2. Select relevant skills for this task.`;
+    }
+}
+/**
+ * Strategy for Claude Code (Local/Terminal)
+ */
+export class ClaudeCodeStrategy extends BaseSpawnStrategy {
+    getPreamble(wuId) {
+        let preamble = this.getCorePreamble(wuId);
+        // Vendor overlay
+        if (existsSync('.claude/CLAUDE.md')) {
+            // Insert after LUMENFLOW.md if possible, or just append/prepend
+            // For simplicity and clarity, we'll prepend the vendor specific instructions
+            // relying on the user to follow the specific order if stated.
+            // Actually, checking original behavior: CLAUDE.md was #1.
+            // But new plan says LUMENFLOW.md is core.
+            // We will append it as an overlay step.
+            preamble += `\n7. Read .claude/CLAUDE.md (Claude-specific workflow overlay)`;
+        }
+        return preamble;
+    }
+    getSkillLoadingInstruction() {
+        return `## Skills Selection
+    
+1. Check \`.lumenflow/agents\` for available skills.
+2. Check \`.claude/agents\` for Claude-specific overrides or additions.
+3. Select relevant skills for this task.`;
+    }
+}
+/**
+ * Strategy for Gemini CLI (Multimodal/Ecosystem)
+ * Uses default getSkillLoadingInstruction from base class
+ */
+export class GeminiCliStrategy extends BaseSpawnStrategy {
+    getPreamble(wuId) {
+        let preamble = this.getCorePreamble(wuId);
+        if (existsSync('GEMINI.md')) {
+            preamble += `\n7. Read GEMINI.md (Gemini-specific workflow overlay)`;
+        }
+        return preamble;
+    }
+}
+/**
+ * Generic Strategy (Unknown/Other clients)
+ * Uses default getSkillLoadingInstruction from base class
+ */
+export class GenericStrategy extends BaseSpawnStrategy {
+    getPreamble(wuId) {
+        return this.getCorePreamble(wuId);
+    }
+}
+/**
+ * Create a strategy for the given client
+ * @param clientName - Client name (e.g. 'claude-code', 'codex-cli', 'gemini-cli')
+ */
+export function createSpawnStrategy(clientName) {
+    switch (clientName.toLowerCase()) {
+        case 'claude': // Legacy alias
+        case 'claude-code':
+            return new ClaudeCodeStrategy();
+        case 'gemini': // Alias
+        case 'gemini-cli':
+            return new GeminiCliStrategy();
+        case 'codex': // Deprecated alias
+        case 'codex-cli':
+            // Codex might need its own strategy later (sandbox), but for now generic or claude-like?
+            // Plan says: "codex: preamble: false, strategy: cloud-sandbox" -> implies Generic or dedicated.
+            // For now, let's map to Generic but maybe we should add CodexStrategy if it has diff behavior.
+            // Re-reading plan: "CodexStrategy: Emphasizes cloud sandbox constraints"
+            // But for this "Minimal" pass, let's stick to Generic with a comment,
+            // OR essentially treat it as Generic since we don't have constraints logic here yet (it's in wu-spawn).
+            // Actually, let's return GenericStrategy but we might handle constraints elsewhere.
+            return new GenericStrategy();
+        default:
+            // Warn? The factory just creates. The caller should warn if it fell back.
+            // But here we just return Generic.
+            return new GenericStrategy();
+    }
+}
+/**
+ * Factory for creating strategies (legacy wrapper)
+ * @deprecated Use createSpawnStrategy function directly
+ */
+export const SpawnStrategyFactory = {
+    create: createSpawnStrategy,
+};
+//# sourceMappingURL=spawn-strategy.js.map

package/dist/spawn-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-strategy.js","sourceRoot":"","sources":["../src/spawn-strategy.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAiBrC;;GAEG;AACH,MAAe,iBAAiB;IACpB,eAAe,CAAC,IAAY;QACpC,OAAO;;;;;;sCAM2B,IAAI;qIAC2F,CAAC;IACpI,CAAC;IAID;;;OAGG;IACH,0BAA0B;QACxB,OAAO;;;yCAG8B,CAAC;IACxC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,iBAAiB;IACvD,WAAW,CAAC,IAAY;QACtB,IAAI,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAE1C,iBAAiB;QACjB,IAAI,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACpC,gEAAgE;YAChE,6EAA6E;YAC7E,8DAA8D;YAC9D,0DAA0D;YAC1D,0CAA0C;YAC1C,wCAAwC;YACxC,QAAQ,IAAI,gEAAgE,CAAC;QAC/E,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,0BAA0B;QACxB,OAAO;;;;yCAI8B,CAAC;IACxC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,iBAAkB,SAAQ,iBAAiB;IACtD,WAAW,CAAC,IAAY;QACtB,IAAI,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAE1C,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,QAAQ,IAAI,wDAAwD,CAAC;QACvE,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,iBAAiB;IACpD,WAAW,CAAC,IAAY;QACtB,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,QAAQ,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC;QACjC,KAAK,QAAQ,CAAC,CAAC,eAAe;QAC9B,KAAK,aAAa;YAChB,OAAO,IAAI,kBAAkB,EAAE,CAAC;QAElC,KAAK,QAAQ,CAAC,CAAC,QAAQ;QACvB,KAAK,YAAY;YACf,OAAO,IAAI,iBAAiB,EAAE,CAAC;QAEjC,KAAK,OAAO,CAAC,CAAC,mBAAmB;QACjC,KAAK,WAAW;YACd,yFAAyF;YACzF,gGAAgG;YAChG,+FAA+F;YAC/F,yEAAyE;YACzE,sEAAsE;YACtE,wGAAwG;YACxG,oFAAoF;YACpF,OAAO,IAAI,eAAe,EAAE,CAAC;QAE/B;YACE,0EAA0E;YAC1E,mCAAmC;YACnC,OAAO,IAAI,eAAe,EAAE,CAAC;IACjC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,MAAM,EAAE,mBAAmB;CAC5B,CAAC"}

package/dist/spawn-task-builder.d.ts

@@ -0,0 +1,68 @@
+import type { LumenFlowConfig } from './lumenflow-config-schema.js';
+import type { SpawnStrategy } from './spawn-strategy.js';
+import { type WUDoc } from './spawn-agent-guidance.js';
+import { type ClientContext } from './spawn-prompt-helpers.js';
+import { type LockMetadata } from './lane-lock.js';
+/**
+ * Options for lane occupation warning
+ */
+interface LaneOccupationWarningOptions {
+    /** Whether the lock is stale (>24h old) */
+    isStale?: boolean;
+}
+/**
+ * Options for spawn generation
+ */
+export interface SpawnOptions {
+    thinking?: boolean;
+    noThinking?: boolean;
+    budget?: string;
+    client?: ClientContext;
+    config?: LumenFlowConfig;
+    /** WU-1240: Base directory for memory context loading */
+    baseDir?: string;
+    /** WU-1240: Include memory context section (default: false for backward compat) */
+    includeMemoryContext?: boolean;
+    /** WU-1240: Skip memory context even if includeMemoryContext is true */
+    noContext?: boolean;
+    /** WU-1240: Memory context content (pre-generated, for async integration) */
+    memoryContextContent?: string;
+}
+/**
+ * Generate the complete Task tool invocation
+ *
+ * @param {object} doc - WU YAML document
+ * @param {string} id - WU ID
+ * @param {SpawnStrategy} strategy - Client strategy
+ * @param {object} [options={}] - Thinking mode options
+ * @returns {string} Complete Task tool invocation
+ */
+export declare function generateTaskInvocation(doc: WUDoc, id: string, strategy: SpawnStrategy, options?: SpawnOptions): string;
+/**
+ * Generate Codex-specific prompt output
+ *
+ * @param {object} doc - WU YAML document
+ * @param {string} id - WU ID
+ * @param {SpawnStrategy} strategy - Client strategy
+ * @param {SpawnOptions} options - Options
+ * @returns {string} Complete Codex prompt
+ */
+export declare function generateCodexPrompt(doc: WUDoc, id: string, strategy: SpawnStrategy, options?: SpawnOptions): string;
+/**
+ * WU-1603: Check if a lane is currently occupied by another WU
+ *
+ * @param {string} lane - Lane name (e.g., "Operations: Tooling")
+ * @returns {import('./lane-lock.js').LockMetadata|null} Lock metadata if occupied, null otherwise
+ */
+export declare function checkLaneOccupation(lane: string): LockMetadata | null;
+/**
+ * WU-1603: Generate a warning message when lane is occupied
+ *
+ * @param {import('./lane-lock.js').LockMetadata} lockMetadata - Lock metadata
+ * @param {string} targetWuId - WU ID being spawned
+ * @param {LaneOccupationWarningOptions} [options={}] - Options
+ * @returns {string} Warning message
+ */
+export declare function generateLaneOccupationWarning(lockMetadata: LockMetadata, targetWuId: string, options?: LaneOccupationWarningOptions): string;
+export {};
+//# sourceMappingURL=spawn-task-builder.d.ts.map

package/dist/spawn-task-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-task-builder.d.ts","sourceRoot":"","sources":["../src/spawn-task-builder.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAWzD,OAAO,EACL,KAAK,KAAK,EAaX,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,KAAK,aAAa,EAQnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAMlE;;GAEG;AACH,UAAU,4BAA4B;IACpC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAMD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,KAAK,EACV,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE,YAAiB,GACzB,MAAM,CAwMR;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,KAAK,EACV,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE,YAAiB,GACzB,MAAM,CAuGR;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAMrE;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,4BAAiC,GACzC,MAAM,CAiBR"}

package/dist/spawn-task-builder.js

@@ -0,0 +1,356 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file spawn-task-builder.ts
+ * WU-2012: Extracted from wu-spawn.ts
+ *
+ * Assembles complete spawn prompts (Task invocations and Codex prompts)
+ * from the guidance, constraints, and template sections.
+ *
+ * Also contains lane occupation checking (checkLaneOccupation,
+ * generateLaneOccupationWarning).
+ *
+ * Single responsibility: Orchestrate the assembly of spawn prompt sections
+ * into complete Task tool invocations or Codex-friendly markdown prompts.
+ *
+ * @module spawn-task-builder
+ */
+import { getConfig } from './lumenflow-config.js';
+import { resolvePolicy } from './resolve-policy.js';
+import { classifyWork } from './work-classifier.js';
+import { generateExecutionModeSection, generateThinkToolGuidance } from './wu-spawn-helpers.js';
+import { generateClientSkillsGuidance, generateSkillsSelectionSection } from './wu-spawn-skills.js';
+import { TRUNCATION_WARNING_BANNER } from './spawn-template-assembler.js';
+import { generatePolicyBasedTestGuidance, generateDesignContextSection, generateMandatoryStandards, generateEnforcementSummary, } from './spawn-guidance-generators.js';
+import { generateConstraints, generateCodexConstraints } from './spawn-constraints-generator.js';
+import { generateEffortScalingRules, generateParallelToolCallGuidance, generateIterativeSearchHeuristics, generateTokenBudgetAwareness, generateCompletionFormat, generateAgentCoordinationSection, generateQuickFixCommands, generateLaneSelectionSection, generateWorktreePathGuidance, generateBugDiscoverySection, generateLaneGuidance, generateActionSection, } from './spawn-agent-guidance.js';
+import { formatAcceptance, generateImplementationContext, detectMandatoryAgents, generateMandatoryAgentSection, generatePreamble, generateClientBlocksSection, generateInvariantsPriorArtSection, } from './spawn-prompt-helpers.js';
+import { checkLaneLock } from './lane-lock.js';
+// ============================================================================
+// Exported Functions
+// ============================================================================
+/**
+ * Generate the complete Task tool invocation
+ *
+ * @param {object} doc - WU YAML document
+ * @param {string} id - WU ID
+ * @param {SpawnStrategy} strategy - Client strategy
+ * @param {object} [options={}] - Thinking mode options
+ * @returns {string} Complete Task tool invocation
+ */
+export function generateTaskInvocation(doc, id, strategy, options = {}) {
+    const codePaths = doc.code_paths || [];
+    const mandatoryAgents = detectMandatoryAgents(codePaths);
+    const preamble = generatePreamble(id, strategy);
+    const clientContext = options.client;
+    const config = options.config || getConfig();
+    // WU-1279: Resolve policy and use policy-based test guidance
+    const policy = resolvePolicy(config);
+    // WU-1900: Run work classifier for domain-aware prompt generation
+    const classificationConfig = config?.methodology?.work_classification;
+    const classification = classifyWork({
+        code_paths: doc.code_paths,
+        lane: doc.lane,
+        type: doc.type,
+        description: doc.description,
+    }, classificationConfig);
+    // WU-1900: Pass classifier hint to test guidance
+    const testGuidance = generatePolicyBasedTestGuidance(doc.type || 'feature', policy, {
+        testMethodologyHint: classification.testMethodologyHint,
+    });
+    // WU-1279: Generate enforcement summary from resolved policy
+    const enforcementSummary = generateEnforcementSummary(policy);
+    // WU-1279: Generate mandatory standards based on resolved policy
+    const mandatoryStandards = generateMandatoryStandards(policy);
+    const clientSkillsGuidance = generateClientSkillsGuidance(clientContext);
+    const skillsSection = generateSkillsSelectionSection(doc, config, clientContext?.name) +
+        (clientSkillsGuidance ? `\n${clientSkillsGuidance}` : '');
+    const clientBlocks = generateClientBlocksSection(clientContext);
+    const mandatorySection = generateMandatoryAgentSection(mandatoryAgents, id);
+    const laneGuidance = generateLaneGuidance(doc.lane);
+    const bugDiscoverySection = generateBugDiscoverySection(id);
+    // WU-1900: Generate constraints with conditional TDD CHECKPOINT
+    const shouldIncludeTddCheckpoint = classification.domain !== 'ui' && policy.testing !== 'none';
+    const constraints = generateConstraints(id, {
+        includeTddCheckpoint: shouldIncludeTddCheckpoint,
+    });
+    // WU-1900: Generate design context section for UI-classified work
+    const designContextSection = generateDesignContextSection(classification);
+    const implementationContext = generateImplementationContext(doc);
+    // WU-2252: Generate invariants/prior-art section for code_paths
+    const invariantsPriorArt = generateInvariantsPriorArtSection(codePaths);
+    // WU-1986: Anthropic multi-agent best practices sections
+    const effortScaling = generateEffortScalingRules();
+    const parallelToolCalls = generateParallelToolCallGuidance();
+    const searchHeuristics = generateIterativeSearchHeuristics();
+    const tokenBudget = generateTokenBudgetAwareness(id);
+    const completionFormat = generateCompletionFormat(id);
+    // WU-1987: Agent coordination and quick fix sections
+    const agentCoordination = generateAgentCoordinationSection(id);
+    const quickFix = generateQuickFixCommands();
+    // WU-2107: Lane selection guidance
+    const laneSelection = generateLaneSelectionSection();
+    // WU-2362: Worktree path guidance for sub-agents
+    const worktreeGuidance = generateWorktreePathGuidance(doc.worktree_path);
+    // WU-1240: Memory context section
+    const shouldIncludeMemoryContext = options.includeMemoryContext && !options.noContext;
+    const memoryContextSection = shouldIncludeMemoryContext ? options.memoryContextContent || '' : '';
+    // Generate thinking mode sections if applicable
+    const executionModeSection = generateExecutionModeSection(options);
+    const thinkToolGuidance = generateThinkToolGuidance(options);
+    // Build optional sections string
+    const thinkingSections = [executionModeSection, thinkToolGuidance]
+        .filter((section) => section.length > 0)
+        .join('\n\n---\n\n');
+    const thinkingBlock = thinkingSections ? `${thinkingSections}\n\n---\n\n` : '';
+    // Build the task prompt
+    // WU-1192: Truncation warning at start, test guidance after </task> per "Lost in the Middle" research
+    const taskPrompt = `${TRUNCATION_WARNING_BANNER}<task>
+${preamble}
+</task>
+
+---
+
+${testGuidance}
+
+---
+
+# ${id}: ${doc.title || 'Untitled'}
+
+## WU Details
+
+- **ID:** ${id}
+- **Lane:** ${doc.lane || 'Unknown'}
+- **Type:** ${doc.type || 'feature'}
+- **Status:** ${doc.status || 'unknown'}
+- **Worktree:** ${doc.worktree_path || `worktrees/<lane>-${id.toLowerCase()}`}
+
+## Description
+
+${doc.description || 'No description provided.'}
+
+## Acceptance Criteria
+
+${formatAcceptance(doc.acceptance)}
+
+## Code Paths
+
+${codePaths.length > 0 ? codePaths.map((p) => `- ${p}`).join('\n') : '- No code paths defined'}
+${mandatorySection}${invariantsPriorArt ? `---\n\n${invariantsPriorArt}\n\n` : ''}${implementationContext ? `---\n\n${implementationContext}\n\n` : ''}---
+
+${thinkingBlock}${skillsSection}
+${memoryContextSection ? `---\n\n${memoryContextSection}\n\n` : ''}---
+
+${mandatoryStandards}
+
+---
+
+${enforcementSummary}
+
+${designContextSection ? `---\n\n${designContextSection}\n\n` : ''}${clientBlocks ? `---\n\n${clientBlocks}\n\n` : ''}${worktreeGuidance ? `---\n\n${worktreeGuidance}\n\n` : ''}---
+
+${bugDiscoverySection}
+
+---
+
+${effortScaling}
+
+---
+
+${parallelToolCalls}
+
+---
+
+${searchHeuristics}
+
+---
+
+${tokenBudget}
+
+---
+
+${completionFormat}
+
+---
+
+${agentCoordination}
+
+---
+
+${quickFix}
+
+---
+
+${laneSelection}
+
+---
+
+${laneGuidance}${laneGuidance ? '\n\n---\n\n' : ''}## Action
+
+${generateActionSection(doc, id)}
+
+${constraints}`;
+    // Escape special characters for XML output
+    const escapedPrompt = taskPrompt
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+    // Build the Task tool invocation block using antml format
+    // Using array join to avoid XML parsing issues
+    const openTag = '<' + 'antml:invoke name="Task">';
+    const closeTag = '</' + 'antml:invoke>';
+    const paramOpen = '<' + 'antml:parameter name="';
+    const paramClose = '</' + 'antml:parameter>';
+    const invocation = [
+        '<' + 'antml:function_calls>',
+        openTag,
+        `${paramOpen}subagent_type">general-purpose${paramClose}`,
+        `${paramOpen}description">Execute ${id}${paramClose}`,
+        `${paramOpen}prompt">${escapedPrompt}${paramClose}`,
+        closeTag,
+        '</' + 'antml:function_calls>',
+    ].join('\n');
+    return invocation;
+}
+/**
+ * Generate Codex-specific prompt output
+ *
+ * @param {object} doc - WU YAML document
+ * @param {string} id - WU ID
+ * @param {SpawnStrategy} strategy - Client strategy
+ * @param {SpawnOptions} options - Options
+ * @returns {string} Complete Codex prompt
+ */
+export function generateCodexPrompt(doc, id, strategy, options = {}) {
+    const codePaths = doc.code_paths || [];
+    const mandatoryAgents = detectMandatoryAgents(codePaths);
+    const preamble = generatePreamble(id, strategy);
+    const mandatorySection = generateMandatoryAgentSection(mandatoryAgents, id);
+    const laneGuidance = generateLaneGuidance(doc.lane);
+    const bugDiscoverySection = generateBugDiscoverySection(id);
+    const implementationContext = generateImplementationContext(doc);
+    const action = generateActionSection(doc, id);
+    const constraints = generateCodexConstraints(id);
+    const clientContext = options.client;
+    const config = options.config || getConfig();
+    const clientSkillsGuidance = generateClientSkillsGuidance(clientContext);
+    const skillsSection = generateSkillsSelectionSection(doc, config, clientContext?.name) +
+        (clientSkillsGuidance ? `\n${clientSkillsGuidance}` : '');
+    const clientBlocks = generateClientBlocksSection(clientContext);
+    // WU-1290: Resolve policy and use policy-based test guidance
+    const policy = resolvePolicy(config);
+    const testGuidance = generatePolicyBasedTestGuidance(doc.type || 'feature', policy);
+    // WU-1290: Generate enforcement summary from resolved policy
+    const enforcementSummary = generateEnforcementSummary(policy);
+    // WU-1290: Generate mandatory standards based on resolved policy
+    const mandatoryStandards = generateMandatoryStandards(policy);
+    const executionModeSection = generateExecutionModeSection(options);
+    const thinkToolGuidance = generateThinkToolGuidance(options);
+    const thinkingSections = [executionModeSection, thinkToolGuidance]
+        .filter((section) => section.length > 0)
+        .join('\n\n---\n\n');
+    const thinkingBlock = thinkingSections ? `${thinkingSections}\n\n---\n\n` : '';
+    return `# ${id}: ${doc.title || 'Untitled'}
+
+${testGuidance}
+
+---
+
+## Context
+
+${preamble}
+
+---
+
+## WU Details
+
+- **ID:** ${id}
+- **Lane:** ${doc.lane || 'Unknown'}
+- **Type:** ${doc.type || 'feature'}
+- **Status:** ${doc.status || 'unknown'}
+- **Worktree:** ${doc.worktree_path || `worktrees/<lane>-${id.toLowerCase()}`}
+
+## Description
+
+${doc.description || 'No description provided.'}
+
+## Scope (code_paths)
+
+Only change files within these paths:
+
+${codePaths.length > 0 ? codePaths.map((p) => `- ${p}`).join('\n') : '- No code paths defined'}
+
+## Acceptance Criteria
+
+${formatAcceptance(doc.acceptance)}
+
+---
+
+${mandatoryStandards}
+
+---
+
+${enforcementSummary}
+
+---
+
+${skillsSection}
+
+---
+
+## Action
+
+${action}
+
+---
+
+## Verification
+
+- Run in worktree: \`pnpm gates\`
+- From shared checkout: \`node packages/@lumenflow/agent/verification ${id}\`
+
+---
+
+${mandatorySection}${implementationContext ? `${implementationContext}\n\n---\n\n` : ''}${clientBlocks ? `${clientBlocks}\n\n---\n\n` : ''}${thinkingBlock}${bugDiscoverySection}
+
+---
+
+${laneGuidance}${laneGuidance ? '\n\n---\n\n' : ''}${constraints}
+`;
+}
+/**
+ * WU-1603: Check if a lane is currently occupied by another WU
+ *
+ * @param {string} lane - Lane name (e.g., "Operations: Tooling")
+ * @returns {import('./lane-lock.js').LockMetadata|null} Lock metadata if occupied, null otherwise
+ */
+export function checkLaneOccupation(lane) {
+    const lockStatus = checkLaneLock(lane);
+    if (lockStatus.locked && lockStatus.metadata) {
+        return lockStatus.metadata;
+    }
+    return null;
+}
+/**
+ * WU-1603: Generate a warning message when lane is occupied
+ *
+ * @param {import('./lane-lock.js').LockMetadata} lockMetadata - Lock metadata
+ * @param {string} targetWuId - WU ID being spawned
+ * @param {LaneOccupationWarningOptions} [options={}] - Options
+ * @returns {string} Warning message
+ */
+export function generateLaneOccupationWarning(lockMetadata, targetWuId, options = {}) {
+    const { isStale = false } = options;
+    let warning = `\u26a0\ufe0f  Lane "${lockMetadata.lane}" is occupied by ${lockMetadata.wuId}\n`;
+    warning += `   This violates WIP=1 (Work In Progress limit of 1 per lane).\n\n`;
+    if (isStale) {
+        warning += `   \u23f0 This lock is STALE (>24 hours old) - the WU may be abandoned.\n`;
+        warning += `   Consider using pnpm wu:block --id ${lockMetadata.wuId} if work is stalled.\n\n`;
+    }
+    warning += `   Options:\n`;
+    warning += `   1. Wait for ${lockMetadata.wuId} to complete or block\n`;
+    warning += `   2. Choose a different lane for ${targetWuId}\n`;
+    warning += `   3. Block ${lockMetadata.wuId} if work is stalled: pnpm wu:block --id ${lockMetadata.wuId}`;
+    return warning;
+}
+//# sourceMappingURL=spawn-task-builder.js.map

package/dist/spawn-task-builder.js.map

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

package/dist/spawn-template-assembler.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @file spawn-template-assembler.ts
+ * WU-2012: Extracted from wu-spawn.ts
+ *
+ * Template loading, assembly, and context building for spawn prompts.
+ *
+ * Single responsibility: Load templates from .lumenflow/templates/ and
+ * assemble them for spawn prompts, with graceful fallback to hardcoded sections.
+ *
+ * @module spawn-template-assembler
+ */
+import { type TemplateContext } from './template-loader.js';
+import type { ResolvedPolicy } from './resolve-policy.js';
+/**
+ * WU-1192: Truncation prevention constants (consolidated from CLI)
+ *
+ * These constants help detect when spawn output has been truncated during
+ * copy-paste operations or context loading. The warning banner alerts users
+ * to the truncation risk, and the end sentinel allows verification that
+ * the full output was received.
+ */
+export declare const TRUNCATION_WARNING_BANNER = "<!-- LUMENFLOW_TRUNCATION_WARNING -->\n<!--\n  \u26A0\uFE0F CRITICAL: DO NOT TRUNCATE THIS OUTPUT\n\n  This spawn prompt MUST be copied verbatim. Truncation causes:\n  - Missing constraints (agents ignore safety rules)\n  - Missing TDD directives (agents skip tests)\n  - Degraded agent performance\n\n  VERIFICATION: The output MUST end with: <!-- LUMENFLOW_SPAWN_END -->\n  If you don't see that sentinel at the end, the output was truncated.\n-->\n";
+export declare const SPAWN_END_SENTINEL = "<!-- LUMENFLOW_SPAWN_END -->";
+/**
+ * WU-1253/WU-1291: Try to assemble spawn prompt sections from templates.
+ *
+ * This function loads templates from .lumenflow/templates/ and assembles
+ * them according to the manifest order. Client-specific overrides are
+ * supported via templates.{client}/ directories.
+ *
+ * **Decision (WU-1291)**: Template system is ACTIVATED. This function is called
+ * by generateTaskInvocation() and generateCodexPrompt() to attempt template-based
+ * generation. If it returns null (templates missing, manifest invalid, or assembly
+ * fails), callers fall back to hardcoded generator functions.
+ *
+ * @param baseDir - Project root directory
+ * @param clientName - Client name for overrides (e.g., 'claude', 'cursor')
+ * @param context - Context for token replacement and condition evaluation
+ * @returns Assembled template content, or null if templates unavailable
+ */
+export declare function tryAssembleSpawnTemplates(baseDir: string, clientName: string, context: TemplateContext): string | null;
+/**
+ * Build template context from WU document.
+ *
+ * @param doc - WU YAML document
+ * @param id - WU ID
+ * @returns Context for template assembly
+ */
+export declare function buildTemplateContext(doc: Record<string, unknown>, id: string): TemplateContext;
+/**
+ * WU-1261: Build template context with resolved policy fields.
+ *
+ * Extends buildTemplateContext() with policy.testing and policy.architecture
+ * fields for template condition evaluation.
+ *
+ * @param doc - WU YAML document
+ * @param id - WU ID
+ * @param policy - Resolved policy from resolvePolicy()
+ * @returns Context for template assembly with policy fields
+ */
+export declare function buildTemplateContextWithPolicy(doc: Record<string, unknown>, id: string, policy: ResolvedPolicy): TemplateContext & {
+    'policy.testing': string;
+    'policy.architecture': string;
+};
+//# sourceMappingURL=spawn-template-assembler.d.ts.map

package/dist/spawn-template-assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-template-assembler.d.ts","sourceRoot":"","sources":["../src/spawn-template-assembler.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AAEH,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,wcAYrC,CAAC;AAEF,eAAO,MAAM,kBAAkB,iCAAiC,CAAC;AAEjE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,GACvB,MAAM,GAAG,IAAI,CAcf;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,eAAe,CAiB9F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,cAAc,GACrB,eAAe,GAAG;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,qBAAqB,EAAE,MAAM,CAAA;CAAE,CAQ/E"}