@lumenflow/core 3.1.3 → 3.2.1

package/dist/wu-spawn-helpers.js

@@ -0,0 +1,276 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file wu-spawn-helpers.ts
+ * Helper functions for wu:spawn thinking mode and model configuration (WU-1577)
+ *
+ * Provides:
+ * - CLI argument parsing for thinking mode options
+ * - Validation for thinking/budget options
+ * - Execution Mode section generation
+ * - Think tool guidance generation
+ * - Help text generation
+ * - Spawn registry integration (WU-1945)
+ */
+import { Command } from 'commander';
+import { DelegationRegistryStore } from './delegation-registry-store.js';
+import { ProcessExitError } from './error-handler.js';
+import { EXIT_CODES, LUMENFLOW_PATHS } from './wu-constants.js';
+/**
+ * Option definitions for thinking mode configuration.
+ *
+ * Note: Commander.js handles --no-thinking automatically as a negation of --thinking.
+ * When --no-thinking is used, opts.thinking is set to false.
+ * We detect this and convert to noThinking: true for clarity.
+ */
+export const THINKING_OPTIONS = {
+    thinking: {
+        name: 'thinking',
+        flags: '--thinking',
+        description: 'Enable extended thinking for complex WU execution',
+    },
+    budget: {
+        name: 'budget',
+        flags: '--budget <tokens>',
+        description: 'Token budget for extended thinking (requires --thinking)',
+    },
+};
+/**
+ * Parse spawn-specific arguments from argv.
+ *
+ * @param {string[]} argv - Process arguments
+ * @returns {object} Parsed arguments with thinking options
+ */
+export function parseSpawnArgs(argv) {
+    const program = new Command()
+        .name('wu-spawn')
+        .description('Generate Task tool invocation for sub-agent WU execution')
+        .allowUnknownOption(true)
+        .allowExcessArguments(true) // Allow positional WU ID argument
+        .exitOverride();
+    // Core options
+    program.option('-i, --id <wuId>', 'Work Unit ID (e.g., WU-123)');
+    // Thinking mode options
+    // Commander automatically creates --no-thinking when --thinking is registered
+    program.option(THINKING_OPTIONS.thinking.flags, THINKING_OPTIONS.thinking.description);
+    program.option(THINKING_OPTIONS.budget.flags, THINKING_OPTIONS.budget.description);
+    try {
+        program.parse(argv);
+    }
+    catch (err) {
+        if (err.code === 'commander.helpDisplayed' || err.code === 'commander.version') {
+            throw new ProcessExitError('Help displayed', EXIT_CODES.SUCCESS);
+        }
+        throw err;
+    }
+    const opts = program.opts();
+    // Handle positional argument as WU ID fallback
+    if (program.args.length > 0 && !opts.id) {
+        opts.id = program.args[0];
+    }
+    // Handle --no-thinking explicitly
+    // Check the argv array directly since Commander's handling of negated booleans varies
+    if (argv.includes('--no-thinking')) {
+        opts.noThinking = true;
+        delete opts.thinking;
+    }
+    return opts;
+}
+/**
+ * Validate spawn arguments for consistency.
+ *
+ * @param {object} args - Parsed arguments
+ * @throws {Error} If validation fails
+ */
+export function validateSpawnArgs(args) {
+    // Check mutually exclusive flags
+    if (args.thinking && args.noThinking) {
+        throw new Error('--thinking and --no-thinking are mutually exclusive');
+    }
+    // Budget requires thinking
+    if (args.budget && !args.thinking) {
+        throw new Error('--budget requires --thinking flag');
+    }
+    // Budget must be positive integer
+    if (args.budget) {
+        const budgetNum = parseInt(args.budget, 10);
+        if (isNaN(budgetNum) || budgetNum <= 0 || !Number.isInteger(budgetNum)) {
+            throw new Error('--budget must be a positive integer');
+        }
+    }
+}
+/**
+ * Generate the Execution Mode section for the task prompt.
+ *
+ * @param {object} options - Thinking mode options
+ * @param {boolean} [options.thinking] - Whether extended thinking is enabled
+ * @param {boolean} [options.noThinking] - Whether thinking is explicitly disabled
+ * @param {string} [options.budget] - Token budget for thinking
+ * @returns {string} Execution Mode section or empty string if no thinking flags
+ */
+export function generateExecutionModeSection(options) {
+    const { thinking, noThinking, budget } = options;
+    // No section if no thinking flags specified (default behavior)
+    if (!thinking && !noThinking) {
+        return '';
+    }
+    const lines = ['## Execution Mode', ''];
+    if (thinking) {
+        lines.push('Extended thinking: **enabled**');
+        if (budget) {
+            lines.push(`Token budget: **${budget}**`);
+        }
+        lines.push('');
+        lines.push('The sub-agent will use extended thinking for complex reasoning tasks.');
+    }
+    else if (noThinking) {
+        lines.push('Extended thinking: **disabled**');
+        lines.push('');
+        lines.push('The sub-agent will execute without extended thinking mode.');
+    }
+    return lines.join('\n');
+}
+/**
+ * Generate think tool guidance for the task prompt.
+ *
+ * @param {object} options - Thinking mode options
+ * @param {boolean} [options.thinking] - Whether extended thinking is enabled
+ * @param {boolean} [options.noThinking] - Whether thinking is explicitly disabled
+ * @returns {string} Think tool guidance or empty string if not applicable
+ */
+export function generateThinkToolGuidance(options) {
+    const { thinking, noThinking } = options;
+    // No guidance if thinking is disabled or not specified
+    if (!thinking || noThinking) {
+        return '';
+    }
+    return `## Think Tool Guidance
+
+When extended thinking is enabled, use the think tool strategically for:
+
+1. **Complex Decision Points**: Before making architectural decisions or choosing between approaches
+2. **Multi-Step Reasoning**: When planning long tool-call chains or multi-file edits
+3. **Mid-Execution Reflection**: After gathering information, before implementing changes
+4. **Error Analysis**: When troubleshooting failures or unexpected behavior
+
+### Best Practices
+
+- Use think blocks to reason through acceptance criteria before implementation
+- Document your reasoning for complex logic decisions
+- Break down large tasks into thought-through steps
+- Reflect on test results before proceeding with fixes
+
+### When NOT to Use Think Blocks
+
+- Simple file reads or writes with clear outcomes
+- Routine git operations
+- Running predefined commands like \`pnpm gates\`
+- When the next action is obvious and low-risk`;
+}
+/**
+ * Generate help text with examples for thinking mode options.
+ *
+ * @returns {string} Help text with option descriptions and examples
+ */
+export function getHelpText() {
+    return `
+Thinking Mode Options:
+
+  --thinking          Enable extended thinking for complex WU execution
+  --no-thinking       Explicitly disable extended thinking (default behavior)
+  --budget <tokens>   Token budget for extended thinking (requires --thinking)
+
+Examples:
+
+  # Enable extended thinking for a complex WU
+  pnpm wu:spawn --id WU-123 --thinking
+
+  # Enable thinking with a specific token budget
+  pnpm wu:spawn --id WU-456 --thinking --budget 10000
+
+  # Explicitly disable thinking (useful for clear-spec WUs)
+  pnpm wu:spawn --id WU-789 --no-thinking
+
+Notes:
+
+  - Default behavior (no flags) preserves backward compatibility
+  - --budget requires --thinking flag to be set
+  - --thinking and --no-thinking are mutually exclusive
+  - Token budget is passed to the sub-agent's execution configuration
+`;
+}
+/**
+ * Log prefix for spawn registry messages (WU-1945)
+ */
+const LOG_PREFIX = '[wu:spawn]';
+/**
+ * Records a spawn event to the spawn registry.
+ *
+ * This function is non-blocking: if the registry write fails, it returns
+ * a result with success=false but does NOT throw an error. This ensures
+ * wu:spawn succeeds even if the registry is unavailable.
+ *
+ * @param {object} options - Spawn recording options
+ * @param {string} options.parentWuId - Parent WU ID (orchestrator)
+ * @param {string} options.targetWuId - Target WU ID (spawned work)
+ * @param {string} options.lane - Lane for the spawned work
+ * @param {string} [options.baseDir] - Base directory for registry (defaults to LUMENFLOW_PATHS.STATE_DIR)
+ * @returns {Promise<{success: boolean, spawnId: string|null, error?: string}>}
+ *
+ * @example
+ * const result = await recordSpawnToRegistry({
+ *   parentWuId: 'WU-1000',
+ *   targetWuId: 'WU-1001',
+ *   lane: 'Operations: Tooling',
+ * });
+ *
+ * if (result.success) {
+ *   console.log(`Recorded: ${result.spawnId}`);
+ * }
+ */
+export async function recordSpawnToRegistry(options) {
+    const { parentWuId, targetWuId, lane, baseDir = LUMENFLOW_PATHS.STATE_DIR } = options;
+    try {
+        const store = new DelegationRegistryStore(baseDir);
+        await store.load();
+        const spawnId = await store.record(parentWuId, targetWuId, lane);
+        return {
+            success: true,
+            spawnId,
+        };
+    }
+    catch (error) {
+        // Non-blocking: return failure result instead of throwing
+        return {
+            success: false,
+            spawnId: null,
+            error: error.message,
+        };
+    }
+}
+/**
+ * Formats a message about spawn recording result.
+ *
+ * @param {string|null} spawnId - Spawn ID if successful, null otherwise
+ * @param {string} [errorMessage] - Error message if spawn recording failed
+ * @returns {string} Formatted message for console output
+ *
+ * @example
+ * // Successful recording
+ * formatSpawnRecordedMessage('spawn-abc1');
+ * // Returns: '[wu:spawn] Spawn recorded spawn-abc1'
+ *
+ * // Failed recording
+ * formatSpawnRecordedMessage(null, 'Registry unavailable');
+ * // Returns: '[wu:spawn] Warning: Registry write skipped (Registry unavailable)'
+ */
+export function formatSpawnRecordedMessage(spawnId, errorMessage = undefined) {
+    if (spawnId) {
+        return `${LOG_PREFIX} Spawn recorded ${spawnId}`;
+    }
+    if (errorMessage) {
+        return `${LOG_PREFIX} Warning: Registry write skipped (${errorMessage})`;
+    }
+    return `${LOG_PREFIX} Warning: Registry unavailable`;
+}
+//# sourceMappingURL=wu-spawn-helpers.js.map

package/dist/wu-spawn-helpers.js.map

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

package/dist/wu-spawn-skills.d.ts

@@ -0,0 +1,39 @@
+import type { ClientConfig } from './lumenflow-config-schema.js';
+interface ClientContext {
+    name: string;
+    config?: ClientConfig;
+}
+export declare function resolveClientConfig(config: UnsafeAny, clientName: UnsafeAny): any;
+export declare function resolveSkillsPaths(config: UnsafeAny, clientName: UnsafeAny): {
+    clientConfig: any;
+    configuredSkillsDir: any;
+    configuredAgentsDir: any;
+    skillsDir: string | undefined;
+    agentsDir: string | undefined;
+    configuredSkillsMissing: boolean;
+    configuredAgentsMissing: boolean;
+};
+export declare function generateSkillsCatalogGuidance(config: UnsafeAny, clientName: UnsafeAny): string;
+/**
+ * WU-1142: Get byLane skills for a specific lane
+ *
+ * @param clientContext - Client context with config
+ * @param lane - Lane name (e.g., "Framework: Core")
+ * @returns Array of skill names for the lane, or empty array
+ */
+export declare function getByLaneSkills(clientContext: ClientContext | undefined, lane: string): string[];
+export declare function generateClientSkillsGuidance(clientContext: ClientContext | undefined, lane?: string): string;
+/**
+ * WU-1900: Resolve capability-to-skill mappings from classifier output and client config.
+ *
+ * Takes the abstract capabilities from classifyWork() and maps them to
+ * client-specific skill names using the capabilities_map in client config.
+ *
+ * @param capabilities - Abstract capability tags from WorkClassification
+ * @param clientConfig - Client config with optional capabilities_map
+ * @returns Array of mapped skill names (may be empty)
+ */
+export declare function resolveCapabilitySkills(capabilities: string[], clientConfig: ClientConfig | undefined): string[];
+export declare function generateSkillsSelectionSection(doc: UnsafeAny, config: UnsafeAny, clientName: UnsafeAny): string;
+export {};
+//# sourceMappingURL=wu-spawn-skills.d.ts.map

package/dist/wu-spawn-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-spawn-skills.d.ts","sourceRoot":"","sources":["../src/wu-spawn-skills.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAuDjE,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,OAQ3E;AAcD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS;;;;;;;;EAoB1E;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,UAuBrF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE,aAAa,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAIhG;AAED,wBAAgB,4BAA4B,CAC1C,aAAa,EAAE,aAAa,GAAG,SAAS,EACxC,IAAI,CAAC,EAAE,MAAM,UA4Bd;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EAAE,EACtB,YAAY,EAAE,YAAY,GAAG,SAAS,GACrC,MAAM,EAAE,CAYV;AAED,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,SAAS,UAsDtB"}

package/dist/wu-spawn-skills.js

@@ -0,0 +1,214 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { existsSync } from 'node:fs';
+import { LUMENFLOW_PATHS } from './wu-constants.js';
+import { classifyWork } from './work-classifier.js';
+/** WU-1430: Compose known skills directories from centralized constants */
+const KNOWN_SKILLS_DIRS = [
+    LUMENFLOW_PATHS.SKILLS_DIR,
+    '.claude/skills',
+    '.codex/skills',
+    '.gemini/skills',
+];
+/** WU-1430: Compose known agents directories from centralized constants */
+const KNOWN_AGENTS_DIRS = [
+    LUMENFLOW_PATHS.AGENTS_DIR,
+    '.claude/agents',
+    '.codex/agents',
+    '.gemini/agents',
+];
+const SECTION = {
+    skillsSelection: '## Skills Selection',
+    skillsCatalog: '### Skills Catalog',
+    softPolicy: '### Soft Policy (baselines for this WU)',
+    additionalSkills: '### Additional Skills (load if needed)',
+    gracefulDegradation: '### Graceful Degradation',
+    clientSkills: '### Client Skills Guidance',
+};
+const MESSAGES = {
+    skillsIntro: '**IMPORTANT**: Before starting work, select and load relevant skills.',
+    catalogMissing: 'No skills directories configured or found. Set `directories.skillsDir` or `agents.clients.<client>.skillsDir` in workspace.yaml software_delivery.',
+    baselineFallback: '- Load baseline skills: `/skill wu-lifecycle`, `/skill tdd-workflow` (for features)\n- Continue with implementation using Mandatory Standards below',
+};
+const CONTEXT_HINTS = {
+    wuLifecycle: '- `wu-lifecycle` — ALL WUs need workflow automation',
+    worktreeDiscipline: '- `worktree-discipline` — ALL WUs need path safety',
+    tddWorkflow: '- `tdd-workflow` — TDD is mandatory for feature/enhancement WUs',
+    bugClassification: '- `bug-classification` — Bug severity assessment',
+    lumenflowGates: '- `lumenflow-gates` — Tooling often affects gates',
+    llmCompliance: '- `llm-compliance` — Intelligence lane requires LLM validation',
+    promptManagement: '- `prompt-management` — For prompt template work',
+    frontendDesign: '- `frontend-design` — For UI component work',
+};
+const ADDITIONAL_SKILLS_TABLE = `| Skill | Use When |
+|-------|----------|
+| lumenflow-gates | Gates fail, debugging format/lint/typecheck errors |
+| bug-classification | Bug discovered mid-WU, need priority classification |
+| llm-compliance | Code touches LLM, prompts, classification |
+| prompt-management | Working with prompt templates, golden datasets |
+| frontend-design | Building UI components, pages |
+| initiative-management | Multi-phase projects, INIT-XXX coordination |
+| multi-agent-coordination | Spawning sub-agents, parallel WU work |
+| orchestration | Agent coordination, mandatory agent checks |
+| ops-maintenance | Metrics, validation, health checks |`;
+export function resolveClientConfig(config, clientName) {
+    const clients = config?.agents?.clients || {};
+    if (!clientName)
+        return undefined;
+    if (clients[clientName])
+        return clients[clientName];
+    const matchKey = Object.keys(clients).find((key) => key.toLowerCase() === clientName.toLowerCase());
+    return matchKey ? clients[matchKey] : undefined;
+}
+function uniqueNonEmpty(values) {
+    const seen = new Set();
+    const result = [];
+    for (const value of values) {
+        if (!value)
+            continue;
+        if (seen.has(value))
+            continue;
+        seen.add(value);
+        result.push(value);
+    }
+    return result;
+}
+export function resolveSkillsPaths(config, clientName) {
+    const clientConfig = resolveClientConfig(config, clientName);
+    const configuredSkillsDir = clientConfig?.skillsDir || config?.directories?.skillsDir;
+    const configuredAgentsDir = config?.directories?.agentsDir;
+    const skillsCandidates = uniqueNonEmpty([configuredSkillsDir, ...KNOWN_SKILLS_DIRS]);
+    const agentsCandidates = uniqueNonEmpty([configuredAgentsDir, ...KNOWN_AGENTS_DIRS]);
+    const skillsDir = skillsCandidates.find((candidate) => existsSync(candidate));
+    const agentsDir = agentsCandidates.find((candidate) => existsSync(candidate));
+    const configuredSkillsMissing = Boolean(configuredSkillsDir && !existsSync(configuredSkillsDir));
+    const configuredAgentsMissing = Boolean(configuredAgentsDir && !existsSync(configuredAgentsDir));
+    return {
+        clientConfig,
+        configuredSkillsDir,
+        configuredAgentsDir,
+        skillsDir,
+        agentsDir,
+        configuredSkillsMissing,
+        configuredAgentsMissing,
+    };
+}
+export function generateSkillsCatalogGuidance(config, clientName) {
+    const resolution = resolveSkillsPaths(config, clientName);
+    const lines = [];
+    if (resolution.skillsDir) {
+        lines.push(`- Check \`${resolution.skillsDir}\` for available skills.`);
+    }
+    if (resolution.agentsDir) {
+        lines.push(`- Check \`${resolution.agentsDir}\` for agent configs (optional).`);
+    }
+    if (lines.length > 0) {
+        return `${SECTION.skillsCatalog}\n\n${lines.join('\n')}\n`;
+    }
+    const configuredHint = resolution.configuredSkillsDir
+        ? `Configured skillsDir \`${resolution.configuredSkillsDir}\` was not found. `
+        : '';
+    const clientHint = clientName
+        ? `agents.clients.${clientName}.skillsDir`
+        : 'agents.clients.<client>.skillsDir';
+    return `${SECTION.skillsCatalog}\n\n${configuredHint}No skills directories configured or found. Set \`directories.skillsDir\` or \`${clientHint}\` in workspace.yaml software_delivery.\n`;
+}
+/**
+ * WU-1142: Get byLane skills for a specific lane
+ *
+ * @param clientContext - Client context with config
+ * @param lane - Lane name (e.g., "Framework: Core")
+ * @returns Array of skill names for the lane, or empty array
+ */
+export function getByLaneSkills(clientContext, lane) {
+    const byLane = clientContext?.config?.skills?.byLane;
+    if (!byLane || !lane)
+        return [];
+    return byLane[lane] || [];
+}
+export function generateClientSkillsGuidance(clientContext, lane) {
+    const skills = clientContext?.config?.skills;
+    if (!skills) {
+        return '';
+    }
+    // WU-1142: Check for byLane skills
+    const byLaneSkills = lane ? getByLaneSkills(clientContext, lane) : [];
+    const hasRecommended = skills.recommended && skills.recommended.length > 0;
+    const hasByLane = byLaneSkills.length > 0;
+    const hasInstructions = Boolean(skills.instructions);
+    if (!hasInstructions && !hasRecommended && !hasByLane) {
+        return '';
+    }
+    const instructions = skills.instructions ? `${skills.instructions.trim()}\n\n` : '';
+    const recommendedSection = hasRecommended || hasByLane
+        ? `Recommended skills:\n${[...(skills.recommended || []), ...byLaneSkills]
+            .filter((s, i, arr) => arr.indexOf(s) === i) // dedupe
+            .map((s) => `- \`${s}\``)
+            .join('\n')}\n`
+        : '';
+    return `${SECTION.clientSkills} (${clientContext?.name})\n\n${instructions}${recommendedSection}`;
+}
+/**
+ * WU-1900: Resolve capability-to-skill mappings from classifier output and client config.
+ *
+ * Takes the abstract capabilities from classifyWork() and maps them to
+ * client-specific skill names using the capabilities_map in client config.
+ *
+ * @param capabilities - Abstract capability tags from WorkClassification
+ * @param clientConfig - Client config with optional capabilities_map
+ * @returns Array of mapped skill names (may be empty)
+ */
+export function resolveCapabilitySkills(capabilities, clientConfig) {
+    const capMap = clientConfig?.capabilities_map;
+    if (!capMap || capabilities.length === 0)
+        return [];
+    const skills = [];
+    for (const capability of capabilities) {
+        const skillName = capMap[capability];
+        if (skillName) {
+            skills.push(skillName);
+        }
+    }
+    return skills;
+}
+export function generateSkillsSelectionSection(doc, config, clientName) {
+    const lane = doc.lane || '';
+    const type = doc.type || 'feature';
+    const laneParent = lane.split(':')[0].trim();
+    // WU-1900: Run work classifier to get domain and capabilities
+    const classificationConfig = config?.methodology?.work_classification;
+    const classification = classifyWork({
+        code_paths: doc.code_paths,
+        lane: doc.lane,
+        type: doc.type,
+        description: doc.description,
+    }, classificationConfig);
+    const contextHints = [];
+    contextHints.push(CONTEXT_HINTS.wuLifecycle);
+    contextHints.push(CONTEXT_HINTS.worktreeDiscipline);
+    if (type === 'feature' || type === 'enhancement') {
+        contextHints.push(CONTEXT_HINTS.tddWorkflow);
+    }
+    if (type === 'bug') {
+        contextHints.push(CONTEXT_HINTS.bugClassification);
+    }
+    if (laneParent === 'Operations' && lane.includes('Tooling')) {
+        contextHints.push(CONTEXT_HINTS.lumenflowGates);
+    }
+    if (laneParent === 'Intelligence') {
+        contextHints.push(CONTEXT_HINTS.llmCompliance);
+        contextHints.push(CONTEXT_HINTS.promptManagement);
+    }
+    // WU-1900: Use classifier domain instead of lane-only check for UI skills
+    if (classification.domain === 'ui' || laneParent === 'Experience') {
+        contextHints.push(CONTEXT_HINTS.frontendDesign);
+    }
+    // WU-1900: Map classifier capabilities to client-specific skills
+    const clientConfig = resolveClientConfig(config, clientName);
+    const capabilitySkills = resolveCapabilitySkills(classification.capabilities, clientConfig);
+    const capabilityHints = capabilitySkills.map((skill) => `- \`${skill}\` — Suggested by work classifier (${classification.domain} domain)`);
+    const softPolicySection = `${SECTION.softPolicy}\n\nBased on WU context, consider loading:\n\n${contextHints.join('\n')}${capabilityHints.length > 0 ? '\n' + capabilityHints.join('\n') : ''}\n\n`;
+    const catalogGuidance = generateSkillsCatalogGuidance(config, clientName);
+    return `${SECTION.skillsSelection}\n\n${MESSAGES.skillsIntro}\n\n${catalogGuidance}${softPolicySection}${SECTION.additionalSkills}\n\n${ADDITIONAL_SKILLS_TABLE}\n\n${SECTION.gracefulDegradation}\n\nIf the skill catalogue is missing or invalid:\n${MESSAGES.baselineFallback}\n`;
+}
+//# sourceMappingURL=wu-spawn-skills.js.map

package/dist/wu-spawn-skills.js.map

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

package/dist/wu-spawn.d.ts

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+/**
+ * WU Spawn - Thin Facade (WU-2012)
+ *
+ * Generates ready-to-use Task tool invocations for sub-agent WU execution.
+ *
+ * This file serves as the public API facade and CLI entry point.
+ * All implementation is delegated to focused modules:
+ *
+ * - spawn-template-assembler.ts: Template loading, context building, constants
+ * - spawn-guidance-generators.ts: Test methodology and architecture guidance
+ * - spawn-policy-resolver.ts: Mandatory standards, enforcement summary, telemetry
+ * - spawn-constraints-generator.ts: Constraints block generation
+ * - spawn-prompt-helpers.ts: WU doc formatting helpers (acceptance, invariants, agents)
+ * - spawn-agent-guidance.ts: Agent operational guidance sections
+ * - spawn-task-builder.ts: Task invocation, Codex prompt assembly, lane occupation
+ *
+ * Existing helper modules (pre-WU-2012):
+ * - wu-spawn-helpers.ts: Thinking mode, spawn registry
+ * - wu-spawn-skills.ts: Skills selection and client config
+ * - wu-spawn-context.ts: Memory context integration
+ *
+ * @module wu-spawn
+ */
+export { TRUNCATION_WARNING_BANNER, SPAWN_END_SENTINEL, tryAssembleSpawnTemplates, buildTemplateContext, buildTemplateContextWithPolicy, } from './spawn-template-assembler.js';
+export { generateTestGuidance, generatePolicyBasedTestGuidance, generatePolicyBasedArchitectureGuidance, generateDesignContextSection, } from './spawn-guidance-generators.js';
+export type { TestGuidanceOptions } from './spawn-guidance-generators.js';
+export { generateMandatoryStandards, generateEnforcementSummary, emitMethodologyTelemetry, } from './spawn-policy-resolver.js';
+export { generateWorktreeBlockRecoverySection } from './spawn-guidance-generators.js';
+export { generateEffortScalingRules, generateParallelToolCallGuidance, generateIterativeSearchHeuristics, generateTokenBudgetAwareness, generateCompletionFormat, generateAgentCoordinationSection, generateQuickFixCommands, generateLaneSelectionSection, generateWorktreePathGuidance, generateActionSection, } from './spawn-agent-guidance.js';
+export { generateTaskInvocation, generateCodexPrompt, checkLaneOccupation, generateLaneOccupationWarning, } from './spawn-task-builder.js';
+export type { SpawnOptions } from './spawn-task-builder.js';
+//# sourceMappingURL=wu-spawn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wu-spawn.d.ts","sourceRoot":"","sources":["../src/wu-spawn.ts"],"names":[],"mappings":";AAGA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAyBH,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,yBAAyB,EACzB,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,oBAAoB,EACpB,+BAA+B,EAC/B,uCAAuC,EACvC,4BAA4B,GAC7B,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAG1E,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,oCAAoC,EAAE,MAAM,gCAAgC,CAAC;AAGtF,OAAO,EACL,0BAA0B,EAC1B,gCAAgC,EAChC,iCAAiC,EACjC,4BAA4B,EAC5B,wBAAwB,EACxB,gCAAgC,EAChC,wBAAwB,EACxB,4BAA4B,EAC5B,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,6BAA6B,GAC9B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC"}