@lumenflow/core 3.1.2 → 3.1.3

package/dist/code-path-validator.d.ts

@@ -1,147 +0,0 @@
-#!/usr/bin/env node
-/**
- * Unified Code Path Validator (WU-1825)
- *
- * Consolidates three separate code path validators into one module:
- * - validateCodePathsExist (wu-done-validators.ts) - file existence for wu:done
- * - validateLaneCodePaths (lane-validator.ts) - lane pattern matching
- * - validateWUCodePaths (wu-validator.ts) - code quality (TODOs, mocks)
- *
- * Usage:
- *   import { validate } from './code-path-validator.js';
- *
- *   // Mode: 'exist' - check file existence (wu:done workflow)
- *   const result = await validate(paths, { mode: 'exist', worktreePath, targetBranch });
- *
- *   // Mode: 'lane' - check lane pattern matching (wu:claim workflow)
- *   const result = validate(paths, { mode: 'lane', lane: 'Operations: Tooling' });
- *
- *   // Mode: 'quality' - check code quality (TODOs, mocks)
- *   const result = validate(paths, { mode: 'quality', worktreePath, allowTodos: false });
- *
- * Part of INIT-023: Workflow Integrity initiative.
- */
-interface ExistValidationResult {
-    valid: boolean;
-    errors: string[];
-    missing: string[];
-}
-interface LaneValidationResult {
-    hasWarnings: boolean;
-    warnings: string[];
-    violations: string[];
-    skipped: boolean;
-}
-interface QualityValidationResult {
-    valid: boolean;
-    errors: string[];
-    warnings: string[];
-}
-interface QualityOptions {
-    allowTodos?: boolean;
-    worktreePath?: string | null;
-}
-interface ValidateOptions {
-    mode?: string;
-    worktreePath?: string;
-    targetBranch?: string;
-    lane?: string;
-    allowTodos?: boolean;
-}
-/**
- * Validation modes for the unified validator
- * @enum {string}
- */
-export declare const VALIDATION_MODES: Readonly<{
-    /** Check file existence - used by wu:done */
-    EXIST: "exist";
-    /** Check lane pattern matching - used by wu:claim */
-    LANE: "lane";
-    /** Check code quality (TODOs, mocks) - used by wu:done */
-    QUALITY: "quality";
-}>;
-/**
- * Check if a file path is a test file
- * @param {string} filePath - Path to check
- * @returns {boolean} True if file is a test file
- */
-declare function isTestFile(filePath: string): boolean;
-/**
- * Check if a file path is a markdown file
- * @param {string} filePath - Path to check
- * @returns {boolean} True if file is a markdown file
- */
-declare function isMarkdownFile(filePath: string): boolean;
-/**
- * Scan a file for TODO/FIXME/HACK/XXX comments
- * @param {string} filePath - Path to file to scan
- * @returns {{found: boolean, matches: Array<{line: number, text: string, pattern: string}>}}
- */
-declare function scanFileForTODOs(filePath: string): {
-    found: boolean;
-    matches: Array<{
-        line: number;
-        text: string;
-        pattern: string | null;
-    }>;
-};
-/**
- * Scan a file for Mock/Stub/Fake class/function names
- * @param {string} filePath - Path to file to scan
- * @returns {{found: boolean, matches: Array<{line: number, text: string, type: string}>}}
- */
-declare function scanFileForMocks(filePath: string): {
-    found: boolean;
-    matches: Array<{
-        line: number;
-        text: string;
-        type: string;
-    }>;
-};
-/**
- * Unified code path validation function
- *
- * @param {string[]} codePaths - Array of file paths to validate
- * @param {object} options - Validation options
- * @param {string} options.mode - Validation mode: 'exist', 'lane', or 'quality'
- * @param {string} [options.worktreePath] - Worktree path (for 'exist' and 'quality' modes)
- * @param {string} [options.targetBranch] - Target branch (for 'exist' mode, branch-only)
- * @param {string} [options.lane] - Lane name (for 'lane' mode)
- * @param {boolean} [options.allowTodos] - Allow TODO comments (for 'quality' mode)
- * @returns {Promise<ExistValidationResult|LaneValidationResult|QualityValidationResult>}
- */
-export declare function validate(codePaths: string[], options?: ValidateOptions): Promise<ExistValidationResult | LaneValidationResult | QualityValidationResult>;
-interface WUDoc {
-    code_paths?: string[];
-}
-interface ExistOptions {
-    targetBranch?: string;
-    worktreePath?: string | null;
-}
-/**
- * @deprecated Use validate(paths, { mode: 'exist' }) instead
- * Backward-compatible wrapper for validateCodePathsExist
- */
-export declare function validateCodePathsExist(doc: WUDoc, _id: string, options?: ExistOptions): Promise<ExistValidationResult>;
-/**
- * @deprecated Use validate(paths, { mode: 'lane', lane }) instead
- * Backward-compatible wrapper for validateLaneCodePaths
- * NOTE: This must remain SYNCHRONOUS for backward compatibility
- */
-export declare function validateLaneCodePaths(doc: WUDoc, lane: string): LaneValidationResult;
-/**
- * @deprecated Use validate(paths, { mode: 'quality' }) instead
- * Backward-compatible wrapper for validateWUCodePaths
- * NOTE: This must remain SYNCHRONOUS for backward compatibility
- */
-export declare function validateWUCodePaths(codePaths: string[], options?: QualityOptions): QualityValidationResult;
-/**
- * Log lane validation warnings to console.
- * Helper function to format and display warnings consistently.
- *
- * @param {LaneValidationResult} result - Result from validateLaneCodePaths
- * @param {string} logPrefix - Log prefix (e.g., "[wu-claim]")
- */
-export declare function logLaneValidationWarnings(result: LaneValidationResult, logPrefix?: string): void;
-export { isTestFile, isMarkdownFile, scanFileForTODOs, scanFileForMocks };
-//# sourceMappingURL=code-path-validator.d.ts.map

package/dist/code-path-validator.d.ts.map

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