@lumenflow/core 3.2.0 → 3.2.1

package/dist/wu-done-preflight-checks.d.ts

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+/**
+ * Options for branch divergence and merge commit checks.
+ */
+export interface CheckBranchOptions {
+    /** Automatically rebase if diverged */
+    autoRebase?: boolean;
+    /** Path to worktree (required if autoRebase=true) */
+    worktreePath?: string | null;
+    /** WU ID for artifact cleanup (e.g., 'WU-1371') */
+    wuId?: string | null;
+}
+/**
+ * Check for branch drift (commits behind main)
+ * WU-755 pre-flight check
+ *
+ * @param {string} branch - Lane branch name
+ * @returns {Promise<number>} Number of commits behind main
+ */
+export declare function checkBranchDrift(branch: string): Promise<number>;
+/**
+ * Check for branch divergence (main has advanced since branch creation)
+ * WU-1303: Added autoRebase option (default ON) to automatically rebase diverged branches
+ * WU-1371: Added wuId option for post-rebase artifact cleanup
+ *
+ * @param {string} branch - Lane branch name
+ * @param {CheckBranchOptions} [options] - Check options
+ * @throws {Error} If divergence detected and auto-rebase fails or is disabled
+ */
+export declare function checkBranchDivergence(branch: string, options?: CheckBranchOptions): Promise<void>;
+/**
+ * Check for merge commits in lane branch that would violate linear history
+ * WU-1384: GitHub requires linear history; merge commits in lane branches must be eliminated
+ * WU-1371: Added wuId option for post-rebase artifact cleanup
+ *
+ * If merge commits are found, triggers auto-rebase to linearize history.
+ *
+ * @param {string} branch - Lane branch name
+ * @param {CheckBranchOptions} [options] - Check options
+ * @throws {Error} If merge commits found and auto-rebase fails or is disabled
+ */
+export declare function checkMergeCommits(branch: string, options?: CheckBranchOptions): Promise<void>;
+/**
+ * Check for merge conflicts using git merge-tree
+ * WU-755 pre-flight check
+ *
+ * @param {string} branch - Lane branch name
+ */
+export declare function checkMergeConflicts(branch: string): Promise<void>;
+/**
+ * WU-1456: Check for empty merge (no work commits beyond claim)
+ * WU-1460: Upgraded to BLOCK when code_paths defined but files not modified
+ *
+ * Detects when an agent runs wu:done without committing actual work.
+ * - If code_paths defined: BLOCK if those files weren't modified
+ * - If no code_paths: WARNING only (docs-only or metadata updates are valid)
+ *
+ * @param {string} branch - Lane branch name
+ * @param {object} [doc] - WU document with code_paths array (optional for backwards compatibility)
+ * @returns {Promise<void>}
+ * @throws {Error} When code_paths defined but files not modified in commits
+ */
+export declare function checkEmptyMerge(branch: string, doc?: {
+    code_paths?: string[];
+} | null): Promise<void>;
+//# sourceMappingURL=wu-done-preflight-checks.d.ts.map

package/dist/wu-done-preflight-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-done-preflight-checks.d.ts","sourceRoot":"","sources":["../src/wu-done-preflight-checks.ts"],"names":[],"mappings":";AAyCA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA+BtE;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAkDf;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CA2Df;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDvE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,GAAG,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAW,GAC3C,OAAO,CAAC,IAAI,CAAC,CA4Df"}

package/dist/wu-done-preflight-checks.js

@@ -0,0 +1,275 @@
+#!/usr/bin/env node
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU-2014: Pre-merge validation checks for wu:done
+ *
+ * Extracted from wu-done-worktree.ts to enforce single responsibility.
+ * Each function performs one specific pre-flight check before merge.
+ *
+ * Functions:
+ *   checkBranchDrift      - Verify branch is not too far behind main
+ *   checkBranchDivergence - Detect and optionally auto-rebase diverged branches
+ *   checkMergeCommits     - Detect merge commits that violate linear history
+ *   checkMergeConflicts   - Detect merge conflicts using git merge-tree
+ *   checkEmptyMerge       - Detect empty merges with no work commits
+ */
+import { spawnSync } from 'node:child_process';
+import { getGitForCwd } from './git-adapter.js';
+import { BRANCHES, REMOTES, THRESHOLDS, LOG_PREFIX, STRING_LITERALS, GIT_COMMANDS, GIT_FLAGS, } from './wu-constants.js';
+import { PREFLIGHT } from './wu-done-messages.js';
+import { createError, ErrorCodes, getErrorMessage } from './error-handler.js';
+import { createValidationError } from './wu-done-errors.js';
+import { autoRebaseBranch } from './wu-done-rebase.js';
+function isErrorWithCode(error, code) {
+    if (typeof error !== 'object' || error === null || !('code' in error)) {
+        return false;
+    }
+    return error.code === code;
+}
+/**
+ * Check for branch drift (commits behind main)
+ * WU-755 pre-flight check
+ *
+ * @param {string} branch - Lane branch name
+ * @returns {Promise<number>} Number of commits behind main
+ */
+export async function checkBranchDrift(branch) {
+    const gitAdapter = getGitForCwd();
+    try {
+        const counts = await gitAdapter.revList([
+            '--left-right',
+            '--count',
+            `${BRANCHES.MAIN}...${branch}`,
+        ]);
+        const [mainAheadRaw] = counts.split(/\s+/).map(Number);
+        const mainAhead = typeof mainAheadRaw === 'number' && Number.isFinite(mainAheadRaw) ? mainAheadRaw : 0;
+        if (mainAhead > THRESHOLDS.BRANCH_DRIFT_MAX) {
+            throw createError(ErrorCodes.GIT_ERROR, PREFLIGHT.BRANCH_DRIFT_ERROR(mainAhead, THRESHOLDS.BRANCH_DRIFT_MAX, REMOTES.ORIGIN, BRANCHES.MAIN), { branch, commitsBehind: mainAhead, threshold: THRESHOLDS.BRANCH_DRIFT_MAX });
+        }
+        return mainAhead;
+    }
+    catch (e) {
+        if (isErrorWithCode(e, ErrorCodes.GIT_ERROR))
+            throw e;
+        console.warn(`${LOG_PREFIX.DONE} Warning: Could not check branch drift: ${getErrorMessage(e)}`);
+        return 0;
+    }
+}
+/**
+ * Check for branch divergence (main has advanced since branch creation)
+ * WU-1303: Added autoRebase option (default ON) to automatically rebase diverged branches
+ * WU-1371: Added wuId option for post-rebase artifact cleanup
+ *
+ * @param {string} branch - Lane branch name
+ * @param {CheckBranchOptions} [options] - Check options
+ * @throws {Error} If divergence detected and auto-rebase fails or is disabled
+ */
+export async function checkBranchDivergence(branch, options = {}) {
+    const { autoRebase = true, worktreePath = null, wuId = null } = options;
+    const gitAdapter = getGitForCwd();
+    try {
+        const mergeBase = await gitAdapter.mergeBase(BRANCHES.MAIN, branch);
+        const mainHead = await gitAdapter.getCommitHash(BRANCHES.MAIN);
+        if (mergeBase !== mainHead) {
+            const mainCommitsAhead = await gitAdapter.revList([
+                '--count',
+                `${mergeBase}..${BRANCHES.MAIN}`,
+            ]);
+            const commitCount = Number(mainCommitsAhead);
+            console.log(PREFLIGHT.DIVERGENCE_DETECTED(commitCount));
+            // Attempt auto-rebase if enabled and worktree path provided
+            if (autoRebase && worktreePath) {
+                const rebaseResult = await autoRebaseBranch(branch, worktreePath, wuId);
+                if (rebaseResult.success) {
+                    // Rebase succeeded - continue with wu:done
+                    return;
+                }
+                // Rebase failed - throw with detailed instructions
+                throw createError(ErrorCodes.GIT_ERROR, rebaseResult.error, {
+                    branch,
+                    mergeBase,
+                    mainHead,
+                    mainCommitsAhead: commitCount,
+                    autoRebaseAttempted: true,
+                });
+            }
+            // Auto-rebase disabled or no worktree path - throw with manual instructions
+            throw createError(ErrorCodes.GIT_ERROR, PREFLIGHT.DIVERGENCE_ERROR(commitCount, REMOTES.ORIGIN, BRANCHES.MAIN, branch), { branch, mergeBase, mainHead, mainCommitsAhead: commitCount });
+        }
+        console.log(PREFLIGHT.NO_DIVERGENCE);
+    }
+    catch (e) {
+        if (isErrorWithCode(e, ErrorCodes.GIT_ERROR))
+            throw e;
+        console.warn(`${LOG_PREFIX.DONE} Warning: Could not check branch divergence: ${getErrorMessage(e)}`);
+    }
+}
+/**
+ * Check for merge commits in lane branch that would violate linear history
+ * WU-1384: GitHub requires linear history; merge commits in lane branches must be eliminated
+ * WU-1371: Added wuId option for post-rebase artifact cleanup
+ *
+ * If merge commits are found, triggers auto-rebase to linearize history.
+ *
+ * @param {string} branch - Lane branch name
+ * @param {CheckBranchOptions} [options] - Check options
+ * @throws {Error} If merge commits found and auto-rebase fails or is disabled
+ */
+export async function checkMergeCommits(branch, options = {}) {
+    const { autoRebase = true, worktreePath = null, wuId = null } = options;
+    const gitAdapter = getGitForCwd();
+    try {
+        // Find merge commits in lane branch that are not in main
+        // --merges: only merge commits
+        // main..branch: commits in branch not reachable from main
+        const mergeCommitsRaw = await gitAdapter.raw([
+            'rev-list',
+            '--merges',
+            `${BRANCHES.MAIN}..${branch}`,
+        ]);
+        const mergeCommits = mergeCommitsRaw.trim().split(STRING_LITERALS.NEWLINE).filter(Boolean);
+        const mergeCount = mergeCommits.length;
+        if (mergeCount > 0) {
+            console.log(PREFLIGHT.MERGE_COMMITS_DETECTED(mergeCount));
+            // Trigger rebase to eliminate merge commits
+            if (autoRebase && worktreePath) {
+                console.log(PREFLIGHT.MERGE_COMMITS_REBASING);
+                const rebaseResult = await autoRebaseBranch(branch, worktreePath, wuId);
+                if (rebaseResult.success) {
+                    // Rebase succeeded - merge commits eliminated
+                    return;
+                }
+                // Rebase failed - throw with detailed instructions
+                throw createError(ErrorCodes.GIT_ERROR, rebaseResult.error, {
+                    branch,
+                    mergeCommitCount: mergeCount,
+                    autoRebaseAttempted: true,
+                });
+            }
+            // Auto-rebase disabled or no worktree path - throw with manual instructions
+            throw createError(ErrorCodes.GIT_ERROR, `Branch ${branch} contains ${mergeCount} merge commit(s).\n\n` +
+                `GitHub requires linear history. Merge commits must be eliminated.\n\n` +
+                `REQUIRED: Rebase your branch to linearize history:\n` +
+                `  1. cd into your worktree\n` +
+                `  2. git fetch ${REMOTES.ORIGIN} ${BRANCHES.MAIN}\n` +
+                `  3. git rebase ${REMOTES.ORIGIN}/${BRANCHES.MAIN}\n` +
+                `  4. git push --force-with-lease ${REMOTES.ORIGIN} ${branch}\n` +
+                `  5. Return to main checkout and retry`, { branch, mergeCommitCount: mergeCount });
+        }
+        console.log(PREFLIGHT.NO_MERGE_COMMITS);
+    }
+    catch (e) {
+        if (isErrorWithCode(e, ErrorCodes.GIT_ERROR))
+            throw e;
+        console.warn(`${LOG_PREFIX.DONE} Warning: Could not check for merge commits: ${getErrorMessage(e)}`);
+    }
+}
+/**
+ * Check for merge conflicts using git merge-tree
+ * WU-755 pre-flight check
+ *
+ * @param {string} branch - Lane branch name
+ */
+export async function checkMergeConflicts(branch) {
+    const MERGE_TREE_CONFLICT_EXIT_CODE = 1;
+    try {
+        // Use git exit status for conflict detection (status=1 indicates conflicts).
+        // This avoids brittle parsing of merge-tree output text.
+        const result = spawnSync(GIT_COMMANDS.GIT, [GIT_COMMANDS.MERGE_TREE, GIT_FLAGS.WRITE_TREE, BRANCHES.MAIN, branch], {
+            cwd: process.cwd(),
+            encoding: 'utf-8',
+        });
+        if (result.error) {
+            console.warn(`${LOG_PREFIX.DONE} Warning: Could not check merge conflicts: ${result.error.message}`);
+            return;
+        }
+        if (result.status === 0) {
+            console.log(PREFLIGHT.NO_CONFLICTS);
+            return;
+        }
+        if (result.status === MERGE_TREE_CONFLICT_EXIT_CODE) {
+            throw createError(ErrorCodes.GIT_ERROR, PREFLIGHT.CONFLICT_ERROR(REMOTES.ORIGIN, BRANCHES.MAIN), {
+                branch,
+                operation: 'merge-tree --write-tree',
+            });
+        }
+        const stderr = typeof result.stderr === 'string' ? result.stderr.trim() : '';
+        const detail = stderr ||
+            `${GIT_COMMANDS.GIT} ${GIT_COMMANDS.MERGE_TREE} exited with status ${String(result.status)}`;
+        console.warn(`${LOG_PREFIX.DONE} Warning: Could not check merge conflicts: ${detail}`);
+    }
+    catch (e) {
+        if (isErrorWithCode(e, ErrorCodes.GIT_ERROR))
+            throw e;
+        const message = getErrorMessage(e);
+        console.warn(`${LOG_PREFIX.DONE} Warning: Could not check merge conflicts: ${message}`);
+    }
+}
+/**
+ * WU-1456: Check for empty merge (no work commits beyond claim)
+ * WU-1460: Upgraded to BLOCK when code_paths defined but files not modified
+ *
+ * Detects when an agent runs wu:done without committing actual work.
+ * - If code_paths defined: BLOCK if those files weren't modified
+ * - If no code_paths: WARNING only (docs-only or metadata updates are valid)
+ *
+ * @param {string} branch - Lane branch name
+ * @param {object} [doc] - WU document with code_paths array (optional for backwards compatibility)
+ * @returns {Promise<void>}
+ * @throws {Error} When code_paths defined but files not modified in commits
+ */
+export async function checkEmptyMerge(branch, doc = null) {
+    const gitAdapter = getGitForCwd();
+    try {
+        // Count commits on lane branch that are not in main
+        const commitCountRaw = await gitAdapter.raw([
+            'rev-list',
+            '--count',
+            `${BRANCHES.MAIN}..${branch}`,
+        ]);
+        const commitCount = Number(commitCountRaw.trim());
+        // WU-1460: If code_paths defined, verify those files were modified
+        const codePaths = Array.isArray(doc?.code_paths)
+            ? doc.code_paths.filter((filePath) => typeof filePath === 'string')
+            : [];
+        const hasCodePaths = codePaths.length > 0;
+        if (hasCodePaths) {
+            // Get list of files modified in lane branch commits
+            const modifiedFilesRaw = await gitAdapter.raw([
+                'diff',
+                '--name-only',
+                `${BRANCHES.MAIN}...${branch}`,
+            ]);
+            const modifiedFiles = modifiedFilesRaw.trim().split('\n').filter(Boolean);
+            // Check if code_paths files are in the modified list
+            const missingCodePaths = codePaths.filter((codePath) => !modifiedFiles.some((modified) => modified.includes(codePath) || codePath.includes(modified)));
+            if (missingCodePaths.length > 0) {
+                // BLOCK: code_paths defined but files not modified
+                throw createValidationError(PREFLIGHT.CODE_PATHS_NOT_MODIFIED(missingCodePaths), {
+                    branch,
+                    codePaths,
+                    missingCodePaths,
+                    modifiedFiles,
+                });
+            }
+            // All code_paths files were modified
+            console.log(PREFLIGHT.CODE_PATHS_VERIFIED);
+        }
+        else if (commitCount <= 1) {
+            // No code_paths - just warn (backwards compatible behaviour)
+            // If only 0-1 commits beyond main, this is likely the claim commit only
+            console.log(PREFLIGHT.EMPTY_MERGE_WARNING(commitCount));
+        }
+        else {
+            console.log(PREFLIGHT.EMPTY_MERGE_CHECK);
+        }
+    }
+    catch (e) {
+        // Re-throw validation errors (WU-1460 blocker)
+        if (isErrorWithCode(e, ErrorCodes.VALIDATION_ERROR))
+            throw e;
+        console.warn(`${LOG_PREFIX.DONE} Warning: Could not check for empty merge: ${getErrorMessage(e)}`);
+    }
+}
+//# sourceMappingURL=wu-done-preflight-checks.js.map

package/dist/wu-done-preflight-checks.js.map

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

package/dist/wu-done-preflight.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Preflight validation helpers for wu:done.
+ */
+import { validatePreflight } from './wu-preflight-validators.js';
+interface PreflightPaths {
+    rootDir: string;
+    worktreePath?: string | null;
+}
+interface PreflightCodePathValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    missingCodePaths: string[];
+    missingCoverageCodePaths: string[];
+    missingTestPaths: string[];
+    suggestedTestPaths?: Record<string, string[]>;
+    abortedBeforeGates: boolean;
+}
+interface PreflightTaskValidationResult {
+    valid: boolean;
+    errors: string[];
+    abortedBeforeMerge: boolean;
+    localMainModified: boolean;
+    hasStampStatusError: boolean;
+}
+/**
+ * WU-1781: Build preflight error message with actionable guidance
+ */
+export declare function buildPreflightErrorMessage(id: string, errors: string[]): string;
+/**
+ * WU-1805: Execute preflight code_paths and test_paths validation
+ */
+export interface ExecutePreflightCodePathValidationOptions {
+    /** Override validatePreflight for testing */
+    validatePreflightFn?: typeof validatePreflight;
+    /** Optional base ref for reality-phase diff checks */
+    baseRef?: string;
+    /** Optional head ref for reality-phase diff checks */
+    headRef?: string;
+}
+export declare function executePreflightCodePathValidation(id: string, paths: PreflightPaths, options?: ExecutePreflightCodePathValidationOptions): Promise<PreflightCodePathValidationResult>;
+/**
+ * WU-1805: Build preflight code_paths error message with actionable guidance
+ */
+export declare function buildPreflightCodePathErrorMessage(id: string, result: PreflightCodePathValidationResult): string;
+/**
+ * WU-1781: Run wu:validate as preflight check before git operations
+ */
+export declare function runPreflightTasksValidation(id: string): PreflightTaskValidationResult;
+/**
+ * WU-2308: Validate all pre-commit hooks with worktree context
+ */
+export interface ValidateAllPreCommitHooksOptions {
+    runGates?: (options: {
+        cwd?: string;
+        docsOnly?: boolean;
+        wuId?: string;
+    }) => Promise<boolean>;
+}
+export declare function validateAllPreCommitHooks(id: string, worktreePath?: string | null, options?: ValidateAllPreCommitHooksOptions): Promise<{
+    valid: boolean;
+    errors: string[];
+}>;
+export {};
+//# sourceMappingURL=wu-done-preflight.d.ts.map

package/dist/wu-done-preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-done-preflight.d.ts","sourceRoot":"","sources":["../src/wu-done-preflight.ts"],"names":[],"mappings":"AAGA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAKjE,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,UAAU,iCAAiC;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9C,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,UAAU,6BAA6B;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAqC/E;AAED;;GAEG;AACH,MAAM,WAAW,yCAAyC;IACxD,6CAA6C;IAC7C,mBAAmB,CAAC,EAAE,OAAO,iBAAiB,CAAC;IAC/C,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,kCAAkC,CACtD,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,cAAc,EACrB,OAAO,GAAE,yCAA8C,GACtD,OAAO,CAAC,iCAAiC,CAAC,CAuC5C;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,iCAAiC,GACxC,MAAM,CA8ER;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,EAAE,EAAE,MAAM,GAAG,6BAA6B,CA0BrF;AAED;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/F;AAED,wBAAsB,yBAAyB,CAC7C,EAAE,EAAE,MAAM,EACV,YAAY,GAAE,MAAM,GAAG,IAAW,EAClC,OAAO,GAAE,gCAAqC,GAC7C,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAqC/C"}

package/dist/wu-done-preflight.js

@@ -0,0 +1,205 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Preflight validation helpers for wu:done.
+ */
+import { validatePreflight } from './wu-preflight-validators.js';
+import { LOG_PREFIX, EMOJI } from './wu-constants.js';
+import { WU_PATHS } from './wu-paths.js';
+import { validateSingleWU } from './validators/wu-tasks.js';
+/**
+ * WU-1781: Build preflight error message with actionable guidance
+ */
+export function buildPreflightErrorMessage(id, errors) {
+    const hasStampStatusError = errors.some((error) => error.includes('stamp but status is not done'));
+    let message = `
+❌ PREFLIGHT VALIDATION FAILED
+
+wu:validate found errors that would block pre-push hooks.
+Aborting wu:done BEFORE merge operations to prevent deadlocks.
+
+Errors:
+${errors.map((error) => `  - ${error}`).join('\n')}
+
+Fix options:
+`;
+    if (hasStampStatusError) {
+        message += `
+  For stamp-status mismatch errors:
+  1. Fix the WU status to match the stamp (set status: done, locked: true)
+  2. Or add the WU ID to workspace.yaml > software_delivery > exemptions > stamp_status_mismatch
+
+`;
+    }
+    message += `
+  General fixes:
+  1. Run: pnpm wu:validate to see full errors
+  2. Fix the validation errors
+  3. Retry: pnpm wu:done --id ${id}
+
+This preflight check prevents wu:done from leaving main in a stuck state
+where husky pre-push would block all further operations.
+`;
+    return message;
+}
+export async function executePreflightCodePathValidation(id, paths, options = {}) {
+    // Use injected validator for testability, default to actual implementation
+    const validatePreflightFn = options.validatePreflightFn || validatePreflight;
+    console.log(`\n${LOG_PREFIX.DONE} 🔍 Preflight: validating code_paths and test paths...`);
+    const result = await validatePreflightFn(id, {
+        rootDir: paths.rootDir,
+        worktreePath: paths.worktreePath,
+        phase: 'reality',
+        baseRef: options.baseRef,
+        headRef: options.headRef,
+    });
+    if (result.valid) {
+        console.log(`${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Preflight code_paths validation passed`);
+        return {
+            valid: true,
+            errors: [],
+            warnings: result.warnings || [],
+            missingCodePaths: [],
+            missingCoverageCodePaths: [],
+            missingTestPaths: [],
+            abortedBeforeGates: false,
+        };
+    }
+    console.error(`\n${LOG_PREFIX.DONE} ${EMOJI.FAILURE} Preflight code_paths validation failed`);
+    return {
+        valid: false,
+        errors: result.errors,
+        warnings: result.warnings || [],
+        missingCodePaths: result.missingCodePaths || [],
+        missingCoverageCodePaths: result.missingCoverageCodePaths || [],
+        missingTestPaths: result.missingTestPaths || [],
+        suggestedTestPaths: result.suggestedTestPaths || {},
+        abortedBeforeGates: true,
+    };
+}
+/**
+ * WU-1805: Build preflight code_paths error message with actionable guidance
+ */
+export function buildPreflightCodePathErrorMessage(id, result) {
+    const { errors, missingCodePaths = [], missingCoverageCodePaths = [], missingTestPaths = [], suggestedTestPaths = {}, } = result;
+    let message = `
+❌ PREFLIGHT CODE_PATHS VALIDATION FAILED
+
+code_paths/test_paths validation found errors that would cause gates to fail.
+Aborting wu:done BEFORE running gates to save time.
+
+Errors:
+${errors.map((error) => `  ${error}`).join('\n')}
+
+`;
+    if (missingCodePaths.length > 0) {
+        message += `
+Fix options for missing code_paths:
+  1. Create the missing files in your worktree
+  2. Update code_paths in ${id}.yaml using: pnpm wu:edit --id ${id} --code-paths "<corrected-paths>"
+  3. Remove paths that were intentionally not created
+
+`;
+    }
+    if (missingCoverageCodePaths.length > 0) {
+        message += `
+Fix options for code_paths coverage (branch diff):
+  1. Commit changes that touch each missing scoped code_path
+  2. Update code_paths in ${id}.yaml to match actual branch scope
+  3. Re-run: pnpm wu:prep --id ${id} (or wu:done when ready)
+
+`;
+    }
+    if (missingTestPaths.length > 0) {
+        message += `
+Fix options for missing test_paths:
+  1. Create the missing test files
+  2. Update test paths in ${id}.yaml using wu:edit
+  3. Use tests.manual for descriptions instead of file paths
+
+`;
+    }
+    // Add suggested paths if available
+    const suggestionsMap = suggestedTestPaths;
+    const hasSuggestions = Object.keys(suggestionsMap).some((missingPath) => (suggestionsMap[missingPath] ?? []).length > 0);
+    if (hasSuggestions) {
+        message += `Suggested alternatives found:
+`;
+        for (const [missingPath, suggestions] of Object.entries(suggestionsMap)) {
+            if (suggestions.length > 0) {
+                message += `For "${missingPath}":
+${suggestions.map((s) => `  - ${s}`).join('\n')}
+
+`;
+            }
+        }
+    }
+    message += `
+After fixing, retry:
+  pnpm wu:done --id ${id}
+
+This preflight check runs BEFORE gates to catch YAML mismatches early.
+See: https://lumenflow.dev/reference/troubleshooting-wu-done/ for more recovery options.
+`;
+    return message;
+}
+/**
+ * WU-1781: Run wu:validate as preflight check before git operations
+ */
+export function runPreflightTasksValidation(id) {
+    console.log(`\n${LOG_PREFIX.DONE} 🔍 Preflight: running wu:validate...`);
+    const wuPath = WU_PATHS.WU(id);
+    const result = validateSingleWU(wuPath, { strict: false });
+    if (result.valid) {
+        console.log(`${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Preflight wu:validate passed`);
+        return {
+            valid: true,
+            errors: [],
+            abortedBeforeMerge: false,
+            localMainModified: false,
+            hasStampStatusError: false,
+        };
+    }
+    console.error(`\n${LOG_PREFIX.DONE} ${EMOJI.FAILURE} Preflight wu:validate failed`);
+    return {
+        valid: false,
+        errors: result.errors ?? [],
+        abortedBeforeMerge: true,
+        localMainModified: false,
+        hasStampStatusError: false,
+    };
+}
+export async function validateAllPreCommitHooks(id, worktreePath = null, options = {}) {
+    console.log(`\n${LOG_PREFIX.DONE} 🔍 Pre-flight: validating all pre-commit hooks...`);
+    const errors = [];
+    try {
+        // WU-2308: Run from worktree context when provided to ensure audit checks
+        // the worktree's dependencies (with fixes) not main's stale dependencies
+        if (!options.runGates) {
+            throw new Error('runGates not provided for pre-commit validation.');
+        }
+        const ok = await options.runGates({
+            cwd: worktreePath ?? process.cwd(),
+            wuId: id,
+        });
+        if (ok) {
+            console.log(`${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} All pre-commit hooks passed`);
+            return { valid: true, errors: [] };
+        }
+        throw new Error('Pre-commit hooks failed.');
+    }
+    catch {
+        // Pre-commit hooks failed
+        errors.push('Pre-commit hook validation failed. Fix these issues before wu:done:');
+        errors.push('');
+        errors.push('Common fixes:');
+        errors.push('  • Formatting issues: Run pnpm format');
+        errors.push('  • Lint errors: Run pnpm lint:fix');
+        errors.push('  • Type errors: Check pnpm typecheck output');
+        errors.push('  • Audit issues: Check pnpm audit output');
+        errors.push('');
+        errors.push(`After fixing, re-run: pnpm wu:done --id ${id}`);
+        return { valid: false, errors };
+    }
+}
+//# sourceMappingURL=wu-done-preflight.js.map

package/dist/wu-done-preflight.js.map

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