@lumenflow/core 3.1.2 → 3.2.0

package/dist/wu-done-retry-helpers.js

@@ -1,175 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * WU-1584: Retry and recovery helpers for wu:done
- *
- * Handles:
- * - Squashing duplicate completion commits from retry attempts
- * - Detecting and counting previous completion attempts
- * - Preparing zombie recovery with squash
- * - Handling parallel completions with auto-rebase
- *
- * @module wu-done-retry-helpers
- */
-import { LOG_PREFIX, EMOJI, GIT, GIT_COMMANDS, GIT_FLAGS, GIT_REFS, STRING_LITERALS, } from './wu-constants.js';
-import { createError, ErrorCodes } from './error-handler.js';
-/**
- * Regex to match wu:done completion commit messages
- * Format: wu(<id>): done - <title>
- *
- * Note: Does not use ^ anchor to allow matching within git log --oneline output
- * which includes commit hash prefix: "abc1234 wu(wu-500): done - title"
- *
- * @constant {RegExp}
- */
-const COMPLETION_COMMIT_PATTERN = /wu\(([^)]+)\):\s*done\s*-/i;
-/**
- * Count previous completion attempt commits for a WU on the current branch
- *
- * WU-1584 Fix #1: Detect duplicate commits from retries
- *
- * Searches commit history for commits matching the completion pattern
- * for the specified WU ID.
- *
- * @param {string} wuId - WU ID (e.g., 'WU-1584')
- * @param {object} gitAdapter - Git adapter instance
- * @returns {Promise<number>} Number of completion attempt commits found
- */
-export async function countPreviousCompletionAttempts(wuId, gitAdapter) {
-    const normalizedId = wuId.toLowerCase();
-    try {
-        // Get recent commit history (limit to reasonable amount)
-        const log = await gitAdapter.log({ maxCount: GIT.LOG_MAX_COUNT });
-        if (!log || !log.all) {
-            return 0;
-        }
-        // Count trailing completion attempts on the branch tip only.
-        // This avoids accidentally squashing unrelated commits if the history contains
-        // older completion commits that are not part of the current retry chain.
-        let trailingCount = 0;
-        for (const commit of log.all) {
-            const match = commit.message.match(COMPLETION_COMMIT_PATTERN);
-            if (!match)
-                break;
-            const commitWuId = match[1].toLowerCase();
-            if (commitWuId !== normalizedId)
-                break;
-            trailingCount += 1;
-        }
-        return trailingCount;
-    }
-    catch (error) {
-        console.warn(`${LOG_PREFIX.DONE} ${EMOJI.WARNING} Could not count previous attempts: ${error.message}`);
-        return 0;
-    }
-}
-export async function squashPreviousCompletionAttempts(wuId, count, gitAdapter, options = {}) {
-    const { preserveIndex = true } = options;
-    if (count === 0) {
-        return { squashed: false, count: 0 };
-    }
-    console.log(`${LOG_PREFIX.DONE} ${EMOJI.WARNING} Detected ${count} previous completion attempt commit(s)`);
-    console.log(`${LOG_PREFIX.DONE} ${EMOJI.INFO} Squashing previous attempts to avoid duplicate commits...`);
-    try {
-        // In the normal retry flow we need to preserve the staged metadata transaction,
-        // so we use --soft (index/working tree unchanged).
-        //
-        // In zombie recovery we want to drop prior completion commits cleanly and start
-        // from a known-good state, so we use --hard (index/working tree reset).
-        if (!preserveIndex) {
-            const status = (await gitAdapter.getStatus())?.trim?.() ?? '';
-            if (status) {
-                throw createError(ErrorCodes.RECOVERY_ERROR, `Cannot squash previous attempts: worktree has uncommitted changes.${STRING_LITERALS.NEWLINE}${STRING_LITERALS.NEWLINE}` +
-                    `Fix: In your worktree, run:${STRING_LITERALS.NEWLINE}` +
-                    `  ${GIT_COMMANDS.GIT} status${STRING_LITERALS.NEWLINE}` +
-                    `  ${GIT_COMMANDS.GIT} restore -SW .${STRING_LITERALS.NEWLINE}` +
-                    `Then retry wu:done.${STRING_LITERALS.NEWLINE}`, { wuId, count, preserveIndex, status });
-            }
-        }
-        const resetMode = preserveIndex ? GIT_FLAGS.SOFT : GIT_FLAGS.HARD;
-        const headBackRef = `${GIT_REFS.HEAD}~${count}`;
-        await gitAdapter.raw([GIT_COMMANDS.RESET, resetMode, headBackRef]);
-        console.log(`${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Squashed ${count} previous attempt(s) - will create single completion commit`);
-        return { squashed: true, count };
-    }
-    catch (error) {
-        console.warn(`${LOG_PREFIX.DONE} ${EMOJI.WARNING} Could not squash previous attempts: ${error.message}`);
-        return { squashed: false, count: 0 };
-    }
-}
-/**
- * Prepare zombie recovery with squash of previous attempts
- *
- * WU-1584 Fix #2: Recovery loop should squash previous attempt commits
- *
- * When recovering from zombie state (status=done but worktree exists),
- * first squash UnsafeAny previous completion attempts to avoid "rebase hell".
- *
- * @param {string} wuId - WU ID
- * @param {object} gitAdapter - Git adapter instance
- * @returns {Promise<{ squashedCount: number }>} Result
- */
-export async function prepareRecoveryWithSquash(wuId, gitAdapter) {
-    console.log(`${LOG_PREFIX.DONE} ${EMOJI.INFO} Checking for previous completion attempts before recovery...`);
-    const previousCount = await countPreviousCompletionAttempts(wuId, gitAdapter);
-    if (previousCount > 0) {
-        console.log(`${LOG_PREFIX.DONE} Squashing ${previousCount} previous completion attempt(s) for clean recovery`);
-        // Recovery: do not preserve index; reset to a clean state before continuing.
-        const result = await squashPreviousCompletionAttempts(wuId, previousCount, gitAdapter, {
-            preserveIndex: false,
-        });
-        return { squashedCount: result.squashed ? result.count : 0 };
-    }
-    return { squashedCount: 0 };
-}
-export async function handleParallelCompletions(wuId, doc, gitAdapter, options = {}) {
-    const { worktreePath, autoRebase = true } = options;
-    // Fetch latest from origin
-    await gitAdapter.fetch();
-    // Get current origin/main SHA
-    const currentMainSha = await gitAdapter.getCommitHash('origin/main');
-    // Get baseline SHA from when WU was claimed
-    const baselineSha = doc.baseline_main_sha;
-    if (!baselineSha || currentMainSha === baselineSha) {
-        // No parallel completions - main hasn't changed since claim
-        return { parallelDetected: false, rebaseTriggered: false };
-    }
-    // Check if changes since baseline include other WU completions
-    const newCommits = await gitAdapter.raw([
-        'log',
-        '--oneline',
-        `${baselineSha}..origin/main`,
-        '--',
-    ]);
-    const hasParallelCompletions = newCommits && newCommits.trim() && COMPLETION_COMMIT_PATTERN.test(newCommits);
-    if (!hasParallelCompletions) {
-        // Changes exist but are not WU completions - proceed normally
-        return { parallelDetected: false, rebaseTriggered: false };
-    }
-    // Parallel completions detected
-    console.log(`${LOG_PREFIX.DONE} ${EMOJI.WARNING} Parallel completion(s) detected on main since WU claim`);
-    if (!autoRebase) {
-        throw createError(ErrorCodes.VALIDATION_ERROR, `Parallel completions detected on main since ${wuId} was claimed.\n` +
-            `This would cause merge conflicts during wu:done.\n\n` +
-            `Fix: Run 'git fetch origin && git rebase origin/main' in your worktree,\n` +
-            `then retry wu:done.\n\n` +
-            `Or use --no-auto-rebase to disable this check (not recommended).`, { wuId, baselineSha, currentMainSha });
-    }
-    // Trigger auto-rebase
-    console.log(`${LOG_PREFIX.DONE} ${EMOJI.INFO} Triggering auto-rebase to incorporate parallel completions...`);
-    try {
-        // Rebase the current branch onto origin/main
-        await gitAdapter.rebase('origin/main');
-        console.log(`${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} Auto-rebase complete - parallel completions incorporated`);
-        return { parallelDetected: true, rebaseTriggered: true };
-    }
-    catch (error) {
-        throw createError(ErrorCodes.GIT_ERROR, `Auto-rebase failed: ${error.message}\n\n` +
-            `Manual resolution required:\n` +
-            `1. cd ${worktreePath || 'your-worktree'}\n` +
-            `2. git fetch origin && git rebase origin/main\n` +
-            `3. Resolve conflicts if UnsafeAny\n` +
-            `4. Retry wu:done`, { wuId, originalError: error.message });
-    }
-}
-//# sourceMappingURL=wu-done-retry-helpers.js.map

package/dist/wu-done-retry-helpers.js.map

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

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

@@ -1,29 +0,0 @@
-/**
- * Print prominent gate failure box
- *
- * Consolidated from two duplicate implementations in wu-done.ts
- * (worktree mode and branch-only mode). Uses pretty-ms for
- * human-readable duration formatting.
- *
- * @param {object} options - Failure info
- * @param {string} options.id - WU ID (e.g., 'WU-123')
- * @param {string} options.location - Location description (worktree path or 'Branch-Only')
- * @param {number} options.durationMs - Duration in milliseconds
- * @param {boolean} [options.isWorktreeMode=true] - True for worktree mode, false for branch-only
- */
-export declare function printGateFailureBox({ id, location, durationMs, isWorktreeMode, }: {
-    id: string;
-    location: string;
-    durationMs: number;
-    isWorktreeMode?: boolean;
-}): void;
-/**
- * Print git status preview with truncation
- *
- * Shows first N lines of git status output with indication
- * of how many more files exist. Parses output once (not three times).
- *
- * @param {string} statusOutput - Raw git status --porcelain output
- */
-export declare function printStatusPreview(statusOutput: UnsafeAny): void;
-//# sourceMappingURL=wu-done-ui.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"wu-done-ui.d.ts","sourceRoot":"","sources":["../src/wu-done-ui.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,EAAE,EACF,QAAQ,EACR,UAAU,EACV,cAAqB,GACtB,EAAE;IACD,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,QA6BA;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,SAAS,QAczD"}

package/dist/wu-done-ui.js

@@ -1,74 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * WU Done UI Helpers
- *
- * WU-1281: Extracted display helpers to consolidate DRY violations
- * and use library-first duration formatting.
- *
- * @see {@link packages/@lumenflow/cli/src/wu-done.ts} - Primary consumer
- * @see {@link packages/@lumenflow/cli/src/lib/wu-constants.ts} - UI constants
- */
-import prettyMs from 'pretty-ms';
-import { UI, LOG_PREFIX, STRING_LITERALS } from './wu-constants.js';
-/**
- * Print prominent gate failure box
- *
- * Consolidated from two duplicate implementations in wu-done.ts
- * (worktree mode and branch-only mode). Uses pretty-ms for
- * human-readable duration formatting.
- *
- * @param {object} options - Failure info
- * @param {string} options.id - WU ID (e.g., 'WU-123')
- * @param {string} options.location - Location description (worktree path or 'Branch-Only')
- * @param {number} options.durationMs - Duration in milliseconds
- * @param {boolean} [options.isWorktreeMode=true] - True for worktree mode, false for branch-only
- */
-export function printGateFailureBox({ id, location, durationMs, isWorktreeMode = true, }) {
-    const width = UI.ERROR_BOX_WIDTH;
-    const duration = prettyMs(durationMs, { secondsDecimalDigits: 0 });
-    console.error(`\n${'═'.repeat(width)}`);
-    console.error('❌ WU:DONE FAILED - GATES DID NOT PASS');
-    console.error('═'.repeat(width));
-    console.error(`WU ID:     ${id}`);
-    console.error(`${isWorktreeMode ? 'Worktree' : 'Mode'}:  ${isWorktreeMode ? location : 'Branch-Only'}`);
-    console.error(`Duration:  ${duration}`);
-    console.error('─'.repeat(width));
-    console.error('Next steps:');
-    if (isWorktreeMode) {
-        console.error(`  1. cd ${location}`);
-        console.error('  2. Review gate output above to identify failures');
-        console.error('  3. Fix issues in the worktree');
-        console.error('  4. Run: pnpm gates');
-        console.error(`  5. cd back to main and re-run: pnpm wu:done --id ${id}`);
-    }
-    else {
-        console.error('  1. Review gate output above to identify failures');
-        console.error('  2. Fix issues on the lane branch');
-        console.error('  3. Run: pnpm gates');
-        console.error(`  4. Re-run: pnpm wu:done --id ${id}`);
-    }
-    console.error(`${'═'.repeat(width)}\n`);
-}
-/**
- * Print git status preview with truncation
- *
- * Shows first N lines of git status output with indication
- * of how many more files exist. Parses output once (not three times).
- *
- * @param {string} statusOutput - Raw git status --porcelain output
- */
-export function printStatusPreview(statusOutput) {
-    const lines = statusOutput
-        .split(STRING_LITERALS.NEWLINE)
-        .filter((line) => line.trim());
-    const previewLimit = UI.STATUS_PREVIEW_LINES;
-    const preview = lines.slice(0, previewLimit);
-    console.warn(`${LOG_PREFIX.DONE} ⚠️  Working tree still has changes after rollback:`);
-    console.warn(preview.join(STRING_LITERALS.NEWLINE));
-    if (lines.length > previewLimit) {
-        console.warn(`  ... and ${lines.length - previewLimit} more files`);
-    }
-    console.warn(`${LOG_PREFIX.DONE} Run "git status" for full details`);
-}
-//# sourceMappingURL=wu-done-ui.js.map

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

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

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

@@ -1,128 +0,0 @@
-interface ExposureDefaultResult {
-    applied: boolean;
-    exposure?: string;
-}
-interface WUDoneValidationDoc {
-    id?: string;
-    lane?: string;
-    type?: string;
-    exposure?: string;
-    status?: string;
-    locked?: boolean;
-    completed?: string;
-    completed_at?: string;
-    description?: string;
-    acceptance?: unknown;
-    code_paths?: unknown;
-    tests?: unknown;
-    test_paths?: unknown;
-}
-interface ValidatePostMutationInput {
-    id: string;
-    wuPath: string;
-    stampPath: string;
-    eventsPath?: string | null;
-}
-export declare function applyExposureDefaults(doc: WUDoneValidationDoc | null | undefined): ExposureDefaultResult;
-/**
- * WU-1351: Validate code_paths files exist on main branch
- *
- * Prevents false completions by ensuring all code_paths entries
- * actually exist on the target branch (main or lane branch).
- *
- * This guards against:
- * - Stamps being created for WUs where code never merged
- * - Metadata becoming desynchronized from actual code
- */
-export interface ValidateCodePathsExistOptions {
-    /** Branch to check files against (default: 'main') */
-    targetBranch?: string;
-    /** Worktree path for worktree mode */
-    worktreePath?: string | null;
-}
-export declare function validateCodePathsExist(doc: WUDoneValidationDoc, id: string, options?: ValidateCodePathsExistOptions): Promise<{
-    valid: boolean;
-    errors: string[];
-    missing: string[];
-}>;
-/**
- * Validate WU spec completeness (WU-1162, WU-1280)
- *
- * Ensures WU specifications are complete before allowing wu:done to proceed.
- * Prevents placeholder WUs from being marked as done.
- */
-export declare function validateSpecCompleteness(doc: WUDoneValidationDoc, _id: string): {
-    valid: boolean;
-    errors: string[];
-};
-/**
- * WU-1617: Post-mutation validation for wu:done
- *
- * Validates that metadata files written by tx.commit() are valid:
- * 1. WU YAML has completed_at field with valid ISO datetime
- * 2. WU YAML has locked: true
- * 3. Stamp file exists
- * 4. State store derives to done (when eventsPath is provided)
- */
-export declare function validatePostMutation({ id, wuPath, stampPath, eventsPath, }: ValidatePostMutationInput): {
-    valid: boolean;
-    errors: string[];
-};
-/**
- * WU-2242: Validate that test_paths is required for non-doc WUs
- *
- * Enforces that WUs with code changes (non-documentation types with code_paths
- * that contain actual code) have at least one test path specified.
- */
-export declare function validateTestPathsRequired(wu: WUDoneValidationDoc): {
-    valid: boolean;
-    error?: undefined;
-} | {
-    valid: boolean;
-    error: string;
-};
-/**
- * WU-2310: Validate type vs code_paths at preflight (before transaction starts).
- */
-export declare function validateTypeVsCodePathsPreflight(wu: WUDoneValidationDoc): {
-    valid: boolean;
-    errors: string[];
-    blockedPaths: string[];
-    abortedBeforeTransaction: boolean;
-};
-/**
- * WU-2310: Build error message for type vs code_paths preflight failure.
- */
-export declare function buildTypeVsCodePathsErrorMessage(id: string, blockedPaths: string[]): string;
-/**
- * WU-1153: Validate that code_paths are committed before wu:done metadata updates
- *
- * Prevents lost work by ensuring all code_paths are committed before metadata
- * transaction starts. If code_paths are uncommitted and metadata transaction
- * fails, the rollback could lose the uncommitted code changes.
- *
- * @param {object} wu - WU YAML document
- * @param {object} gitAdapter - Git adapter instance
- * @param {object} options - Validation options
- * @param {boolean} [options.abortOnFailure=true] - Whether to call die() on failure
- * @returns {Promise<{valid: boolean, errors: string[], uncommittedPaths: string[]}>}
- */
-export declare function validateCodePathsCommittedBeforeDone(wu: Record<string, unknown>, gitAdapter: {
-    getStatus: () => Promise<string>;
-}, options?: {
-    abortOnFailure?: boolean;
-}): Promise<{
-    valid: boolean;
-    errors: string[];
-    uncommittedPaths: string[];
-}>;
-/**
- * WU-1153: Build error message for uncommitted code_paths validation failure
- *
- * @param {string} wuId - WU ID
- * @param {string[]} uncommittedPaths - List of uncommitted code_paths
- * @returns {string} Formatted error message
- */
-export declare function buildCodePathsCommittedErrorMessage(wuId: string, uncommittedPaths: string[]): string;
-export {};
-//# sourceMappingURL=wu-done-validation.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"wu-done-validation.d.ts","sourceRoot":"","sources":["../src/wu-done-validation.ts"],"names":[],"mappings":"AA8BA,UAAU,qBAAqB;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,mBAAmB;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,yBAAyB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAC1C,qBAAqB,CAgBvB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,6BAA6B;IAC5C,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,mBAAmB,EACxB,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,6BAAkC;;;;GAoF5C;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,MAAM;;;EAwE7E;AAwCD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,EAAE,EACF,MAAM,EACN,SAAS,EACT,UAAiB,GAClB,EAAE,yBAAyB;;;EAiF3B;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,mBAAmB;;;;;;EAuDhE;AA+BD;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,EAAE,EAAE,mBAAmB;;;;;EAgCvE;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,CA6B3F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,oCAAoC,CACxD,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3B,UAAU,EAAE;IAAE,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,EAChD,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GACzC,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAiE3E;AAED;;;;;;GAMG;AACH,wBAAgB,mCAAmC,CACjD,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,MAAM,EAAE,GACzB,MAAM,CA6BR"}