@lumenflow/core 3.1.3 → 3.2.1

package/dist/wu-paths.js

@@ -0,0 +1,223 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU Paths - Centralized path management for Work Units
+ *
+ * All paths are configurable via workspace.yaml (`software_delivery`) config.
+ *
+ * @module wu-paths
+ */
+import * as path from 'node:path';
+import { getWorktreePath, getProjectRoot as getProjectRootFromConstants } from './wu-constants.js';
+import { getConfig, getProjectRoot as getProjectRootFromConfig } from './lumenflow-config.js';
+/**
+ * Directory depth constants for path resolution.
+ * These define how many levels deep each standard file is from repo root.
+ */
+const _PATH_DEPTHS = {
+    /** backlog.md is 4 levels deep: docs/04-operations/tasks/backlog.md */
+    BACKLOG: 4,
+    /** status.md is 4 levels deep: docs/04-operations/tasks/status.md */
+    STATUS: 4,
+    /** WU YAML files are 5 levels deep: docs/04-operations/tasks/wu/{id}.yaml */
+    WU_YAML: 5,
+    /** State store is 3 levels deep: .lumenflow/state/wu-events.jsonl */
+    STATE_STORE: 3,
+};
+/**
+ * Resolve repo root from an absolute file path by traversing up N directory levels.
+ *
+ * @param absolutePath - Absolute path to a file within the repo
+ * @param depth - Number of directory levels to traverse up
+ * @returns Absolute path to repo root
+ */
+export function resolveRepoRoot(absolutePath, depth) {
+    let result = absolutePath;
+    for (let i = 0; i < depth; i++) {
+        result = path.dirname(result);
+    }
+    return result;
+}
+/**
+ * Compute the directory depth of a relative path (number of path segments).
+ *
+ * WU-1523: Used to dynamically determine backlog depth from config
+ * instead of using hardcoded PATH_DEPTHS constants. This ensures
+ * getStateStoreDirFromBacklog works correctly for all docs structures
+ * (arc42: docs/04-operations/tasks/backlog.md, simple: docs/tasks/backlog.md, etc.)
+ *
+ * @param relativePath - Relative file path (e.g., 'docs/tasks/backlog.md')
+ * @returns Number of path segments (e.g., 3 for 'docs/tasks/backlog.md')
+ */
+function computePathDepth(relativePath) {
+    // Normalize separators and split on path separator
+    const normalized = relativePath.replace(/\\/g, '/');
+    return normalized.split('/').filter(Boolean).length;
+}
+/**
+ * Get the state store directory path from backlog.md path.
+ *
+ * WU-1523: Now computes depth dynamically from configured backlog path
+ * instead of using a hardcoded depth constant. This fixes empty backlog.md
+ * and status.md rendering in scaffolded projects with non-default docs structures.
+ *
+ * @param backlogPath - Absolute path to backlog.md
+ * @returns Absolute path to state store directory
+ */
+export function getStateStoreDirFromBacklog(backlogPath) {
+    const config = getConfig();
+    const depth = computePathDepth(config.directories.backlogPath);
+    const repoRoot = resolveRepoRoot(backlogPath, depth);
+    return path.join(repoRoot, config.state.stateDir);
+}
+/**
+ * Create WU paths object with configurable base paths
+ *
+ * @param options - Options for path generation
+ * @param options.projectRoot - Override project root
+ * @returns WU paths object
+ */
+export function createWuPaths(options = {}) {
+    const config = getConfig({ projectRoot: options.projectRoot });
+    return {
+        /**
+         * Get path to WU YAML file
+         * @param id - WU ID (e.g., 'WU-123')
+         * @returns Path to WU YAML file
+         */
+        WU: (id) => path.join(config.directories.wuDir, `${id}.yaml`),
+        /**
+         * Get path to WU directory
+         * @returns Path to WU directory
+         */
+        WU_DIR: () => config.directories.wuDir,
+        /**
+         * Get path to status.md
+         * @returns Path to status.md
+         */
+        STATUS: () => config.directories.statusPath,
+        /**
+         * Get path to backlog.md
+         * @returns Path to backlog.md
+         */
+        BACKLOG: () => config.directories.backlogPath,
+        /**
+         * Get path to stamps directory
+         * @returns Path to stamps directory
+         */
+        STAMPS_DIR: () => config.state.stampsDir,
+        /**
+         * Get path to WU done stamp file
+         * @param id - WU ID (e.g., 'WU-123')
+         * @returns Path to stamp file
+         */
+        STAMP: (id) => path.join(config.state.stampsDir, `${id}.done`),
+        /**
+         * Get path to state directory
+         * @returns Path to state directory
+         */
+        STATE_DIR: () => config.state.stateDir,
+        /**
+         * Get path to initiatives directory
+         * @returns Path to initiatives directory
+         */
+        INITIATIVES_DIR: () => config.directories.initiativesDir,
+        /**
+         * Get path to initiative YAML file
+         * @param id - Initiative ID (e.g., 'INIT-001')
+         * @returns Path to initiative YAML file
+         */
+        INITIATIVE: (id) => path.join(config.directories.initiativesDir, `${id}.yaml`),
+        /**
+         * Get path to worktrees directory
+         * @returns Path to worktrees directory
+         */
+        WORKTREES_DIR: () => config.directories.worktrees,
+        /**
+         * Get path to plans directory
+         * @returns Path to plans directory (WU-1301)
+         */
+        PLANS_DIR: () => config.directories.plansDir,
+        /**
+         * Get path to templates directory
+         * @returns Path to templates directory (WU-1310)
+         */
+        TEMPLATES_DIR: () => config.directories.templatesDir,
+        /**
+         * Get path to onboarding directory
+         * @returns Path to onboarding directory (WU-1310)
+         */
+        ONBOARDING_DIR: () => config.directories.onboardingDir,
+    };
+}
+/**
+ * Default WU paths using default config
+ * For backwards compatibility with existing code
+ */
+export const WU_PATHS = createWuPaths();
+/**
+ * Generate default worktree path from WU document
+ *
+ * @param doc - WU document with lane and id fields
+ * @returns Worktree path or null if inputs are invalid
+ */
+export function defaultWorktreeFrom(doc) {
+    if (!doc)
+        return null;
+    const lane = doc.lane;
+    const id = doc.id;
+    // Validate inputs
+    if (!lane || !id)
+        return null;
+    // Convert to string and trim
+    const laneStr = String(lane).trim();
+    const idStr = String(id).trim();
+    // Check for empty strings after trimming
+    if (laneStr === '' || idStr === '')
+        return null;
+    // Use centralized getWorktreePath from wu-constants
+    return getWorktreePath(laneStr, idStr);
+}
+/**
+ * Resolve a repo-root-relative path to an absolute path using project root.
+ *
+ * @param relativePath - Path relative to project root
+ * @param moduleUrl - import.meta.url of the calling module (for backwards compat)
+ * @returns Absolute path resolved from project root
+ */
+export function resolveFromProjectRoot(relativePath, moduleUrl) {
+    // Try config-based project root first, fall back to constants-based
+    let projectRoot;
+    try {
+        projectRoot = getProjectRootFromConfig();
+    }
+    catch {
+        projectRoot = moduleUrl ? getProjectRootFromConstants(moduleUrl) : process.cwd();
+    }
+    return path.join(projectRoot, relativePath);
+}
+/**
+ * Get absolute path to WU YAML file
+ *
+ * @param id - WU ID (e.g., 'WU-123')
+ * @param options - Options
+ * @returns Absolute path to WU YAML file
+ */
+export function getAbsoluteWuPath(id, options = {}) {
+    const projectRoot = options.projectRoot || getProjectRootFromConfig();
+    const paths = createWuPaths({ projectRoot });
+    return path.join(projectRoot, paths.WU(id));
+}
+/**
+ * Get absolute path to stamp file
+ *
+ * @param id - WU ID (e.g., 'WU-123')
+ * @param options - Options
+ * @returns Absolute path to stamp file
+ */
+export function getAbsoluteStampPath(id, options = {}) {
+    const projectRoot = options.projectRoot || getProjectRootFromConfig();
+    const paths = createWuPaths({ projectRoot });
+    return path.join(projectRoot, paths.STAMP(id));
+}
+//# sourceMappingURL=wu-paths.js.map

package/dist/wu-paths.js.map

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

package/dist/wu-preflight-validators.d.ts

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+import { type ValidationPhase } from './wu-rules-engine.js';
+interface PreflightResultData {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    missingCodePaths: string[];
+    missingCoverageCodePaths: string[];
+    missingTestPaths: string[];
+    changedFiles: string[];
+    suggestedTestPaths: Record<string, string[]>;
+}
+interface CreatePreflightResultInput {
+    valid: boolean;
+    errors?: string[];
+    warnings?: string[];
+    missingCodePaths?: string[];
+    missingCoverageCodePaths?: string[];
+    missingTestPaths?: string[];
+    changedFiles?: string[];
+    suggestedTestPaths?: Record<string, string[]>;
+}
+interface PathValidationResult {
+    valid: boolean;
+    errors: string[];
+    missing: string[];
+}
+/**
+ * Create a PreflightResult object
+ */
+export declare function createPreflightResult({ valid, errors, warnings, missingCodePaths, missingCoverageCodePaths, missingTestPaths, changedFiles, suggestedTestPaths, }: CreatePreflightResultInput): PreflightResultData;
+/**
+ * Validate code_paths files/globs exist on disk.
+ */
+export declare function validateCodePathsExistence(codePaths: unknown, rootDir: string): PathValidationResult;
+/**
+ * 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 declare function validateTestPathsExistence(tests: unknown, rootDir: string): PathValidationResult;
+export interface ValidatePreflightOptions {
+    /** Root directory for path resolution (fallback) */
+    rootDir?: string;
+    /** Worktree path (preferred source for YAML and file checks) */
+    worktreePath?: string | null;
+    /** Validation phase (default: reality for preflight entrypoints) */
+    phase?: ValidationPhase;
+    /** Optional git base ref for reality diff-aware checks */
+    baseRef?: string;
+    /** Optional git head ref for reality diff-aware checks */
+    headRef?: string;
+}
+export declare function validatePreflight(id: string, options?: ValidatePreflightOptions): Promise<PreflightResultData>;
+export declare function formatPreflightResult(id: string, result: PreflightResultData): string;
+/**
+ * Build display lines for preflight warnings with a consistent shape.
+ */
+export declare function formatPreflightWarnings(warnings: string[] | undefined, header?: string): string[];
+export declare const PreflightResult: {};
+export declare function findSuggestedTestPaths(missingPaths: string[], rootDir: string): Promise<Record<string, string[]>>;
+export {};
+//# sourceMappingURL=wu-preflight-validators.d.ts.map

package/dist/wu-preflight-validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-preflight-validators.d.ts","sourceRoot":"","sources":["../src/wu-preflight-validators.ts"],"names":[],"mappings":";AAmBA,OAAO,EAIL,KAAK,eAAe,EAIrB,MAAM,sBAAsB,CAAC;AAE9B,UAAU,mBAAmB;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC9C;AAED,UAAU,0BAA0B;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;IACpC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC/C;AAYD,UAAU,oBAAoB;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAUD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,KAAK,EACL,MAAW,EACX,QAAa,EACb,gBAAqB,EACrB,wBAA6B,EAC7B,gBAAqB,EACrB,YAAiB,EACjB,kBAAuB,GACxB,EAAE,0BAA0B,GAAG,mBAAmB,CAWlD;AAwCD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,MAAM,GACd,oBAAoB,CAwBtB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAgChG;AAED,MAAM,WAAW,wBAAwB;IACvC,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,oEAAoE;IACpE,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,mBAAmB,CAAC,CAgF9B;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAiDrF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,EAC9B,MAAM,SAAuD,GAC5D,MAAM,EAAE,CAMV;AAED,eAAO,MAAM,eAAe,IAAK,CAAC;AAElC,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAiCnC"}

package/dist/wu-preflight-validators.js

@@ -0,0 +1,277 @@
+#!/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

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