@lumenflow/cli 2.4.0 → 2.5.0

package/dist/wu-recover.d.ts

@@ -1,37 +0,0 @@
-#!/usr/bin/env node
-/**
- * WU Recovery Command
- *
- * WU-1090: Context-aware state machine for WU lifecycle commands
- *
- * Analyzes WU state inconsistencies and offers recovery actions:
- * - resume: Reconcile state and continue working (preserves work)
- * - reset: Discard worktree and reset WU to ready
- * - nuke: Remove all artifacts completely (requires --force)
- * - cleanup: Remove leftover worktree for done WUs
- *
- * Usage:
- *   pnpm wu:recover --id WU-123             # Analyze issues
- *   pnpm wu:recover --id WU-123 --action resume  # Apply fix
- *   pnpm wu:recover --id WU-123 --action nuke --force  # Destructive
- */
-import { type RecoveryAnalysis } from '@lumenflow/core/dist/recovery/recovery-analyzer.js';
-/**
- * Check if action requires --force flag
- */
-export declare function requiresForceFlag(action: string): boolean;
-/**
- * Validate recovery action
- */
-export declare function validateRecoveryAction(action: string): {
-    valid: boolean;
-    error?: string;
-};
-/**
- * Format recovery analysis output
- */
-export declare function formatRecoveryOutput(analysis: RecoveryAnalysis): string;
-/**
- * Get exit code for recovery command
- */
-export declare function getRecoveryExitCode(analysis: RecoveryAnalysis, actionFailed: boolean): number;

package/dist/wu-release.d.ts

@@ -1,19 +0,0 @@
-#!/usr/bin/env node
-/**
- * WU Release Command (WU-1080)
- *
- * Releases an orphaned WU from in_progress back to ready state.
- * Use when an agent is interrupted mid-WU and the WU needs to be reclaimed.
- *
- * Sequence (micro-worktree pattern):
- * 1) Validate WU is in_progress
- * 2) Create micro-worktree from main
- * 3) Append release event to state store
- * 4) Regenerate backlog.md and status.md
- * 5) Commit in micro-worktree, push directly to origin/main
- * 6) Optionally remove the work worktree
- *
- * Usage:
- *   pnpm wu:release --id WU-1080 --reason "Agent interrupted"
- */
-export {};

package/dist/wu-repair.d.ts

@@ -1,60 +0,0 @@
-#!/usr/bin/env node
-/**
- * WU State Repair Tool (Unified - WU-1826, WU-2240)
- *
- * Layer 2 defense-in-depth: detect and repair WU state inconsistencies.
- *
- * This unified tool consolidates four repair modes:
- * - Consistency mode (default): detect/repair state inconsistencies
- * - Claim mode (--claim): repair missing claim metadata in worktrees
- * - Admin mode (--admin): administrative fixes for done WUs
- * - State mode (--repair-state): repair corrupted wu-events.jsonl (WU-2240)
- *
- * Usage:
- *   # Consistency mode (default)
- *   pnpm wu:repair --id WU-123           # Repair single WU
- *   pnpm wu:repair --id WU-123 --check   # Audit only, no changes
- *   pnpm wu:repair --all                 # Batch repair all WUs
- *   pnpm wu:repair --all --check         # Audit all WUs
- *
- *   # Claim mode
- *   pnpm wu:repair --claim --id WU-123           # Repair claim metadata
- *   pnpm wu:repair --claim --id WU-123 --check   # Check only
- *   pnpm wu:repair --claim --id WU-123 --worktree /path/to/worktree
- *
- *   # Admin mode
- *   pnpm wu:repair --admin --id WU-123 --lane "Operations: Tooling"
- *   pnpm wu:repair --admin --id WU-123 --status cancelled
- *   pnpm wu:repair --admin --id WU-123 --notes "Administrative fix"
- *   pnpm wu:repair --admin --id WU-123 --initiative INIT-001
- *
- *   # State mode (WU-2240)
- *   pnpm wu:repair --repair-state                    # Repair default state file
- *   pnpm wu:repair --repair-state --path /path/to/wu-events.jsonl  # Repair specific file
- *
- * Exit codes:
- *   0: Success (no issues or all repaired)
- *   1: Issues detected (--check mode)
- *   2: Repair failed
- *
- * DEPRECATION NOTICE:
- *   - pnpm wu:repair-claim is deprecated. Use: pnpm wu:repair --claim
- *   - pnpm wu:admin-repair is deprecated. Use: pnpm wu:repair --admin
- *
- * @see {@link tools/lib/wu-repair-core.mjs} - Core repair logic
- * @see {@link tools/lib/wu-consistency-checker.mjs} - Consistency detection/repair
- * @see {@link tools/lib/wu-state-store.mjs} - State file repair (repairStateFile)
- */
-/**
- * Normalise WU ID to uppercase with WU- prefix
- * @param {string} id - Raw WU ID
- * @returns {string} Normalised WU ID
- */
-declare function normaliseWUId(id: any): any;
-/**
- * Validate WU ID format
- * @param {string} id - WU ID to validate
- * @returns {boolean} True if valid
- */
-declare function isValidWUId(id: any): boolean;
-export { normaliseWUId, isValidWUId };

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

@@ -1,10 +0,0 @@
-/**
- * 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;

package/dist/wu-spawn.d.ts

@@ -1,192 +0,0 @@
-#!/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/CLAUDE.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 docs/04-operations/_frameworks/lumenflow/agent/onboarding/agent-invocation-guide.md} - Context loading templates
- */
-import { getConfig } from '@lumenflow/core/dist/lumenflow-config.js';
-import type { ClientConfig } from '@lumenflow/core/dist/lumenflow-config-schema.js';
-/**
- * WU-1131: Truncation prevention constants
- *
- * 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 -->";
-/**
- * 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;
-interface ClientContext {
-    name: string;
-    config?: ClientConfig;
-}
-interface SpawnOptions {
-    thinking?: boolean;
-    noThinking?: boolean;
-    budget?: string;
-    client?: ClientContext;
-    config?: ReturnType<typeof getConfig>;
-}
-/**
- * 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
- * @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, strategy: any, options?: SpawnOptions): string;
-export declare function generateCodexPrompt(doc: any, id: any, strategy: any, 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('@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-status.d.ts

@@ -1,25 +0,0 @@
-#!/usr/bin/env node
-/**
- * WU Status Command
- *
- * WU-1090: Context-aware state machine for WU lifecycle commands
- *
- * Shows:
- * - Current location (main checkout vs worktree)
- * - WU state if in worktree or --id provided
- * - Git state (branch, dirty, ahead/behind)
- * - Valid commands for current context
- *
- * Usage:
- *   pnpm wu:status              # Auto-detect from current directory
- *   pnpm wu:status --id WU-123  # Show status for specific WU
- */
-import type { WuContext } from '@lumenflow/core/dist/validation/types.js';
-/**
- * Format complete status output
- */
-export declare function formatStatusOutput(context: WuContext): string;
-/**
- * Get exit code based on context state
- */
-export declare function getStatusExitCode(context: WuContext): number;

package/dist/wu-unblock.d.ts

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-/**
- * WU Unblock Helper
- *
- * Sequence (micro-worktree pattern):
- * 1) Create micro-worktree from main
- * 2) Auto-update WU YAML/backlog/status to In Progress in micro-worktree
- * 3) Commit in micro-worktree, push directly to origin/main
- * 4) Optionally create a fresh work worktree/branch (default: skip unless --create-worktree)
- *
- * Uses micro-worktree pattern to avoid pre-commit hook blocking commits to main.
- *
- * Usage:
- *   pnpm wu:unblock --id WU-334 [--reason "Dependency cleared"] [--create-worktree] [--worktree ...] [--branch ...] [--no-auto]
- */
-export {};

package/dist/wu-unlock-lane.d.ts

@@ -1,19 +0,0 @@
-#!/usr/bin/env node
-/**
- * WU Unlock Lane Helper
- *
- * Provides a dedicated audited command for operators to safely clear lane locks.
- *
- * Safety-first approach:
- * - Zombie locks (PID not running): Can be unlocked without --force
- * - Stale locks (>24h old): Can be unlocked without --force
- * - Active locks (recent, PID running): Require --force to unlock
- *
- * All unlocks require a --reason parameter for audit purposes.
- *
- * Usage:
- *   pnpm wu:unlock-lane --lane "Core" --reason "Process crashed"
- *   pnpm wu:unlock-lane --lane "Core" --reason "Emergency" --force
- *   pnpm wu:unlock-lane --list  # List all current locks
- */
-export {};

package/dist/wu-validate.d.ts

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-/**
- * WU Validation Tool
- *
- * Validates WU YAML files against schema and checks for quality warnings.
- * Returns exit code 0 if valid (warnings are advisory, not blocking).
- * Returns exit code 1 only for schema errors.
- *
- * Usage:
- *   pnpm wu:validate --id WU-123         # Validate specific WU
- *   pnpm wu:validate --all               # Validate all WUs
- *   pnpm wu:validate --all --strict      # Fail on warnings too
- *
- * @see {@link tools/lib/wu-schema.mjs} - Schema definitions
- */
-export {};