@lumenflow/cli 1.0.0

package/dist/wu-prune.js

@@ -0,0 +1,259 @@
+#!/usr/bin/env node
+/**
+ * WU Prune Utility
+ *
+ * Maintains worktree hygiene by:
+ * - Running git worktree prune to clean stale metadata
+ * - Validating worktree ↔ WU ↔ lane mappings
+ * - Warning on orphaned worktrees (no matching WU YAML)
+ * - Warning on stale worktrees (WU status is done/blocked)
+ * - Warning on invalid branch naming conventions
+ *
+ * Usage:
+ *   pnpm wu:prune          # Dry-run mode (shows what would be done)
+ *   pnpm wu:prune --execute # Actually run cleanup
+ */
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { readWUYaml, validateBranchName, extractWUFromBranch, } from '@lumenflow/core/dist/wu-helpers.js';
+import { WU_PATHS } from '@lumenflow/core/dist/wu-paths.js';
+import { die } from '@lumenflow/core/dist/error-handler.js';
+import { getGitForCwd } from '@lumenflow/core/dist/git-adapter.js';
+import { detectOrphanWorktrees, removeOrphanDirectory, } from '@lumenflow/core/dist/orphan-detector.js';
+import { BRANCHES, WU_STATUS, CLI_FLAGS, EXIT_CODES, STRING_LITERALS, EMOJI, LOG_PREFIX, } from '@lumenflow/core/dist/wu-constants.js';
+function parseArgs(argv) {
+    const args = { dryRun: true }; // Default to dry-run for safety
+    for (let i = 2; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === CLI_FLAGS.EXECUTE)
+            args.dryRun = false;
+        else if (a === CLI_FLAGS.DRY_RUN)
+            args.dryRun = true;
+        else if (a === CLI_FLAGS.HELP || a === CLI_FLAGS.HELP_SHORT)
+            args.help = true;
+        else
+            die(`Unknown argument: ${a}`);
+    }
+    return args;
+}
+async function listWorktrees() {
+    const output = await getGitForCwd().worktreeList();
+    if (!output)
+        return [];
+    const worktrees = [];
+    const lines = output.split(STRING_LITERALS.NEWLINE);
+    let current = {};
+    for (const line of lines) {
+        if (line.startsWith('worktree ')) {
+            if (current.path)
+                worktrees.push(current);
+            current = { path: line.substring(9).trim() };
+        }
+        else if (line.startsWith('HEAD ')) {
+            current.head = line.substring(5).trim();
+        }
+        else if (line.startsWith('branch ')) {
+            const fullRef = line.substring(7).trim();
+            // Extract branch name from refs/heads/...
+            current.branch = fullRef.replace(/^refs\/heads\//, '');
+        }
+        else if (line === '') {
+            if (current.path)
+                worktrees.push(current);
+            current = {};
+        }
+    }
+    if (current.path)
+        worktrees.push(current);
+    return worktrees;
+}
+/**
+ * Validate a single worktree
+ * @returns {Promise<{valid: boolean, warnings: string[], errors: string[]}>}
+ */
+async function validateWorktree(wt) {
+    const warnings = [];
+    const errors = [];
+    // Skip main worktree
+    if (wt.branch === BRANCHES.MAIN) {
+        return { valid: true, warnings, errors };
+    }
+    // Check branch naming convention
+    const branchValidation = validateBranchName(wt.branch);
+    if (!branchValidation.valid) {
+        errors.push(`Invalid branch name: ${wt.branch}\n    Expected: lane/<lane>/<wu-id>\n    ${branchValidation.error}`);
+        return { valid: false, warnings, errors }; // Can't continue validation without WU ID
+    }
+    const wuid = extractWUFromBranch(wt.branch);
+    if (!wuid) {
+        errors.push(`Could not extract WU ID from branch: ${wt.branch}`);
+        return { valid: false, warnings, errors };
+    }
+    // Check if WU YAML exists
+    const repoRoot = await getGitForCwd().raw(['rev-parse', '--show-toplevel']);
+    const wuPath = path.join(repoRoot.trim(), WU_PATHS.WU(wuid));
+    if (!existsSync(wuPath)) {
+        errors.push(`Orphaned worktree: WU ${wuid} not found\n    Worktree: ${wt.path}\n    Branch: ${wt.branch}\n    Expected: ${wuPath}`);
+        return { valid: false, warnings, errors };
+    }
+    // Read WU YAML and check status
+    const wu = readWUYaml(wuid);
+    if (!wu) {
+        errors.push(`Failed to parse WU YAML: ${wuPath}`);
+        return { valid: false, warnings, errors };
+    }
+    // Check for status mismatches
+    const status = wu.status;
+    if (status === WU_STATUS.DONE) {
+        warnings.push(`Stale worktree: WU ${wuid} is marked '${WU_STATUS.DONE}'\n    Worktree: ${wt.path}\n    Branch: ${wt.branch}\n    Action: Remove with 'git worktree remove ${wt.path}'`);
+    }
+    else if (status === WU_STATUS.BLOCKED) {
+        warnings.push(`Blocked worktree: WU ${wuid} is marked '${WU_STATUS.BLOCKED}'\n    Worktree: ${wt.path}\n    Branch: ${wt.branch}\n    Consider: Keep if resuming soon, otherwise remove`);
+    }
+    else if (status === WU_STATUS.READY) {
+        warnings.push(`Unclaimed worktree: WU ${wuid} is marked '${WU_STATUS.READY}'\n    Worktree: ${wt.path}\n    Branch: ${wt.branch}\n    Expected: Status should be '${WU_STATUS.IN_PROGRESS}' for active worktrees`);
+    }
+    // Check lane consistency
+    const laneName = branchValidation.lane;
+    const wuLane = wu.lane;
+    if (wuLane && laneName && laneName !== wuLane.toLowerCase()) {
+        warnings.push(`Lane mismatch: Branch lane '${laneName}' doesn't match WU lane '${wuLane}'\n    Worktree: ${wt.path}\n    WU: ${wuid}`);
+    }
+    return { valid: true, warnings, errors };
+}
+async function main() {
+    const args = parseArgs(process.argv);
+    const PREFIX = LOG_PREFIX.PRUNE;
+    if (args.help) {
+        console.log(`
+WU Prune Utility - Maintain worktree hygiene
+
+Usage:
+  pnpm wu:prune           # Dry-run mode (default, shows issues but doesn't change anything)
+  pnpm wu:prune --execute # Execute cleanup (runs git worktree prune)
+
+This tool:
+  ${EMOJI.SUCCESS} Runs 'git worktree prune' to clean stale worktree metadata
+  ${EMOJI.SUCCESS} Detects orphan directories (exist on disk but not tracked by git)
+  ${EMOJI.SUCCESS} Validates worktree to WU to lane mappings
+  ${EMOJI.SUCCESS} Warns on orphaned worktrees (no matching WU YAML)
+  ${EMOJI.SUCCESS} Warns on stale worktrees (WU status is 'done' or 'blocked')
+  ${EMOJI.SUCCESS} Warns on invalid branch naming (not lane/<lane>/<wu-id>)
+  ${EMOJI.SUCCESS} Safe to run regularly (doesn't break active work)
+`);
+        process.exit(EXIT_CODES.SUCCESS);
+    }
+    console.log(`${PREFIX} Worktree Hygiene Check`);
+    console.log(`${PREFIX} =====================\n`);
+    if (args.dryRun) {
+        console.log(`${PREFIX} ${EMOJI.INFO} DRY-RUN MODE (use --execute to apply changes)\n`);
+    }
+    // Get all worktrees
+    const worktrees = await listWorktrees();
+    console.log(`${PREFIX} Found ${worktrees.length} tracked worktree(s)\n`);
+    let totalWarnings = 0;
+    let totalErrors = 0;
+    let orphansRemoved = 0;
+    // Layer 2: Detect orphan directories (WU-1476)
+    console.log(`${PREFIX} Checking for orphan directories...`);
+    const orphanResult = await detectOrphanWorktrees(process.cwd());
+    if (orphanResult.errors.length > 0) {
+        console.log(`${PREFIX} ${EMOJI.WARNING} Orphan detection errors:`);
+        orphanResult.errors.forEach((e) => console.log(`    ${e}`));
+        totalErrors += orphanResult.errors.length;
+    }
+    if (orphanResult.orphans.length > 0) {
+        console.log(`${PREFIX} ${EMOJI.WARNING} Found ${orphanResult.orphans.length} orphan director${orphanResult.orphans.length === 1 ? 'y' : 'ies'} (not tracked by git):`);
+        for (const orphanPath of orphanResult.orphans) {
+            console.log(`    - ${orphanPath}`);
+            if (!args.dryRun) {
+                const removeResult = await removeOrphanDirectory(orphanPath);
+                if (removeResult.removed) {
+                    console.log(`      ${EMOJI.SUCCESS} Removed`);
+                    orphansRemoved++;
+                }
+                else if (removeResult.error) {
+                    console.log(`      ${EMOJI.FAILURE} Failed: ${removeResult.error}`);
+                    totalErrors++;
+                }
+            }
+        }
+        if (args.dryRun && orphanResult.orphans.length > 0) {
+            console.log(`${PREFIX} (use --execute to remove orphan directories)`);
+        }
+    }
+    else {
+        console.log(`${PREFIX} ${EMOJI.SUCCESS} No orphan directories found`);
+    }
+    console.log('');
+    // Validate each tracked worktree
+    for (const wt of worktrees) {
+        const { warnings, errors } = await validateWorktree(wt);
+        if (warnings.length > 0) {
+            console.log(`${PREFIX} ${EMOJI.WARNING} Warnings for ${wt.path}:`);
+            warnings.forEach((w) => console.log(`    ${w}\n`));
+            totalWarnings += warnings.length;
+        }
+        if (errors.length > 0) {
+            console.log(`${PREFIX} ${EMOJI.FAILURE} Errors for ${wt.path}:`);
+            errors.forEach((e) => console.log(`    ${e}\n`));
+            totalErrors += errors.length;
+        }
+    }
+    // Run git worktree prune
+    console.log(`${PREFIX} Running git worktree prune...`);
+    if (args.dryRun) {
+        console.log(`${PREFIX} (skipped in dry-run mode)`);
+    }
+    else {
+        try {
+            const output = await getGitForCwd().raw(['worktree', 'prune', '-v']);
+            if (output) {
+                console.log(output);
+            }
+            else {
+                console.log(`${PREFIX} ${EMOJI.SUCCESS} No stale worktree metadata to prune`);
+            }
+        }
+        catch (e) {
+            console.error(`${PREFIX} ${EMOJI.WARNING} Failed to run git worktree prune: ${e.message}`);
+        }
+    }
+    // Summary
+    console.log(`\n${PREFIX} Summary`);
+    console.log(`${PREFIX} ========`);
+    console.log(`${PREFIX} Tracked worktrees: ${worktrees.length}`);
+    console.log(`${PREFIX} Orphan directories: ${orphanResult.orphans.length}`);
+    if (!args.dryRun && orphansRemoved > 0) {
+        console.log(`${PREFIX} Orphans removed: ${orphansRemoved}`);
+    }
+    console.log(`${PREFIX} Warnings: ${totalWarnings}`);
+    console.log(`${PREFIX} Errors: ${totalErrors}`);
+    if (totalWarnings > 0 || totalErrors > 0 || orphanResult.orphans.length > 0) {
+        console.log(`\n${PREFIX} ${EMOJI.INFO} Recommendations:`);
+        if (orphanResult.orphans.length > 0 && args.dryRun) {
+            console.log(`${PREFIX}    - Run 'pnpm wu:prune --execute' to remove orphan directories`);
+        }
+        if (totalErrors > 0) {
+            console.log(`${PREFIX}    - Fix errors above (orphaned/invalid worktrees)`);
+            console.log(`${PREFIX}    - Remove orphaned worktrees: git worktree remove <path>`);
+        }
+        if (totalWarnings > 0) {
+            console.log(`${PREFIX}    - Review warnings and clean up stale worktrees`);
+            console.log(`${PREFIX}    - For done WUs: Use pnpm wu:done to clean up properly`);
+            console.log(`${PREFIX}    - For blocked WUs: Use pnpm wu:block to clean up if not resuming`);
+        }
+    }
+    else {
+        console.log(`\n${PREFIX} ${EMOJI.SUCCESS} All worktrees are valid and up-to-date!`);
+    }
+    if (args.dryRun) {
+        console.log(`\n${PREFIX} ${EMOJI.INFO} This was a dry-run. Use --execute to apply changes.`);
+    }
+    process.exit(totalErrors > 0 ? EXIT_CODES.ERROR : EXIT_CODES.SUCCESS);
+}
+// Guard main() for testability (WU-1366)
+import { fileURLToPath } from 'node:url';
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+    main();
+}

package/dist/wu-prune.js.map

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

package/dist/wu-repair.d.ts

@@ -0,0 +1,60 @@
+#!/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-repair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-repair.d.ts","sourceRoot":"","sources":["../src/wu-repair.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAcH;;;;GAIG;AACH,iBAAS,aAAa,CAAC,EAAE,KAAA,OAOxB;AAED;;;;GAIG;AACH,iBAAS,WAAW,CAAC,EAAE,KAAA,OAEtB;AAmLD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC"}

package/dist/wu-repair.js

@@ -0,0 +1,226 @@
+#!/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)
+ */
+import { Command } from 'commander';
+import path from 'node:path';
+import { EXIT_CODES, LOG_PREFIX, PATTERNS } from '@lumenflow/core/dist/wu-constants.js';
+import { runConsistencyRepairMode, runClaimRepairMode, runAdminRepairMode, } from '@lumenflow/core/dist/wu-repair-core.js';
+import { repairStateFile, WU_EVENTS_FILE_NAME } from '@lumenflow/core/dist/wu-state-store.js';
+const PREFIX = LOG_PREFIX.REPAIR;
+/**
+ * Normalise WU ID to uppercase with WU- prefix
+ * @param {string} id - Raw WU ID
+ * @returns {string} Normalised WU ID
+ */
+function normaliseWUId(id) {
+    if (!id)
+        return id;
+    let normalised = id.toUpperCase();
+    if (!normalised.startsWith('WU-')) {
+        normalised = `WU-${normalised}`;
+    }
+    return normalised;
+}
+/**
+ * Validate WU ID format
+ * @param {string} id - WU ID to validate
+ * @returns {boolean} True if valid
+ */
+function isValidWUId(id) {
+    return PATTERNS.WU_ID.test(id);
+}
+/**
+ * Create and configure the CLI program
+ */
+function createProgram() {
+    const program = new Command();
+    program
+        .name('wu-repair')
+        .description('Unified WU repair tool - detect and fix WU state issues\n\n' +
+        'Modes:\n' +
+        '  (default)       Consistency repair - detect/repair state inconsistencies\n' +
+        '  --claim         Claim repair - fix missing claim metadata in worktrees\n' +
+        '  --admin         Admin repair - fix done WUs (lane, status, notes, initiative)\n' +
+        '  --repair-state  State repair - fix corrupted wu-events.jsonl (WU-2240)')
+        // Mode selection flags
+        .option('--claim', 'Claim repair mode: fix missing claim metadata in worktrees')
+        .option('--admin', 'Admin repair mode: fix done WUs (lane, status, notes, initiative)')
+        .option('--repair-state', 'State repair mode: fix corrupted wu-events.jsonl (WU-2240)')
+        // Common flags
+        .option('--id <wuId>', 'WU ID to check/repair (e.g., WU-123)')
+        .option('--check', 'Audit only, no changes (exits 1 if issues found)')
+        // Consistency mode flags
+        .option('--all', 'Check/repair all WUs (consistency mode only)')
+        // Claim mode flags
+        .option('--worktree <path>', 'Override worktree path (claim mode only)')
+        // Admin mode flags
+        .option('--lane <lane>', 'New lane assignment (admin mode only)')
+        .option('--status <status>', 'New status value (admin mode only)')
+        .option('--notes <text>', 'Add/update notes (admin mode only)')
+        .option('--initiative <ref>', 'New initiative reference (admin mode only)')
+        // State repair mode flags
+        .option('--path <path>', 'Path to state file to repair (state mode only)')
+        .parse(process.argv);
+    return program.opts();
+}
+/**
+ * Validate options and exit with error if invalid
+ */
+function validateOptions(options) {
+    // Validate mode selection - only one mode at a time
+    const modes = [options.claim, options.admin, options.repairState].filter(Boolean);
+    if (modes.length > 1) {
+        console.error(`${PREFIX} Error: Cannot specify multiple modes (--claim, --admin, --repair-state are mutually exclusive)`);
+        process.exit(EXIT_CODES.FAILURE);
+    }
+    // Normalise and validate WU ID if provided
+    if (options.id) {
+        options.id = normaliseWUId(options.id);
+        if (!isValidWUId(options.id)) {
+            console.error(`${PREFIX} Error: Invalid WU ID format '${options.id}'`);
+            console.error(`${PREFIX} Expected format: WU-123`);
+            process.exit(EXIT_CODES.FAILURE);
+        }
+    }
+}
+/**
+ * Validate mode-specific requirements
+ */
+function validateModeRequirements(options) {
+    if (options.claim && !options.id) {
+        console.error(`${PREFIX} Error: --id is required for claim mode`);
+        console.error(`${PREFIX} Usage: pnpm wu:repair --claim --id WU-123`);
+        process.exit(EXIT_CODES.FAILURE);
+    }
+    if (options.admin && !options.id) {
+        console.error(`${PREFIX} Error: --id is required for admin mode`);
+        console.error(`${PREFIX} Usage: pnpm wu:repair --admin --id WU-123 --lane "Operations: Tooling"`);
+        process.exit(EXIT_CODES.FAILURE);
+    }
+    // State repair mode has no required options (uses default path if not specified)
+    if (options.repairState) {
+        return; // No additional validation needed
+    }
+    if (!options.claim && !options.admin) {
+        // Consistency mode requirements
+        if (!options.id && !options.all) {
+            console.error(`${PREFIX} Error: Must specify either --id <WU-ID> or --all`);
+            process.exit(EXIT_CODES.FAILURE);
+        }
+        if (options.id && options.all) {
+            console.error(`${PREFIX} Error: Cannot specify both --id and --all`);
+            process.exit(EXIT_CODES.FAILURE);
+        }
+    }
+}
+/**
+ * Run state file repair mode (WU-2240)
+ *
+ * @param {object} options - CLI options
+ * @param {string} [options.path] - Path to state file (defaults to .beacon/state/wu-events.jsonl)
+ * @returns {Promise<{success: boolean, exitCode: number}>}
+ */
+async function runStateRepairMode(options) {
+    // Default path is .beacon/state/wu-events.jsonl relative to cwd
+    const defaultPath = path.join(process.cwd(), '.beacon', 'state', WU_EVENTS_FILE_NAME);
+    const filePath = options.path || defaultPath;
+    console.log(`${PREFIX} Repairing state file: ${filePath}`);
+    try {
+        const result = await repairStateFile(filePath);
+        if (result.linesRemoved === 0 && result.linesKept === 0 && result.backupPath === null) {
+            // File didn't exist
+            console.log(`${PREFIX} File does not exist, nothing to repair`);
+            return { success: true, exitCode: EXIT_CODES.SUCCESS };
+        }
+        console.log(`${PREFIX} Repair complete:`);
+        console.log(`${PREFIX}   Lines kept: ${result.linesKept}`);
+        console.log(`${PREFIX}   Lines removed: ${result.linesRemoved}`);
+        if (result.backupPath) {
+            console.log(`${PREFIX}   Backup created: ${result.backupPath}`);
+        }
+        if (result.warnings.length > 0) {
+            console.log(`${PREFIX} Warnings:`);
+            for (const warning of result.warnings) {
+                console.log(`${PREFIX}   - ${warning}`);
+            }
+        }
+        return { success: true, exitCode: EXIT_CODES.SUCCESS };
+    }
+    catch (error) {
+        console.error(`${PREFIX} Error repairing state file: ${error.message}`);
+        return { success: false, exitCode: EXIT_CODES.FAILURE };
+    }
+}
+/**
+ * Route to appropriate repair mode
+ */
+async function routeToRepairMode(options) {
+    if (options.claim) {
+        return runClaimRepairMode(options);
+    }
+    if (options.admin) {
+        return runAdminRepairMode(options);
+    }
+    if (options.repairState) {
+        return runStateRepairMode(options);
+    }
+    return runConsistencyRepairMode(options);
+}
+async function main() {
+    const options = createProgram();
+    validateOptions(options);
+    validateModeRequirements(options);
+    const result = await routeToRepairMode(options);
+    process.exit(result.exitCode);
+}
+// Guard main() for testability (WU-1366)
+import { fileURLToPath } from 'node:url';
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+    main();
+}
+// Export for testing
+export { normaliseWUId, isValidWUId };

package/dist/wu-repair.js.map

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

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

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

@@ -0,0 +1,30 @@
+/**
+ * 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 function generateCompletionWorkflowSection(id) {
+    return `## Completion Workflow
+
+**CRITICAL: Complete autonomously. Do NOT ask for permission.**
+
+After all acceptance criteria are satisfied:
+
+1. Run gates in the worktree: \`pnpm gates\`
+2. If gates pass, cd back to main checkout
+3. Run: \`pnpm wu:done --id ${id}\`
+
+\`\`\`bash
+# From worktree, after gates pass:
+cd /path/to/main  # NOT the worktree
+pnpm wu:done --id ${id}
+\`\`\`
+
+**wu:done** handles: merge to main, stamp creation, worktree cleanup.
+
+**Do not ask** "should I run wu:done?" — just run it when gates pass.`;
+}