@lumenflow/core 3.1.3 → 3.2.1

package/dist/wu-done-concurrent-merge.js.map

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

package/dist/wu-done-docs-generate.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Pathspecs for files that affect generated documentation.
+ * When UnsafeAny of these files change, docs:generate should be run.
+ *
+ * Based on .husky/hooks/docs-sync.ts patterns, expanded to match
+ * all files that can affect CLI/config documentation.
+ */
+export declare const DOC_SOURCE_PATHSPECS: readonly ["tools/generate-cli-docs.ts", "packages/@lumenflow/core/src/arg-parser.ts", "packages/@lumenflow/core/src/lumenflow-config-schema.ts", "packages/@lumenflow/core/src/index.ts", "packages/@lumenflow/cli/package.json", "packages/@lumenflow/cli/src/"];
+/**
+ * Output files generated by docs:generate.
+ * These files are staged before the metadata commit.
+ */
+export declare const DOC_OUTPUT_FILES: readonly ["apps/docs/src/content/docs/reference/cli.mdx", "apps/docs/src/content/docs/reference/config.mdx"];
+/**
+ * Check if UnsafeAny doc-source files changed compared to the base branch.
+ * Uses git diff with pathspecs for efficient detection.
+ *
+ * @param baseBranch - Base branch for comparison (e.g., 'main', 'origin/main')
+ * @returns Promise<boolean> - True if doc-source files changed
+ */
+export declare function hasDocSourceChanges(baseBranch: string): Promise<boolean>;
+/**
+ * Stage doc output files for the metadata commit.
+ *
+ * @returns Promise<void>
+ */
+export declare function stageDocOutputs(): Promise<void>;
+/**
+ * Run turbo docs:generate to regenerate documentation.
+ * Turbo handles build dependencies and caching.
+ *
+ * @param repoRoot - Repository root directory
+ * @returns void
+ */
+export declare function runDocsGenerate(repoRoot: string): void;
+/**
+ * Format generated doc output files with prettier.
+ *
+ * @param repoRoot - Repository root directory for running prettier
+ * @returns void
+ */
+export declare function formatDocOutputs(repoRoot: string): void;
+/**
+ * Result of the docs regeneration check.
+ */
+export interface DocsRegenerationResult {
+    /** Whether doc-source files changed */
+    docsChanged: boolean;
+    /** Whether docs were regenerated */
+    regenerated: boolean;
+}
+/**
+ * Options for maybeRegenerateAndStageDocs.
+ */
+export interface MaybeRegenerateDocsOptions {
+    /** Base branch for comparison (e.g., 'main', calculated from defaultBranchFrom) */
+    baseBranch: string;
+    /** Repository root directory for running turbo */
+    repoRoot: string;
+}
+/**
+ * Detect doc-source changes and regenerate docs if needed.
+ * This is the main integration point for wu:done.
+ *
+ * Call this BEFORE stageAndFormatMetadata() to include doc outputs
+ * in the single atomic commit.
+ *
+ * @param options - Detection and regeneration options
+ * @returns Promise<DocsRegenerationResult> - Whether docs changed and were regenerated
+ */
+export declare function maybeRegenerateAndStageDocs(options: MaybeRegenerateDocsOptions): Promise<DocsRegenerationResult>;
+//# sourceMappingURL=wu-done-docs-generate.d.ts.map

package/dist/wu-done-docs-generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-done-docs-generate.d.ts","sourceRoot":"","sources":["../src/wu-done-docs-generate.ts"],"names":[],"mappings":"AAiBA;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,mQAOvB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,gBAAgB,8GAGnB,CAAC;AAEX;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAe9E;AAED;;;;GAIG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAGrD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOtD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAQvD;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,uCAAuC;IACvC,WAAW,EAAE,OAAO,CAAC;IACrB,oCAAoC;IACpC,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,mFAAmF;IACnF,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,sBAAsB,CAAC,CAyBjC"}

package/dist/wu-done-docs-generate.js

@@ -0,0 +1,129 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file wu-done-docs-generate.ts
+ * @description Documentation regeneration utilities for wu:done
+ *
+ * WU-1061: Integrate docs:generate into wu:done for @lumenflow/* changes
+ *
+ * Detects changes to files that affect generated documentation and triggers
+ * regeneration during wu:done (after gates pass, before metadata commit).
+ */
+import { execSync } from 'node:child_process';
+import { getGitForCwd } from './git-adapter.js';
+import { STDIO, PKG_MANAGER, SCRIPTS, PRETTIER_FLAGS } from './wu-constants.js';
+/**
+ * Pathspecs for files that affect generated documentation.
+ * When UnsafeAny of these files change, docs:generate should be run.
+ *
+ * Based on .husky/hooks/docs-sync.ts patterns, expanded to match
+ * all files that can affect CLI/config documentation.
+ */
+export const DOC_SOURCE_PATHSPECS = [
+    'tools/generate-cli-docs.ts',
+    'packages/@lumenflow/core/src/arg-parser.ts',
+    'packages/@lumenflow/core/src/lumenflow-config-schema.ts',
+    'packages/@lumenflow/core/src/index.ts',
+    'packages/@lumenflow/cli/package.json',
+    'packages/@lumenflow/cli/src/',
+];
+/**
+ * Output files generated by docs:generate.
+ * These files are staged before the metadata commit.
+ */
+export const DOC_OUTPUT_FILES = [
+    'apps/docs/src/content/docs/reference/cli.mdx',
+    'apps/docs/src/content/docs/reference/config.mdx',
+];
+/**
+ * Check if UnsafeAny doc-source files changed compared to the base branch.
+ * Uses git diff with pathspecs for efficient detection.
+ *
+ * @param baseBranch - Base branch for comparison (e.g., 'main', 'origin/main')
+ * @returns Promise<boolean> - True if doc-source files changed
+ */
+export async function hasDocSourceChanges(baseBranch) {
+    try {
+        const gitAdapter = getGitForCwd();
+        const diff = await gitAdapter.raw([
+            'diff',
+            `${baseBranch}...HEAD`,
+            '--name-only',
+            '--',
+            ...DOC_SOURCE_PATHSPECS,
+        ]);
+        return diff.trim().length > 0;
+    }
+    catch {
+        // Fail-safe: don't regenerate on git errors
+        return false;
+    }
+}
+/**
+ * Stage doc output files for the metadata commit.
+ *
+ * @returns Promise<void>
+ */
+export async function stageDocOutputs() {
+    const gitAdapter = getGitForCwd();
+    await gitAdapter.add([...DOC_OUTPUT_FILES]);
+}
+/**
+ * Run turbo docs:generate to regenerate documentation.
+ * Turbo handles build dependencies and caching.
+ *
+ * @param repoRoot - Repository root directory
+ * @returns void
+ */
+export function runDocsGenerate(repoRoot) {
+    // eslint-disable-next-line sonarjs/no-os-command-from-path -- pnpm resolved from PATH; workflow tooling orchestration
+    execSync('pnpm turbo docs:generate', {
+        cwd: repoRoot,
+        stdio: STDIO.INHERIT,
+        encoding: 'utf-8',
+    });
+}
+/**
+ * Format generated doc output files with prettier.
+ *
+ * @param repoRoot - Repository root directory for running prettier
+ * @returns void
+ */
+export function formatDocOutputs(repoRoot) {
+    const files = DOC_OUTPUT_FILES.map((file) => `"${file}"`).join(' ');
+    const prettierCmd = `${PKG_MANAGER} ${SCRIPTS.PRETTIER} ${PRETTIER_FLAGS.WRITE} ${files}`;
+    execSync(prettierCmd, {
+        cwd: repoRoot,
+        stdio: STDIO.INHERIT,
+        encoding: 'utf-8',
+    });
+}
+/**
+ * Detect doc-source changes and regenerate docs if needed.
+ * This is the main integration point for wu:done.
+ *
+ * Call this BEFORE stageAndFormatMetadata() to include doc outputs
+ * in the single atomic commit.
+ *
+ * @param options - Detection and regeneration options
+ * @returns Promise<DocsRegenerationResult> - Whether docs changed and were regenerated
+ */
+export async function maybeRegenerateAndStageDocs(options) {
+    const { baseBranch, repoRoot } = options;
+    // Check if doc-source files changed
+    const docsChanged = await hasDocSourceChanges(baseBranch);
+    if (!docsChanged) {
+        console.log('[wu:done] No doc-source changes detected, skipping docs:generate');
+        return { docsChanged: false, regenerated: false };
+    }
+    console.log('[wu:done] Doc-source changes detected, running turbo docs:generate...');
+    // Run turbo docs:generate (Turbo handles caching and dependencies)
+    runDocsGenerate(repoRoot);
+    // Format the generated doc outputs before staging
+    formatDocOutputs(repoRoot);
+    // Stage the doc output files
+    await stageDocOutputs();
+    console.log('[wu:done] Documentation regenerated and staged');
+    return { docsChanged: true, regenerated: true };
+}
+//# sourceMappingURL=wu-done-docs-generate.js.map

package/dist/wu-done-docs-generate.js.map

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

package/dist/wu-done-docs-only.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Detect docs-only WU from code_paths.
+ * Returns true if all code_paths are documentation paths only.
+ *
+ * Docs-only paths: docs/, ai/, .claude/, memory-bank/, README*, CLAUDE*.md
+ * NOT docs-only: tools/, scripts/ (these are code, not documentation)
+ *
+ * WU-1539: Fixed misclassification where tools/ was treated as docs-only
+ * but then rejected by validateDocsOnly(). tools/ should skip web tests
+ * but NOT be classified as docs-only.
+ *
+ * @param {string[]|null|undefined} codePaths - Array of file paths from WU YAML
+ * @returns {boolean} True if WU is docs-only (all paths are documentation)
+ */
+export declare function detectDocsOnlyByPaths(codePaths: UnsafeAny): boolean;
+//# sourceMappingURL=wu-done-docs-only.d.ts.map

package/dist/wu-done-docs-only.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-done-docs-only.d.ts","sourceRoot":"","sources":["../src/wu-done-docs-only.ts"],"names":[],"mappings":"AAyBA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,WAqCzD"}

package/dist/wu-done-docs-only.js

@@ -0,0 +1,68 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Docs-only detection utilities for wu:done
+ *
+ * WU-1234 + WU-1255 + WU-1539: Detect docs-only WUs from code_paths.
+ */
+/**
+ * Prefixes for paths that qualify as "docs-only" (no code changes).
+ * Unlike SKIP_TESTS_PREFIXES, this excludes tools/ and scripts/ because
+ * those contain code files that require full gate validation.
+ *
+ * WU-1539: Split from shouldSkipWebTests to fix docs-only misclassification.
+ * @constant {string[]}
+ */
+const DOCS_ONLY_PREFIXES = Object.freeze(['docs/', 'ai/', '.claude/', 'memory-bank/']);
+/**
+ * Root file patterns that qualify as docs-only.
+ * @constant {string[]}
+ */
+const DOCS_ONLY_ROOT_FILES = Object.freeze(['readme', 'claude']);
+/**
+ * Detect docs-only WU from code_paths.
+ * Returns true if all code_paths are documentation paths only.
+ *
+ * Docs-only paths: docs/, ai/, .claude/, memory-bank/, README*, CLAUDE*.md
+ * NOT docs-only: tools/, scripts/ (these are code, not documentation)
+ *
+ * WU-1539: Fixed misclassification where tools/ was treated as docs-only
+ * but then rejected by validateDocsOnly(). tools/ should skip web tests
+ * but NOT be classified as docs-only.
+ *
+ * @param {string[]|null|undefined} codePaths - Array of file paths from WU YAML
+ * @returns {boolean} True if WU is docs-only (all paths are documentation)
+ */
+export function detectDocsOnlyByPaths(codePaths) {
+    if (!codePaths || !Array.isArray(codePaths) || codePaths.length === 0) {
+        return false;
+    }
+    return codePaths.every((filePath) => {
+        if (!filePath || typeof filePath !== 'string') {
+            return false;
+        }
+        const path = filePath.trim();
+        if (path.length === 0) {
+            return false;
+        }
+        // Check docs-only prefixes (docs/, ai/, .claude/, memory-bank/)
+        for (const prefix of DOCS_ONLY_PREFIXES) {
+            if (path.startsWith(prefix)) {
+                return true;
+            }
+        }
+        // Check if it's a markdown file (*.md)
+        if (path.endsWith('.md')) {
+            return true;
+        }
+        // Check root file patterns (README*, CLAUDE*.md)
+        const lowerPath = path.toLowerCase();
+        for (const pattern of DOCS_ONLY_ROOT_FILES) {
+            if (lowerPath.startsWith(pattern)) {
+                return true;
+            }
+        }
+        return false;
+    });
+}
+//# sourceMappingURL=wu-done-docs-only.js.map

package/dist/wu-done-docs-only.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-done-docs-only.js","sourceRoot":"","sources":["../src/wu-done-docs-only.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;GAIG;AAEH;;;;;;;GAOG;AACH,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC;AAEvF;;;GAGG;AACH,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEjE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAoB;IACxD,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,EAAE;QAClC,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC9C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,gEAAgE;QAChE,KAAK,MAAM,MAAM,IAAI,kBAAkB,EAAE,CAAC;YACxC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5B,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,uCAAuC;QACvC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,iDAAiD;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACrC,KAAK,MAAM,OAAO,IAAI,oBAAoB,EAAE,CAAC;YAC3C,IAAI,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAClC,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/wu-done-error-handling.d.ts

@@ -0,0 +1,35 @@
+import { WUTransaction } from './wu-transaction.js';
+/**
+ * Context required for error handling after a failed completion attempt.
+ */
+export interface CompletionErrorContext {
+    /** The caught error */
+    error: unknown;
+    /** WU ID */
+    id: string;
+    /** Path to the worktree */
+    worktreePath: string;
+    /** The transaction object */
+    transaction: WUTransaction;
+    /** Whether a git commit was made in the worktree */
+    gitCommitMade: boolean;
+    /** SHA before the metadata commit (for rollback) */
+    preCommitSha: string | null;
+    /** Transaction file snapshot for rollback */
+    transactionSnapshot: Map<string, string | null> | null;
+}
+/**
+ * Orchestrate error recovery after a failed wu:done completion attempt.
+ *
+ * Handles two distinct failure scenarios:
+ * 1. Pre-commit failure: Transaction was not committed, abort cleanly
+ * 2. Post-commit failure: Transaction was committed but merge failed,
+ *    attempt file rollback and/or branch rollback
+ *
+ * Always prints user-facing error box with next steps.
+ *
+ * @param ctx - Error context with all state needed for recovery
+ * @throws Always re-throws the original error with cleanupSafe=false
+ */
+export declare function handleCompletionError(ctx: CompletionErrorContext): Promise<never>;
+//# sourceMappingURL=wu-done-error-handling.d.ts.map

package/dist/wu-done-error-handling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-done-error-handling.d.ts","sourceRoot":"","sources":["../src/wu-done-error-handling.ts"],"names":[],"mappings":"AAeA,OAAO,EAAuB,aAAa,EAAE,MAAM,qBAAqB,CAAC;AASzE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,uBAAuB;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,WAAW,EAAE,aAAa,CAAC;IAC3B,oDAAoD;IACpD,aAAa,EAAE,OAAO,CAAC;IACvB,oDAAoD;IACpD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,6CAA6C;IAC7C,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;CACxD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,KAAK,CAAC,CA6FvF"}

package/dist/wu-done-error-handling.js

@@ -0,0 +1,109 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU-2014: Error handling and rollback for wu:done worktree completion.
+ *
+ * Extracted from wu-done-worktree.ts to isolate error recovery orchestration.
+ * Handles transaction rollback, git branch rollback, and user-facing error messages.
+ *
+ * Functions:
+ *   handleCompletionError - Orchestrate error recovery after failed completion
+ */
+import { createGitForPath } from './git-adapter.js';
+import { LOG_PREFIX, EMOJI, BOX } from './wu-constants.js';
+import { restoreFromSnapshot, WUTransaction } from './wu-transaction.js';
+import { rollbackBranchOnMergeFailure } from './wu-done-utils.js';
+import { getErrorMessage } from './error-handler.js';
+/**
+ * Orchestrate error recovery after a failed wu:done completion attempt.
+ *
+ * Handles two distinct failure scenarios:
+ * 1. Pre-commit failure: Transaction was not committed, abort cleanly
+ * 2. Post-commit failure: Transaction was committed but merge failed,
+ *    attempt file rollback and/or branch rollback
+ *
+ * Always prints user-facing error box with next steps.
+ *
+ * @param ctx - Error context with all state needed for recovery
+ * @throws Always re-throws the original error with cleanupSafe=false
+ */
+export async function handleCompletionError(ctx) {
+    const { error, id, worktreePath, transaction, gitCommitMade, preCommitSha, transactionSnapshot } = ctx;
+    const worktreeError = error instanceof Error ? error : new Error(String(error));
+    const wasCommitted = transaction.isCommitted;
+    if (!wasCommitted) {
+        transaction.abort();
+        console.log(`\n${BOX.TOP}`);
+        console.log(`${BOX.SIDE}  WU:DONE FAILED - NO FILES MODIFIED (atomic pattern)`);
+        console.log(BOX.MID);
+        console.log(`${BOX.SIDE}  Error: ${worktreeError.message}`);
+        console.log(BOX.SIDE);
+        console.log(`${BOX.SIDE}  WU-1369: Transaction aborted before file writes.`);
+        console.log(`${BOX.SIDE}  WU-1811: Worktree preserved for recovery.`);
+        console.log(`${BOX.SIDE}  Worktree: ${worktreePath}`);
+        console.log(BOX.MID);
+        console.log(`${BOX.SIDE}  NEXT STEP: Fix the error and rerun:`);
+        console.log(`${BOX.SIDE}    pnpm wu:done --id ${id}`);
+        console.log(BOX.BOT);
+    }
+    else {
+        let fileRollbackSuccess = false;
+        if (!gitCommitMade && transactionSnapshot) {
+            console.log(`\n${LOG_PREFIX.DONE} ${EMOJI.WARNING} WU-2310: Git commit failed after transaction - rolling back files...`);
+            try {
+                const rollbackResult = restoreFromSnapshot(transactionSnapshot);
+                if (rollbackResult.errors.length === 0) {
+                    fileRollbackSuccess = true;
+                    console.log(`${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} WU-2310: File rollback complete - ${rollbackResult.restored.length} files restored`);
+                }
+                else {
+                    console.log(`${LOG_PREFIX.DONE} ${EMOJI.WARNING} WU-2310: Partial file rollback - ${rollbackResult.restored.length} restored, ${rollbackResult.errors.length} failed`);
+                    for (const e of rollbackResult.errors) {
+                        console.log(`${LOG_PREFIX.DONE}   ${EMOJI.FAILURE} ${e.path}: ${e.error}`);
+                    }
+                }
+            }
+            catch (rollbackErr) {
+                console.log(`${LOG_PREFIX.DONE} ${EMOJI.WARNING} WU-2310: File rollback error: ${getErrorMessage(rollbackErr)}`);
+            }
+        }
+        if (gitCommitMade && preCommitSha) {
+            console.log(`\n${LOG_PREFIX.DONE} ${EMOJI.WARNING} Merge failed after git commit - attempting branch rollback...`);
+            try {
+                const gitWorktreeForRollback = createGitForPath(worktreePath);
+                await rollbackBranchOnMergeFailure(gitWorktreeForRollback, preCommitSha, id);
+            }
+            catch (rollbackErr) {
+                console.log(`${LOG_PREFIX.DONE} ${EMOJI.WARNING} Rollback error: ${getErrorMessage(rollbackErr)}`);
+            }
+        }
+        console.log(`\n${BOX.TOP}`);
+        if (fileRollbackSuccess) {
+            console.log(`${BOX.SIDE}  WU:DONE FAILED - FILES ROLLED BACK (WU-2310)`);
+            console.log(BOX.MID);
+            console.log(`${BOX.SIDE}  Error: ${worktreeError.message}`);
+            console.log(BOX.SIDE);
+            console.log(`${BOX.SIDE}  WU-2310: Transaction files were rolled back to pre-commit state.`);
+            console.log(`${BOX.SIDE}  Worktree is now consistent (status=in_progress, no stamp).`);
+        }
+        else {
+            console.log(`${BOX.SIDE}  WU:DONE FAILED - PARTIAL STATE (post-transaction)`);
+            console.log(BOX.MID);
+            console.log(`${BOX.SIDE}  Error: ${worktreeError.message}`);
+            console.log(BOX.SIDE);
+            console.log(`${BOX.SIDE}  Metadata files were written, but git operations failed.`);
+            if (gitCommitMade && preCommitSha) {
+                console.log(`${BOX.SIDE}  WU-1943: Branch rolled back to pre-commit state.`);
+            }
+        }
+        console.log(`${BOX.SIDE}  WU-1811: Worktree preserved for recovery.`);
+        console.log(`${BOX.SIDE}  Worktree: ${worktreePath}`);
+        console.log(BOX.MID);
+        console.log(`${BOX.SIDE}  NEXT STEP: Rerun wu:done (idempotent recovery):`);
+        console.log(`${BOX.SIDE}    pnpm wu:done --id ${id}`);
+        console.log(BOX.BOT);
+    }
+    worktreeError.cleanupSafe = false;
+    throw worktreeError;
+}
+//# sourceMappingURL=wu-done-error-handling.js.map

package/dist/wu-done-error-handling.js.map

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

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

@@ -0,0 +1,13 @@
+/**
+ * Create a validation error for wu:done validators.
+ */
+export declare function createValidationError(message: UnsafeAny, details?: {}): import("./error-handler.js").WUError;
+/**
+ * Create a file-not-found error for wu:done validators.
+ */
+export declare function createFileNotFoundError(message: UnsafeAny, details?: {}): import("./error-handler.js").WUError;
+/**
+ * Create a recovery error for wu:done recovery flows.
+ */
+export declare function createRecoveryError(message: UnsafeAny, details?: {}): import("./error-handler.js").WUError;
+//# sourceMappingURL=wu-done-errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wu-done-errors.d.ts","sourceRoot":"","sources":["../src/wu-done-errors.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,KAAK,wCAErE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,KAAK,wCAEvE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,KAAK,wCAEnE"}

package/dist/wu-done-errors.js

@@ -0,0 +1,27 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Error helpers for wu:done validators
+ *
+ * WU-1049: Standardize error handling patterns across wu-done validator paths.
+ */
+import { createError, ErrorCodes } from './error-handler.js';
+/**
+ * Create a validation error for wu:done validators.
+ */
+export function createValidationError(message, details = {}) {
+    return createError(ErrorCodes.VALIDATION_ERROR, message, details);
+}
+/**
+ * Create a file-not-found error for wu:done validators.
+ */
+export function createFileNotFoundError(message, details = {}) {
+    return createError(ErrorCodes.FILE_NOT_FOUND, message, details);
+}
+/**
+ * Create a recovery error for wu:done recovery flows.
+ */
+export function createRecoveryError(message, details = {}) {
+    return createError(ErrorCodes.RECOVERY_ERROR, message, details);
+}
+//# sourceMappingURL=wu-done-errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wu-done-errors.js","sourceRoot":"","sources":["../src/wu-done-errors.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE7D;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAkB,EAAE,OAAO,GAAG,EAAE;IACpE,OAAO,WAAW,CAAC,UAAU,CAAC,gBAAgB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAkB,EAAE,OAAO,GAAG,EAAE;IACtE,OAAO,WAAW,CAAC,UAAU,CAAC,cAAc,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAkB,EAAE,OAAO,GAAG,EAAE;IAClE,OAAO,WAAW,CAAC,UAAU,CAAC,cAAc,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAClE,CAAC"}

package/dist/wu-done-initiative-sync.d.ts

@@ -0,0 +1,13 @@
+interface SyncInput {
+    wuId: string;
+    wuDoc: Record<string, unknown>;
+    projectRoot: string;
+}
+export interface InitiativeSyncWrite {
+    initiativeId: string;
+    initiativePath: string;
+    content: string;
+}
+export declare function computeInitiativeSyncWriteOnWUComplete(input: SyncInput): InitiativeSyncWrite | null;
+export {};
+//# sourceMappingURL=wu-done-initiative-sync.d.ts.map

package/dist/wu-done-initiative-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-done-initiative-sync.d.ts","sourceRoot":"","sources":["../src/wu-done-initiative-sync.ts"],"names":[],"mappings":"AA6CA,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAiMD,wBAAgB,sCAAsC,CACpD,KAAK,EAAE,SAAS,GACf,mBAAmB,GAAG,IAAI,CAqF5B"}