@lumenflow/core 3.1.1 → 3.1.3

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

@@ -1,229 +0,0 @@
-#!/usr/bin/env node
-import { type GitAdapter } from './git-adapter.js';
-/**
- * @typedef {Object} WorktreeContext
- * @property {string} id - WU ID (e.g., "WU-1215")
- * @property {Object} args - Parsed CLI arguments
- * @property {Object} docMain - WU YAML document from main checkout
- * @property {string} title - WU title for commit message
- * @property {boolean} isDocsOnly - Whether this is a docs-only WU
- * @property {string} worktreePath - Path to worktree
- * @property {number} maxCommitLength - Max commit header length from commitlint
- * @property {function} validateStagedFiles - Staged files validator
- * NOTE: recordTransactionState/rollbackTransaction removed in WU-1369 (atomic pattern)
- */
-/**
- * @typedef {Object} WorktreeResult
- * @property {boolean} success - Whether completion succeeded
- * @property {boolean} committed - Whether changes were committed
- * @property {boolean} pushed - Whether changes were pushed
- * @property {boolean} merged - Whether lane branch was merged (vs PR created)
- * @property {string|null} prUrl - PR URL if PR mode was used
- * @property {boolean} [recovered] - Whether zombie state was recovered
- * @property {boolean} [cleanupSafe] - WU-1811: Whether worktree cleanup is safe (all steps succeeded)
- */
-interface WorktreeMetadataPaths {
-    wuPath: string;
-    statusPath: string;
-    backlogPath: string;
-    stampsDir: string;
-    stampPath: string;
-    eventsPath: string;
-}
-interface DoneArgs {
-    noMerge?: boolean;
-    prDraft?: boolean;
-    noAutoRebase?: boolean;
-    [key: string]: unknown;
-}
-interface WorktreeDoc {
-    id?: string;
-    lane?: string;
-    code_paths?: string[];
-    [key: string]: unknown;
-}
-type ValidateStagedFilesFn = (id: string, isDocsOnly: boolean, options: {
-    metadataAllowlist: string[];
-}) => Promise<void> | void;
-interface WorktreeCompletionContext {
-    id: string;
-    args: DoneArgs;
-    docMain: WorktreeDoc;
-    title: string;
-    isDocsOnly: boolean;
-    worktreePath: string;
-    maxCommitLength: number;
-    validateStagedFiles: ValidateStagedFilesFn;
-}
-interface WorktreeCompletionResult {
-    success: boolean;
-    committed: boolean;
-    pushed: boolean;
-    merged: boolean;
-    prUrl: string | null;
-    recovered?: boolean;
-    cleanupSafe?: boolean;
-}
-interface MainSyncGitAdapter {
-    fetch: (remote?: string, branch?: string) => Promise<void>;
-    getCommitHash: (ref: string) => Promise<string>;
-    revList: (args: string[]) => Promise<string>;
-}
-/**
- * Resolve all metadata/state paths as absolute worktree-local paths.
- *
- * WU-1563: Prevents wu:done from writing lifecycle metadata into main checkout
- * when worktree mode is active.
- */
-export declare function resolveWorktreeMetadataPaths(worktreePath: string, id: string): WorktreeMetadataPaths;
-/**
- * Execute worktree mode completion
- *
- * @param {WorktreeContext} context - Worktree mode context
- * @returns {Promise<WorktreeResult>} Completion result
- * @throws {Error} On validation or git operation failure
- */
-export declare function executeWorktreeCompletion(context: WorktreeCompletionContext): Promise<WorktreeCompletionResult>;
-/**
- * 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>;
-/**
- * Auto-rebase branch onto main
- * WU-1303: Auto-rebase on wu:done to handle diverged branches automatically
- * WU-1371: Added wuId parameter for post-rebase artifact cleanup
- * WU-1749 Bug 3: Auto-resolve append-only file conflicts during rebase
- *
- * @param {string} branch - Lane branch name
- * @param {string} worktreePath - Path to worktree
- * @param {string} [wuId] - WU ID for artifact cleanup (e.g., 'WU-1371')
- * @returns {Promise<{success: boolean, error?: string}>} Rebase result
- */
-export declare function autoRebaseBranch(branch: string, worktreePath: string, wuId?: string | null): Promise<{
-    success: boolean;
-    error?: string;
-}>;
-/**
- * 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
- */
-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;
-}
-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>;
-/**
- * Merge lane branch to main with exponential backoff retry (WU-1747)
- *
- * Uses retry strategy to handle concurrent completions gracefully.
- * WU-1749 Bug 2: Will auto-rebase lane branch onto new main on retry.
- *
- * @param {string} branch - Lane branch name
- * @param {Object} [options] - Merge options
- * @param {MergeLaneBranchOptions} [options] - Merge options
- * @throws {Error} On merge failure after all retries
- */
-interface MergeLaneBranchOptions extends CheckBranchOptions {
-    /** Override max retry attempts */
-    maxAttempts?: number;
-}
-export declare function mergeLaneBranch(branch: string, options?: MergeLaneBranchOptions): Promise<void>;
-/**
- * WU-1943: Check if the session has checkpoints for the given WU
- *
- * Used to warn agents when they're completing a WU without UnsafeAny checkpoints,
- * which means no recovery data if the session crashes.
- *
- * @param {string} wuId - WU ID to check
- * @param {Array|null} nodes - Memory nodes for the WU (from queryByWu)
- * @returns {boolean} True if checkpoints exist, false otherwise
- */
-export declare function hasSessionCheckpoints(wuId: string, nodes: Array<{
-    type?: string;
-}> | null | undefined): boolean;
-/**
- * WU-1943: Rollback branch to pre-commit SHA when merge fails
- *
- * When wu:done commits metadata to the lane branch but the subsequent merge
- * to main fails, this function rolls back the branch to its pre-commit state.
- * This prevents "zombie" states where the branch shows done but wasn't merged.
- *
- * @param {object} gitAdapter - Git adapter instance (must be in worktree context)
- * @param {string} preCommitSha - SHA to reset to (captured before metadata commit)
- * @param {string} wuId - WU ID for logging
- * @returns {Promise<{success: boolean, error?: string}>} Rollback result
- */
-export declare function rollbackBranchOnMergeFailure(gitAdapter: GitAdapter, preCommitSha: string, wuId: string): Promise<{
-    success: boolean;
-    error?: string;
-}>;
-/**
- * WU-1577: Validate that local main is not behind origin/main before transaction.
- *
- * Defense-in-depth check inside the core layer. The CLI layer already has
- * `ensureMainUpToDate()`, but this adds a guard directly before the
- * transaction starts in `executeWorktreeCompletion()`. This prevents
- * metadata leaks when the merge succeeds but the subsequent push fails
- * because main was behind.
- *
- * Fail-open: if the fetch or comparison fails (network issue), returns valid=true
- * to avoid blocking legitimate work when there's no remote.
- *
- * @param gitAdapter - Git adapter instance (must be in main checkout context)
- * @returns Validation result with commitsBehind count
- */
-export declare function validateMainNotBehindOrigin(gitAdapter: MainSyncGitAdapter): Promise<{
-    valid: boolean;
-    commitsBehind: number;
-    failOpen?: boolean;
-}>;
-export {};
-//# sourceMappingURL=wu-done-worktree.d.ts.map

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

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