@lumenflow/core 3.2.0 → 3.2.1

package/dist/wu-validation.js

@@ -0,0 +1,266 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU Exposure Validation (WU-1999, WU-2022)
+ *
+ * WU-1999: Validates exposure field and UI pairing for wu:done.
+ *          Provides warnings (not errors) to guide completion without blocking.
+ *
+ * WU-2022: Adds BLOCKING validation for feature accessibility.
+ *          When exposure=ui, ensures the feature is actually accessible via navigation.
+ *
+ * Part of INIT-031 Phase 4: Prevent backend-without-UI pattern.
+ *
+ * @see {@link packages/@lumenflow/cli/src/wu-done.ts} - Consumer
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-schema.ts} - WU schema with exposure field
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-constants.ts} - WU_EXPOSURE values
+ */
+import { WU_EXPOSURE } from './wu-constants.js';
+const LANE_PARENTS = {
+    CONTENT: 'content',
+    FRAMEWORK: 'framework',
+    OPERATIONS: 'operations',
+};
+function getLaneParent(lane) {
+    if (!lane || typeof lane !== 'string')
+        return '';
+    return (lane.split(':')[0] ?? '').trim().toLowerCase();
+}
+export function resolveExposureDefault(lane) {
+    const parent = getLaneParent(lane);
+    if (parent === LANE_PARENTS.CONTENT) {
+        return WU_EXPOSURE.DOCUMENTATION;
+    }
+    if (parent === LANE_PARENTS.FRAMEWORK || parent === LANE_PARENTS.OPERATIONS) {
+        return WU_EXPOSURE.BACKEND_ONLY;
+    }
+    return undefined;
+}
+/**
+ * UI verification keywords to search for in acceptance criteria.
+ * Case-insensitive patterns that indicate the acceptance criteria
+ * mentions UI verification.
+ */
+const UI_VERIFICATION_KEYWORDS = [
+    'ui',
+    'frontend',
+    'component',
+    'widget',
+    'page',
+    'displays',
+    'shows',
+    'renders',
+    'user sees',
+    'visible',
+    'screen',
+    'interface',
+];
+/**
+ * Warning message templates with remediation guidance.
+ * All messages include the WU ID for context.
+ */
+export const EXPOSURE_WARNING_MESSAGES = {
+    /**
+     * Warning when exposure field is missing entirely.
+     * @param {string} wuId - The WU identifier
+     * @returns {string} Warning message with remediation
+     */
+    MISSING_EXPOSURE: (wuId) => `${wuId}: exposure field is missing. ` +
+        `Add 'exposure: ui|api|backend-only|documentation' to the WU YAML. ` +
+        `This helps ensure user-facing features have corresponding UI coverage.`,
+    /**
+     * Warning when API exposure lacks UI pairing WUs.
+     * @param {string} wuId - The WU identifier
+     * @returns {string} Warning message with remediation
+     */
+    MISSING_UI_PAIRING: (wuId) => `${wuId}: exposure=api but ui_pairing_wus not specified. ` +
+        `Add 'ui_pairing_wus: [WU-XXX]' listing UI WUs that consume this API, ` +
+        `or set exposure to 'backend-only' if no UI is planned.`,
+    /**
+     * Warning when API exposure lacks UI verification in acceptance criteria.
+     * @param {string} wuId - The WU identifier
+     * @returns {string} Warning message with remediation
+     */
+    MISSING_UI_VERIFICATION: (wuId) => `${wuId}: exposure=api but acceptance criteria lacks UI verification mention. ` +
+        `Consider adding a criterion like 'UI displays the data correctly' to ensure end-to-end coverage.`,
+    /**
+     * Recommendation for user_journey when exposure is UI.
+     * @param {string} wuId - The WU identifier
+     * @returns {string} Warning message with remediation
+     */
+    MISSING_USER_JOURNEY: (wuId) => `${wuId}: exposure=ui but user_journey field not present. ` +
+        `Adding 'user_journey: "<description>"' is recommended to document the user flow.`,
+};
+/**
+ * Check if acceptance criteria mentions UI verification.
+ *
+ * Searches acceptance criteria (array or nested object) for keywords
+ * that indicate UI verification is mentioned.
+ *
+ * @param {string[]|Record<string, string[]>} acceptance - Acceptance criteria
+ * @returns {boolean} True if UI verification is mentioned
+ */
+function hasUIVerificationInAcceptance(acceptance) {
+    // Flatten acceptance to array of strings
+    let criteria;
+    if (Array.isArray(acceptance)) {
+        criteria = acceptance;
+    }
+    else {
+        // Nested object format: { category: [items] }
+        criteria = Object.values(acceptance).flat();
+    }
+    // Search for UI-related keywords (case-insensitive)
+    const lowerCriteria = criteria.map((c) => (typeof c === 'string' ? c.toLowerCase() : ''));
+    return lowerCriteria.some((criterion) => UI_VERIFICATION_KEYWORDS.some((keyword) => criterion.includes(keyword.toLowerCase())));
+}
+export function validateExposure(wu, options = {}) {
+    const warnings = [];
+    // Early return if skip flag is set
+    if (options.skipExposureCheck) {
+        return { valid: true, warnings: [] };
+    }
+    const wuId = wu.id || 'WU-???';
+    const exposure = wu.exposure || resolveExposureDefault(wu.lane);
+    // Check 1: exposure field presence
+    if (!exposure) {
+        warnings.push(EXPOSURE_WARNING_MESSAGES.MISSING_EXPOSURE(wuId));
+        // Can't check further without exposure
+        return { valid: true, warnings };
+    }
+    // Check 2 & 3: API exposure checks
+    if (exposure === WU_EXPOSURE.API) {
+        // Check for ui_pairing_wus
+        const uiPairingWus = wu.ui_pairing_wus;
+        if (!uiPairingWus || uiPairingWus.length === 0) {
+            warnings.push(EXPOSURE_WARNING_MESSAGES.MISSING_UI_PAIRING(wuId));
+        }
+        // Check acceptance criteria for UI verification mention
+        const acceptance = wu.acceptance;
+        if (acceptance && !hasUIVerificationInAcceptance(acceptance)) {
+            warnings.push(EXPOSURE_WARNING_MESSAGES.MISSING_UI_VERIFICATION(wuId));
+        }
+    }
+    // Check 4: UI exposure checks
+    if (exposure === WU_EXPOSURE.UI) {
+        // Recommend user_journey if not present
+        if (!wu.user_journey) {
+            warnings.push(EXPOSURE_WARNING_MESSAGES.MISSING_USER_JOURNEY(wuId));
+        }
+    }
+    // backend-only and documentation exposures: no additional checks
+    return { valid: true, warnings };
+}
+// =============================================================================
+// WU-2022: Feature Accessibility Validation (BLOCKING)
+// =============================================================================
+/**
+ * Navigation keywords to search for in tests.manual.
+ * Case-insensitive patterns that indicate manual navigation testing.
+ */
+const NAVIGATION_KEYWORDS = [
+    'navigate',
+    'navigation',
+    'accessible',
+    'access',
+    'visible',
+    'reachable',
+    'go to',
+    'visit',
+    'open',
+    'click',
+    'link',
+    'route',
+    'url',
+    'path',
+    '/space',
+    '/dashboard',
+    '/settings',
+];
+/**
+ * Pattern to detect Next.js page files in code_paths.
+ * Matches: app/.../page.tsx, pages/.../index.tsx, pages/.../*.tsx
+ */
+const PAGE_FILE_PATTERNS = [
+    /app\/.*\/page\.tsx$/,
+    /app\/.*\/page\.ts$/,
+    /pages\/.*\.tsx$/,
+    /pages\/.*\.ts$/,
+];
+/**
+ * Error message templates for accessibility validation (WU-2022).
+ * These are BLOCKING errors, not warnings.
+ */
+export const ACCESSIBILITY_ERROR_MESSAGES = {
+    /**
+     * Error when UI exposure lacks navigation accessibility proof.
+     * @param {string} wuId - The WU identifier
+     * @returns {string} Error message with remediation guidance
+     */
+    UI_NOT_ACCESSIBLE: (wuId) => `${wuId}: exposure=ui but feature accessibility not verified. ` +
+        `Add one of the following:\n` +
+        `  1. navigation_path: '/your-route' - specify the route where feature is accessible\n` +
+        `  2. code_paths: [..., 'apps/web/src/app/.../page.tsx'] - include a page file\n` +
+        `  3. tests.manual: ['Navigate to /path and verify feature is accessible'] - add navigation test\n\n` +
+        `This prevents "orphaned code" - features that exist but users cannot access. ` +
+        `Use --skip-accessibility-check to bypass (not recommended).`,
+};
+/**
+ * Check if code_paths includes a page file (Next.js page).
+ *
+ * @param {string[]} codePaths - Array of code paths
+ * @returns {boolean} True if UnsafeAny code path matches a page file pattern
+ */
+function hasPageFileInCodePaths(codePaths) {
+    if (!codePaths || !Array.isArray(codePaths)) {
+        return false;
+    }
+    return codePaths.some((codePath) => PAGE_FILE_PATTERNS.some((pattern) => pattern.test(codePath)));
+}
+/**
+ * Check if tests.manual includes navigation verification.
+ *
+ * @param {object} tests - Tests object from WU YAML
+ * @returns {boolean} True if manual tests mention navigation
+ */
+function hasNavigationInManualTests(tests) {
+    if (!tests || typeof tests !== 'object') {
+        return false;
+    }
+    const manualTests = tests.manual;
+    if (!manualTests || !Array.isArray(manualTests)) {
+        return false;
+    }
+    const lowerTests = manualTests.map((t) => (typeof t === 'string' ? t.toLowerCase() : ''));
+    return lowerTests.some((test) => NAVIGATION_KEYWORDS.some((keyword) => test.includes(keyword.toLowerCase())));
+}
+export function validateFeatureAccessibility(wu, options = {}) {
+    const errors = [];
+    // Early return if skip flag is set
+    if (options.skipAccessibilityCheck) {
+        return { valid: true, errors: [] };
+    }
+    const exposure = wu.exposure;
+    // Skip validation for non-UI exposures
+    if (!exposure || exposure !== WU_EXPOSURE.UI) {
+        return { valid: true, errors: [] };
+    }
+    // For exposure=ui, verify accessibility via one of three methods
+    const wuId = wu.id || 'WU-???';
+    // Method 1: navigation_path is specified
+    if (wu.navigation_path && wu.navigation_path.trim().length > 0) {
+        return { valid: true, errors: [] };
+    }
+    // Method 2: code_paths includes a page file
+    if (hasPageFileInCodePaths(wu.code_paths)) {
+        return { valid: true, errors: [] };
+    }
+    // Method 3: tests.manual includes navigation verification
+    if (hasNavigationInManualTests(wu.tests)) {
+        return { valid: true, errors: [] };
+    }
+    // No accessibility proof found - this is a blocking error
+    errors.push(ACCESSIBILITY_ERROR_MESSAGES.UI_NOT_ACCESSIBLE(wuId));
+    return { valid: false, errors };
+}
+//# sourceMappingURL=wu-validation.js.map

package/dist/wu-validation.js.map

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

package/dist/wu-validator.d.ts

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+/**
+ * WU Validator - Enforces code quality rules from Definition of Done
+ *
+ * Validates WU completion requirements:
+ * - No TODO/FIXME/HACK/XXX comments in production code
+ * - No Mock/Stub/Fake classes in production code
+ * - Excludes test files from scans
+ * - Excludes markdown files from TODO scans (documentation prose)
+ *
+ * Used by wu:done before creating stamp.
+ */
+export interface TodoMatch {
+    line: number;
+    text: string;
+    pattern: string;
+}
+export interface TodoScanResult {
+    found: boolean;
+    matches: TodoMatch[];
+}
+export interface MockMatch {
+    line: number;
+    text: string;
+    type: string;
+}
+export interface MockScanResult {
+    found: boolean;
+    matches: MockMatch[];
+}
+interface ValidateWUCodePathsResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Check if a file path is a test file
+ * @param {string} filePath - Path to check
+ * @returns {boolean} True if file is a test file
+ */
+export 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
+ */
+export 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}>}}
+ */
+export declare function scanFileForTODOs(filePath: string): TodoScanResult;
+/**
+ * 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}>}}
+ */
+export declare function scanFileForMocks(filePath: string): MockScanResult;
+/**
+ * Options for validating WU code paths
+ */
+export interface ValidateWUCodePathsOptions {
+    /** Allow TODO comments (with warning) */
+    allowTodos?: boolean;
+    /** Optional worktree path to validate files from */
+    worktreePath?: string | null;
+}
+/**
+ * Validate all code paths for a WU
+ * @param {Array<string>} codePaths - Array of file/directory paths from WU YAML
+ * @param {ValidateWUCodePathsOptions} options - Validation options
+ * @returns {{valid: boolean, errors: Array<string>, warnings: Array<string>}}
+ */
+export declare function validateWUCodePaths(codePaths: string[] | null | undefined, options?: ValidateWUCodePathsOptions): ValidateWUCodePathsResult;
+/**
+ * Result of placeholder validation
+ */
+export interface PlaceholderValidationResult {
+    /** Whether validation passed (no placeholders found) */
+    valid: boolean;
+    /** List of validation errors */
+    errors: string[];
+    /** Fields that contain placeholders */
+    fieldsWithPlaceholders: string[];
+}
+/**
+ * WU-1025: Validate that WU spec content does not contain PLACEHOLDER markers
+ *
+ * Used by wu:create (for inline content) and wu:claim (for full spec).
+ * Provides clear error messages telling the user which fields need to be fixed.
+ *
+ * @param {object} spec - WU spec content to validate
+ * @param {string} [spec.description] - WU description
+ * @param {string[]|object} [spec.acceptance] - Acceptance criteria (array or object)
+ * @returns {PlaceholderValidationResult} Validation result with errors and affected fields
+ *
+ * @example
+ * // wu:create validation (inline content only)
+ * const result = validateNoPlaceholders({ description: args.description });
+ * if (!result.valid) {
+ *   die(`Cannot create WU:\n${result.errors.join('\n')}`);
+ * }
+ *
+ * @example
+ * // wu:claim validation (full spec)
+ * const result = validateNoPlaceholders(wuDoc);
+ * if (!result.valid) {
+ *   die(`Cannot claim WU:\n${result.errors.join('\n')}`);
+ * }
+ */
+export declare function validateNoPlaceholders(spec: {
+    description?: string;
+    acceptance?: string[] | Record<string, string[]>;
+}): PlaceholderValidationResult;
+/**
+ * WU-1025: Build error message for placeholder validation failure
+ *
+ * Creates a user-friendly error message with actionable guidance.
+ *
+ * @param {string} command - Command that failed ('wu:create' or 'wu:claim')
+ * @param {PlaceholderValidationResult} result - Validation result
+ * @param {string} [wuId] - WU ID (for wu:claim error messages)
+ * @returns {string} Formatted error message
+ */
+export declare function buildPlaceholderErrorMessage(command: string, result: PlaceholderValidationResult, wuId?: string): string;
+export {};
+//# sourceMappingURL=wu-validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wu-validator.d.ts","sourceRoot":"","sources":["../src/wu-validator.ts"],"names":[],"mappings":";AAGA;;;;;;;;;;GAUG;AAUH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAOD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAeD,UAAU,yBAAyB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAapD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAoJjE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAoDjE;AAkBD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,yCAAyC;IACzC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,EACtC,OAAO,GAAE,0BAA+B,GACvC,yBAAyB,CA2D3B;AAgDD;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,wDAAwD;IACxD,KAAK,EAAE,OAAO,CAAC;IACf,gCAAgC;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,uCAAuC;IACvC,sBAAsB,EAAE,MAAM,EAAE,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAClD,GAAG,2BAA2B,CAgC9B;AA2BD;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,2BAA2B,EACnC,IAAI,CAAC,EAAE,MAAM,GACZ,MAAM,CA0BR"}