@lumenflow/core 3.1.1 → 3.1.3

package/dist/wu-validation.js

@@ -1,266 +0,0 @@
-// 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

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

package/dist/wu-validator.d.ts

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

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