@lumenflow/core 3.1.2 → 3.2.0

package/dist/wu-preflight-validators.js

@@ -1,277 +0,0 @@
-#!/usr/bin/env node
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * Preflight validation functions for wu:preflight and wu:done.
- *
- * Uses phase-aware rules from wu-rules-engine:
- * - intent/structural: syntax + policy intent checks
- * - reality: disk/diff/parity/test existence checks
- */
-import { WU_PATHS } from './wu-paths.js';
-import { readWURaw } from './wu-yaml.js';
-import { TEST_TYPES, LOG_PREFIX, EMOJI } from './wu-constants.js';
-import { BaseWUSchema } from './wu-schema.js';
-import { detectFixableIssues, FIXABLE_ISSUES } from './wu-yaml-fixer.js';
-import fg from 'fast-glob';
-import path from 'node:path';
-import { isPathLikeTestEntry, pathReferenceExistsSync, validationIssueToDisplayLines, validateWURules, validateWURulesSync, } from './wu-rules-engine.js';
-function getUnknownErrorMessage(error) {
-    if (error instanceof Error) {
-        return error.message;
-    }
-    return String(error);
-}
-/**
- * Create a PreflightResult object
- */
-export function createPreflightResult({ valid, errors = [], warnings = [], missingCodePaths = [], missingCoverageCodePaths = [], missingTestPaths = [], changedFiles = [], suggestedTestPaths = {}, }) {
-    return {
-        valid,
-        errors,
-        warnings,
-        missingCodePaths,
-        missingCoverageCodePaths,
-        missingTestPaths,
-        changedFiles,
-        suggestedTestPaths,
-    };
-}
-function validateSchema(doc, id) {
-    const errors = [];
-    if (doc.id !== id) {
-        errors.push(`WU ID mismatch: expected ${id}, found ${doc.id}`);
-    }
-    const fixableIssues = detectFixableIssues(doc);
-    const createdIssue = fixableIssues.find((issue) => issue.type === FIXABLE_ISSUES.DATE_ISO_TIMESTAMP);
-    if (createdIssue) {
-        errors.push(`created field has invalid format: "${createdIssue.current}" is an ISO timestamp. ` +
-            `Expected YYYY-MM-DD format. Suggested fix: change to "${createdIssue.suggested}". ` +
-            `Fix by editing the WU YAML file (created: '${createdIssue.suggested}').`);
-    }
-    const schemaResult = BaseWUSchema.safeParse(doc);
-    if (!schemaResult.success) {
-        for (const issue of schemaResult.error.issues) {
-            const fieldPath = issue.path.join('.');
-            const message = issue.message;
-            if (fieldPath === 'created' && createdIssue) {
-                continue;
-            }
-            errors.push(`${fieldPath}: ${message}`);
-        }
-    }
-    return { valid: errors.length === 0, errors };
-}
-/**
- * Validate code_paths files/globs exist on disk.
- */
-export function validateCodePathsExistence(codePaths, rootDir) {
-    if (!codePaths || !Array.isArray(codePaths) || codePaths.length === 0) {
-        return { valid: true, errors: [], missing: [] };
-    }
-    const missing = [];
-    for (const filePath of codePaths) {
-        if (!filePath || typeof filePath !== 'string')
-            continue;
-        if (!pathReferenceExistsSync(filePath, rootDir)) {
-            missing.push(filePath);
-        }
-    }
-    if (missing.length > 0) {
-        const errors = [
-            `code_paths validation failed - ${missing.length} path(s) not found:`,
-            ...missing.map((p) => `  - ${p}`),
-        ];
-        return { valid: false, errors, missing };
-    }
-    return { valid: true, errors: [], missing: [] };
-}
-/**
- * Validate automated test file paths/globs exist.
- *
- * Non-path-like prose entries are ignored here; they are classified by
- * reality-phase rule R-007.
- */
-export function validateTestPathsExistence(tests, rootDir) {
-    if (!tests || typeof tests !== 'object') {
-        return { valid: true, errors: [], missing: [] };
-    }
-    const normalizedTests = tests;
-    const missing = [];
-    const fileTestTypes = [TEST_TYPES.UNIT, TEST_TYPES.E2E, TEST_TYPES.INTEGRATION];
-    for (const testType of fileTestTypes) {
-        const paths = normalizedTests[testType];
-        if (!paths || !Array.isArray(paths))
-            continue;
-        for (const filePath of paths) {
-            if (!filePath || typeof filePath !== 'string')
-                continue;
-            if (!isPathLikeTestEntry(filePath))
-                continue;
-            if (!pathReferenceExistsSync(filePath, rootDir)) {
-                missing.push(filePath);
-            }
-        }
-    }
-    if (missing.length > 0) {
-        const errors = [
-            `test paths validation failed - ${missing.length} automated test path(s) not found:`,
-            ...missing.map((p) => `  - ${p}`),
-        ];
-        return { valid: false, errors, missing };
-    }
-    return { valid: true, errors: [], missing: [] };
-}
-export async function validatePreflight(id, options = {}) {
-    const rootDir = options.rootDir || process.cwd();
-    const worktreePath = options.worktreePath || rootDir;
-    const phase = options.phase || 'reality';
-    const allErrors = [];
-    const allWarnings = [];
-    const missingCodePaths = [];
-    const missingCoverageCodePaths = [];
-    const missingTestPaths = [];
-    const changedFiles = [];
-    const wuPath = path.join(worktreePath, WU_PATHS.WU(id));
-    let doc;
-    try {
-        doc = readWURaw(wuPath);
-    }
-    catch (err) {
-        return createPreflightResult({
-            valid: false,
-            errors: [`Failed to read WU YAML: ${getUnknownErrorMessage(err)}`],
-        });
-    }
-    const schemaResult = validateSchema(doc, id);
-    if (!schemaResult.valid) {
-        allErrors.push(...schemaResult.errors);
-    }
-    const rulesContext = {
-        id,
-        type: doc.type,
-        status: doc.status,
-        code_paths: doc.code_paths,
-        tests: doc.tests || doc.test_paths || {},
-        cwd: worktreePath,
-        baseRef: options.baseRef,
-        headRef: options.headRef,
-    };
-    const rulesResult = phase === 'reality'
-        ? await validateWURules(rulesContext, { phase })
-        : validateWURulesSync(rulesContext, { phase });
-    for (const issue of rulesResult.errors) {
-        allErrors.push(...validationIssueToDisplayLines(issue));
-    }
-    for (const issue of rulesResult.warnings) {
-        allWarnings.push(...validationIssueToDisplayLines(issue));
-    }
-    missingCodePaths.push(...rulesResult.metadata.missingCodePaths);
-    missingCoverageCodePaths.push(...rulesResult.metadata.missingCoverageCodePaths);
-    missingTestPaths.push(...rulesResult.metadata.missingTestPaths);
-    changedFiles.push(...rulesResult.metadata.changedFiles);
-    let suggestedTestPaths = {};
-    if (missingTestPaths.length > 0) {
-        const searchRoot = worktreePath || rootDir;
-        try {
-            suggestedTestPaths = await findSuggestedTestPaths(missingTestPaths, searchRoot);
-        }
-        catch (err) {
-            if (process.env.DEBUG) {
-                console.log(`[wu-preflight] Failed to find suggestions: ${getUnknownErrorMessage(err)}`);
-            }
-        }
-    }
-    return createPreflightResult({
-        valid: allErrors.length === 0,
-        errors: allErrors,
-        warnings: allWarnings,
-        missingCodePaths,
-        missingCoverageCodePaths,
-        missingTestPaths,
-        changedFiles,
-        suggestedTestPaths,
-    });
-}
-export function formatPreflightResult(id, result) {
-    if (result.valid) {
-        const lines = [
-            `${LOG_PREFIX.PREFLIGHT} ${EMOJI.SUCCESS} Preflight validation passed for ${id}`,
-        ];
-        if (Array.isArray(result.warnings) && result.warnings.length > 0) {
-            lines.push('');
-            lines.push(`${LOG_PREFIX.PREFLIGHT} ${EMOJI.WARNING} Warnings:`);
-            lines.push(...result.warnings.map((warning) => `  - ${warning}`));
-        }
-        return lines.join('\n');
-    }
-    const lines = [
-        `${LOG_PREFIX.PREFLIGHT} ${EMOJI.FAILURE} Preflight validation failed for ${id}`,
-        '',
-        ...result.errors,
-    ];
-    if (Array.isArray(result.warnings) && result.warnings.length > 0) {
-        lines.push('');
-        lines.push(`${LOG_PREFIX.PREFLIGHT} ${EMOJI.WARNING} Warnings:`);
-        lines.push(...result.warnings.map((warning) => `  - ${warning}`));
-    }
-    if (result.missingCodePaths.length > 0) {
-        lines.push('');
-        lines.push('Fix options for missing code_paths:');
-        lines.push('  1. Create the missing files/glob targets');
-        lines.push(`  2. Update code_paths in ${id}.yaml to match actual files`);
-    }
-    if (result.missingCoverageCodePaths.length > 0) {
-        lines.push('');
-        lines.push('Fix options for code_paths coverage vs branch diff:');
-        lines.push('  1. Commit changes that touch each missing scoped code_path');
-        lines.push(`  2. Update code_paths in ${id}.yaml to match actual branch scope`);
-        lines.push(`  3. Re-run: pnpm wu:prep --id ${id}`);
-    }
-    if (result.missingTestPaths.length > 0) {
-        lines.push('');
-        lines.push('Fix options for automated test paths:');
-        lines.push('  1. Create the missing test files/glob targets');
-        lines.push(`  2. Update tests in ${id}.yaml to match actual files`);
-        lines.push('  3. Move prose/non-path test notes into tests.manual');
-    }
-    return lines.join('\n');
-}
-/**
- * Build display lines for preflight warnings with a consistent shape.
- */
-export function formatPreflightWarnings(warnings, header = `${LOG_PREFIX.PREFLIGHT} ${EMOJI.WARNING} Warnings:`) {
-    if (!Array.isArray(warnings) || warnings.length === 0) {
-        return [];
-    }
-    return [header, ...warnings.map((warning) => `  - ${warning}`)];
-}
-export const PreflightResult = {};
-export async function findSuggestedTestPaths(missingPaths, rootDir) {
-    const suggestions = {};
-    if (missingPaths.length === 0)
-        return suggestions;
-    const globOptions = {
-        cwd: rootDir,
-        caseSensitiveMatch: false,
-        limit: 5,
-        ignore: ['**/node_modules/**'],
-    };
-    for (const missingPath of missingPaths) {
-        const filename = missingPath.split('/').pop() || missingPath;
-        const basename = filename.replace(/\.[^/.]+$/, '');
-        const cleanBasename = basename.replace(/(\.test|\.spec)$/, '');
-        let matches = await fg(`**/${filename}`, globOptions);
-        if (matches.length === 0) {
-            matches = await fg(`**/${basename}.{ts,js,mjs,tsx,jsx}`, globOptions);
-        }
-        if (matches.length === 0) {
-            matches = await fg(`**/${cleanBasename}.{ts,js,mjs,tsx,jsx}`, globOptions);
-        }
-        if (matches.length > 0) {
-            suggestions[missingPath] = matches.filter((matchPath) => matchPath !== missingPath);
-        }
-    }
-    return suggestions;
-}
-//# sourceMappingURL=wu-preflight-validators.js.map

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

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

package/dist/wu-recovery.d.ts

@@ -1,220 +0,0 @@
-/**
- * WU-1335: Maximum number of recovery attempts before escalating to manual intervention
- * WU-1747: Now derived from the recovery retry preset for consistency
- */
-export declare const MAX_RECOVERY_ATTEMPTS: 4;
-interface RecoveryDoc extends Record<string, unknown> {
-    title?: string;
-    status?: string;
-    locked?: boolean;
-    completed_at?: string;
-    completed?: string | boolean;
-}
-interface ResetWorktreeYAMLForRecoveryParams {
-    worktreePath: string;
-    id: string;
-    doc: RecoveryDoc;
-}
-interface RecoverZombieStateParams {
-    id: string;
-    doc: RecoveryDoc;
-    _worktreePath?: string;
-    _args?: unknown;
-}
-interface RecoverZombieStateResults {
-    stamp: {
-        created: boolean;
-        path: string;
-        reason?: string;
-    } | null;
-    yaml: {
-        updated: boolean;
-        reason?: string;
-    } | null;
-    docs: {
-        status: unknown | null;
-        backlog: unknown | null;
-    };
-    commit?: {
-        committed: boolean;
-        reason?: string;
-    };
-}
-/**
- * WU-1335: Get the path to the recovery marker file for a WU
- *
- * @param {string} id - WU ID
- * @param {string} [baseDir=process.cwd()] - Base directory for .lumenflow
- * @returns {string} Path to recovery marker file
- */
-export declare function getRecoveryMarkerPath(id: string, baseDir?: string): string;
-/**
- * WU-1335: Get the current recovery attempt count for a WU
- *
- * @param {string} id - WU ID
- * @param {string} [baseDir=process.cwd()] - Base directory for .lumenflow
- * @returns {number} Current attempt count (0 if no marker exists)
- */
-export declare function getRecoveryAttemptCount(id: string, baseDir?: string): number;
-/**
- * WU-1335: Increment recovery attempt count for a WU
- *
- * @param {string} id - WU ID
- * @param {string} [baseDir=process.cwd()] - Base directory for .lumenflow
- * @returns {number} New attempt count
- */
-export declare function incrementRecoveryAttempt(id: string, baseDir?: string): number;
-/**
- * WU-1335: Clear recovery attempts for a WU (called on successful recovery)
- *
- * @param {string} id - WU ID
- * @param {string} [baseDir=process.cwd()] - Base directory for .lumenflow
- */
-export declare function clearRecoveryAttempts(id: string, baseDir?: string): void;
-/**
- * WU-1335: Check if recovery should escalate to manual intervention
- *
- * @param {number} attempts - Current attempt count
- * @returns {boolean} True if should escalate
- */
-export declare function shouldEscalateToManualIntervention(attempts: number): boolean;
-/**
- * Detect zombie state
- *
- * @param {object} doc - WU YAML document
- * @param {string|null} worktreePath - Path to worktree
- * @returns {boolean} True if zombie state detected
- */
-export declare function detectZombieState(doc: {
-    status?: string;
-}, worktreePath: string | null): boolean;
-/**
- * WU-1440: Reset worktree WU YAML to in_progress for recovery
- *
- * Instead of committing directly to main (old recovery mode), this function
- * resets the worktree YAML so the normal wu:done merge flow can proceed.
- *
- * Removes completion markers:
- * - status → in_progress
- * - locked → removed
- * - completed_at → removed
- *
- * Preserves all other fields (description, acceptance, code_paths, etc.)
- *
- * @param {object} params - Recovery parameters
- * @param {string} params.worktreePath - Path to worktree root
- * @param {string} params.id - WU ID
- * @param {object} params.doc - WU YAML document (will be mutated)
- * @returns {{ reset: boolean }} Reset result
- */
-export declare function resetWorktreeYAMLForRecovery({ worktreePath, id, doc, }: ResetWorktreeYAMLForRecoveryParams): {
-    reset: boolean;
-};
-/**
- * Recover from zombie state
- *
- * THE COMPLETE FIX for WU-1159 gap:
- * - Ensures stamp exists
- * - Ensures YAML completion markers
- * - Ensures status.md updated (THE FIX)
- * - Ensures backlog.md updated (THE FIX)
- *
- * All operations are idempotent - safe to run multiple times
- *
- * WU-1303: Added atomic rollback - if UnsafeAny operation fails, all files are
- * restored to their original state to prevent leaving main checkout dirty.
- *
- * @param {object} params - Recovery parameters
- * @param {string} params.id - WU ID
- * @param {object} params.doc - WU YAML document
- * @param {string} params.worktreePath - Path to worktree
- * @param {object} params.args - Command-line args
- * @returns {object} Recovery results
- */
-export declare function recoverZombieState({ id, doc, _worktreePath, _args, }: RecoverZombieStateParams): Promise<RecoverZombieStateResults>;
-/**
- * WU-1665: Environment variable key for legacy rollback compatibility guard.
- * When set to "1", the legacy rollback path is used instead of state-machine-driven recovery.
- */
-export declare const LUMENFLOW_LEGACY_ROLLBACK_ENV_KEY = "LUMENFLOW_LEGACY_ROLLBACK";
-/**
- * WU-1665: Check if legacy rollback mode is enabled via environment variable.
- *
- * During the migration window, operators can set LUMENFLOW_LEGACY_ROLLBACK=1
- * to use the pre-WU-1665 recovery path for rollback operations.
- *
- * @returns {boolean} True if legacy rollback is enabled
- */
-export declare function isLegacyRollbackEnabled(): boolean;
-/**
- * WU-1665: Rollback scope determined by the pipeline state where failure occurred.
- *
- * Maps each pipeline stage to the recovery actions needed:
- * - validating/preparing: nothing written, no rollback needed
- * - gating: nothing written (gates are read-only checks), no rollback needed
- * - committing: files written to disk, need snapshot restore
- * - merging: committed to worktree branch, need snapshot + branch rollback
- * - pushing: merged but push failed, need snapshot + branch rollback
- * - cleaningUp: push succeeded, only worktree cleanup remains
- */
-export interface RollbackScope {
-    /** Whether file snapshot restore is needed (files were written to disk) */
-    snapshotRestore: boolean;
-    /** Whether branch-level rollback is needed (commits were made) */
-    branchRollback: boolean;
-    /** Whether worktree cleanup is the remaining action (push already succeeded) */
-    worktreeCleanup: boolean;
-}
-/**
- * WU-1665: Recovery state from the XState pipeline snapshot.
- */
-export interface PipelineRecoveryState {
-    wuId: string;
-    failedAt: string | null;
-    error: string | null;
-    retryCount: number;
-}
-/**
- * WU-1665: State-machine-driven recovery manager.
- *
- * Determines rollback scope from the pipeline's failedAt state, replacing
- * the ad-hoc per-function rollback logic scattered across wu-recovery.ts,
- * wu-transaction.ts, and rollback-utils.ts.
- *
- * Usage:
- * ```ts
- * const manager = new StateMachineRecoveryManager({
- *   wuId: 'WU-1665',
- *   failedAt: 'committing',
- *   error: 'git commit failed',
- *   retryCount: 0,
- * });
- * const scope = manager.getRollbackScope();
- * // scope.snapshotRestore === true
- * // scope.branchRollback === false
- * ```
- */
-export declare class StateMachineRecoveryManager {
-    readonly wuId: string;
-    readonly failedAt: string | null;
-    readonly error: string | null;
-    readonly retryCount: number;
-    constructor(state: PipelineRecoveryState);
-    /**
-     * Determine rollback scope based on the pipeline stage where failure occurred.
-     *
-     * The scope is deterministic: given the same failedAt state, the same
-     * rollback actions are always prescribed.
-     */
-    getRollbackScope(): RollbackScope;
-    /**
-     * Serialize recovery state for persistence (e.g., to .lumenflow/recovery/).
-     */
-    serialize(): string;
-    /**
-     * Deserialize recovery state from persisted JSON.
-     */
-    static deserialize(json: string): StateMachineRecoveryManager;
-}
-export {};
-//# sourceMappingURL=wu-recovery.d.ts.map

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

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