@lumenflow/core 3.2.0 → 3.2.1

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

@@ -0,0 +1,145 @@
+#!/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>;
+type WUDoc = Pick<import('./wu-doc-types.js').WUDocBase, 'code_paths'>;
+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

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