@lumenflow/core 3.1.3 → 3.2.1

package/dist/wu-inconsistency-repairer.js

@@ -0,0 +1,271 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU Inconsistency Repairer (WU-2015, WU-2018)
+ *
+ * Repair orchestration for WU state inconsistencies. Coordinates micro-worktree
+ * isolation for file-based repairs and direct execution for git-only repairs.
+ *
+ * WU-2018: Replaced switch-based dispatch with strategy maps for OCP compliance.
+ * Adding a new repair type requires only a new map entry — no modification to
+ * existing dispatch logic.
+ *
+ * Extracted from wu-consistency-checker.ts to isolate repair orchestration
+ * from detection and file manipulation concerns.
+ *
+ * @see {@link ./wu-consistency-detector.ts} Detection logic
+ * @see {@link ./wu-consistency-file-repairs.ts} File-level repairs
+ */
+import { CONSISTENCY_TYPES, LOG_PREFIX } from './wu-constants.js';
+import { WU_PATHS } from './wu-paths.js';
+import { withMicroWorktree } from './micro-worktree.js';
+import { createStampInWorktree, updateYamlToDoneInWorktree, removeWUFromSectionInWorktree, removeOrphanWorktree, } from './wu-consistency-file-repairs.js';
+/**
+ * Strategy map for file-based repairs (WU-2018).
+ *
+ * Each entry maps a CONSISTENCY_TYPES value to a handler function.
+ * File-based repairs run inside a micro-worktree for atomic commits.
+ */
+export const FILE_REPAIR_STRATEGIES = {
+    [CONSISTENCY_TYPES.YAML_DONE_NO_STAMP]: async (error, worktreePath) => {
+        const files = await createStampInWorktree(error.wuId, error.title || `WU ${error.wuId}`, worktreePath);
+        return { success: true, files };
+    },
+    [CONSISTENCY_TYPES.YAML_DONE_STATUS_IN_PROGRESS]: async (error, worktreePath, projectRoot) => {
+        const files = await removeWUFromSectionInWorktree(WU_PATHS.STATUS(), error.wuId, '## In Progress', worktreePath, projectRoot);
+        return { success: true, files };
+    },
+    [CONSISTENCY_TYPES.BACKLOG_DUAL_SECTION]: async (error, worktreePath, projectRoot) => {
+        const files = await removeWUFromSectionInWorktree(WU_PATHS.BACKLOG(), error.wuId, '## \uD83D\uDD27 In progress', worktreePath, projectRoot);
+        return { success: true, files };
+    },
+    [CONSISTENCY_TYPES.STAMP_EXISTS_YAML_NOT_DONE]: async (error, worktreePath, projectRoot) => {
+        const files = await updateYamlToDoneInWorktree(error.wuId, worktreePath, projectRoot);
+        return { success: true, files };
+    },
+};
+/**
+ * Strategy map for git-only repairs (WU-2018).
+ *
+ * Each entry maps a CONSISTENCY_TYPES value to a handler function.
+ * Git-only repairs (worktree/branch cleanup) run directly without micro-worktree.
+ */
+export const GIT_REPAIR_STRATEGIES = {
+    [CONSISTENCY_TYPES.ORPHAN_WORKTREE_DONE]: async (error, projectRoot) => {
+        if (!error.lane) {
+            return { skipped: true, reason: 'Missing lane metadata for orphan worktree cleanup' };
+        }
+        return await removeOrphanWorktree(error.wuId, error.lane, projectRoot);
+    },
+};
+/**
+ * Categorize errors into file-based repairs (need micro-worktree) and git-only repairs.
+ *
+ * Uses the strategy maps to determine categorization — an error type present in
+ * GIT_REPAIR_STRATEGIES is git-only, one in FILE_REPAIR_STRATEGIES is file-based.
+ */
+function categorizeErrors(errors) {
+    const fileRepairs = [];
+    const gitOnlyRepairs = [];
+    const nonRepairable = [];
+    for (const error of errors) {
+        if (!error.canAutoRepair) {
+            nonRepairable.push(error);
+            continue;
+        }
+        // Git-only repairs: worktree/branch cleanup doesn't need micro-worktree
+        if (error.type in GIT_REPAIR_STRATEGIES) {
+            gitOnlyRepairs.push(error);
+        }
+        else {
+            // All file-based repairs need micro-worktree isolation
+            fileRepairs.push(error);
+        }
+    }
+    return { fileRepairs, gitOnlyRepairs, nonRepairable };
+}
+/**
+ * Repair a single file-based error inside a micro-worktree (WU-1078, WU-2018)
+ *
+ * This function performs file modifications inside the worktree path,
+ * which is then committed and pushed atomically by withMicroWorktree.
+ *
+ * Uses FILE_REPAIR_STRATEGIES map for dispatch — no switch statement.
+ *
+ * @param {ConsistencyError} error - Error object from checkWUConsistency()
+ * @param {string} worktreePath - Path to the micro-worktree
+ * @param {string} projectRoot - Original project root (for reading source files)
+ * @returns {Promise<RepairResult>} Result with success, skipped, reason, and files modified
+ */
+async function repairSingleErrorInWorktree(error, worktreePath, projectRoot) {
+    const strategy = FILE_REPAIR_STRATEGIES[error.type];
+    if (!strategy) {
+        return { skipped: true, reason: `Unknown error type: ${error.type}` };
+    }
+    return strategy(error, worktreePath, projectRoot);
+}
+/**
+ * Repair git-only errors (worktree/branch cleanup) without micro-worktree (WU-2018)
+ *
+ * These operations don't modify files in the repo, they only manage git worktrees
+ * and branches, so they can run directly.
+ *
+ * Uses GIT_REPAIR_STRATEGIES map for dispatch — no switch statement.
+ *
+ * @param {ConsistencyError} error - Error object
+ * @param {string} projectRoot - Project root directory
+ * @returns {Promise<RepairResult>} Result with success, skipped, and reason
+ */
+async function repairGitOnlyError(error, projectRoot) {
+    const strategy = GIT_REPAIR_STRATEGIES[error.type];
+    if (!strategy) {
+        return { skipped: true, reason: `Unknown git-only error type: ${error.type}` };
+    }
+    return strategy(error, projectRoot);
+}
+/**
+ * Repair WU inconsistencies using micro-worktree isolation (WU-1078)
+ *
+ * All file modifications (stamps, YAML, markdown) are made atomically
+ * in a micro-worktree, then committed and pushed to origin/main.
+ * This prevents direct writes to the main checkout.
+ *
+ * WU-1370: When projectRoot is explicitly provided (not process.cwd()), the caller
+ * is already inside a micro-worktree context (e.g., handleOrphanCheck during wu:claim).
+ * In this case, skip creating a nested micro-worktree and work directly in projectRoot.
+ * This prevents local main drift from nested micro-worktrees merging before pushing.
+ *
+ * @param {object} report - Report from checkWUConsistency()
+ * @param {RepairWUInconsistencyOptions} [options={}] - Repair options
+ * @returns {Promise<object>} Result with repaired, skipped, and failed counts
+ */
+export async function repairWUInconsistency(report, options = {}) {
+    const { dryRun = false, projectRoot } = options;
+    // WU-1370: Detect if projectRoot was explicitly provided
+    // If provided, we're inside a micro-worktree and should work directly in projectRoot
+    const isInsideMicroWorktree = projectRoot !== undefined;
+    const effectiveProjectRoot = projectRoot ?? process.cwd();
+    if (report.valid) {
+        return { repaired: 0, skipped: 0, failed: 0 };
+    }
+    const { fileRepairs, gitOnlyRepairs, nonRepairable } = categorizeErrors(report.errors);
+    let repaired = 0;
+    let skipped = nonRepairable.length;
+    let failed = 0;
+    // Dry run mode: just count
+    if (dryRun) {
+        return {
+            repaired: fileRepairs.length + gitOnlyRepairs.length,
+            skipped,
+            failed: 0,
+        };
+    }
+    // Step 1: Process file-based repairs
+    if (fileRepairs.length > 0) {
+        // WU-1370: When projectRoot is provided, we're already in a micro-worktree context
+        // (e.g., called from handleOrphanCheck during wu:claim). Work directly in projectRoot
+        // instead of creating a nested micro-worktree.
+        if (isInsideMicroWorktree) {
+            // Direct repair mode: work in the provided projectRoot
+            for (const error of fileRepairs) {
+                try {
+                    // When inside a micro-worktree, worktreePath === projectRoot
+                    // We're both reading from and writing to the same location
+                    const result = await repairSingleErrorInWorktree(error, effectiveProjectRoot, effectiveProjectRoot);
+                    if (result.success && result.files) {
+                        repaired++;
+                    }
+                    else if (result.skipped) {
+                        skipped++;
+                        if (result.reason) {
+                            console.warn(`${LOG_PREFIX.REPAIR} Skipped ${error.type}: ${result.reason}`);
+                        }
+                    }
+                    else {
+                        failed++;
+                    }
+                }
+                catch (err) {
+                    const errMessage = err instanceof Error ? err.message : String(err);
+                    console.error(`${LOG_PREFIX.REPAIR} Failed to repair ${error.type}: ${errMessage}`);
+                    failed++;
+                }
+            }
+        }
+        else {
+            // Standard mode: create micro-worktree for isolation
+            try {
+                // Generate a batch ID from the WU IDs being repaired
+                const batchId = `batch-${fileRepairs.map((e) => e.wuId).join('-')}`.slice(0, 50);
+                await withMicroWorktree({
+                    operation: 'wu-repair',
+                    id: batchId,
+                    logPrefix: LOG_PREFIX.REPAIR,
+                    execute: async ({ worktreePath }) => {
+                        const filesModified = [];
+                        for (const error of fileRepairs) {
+                            try {
+                                const result = await repairSingleErrorInWorktree(error, worktreePath, worktreePath);
+                                if (result.success && result.files) {
+                                    filesModified.push(...result.files);
+                                    repaired++;
+                                }
+                                else if (result.skipped) {
+                                    skipped++;
+                                    if (result.reason) {
+                                        console.warn(`${LOG_PREFIX.REPAIR} Skipped ${error.type}: ${result.reason}`);
+                                    }
+                                }
+                                else {
+                                    failed++;
+                                }
+                            }
+                            catch (err) {
+                                const errMessage = err instanceof Error ? err.message : String(err);
+                                console.error(`${LOG_PREFIX.REPAIR} Failed to repair ${error.type}: ${errMessage}`);
+                                failed++;
+                            }
+                        }
+                        // Deduplicate files
+                        const uniqueFiles = [...new Set(filesModified)];
+                        return {
+                            commitMessage: `fix: repair ${repaired} WU inconsistencies`,
+                            files: uniqueFiles,
+                        };
+                    },
+                });
+            }
+            catch (err) {
+                // If micro-worktree fails, mark all file repairs as failed
+                const errMessage = err instanceof Error ? err.message : String(err);
+                console.error(`${LOG_PREFIX.REPAIR} Micro-worktree operation failed: ${errMessage}`);
+                failed += fileRepairs.length - repaired;
+            }
+        }
+    }
+    // Step 2: Process git-only repairs (worktree/branch cleanup) directly
+    for (const error of gitOnlyRepairs) {
+        try {
+            const result = await repairGitOnlyError(error, effectiveProjectRoot);
+            if (result.success) {
+                repaired++;
+            }
+            else if (result.skipped) {
+                skipped++;
+                if (result.reason) {
+                    console.warn(`${LOG_PREFIX.REPAIR} Skipped ${error.type}: ${result.reason}`);
+                }
+            }
+            else {
+                failed++;
+            }
+        }
+        catch (err) {
+            const errMessage = err instanceof Error ? err.message : String(err);
+            console.error(`${LOG_PREFIX.REPAIR} Failed to repair ${error.type}: ${errMessage}`);
+            failed++;
+        }
+    }
+    return { repaired, skipped, failed };
+}
+//# sourceMappingURL=wu-inconsistency-repairer.js.map

package/dist/wu-inconsistency-repairer.js.map

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

package/dist/wu-lint.d.ts

@@ -0,0 +1,191 @@
+import { type ValidationPhase } from './wu-rules-engine.js';
+/**
+ * Error type constants for WU spec linting
+ */
+export declare const WU_LINT_ERROR_TYPES: {
+    ACCEPTANCE_PATH_NOT_IN_CODE_PATHS: string;
+    CODE_PATH_CONFLICTS_INVARIANT: string;
+    ACCEPTANCE_CONFLICTS_INVARIANT: string;
+    /** CLI registration parity surface missing */
+    REGISTRATION_PARITY_MISSING: string;
+    /** Backward-compatible key for minimum test intent */
+    UNIT_TESTS_REQUIRED: string;
+    /** Canonical minimum test intent key */
+    MINIMUM_TEST_INTENT_REQUIRED: string;
+};
+/**
+ * Registration surface paths required when CLI bin changes.
+ */
+export declare const REGISTRATION_SURFACES: {
+    readonly PUBLIC_MANIFEST: "packages/@lumenflow/cli/src/public-manifest.ts";
+    readonly MCP_TOOLS: "packages/@lumenflow/mcp/src/tools.ts";
+};
+/**
+ * Paths historically used to indicate CLI command surface changes.
+ * Kept exported for compatibility and docs/tests.
+ */
+export declare const CLI_COMMAND_PATTERNS: string[];
+/**
+ * Validate that acceptance criteria only reference paths in code_paths
+ */
+export declare function validateAcceptanceCodePaths(wu: UnsafeAny): {
+    valid: boolean;
+    errors: {
+        type: string;
+        wuId: any;
+        path: string | undefined;
+        criterion: any;
+        message: string;
+        suggestion: string;
+    }[];
+};
+/**
+ * Validate that code_paths and acceptance do not conflict with invariants
+ */
+export declare function validateInvariantsCompliance(wu: UnsafeAny, invariants: UnsafeAny): {
+    valid: boolean;
+    errors: ({
+        type: string;
+        wuId: any;
+        invariantId: any;
+        path: any;
+        message: string;
+        suggestion: any;
+        criterion?: undefined;
+    } | {
+        type: string;
+        wuId: any;
+        invariantId: any;
+        path: any;
+        criterion: any;
+        message: string;
+        suggestion: any;
+    } | {
+        type: string;
+        wuId: any;
+        invariantId: any;
+        paths: any;
+        message: string;
+        suggestion: any;
+    })[];
+};
+/**
+ * Backward-compatible adapter for minimum test intent.
+ */
+export declare function validateUnitTestsRequirement(wu: {
+    id: string;
+    type?: string;
+    status?: string;
+    code_paths?: string[];
+    tests?: {
+        unit?: string[];
+        e2e?: string[];
+        integration?: string[];
+        manual?: string[];
+    };
+}): {
+    valid: boolean;
+    errors: Array<{
+        type: string;
+        wuId: string;
+        message: string;
+        suggestion: string;
+    }>;
+};
+/**
+ * Adapter for parity surface validation.
+ *
+ * Parity is enforced in reality-phase preflight where git diff context is available.
+ * This adapter only enforces when caller explicitly confirms `binChanged`.
+ */
+export declare function validateRegistrationParity(wu: {
+    id: string;
+    code_paths?: string[];
+    status?: string;
+}, options?: {
+    binChanged?: boolean;
+}): {
+    valid: boolean;
+    errors: Array<{
+        type: string;
+        wuId: string;
+        message: string;
+        suggestion: string;
+    }>;
+    warnings?: Array<{
+        type: string;
+        wuId: string;
+        message: string;
+        suggestion: string;
+    }>;
+};
+/**
+ * Options for linting WU spec
+ */
+export interface LintWUSpecOptions {
+    /** Pre-loaded invariants */
+    invariants?: unknown[];
+    /** Path to invariants.yml */
+    invariantsPath?: string;
+    /** Validation phase for shared rule engine */
+    phase?: ValidationPhase;
+    /** Optional validation context */
+    context?: {
+        cwd?: string;
+        baseRef?: string;
+        headRef?: string;
+    };
+}
+/**
+ * Lint a WU spec against all rules
+ */
+export declare function lintWUSpec(wu: UnsafeAny, options?: LintWUSpecOptions): {
+    valid: boolean;
+    errors: ({
+        type: string;
+        wuId: any;
+        path: string | undefined;
+        criterion: any;
+        message: string;
+        suggestion: string;
+    } | {
+        type: string;
+        wuId: any;
+        invariantId: any;
+        path: any;
+        message: string;
+        suggestion: any;
+        criterion?: undefined;
+    } | {
+        type: string;
+        wuId: any;
+        invariantId: any;
+        path: any;
+        criterion: any;
+        message: string;
+        suggestion: any;
+    } | {
+        type: string;
+        wuId: any;
+        invariantId: any;
+        paths: any;
+        message: string;
+        suggestion: any;
+    } | {
+        type: string;
+        wuId: string;
+        message: string;
+        suggestion: string;
+    })[];
+    warnings: {
+        type: string;
+        wuId: string;
+        message: string;
+        suggestion: string;
+    }[];
+};
+/**
+ * Format lint errors for display
+ */
+export declare function formatLintErrors(errors: UnsafeAny): string;
+//# sourceMappingURL=wu-lint.d.ts.map

package/dist/wu-lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-lint.d.ts","sourceRoot":"","sources":["../src/wu-lint.ts"],"names":[],"mappings":"AAiBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;IAI9B,8CAA8C;;IAE9C,sDAAsD;;IAEtD,wCAAwC;;CAEzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;CAGxB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,EAA4B,CAAC;AAkDtE;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,EAAE,EAAE,SAAS;;;;;;;;;;EAyBxD;AAsDD;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;EAehF;AAwCD;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,EAAE,EAAE;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACxF,GAAG;IACF,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpF,CAuBA;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,EAAE,EAAE;IACF,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,EACD,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,OAAO,CAAC;CACjB,GACL;IACD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnF,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvF,CAkDA;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;IACvB,6BAA6B;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,kCAAkC;IAClC,OAAO,CAAC,EAAE;QACR,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,GAAE,iBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmDxE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,UAgBjD"}