@lumenflow/cli 1.0.0

package/dist/wu-spawn.d.ts

@@ -0,0 +1,168 @@
+#!/usr/bin/env node
+/**
+ * WU Spawn Helper
+ *
+ * Generates ready-to-use Task tool invocations for sub-agent WU execution.
+ * Includes context loading preamble, skills selection guidance, and constraints block.
+ *
+ * Usage:
+ *   pnpm wu:spawn --id WU-123
+ *   pnpm wu:spawn --id WU-123 --codex
+ *
+ * Output:
+ *   A complete Task tool invocation block with:
+ *   - Context loading preamble (CLAUDE-core.md, README, lumenflow, WU YAML)
+ *   - WU details and acceptance criteria
+ *   - Skills Selection section (sub-agent reads catalogue and selects at runtime)
+ *   - Mandatory agent advisory
+ *   - Constraints block at end (Lost in the Middle research)
+ *
+ * Skills Selection:
+ *   This command is AGENT-FACING. Unlike /wu-prompt (human-facing, skills selected
+ *   at generation time), wu:spawn instructs the sub-agent to read the skill catalogue
+ *   and select skills at execution time based on WU context.
+ *
+ * Codex Mode:
+ *   When --codex is used, outputs a Codex/GPT-friendly Markdown prompt (no antml/XML escaping).
+ *
+ * @see {@link ai/onboarding/agent-invocation-guide.md} - Context loading templates
+ */
+/**
+ * Generate effort scaling rules section (WU-1986)
+ *
+ * Based on Anthropic multi-agent research: helps agents decide when to
+ * spawn sub-agents vs handle inline.
+ *
+ * @returns {string} Effort scaling section
+ */
+export declare function generateEffortScalingRules(): string;
+/**
+ * Generate parallel tool call guidance (WU-1986)
+ *
+ * Based on Anthropic research: 3+ parallel tool calls significantly improve performance.
+ *
+ * @returns {string} Parallel tool call guidance
+ */
+export declare function generateParallelToolCallGuidance(): string;
+/**
+ * Generate iterative search heuristics (WU-1986)
+ *
+ * Based on Anthropic research: start broad, narrow focus.
+ *
+ * @returns {string} Search heuristics section
+ */
+export declare function generateIterativeSearchHeuristics(): string;
+/**
+ * Generate token budget awareness section (WU-1986)
+ *
+ * @param {string} id - WU ID
+ * @returns {string} Token budget section
+ */
+export declare function generateTokenBudgetAwareness(id: any): string;
+/**
+ * Generate structured completion format (WU-1986)
+ *
+ * @param {string} id - WU ID
+ * @returns {string} Completion format section
+ */
+export declare function generateCompletionFormat(_id: any): string;
+/**
+ * Generate agent coordination section (WU-1987)
+ *
+ * Provides guidance on mem:signal for parallel agent coordination,
+ * orchestrate:status for dashboard checks, and abandoned WU handling.
+ *
+ * @param {string} id - WU ID
+ * @returns {string} Agent coordination section
+ */
+export declare function generateAgentCoordinationSection(id: any): string;
+/**
+ * Generate quick fix commands section (WU-1987)
+ *
+ * Provides format/lint/typecheck commands for quick fixes before gates.
+ *
+ * @returns {string} Quick fix commands section
+ */
+export declare function generateQuickFixCommands(): string;
+/**
+ * Generate Lane Selection section (WU-2107)
+ *
+ * Provides guidance on lane selection when creating new WUs.
+ * Points agents to wu:infer-lane for automated lane suggestions.
+ *
+ * @returns {string} Lane Selection section
+ */
+export declare function generateLaneSelectionSection(): string;
+/**
+ * Generate Worktree Path Guidance section (WU-2362)
+ *
+ * Provides guidance for sub-agents on working within worktrees, including
+ * how to determine the worktree root and where to create stamps.
+ *
+ * Problem: CLAUDE_PROJECT_DIR is hook-only; sub-agents inherit parent cwd (main).
+ * Solution: Use git rev-parse --show-toplevel to determine actual worktree root.
+ *
+ * @param {string|undefined} worktreePath - Worktree path from WU YAML
+ * @returns {string} Worktree path guidance section
+ */
+export declare function generateWorktreePathGuidance(worktreePath: any): string;
+/**
+ * Generate the Action section based on WU claim status (WU-1745).
+ *
+ * If WU is already claimed (has claimed_at and worktree_path), tells agent
+ * to continue in the existing worktree.
+ *
+ * If WU is unclaimed (status: ready), tells agent to run wu:claim first.
+ *
+ * @param {object} doc - WU YAML document
+ * @param {string} id - WU ID
+ * @returns {string} Action section content
+ */
+export declare function generateActionSection(doc: any, id: any): string;
+/**
+ * Generate the Completion Workflow section for sub-agents (WU-2682).
+ *
+ * Explicitly instructs sub-agents to run wu:done autonomously after gates pass.
+ * This prevents agents from asking permission instead of completing.
+ *
+ * @param {string} id - WU ID
+ * @returns {string} Completion Workflow section
+ */
+export declare function generateCompletionWorkflowSection(id: string): string;
+/**
+ * Generate the complete Task tool invocation
+ *
+ * @param {object} doc - WU YAML document
+ * @param {string} id - WU ID
+ * @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} Complete Task tool invocation
+ */
+export declare function generateTaskInvocation(doc: any, id: any, options?: {}): string;
+export declare function generateCodexPrompt(doc: any, id: any, options?: {}): string;
+/**
+ * WU-1603: Check if a lane is currently occupied by another WU
+ *
+ * @param {string} lane - Lane name (e.g., "Operations: Tooling")
+ * @returns {import('@lumenflow/core/dist/lane-lock.js').LockMetadata|null} Lock metadata if occupied, null otherwise
+ */
+export declare function checkLaneOccupation(lane: any): import("@lumenflow/core/dist/lane-lock.js").LockMetadata;
+/**
+ * WU-1603: Generate a warning message when lane is occupied
+ *
+ * @param {import('@lumenflow/core/dist/lane-lock.js').LockMetadata} lockMetadata - Lock metadata
+ * @param {string} targetWuId - WU ID being spawned
+ * @param {Object} [options={}] - Options
+ * @param {boolean} [options.isStale] - Whether the lock is stale (>24h old)
+ * @returns {string} Warning message
+ */
+interface LaneOccupationOptions {
+    isStale?: boolean;
+}
+export declare function generateLaneOccupationWarning(lockMetadata: {
+    lane: string;
+    wuId: string;
+}, targetWuId: string, options?: LaneOccupationOptions): string;
+export {};

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":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAsdH;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,WAazC;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,WAe/C;AAED;;;;;;GAMG;AACH,wBAAgB,iCAAiC,WAWhD;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,EAAE,KAAA,UAU9C;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,KAAA,UA0B3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAAC,EAAE,KAAA,UAsClD;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,WAYvC;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,WAgB3C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAAC,YAAY,KAAA,UAyCxD;AAyFD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,KAAA,EAAE,EAAE,KAAA,UA4B5C;AAuHD;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,KAAA,EAAE,EAAE,KAAA,EAAE,OAAO,KAAK,UAkK3D;AAED,wBAAgB,mBAAmB,CAAC,GAAG,KAAA,EAAE,EAAE,KAAA,EAAE,OAAO,KAAK,UA2ExD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,KAAA,OAMvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,KAAA,EAAE,UAAU,KAAA,EAAE,OAAO,KAAK,UAiBnF"}