@lumenflow/cli 3.1.2 → 3.2.0

package/dist/formatters.js

@@ -1,151 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * Beautiful CLI Output Formatters
- *
- * WU-1929: Provides branded header, colored status indicators,
- * structured tables, and progress spinners for consistent CLI output.
- *
- * Dependencies: chalk (color), cli-table3 (tables) - both already in package.json.
- * Spinner: lightweight inline implementation (no external dependency).
- *
- * @module formatters
- */
-import chalk from 'chalk';
-import Table from 'cli-table3';
-// ── Constants ───────────────────────────────────────────────────────
-const BRAND_NAME = 'LumenFlow';
-const HEADER_WIDTH = 50;
-const SPINNER_INTERVAL_MS = 80;
-const SPINNER_FRAMES = ['|', '/', '-', '\\'];
-/**
- * Color mappings for WU status values.
- * Maps each status to a chalk color function name.
- */
-export const STATUS_COLORS = {
-    ready: chalk.cyan,
-    in_progress: chalk.yellow,
-    done: chalk.green,
-    blocked: chalk.red,
-    waiting: chalk.magenta,
-};
-/** Default color for unknown statuses */
-const DEFAULT_STATUS_COLOR = chalk.white;
-// ── AC1: Branded Header ─────────────────────────────────────────────
-/**
- * Format a branded header string with version information.
- *
- * @param options - Header options
- * @param options.version - CLI version string (optional)
- * @returns Formatted header string
- */
-export function formatHeader(options = {}) {
-    const separator = chalk.dim('─'.repeat(HEADER_WIDTH));
-    const versionStr = options.version ? ` v${options.version}` : '';
-    const title = chalk.bold.cyan(`${BRAND_NAME}${versionStr}`);
-    const tagline = chalk.dim('The governance layer between AI agents and the world.');
-    return [separator, title, tagline, separator].join('\n');
-}
-/**
- * Print the branded header to console.log.
- *
- * @param options - Header options
- * @param options.version - CLI version string (optional)
- */
-export function printHeader(options = {}) {
-    console.log(formatHeader(options));
-}
-// ── AC2: Colored Status Indicators ──────────────────────────────────
-/**
- * Apply color to a WU status string based on its value.
- *
- * @param status - The WU status string (e.g., "ready", "in_progress", "done", "blocked")
- * @returns Colored string suitable for terminal output
- */
-export function statusColor(status) {
-    const colorFn = STATUS_COLORS[status] ?? DEFAULT_STATUS_COLOR;
-    return colorFn(status);
-}
-// ── AC3: Structured Tables ──────────────────────────────────────────
-/**
- * Create a formatted table string using cli-table3.
- *
- * @param options - Table configuration
- * @param options.head - Column headers
- * @param options.rows - Array of row arrays
- * @param options.colWidths - Optional column widths
- * @returns Formatted table string
- */
-export function createStatusTable(options) {
-    const tableConfig = {
-        head: options.head,
-        style: {
-            head: ['cyan'],
-        },
-    };
-    if (options.colWidths) {
-        tableConfig.colWidths = options.colWidths;
-    }
-    const table = new Table(tableConfig);
-    for (const row of options.rows) {
-        table.push(row);
-    }
-    return table.toString();
-}
-/**
- * Create a lightweight terminal spinner for long-running operations.
- * Uses stderr to avoid polluting stdout (which may be piped).
- * No external dependency required.
- *
- * @param message - The message to display next to the spinner
- * @returns Spinner object with start/stop/succeed/fail methods
- */
-export function createSpinner(message) {
-    let intervalId = null;
-    let frameIndex = 0;
-    function clearLine() {
-        // Move cursor to beginning of line and clear it
-        process.stderr.write('\r\x1B[K');
-    }
-    function renderFrame() {
-        const frame = SPINNER_FRAMES[frameIndex % SPINNER_FRAMES.length];
-        clearLine();
-        process.stderr.write(`${chalk.cyan(frame)} ${message}`);
-        frameIndex++;
-    }
-    return {
-        start() {
-            if (intervalId !== null)
-                return;
-            frameIndex = 0;
-            renderFrame();
-            intervalId = setInterval(renderFrame, SPINNER_INTERVAL_MS);
-        },
-        stop() {
-            if (intervalId !== null) {
-                clearInterval(intervalId);
-                intervalId = null;
-            }
-            clearLine();
-        },
-        succeed(msg) {
-            if (intervalId !== null) {
-                clearInterval(intervalId);
-                intervalId = null;
-            }
-            clearLine();
-            const text = msg ?? message;
-            process.stderr.write(`${chalk.green('✓')} ${text}\n`);
-        },
-        fail(msg) {
-            if (intervalId !== null) {
-                clearInterval(intervalId);
-                intervalId = null;
-            }
-            clearLine();
-            const text = msg ?? message;
-            process.stderr.write(`${chalk.red('✗')} ${text}\n`);
-        },
-    };
-}
-//# sourceMappingURL=formatters.js.map

package/dist/formatters.js.map

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

package/dist/gate-defaults.js

@@ -1,131 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-import { GATE_NAMES, GATE_COMMANDS, SCRIPTS } from '@lumenflow/core/wu-constants';
-/**
- * Register the default docs-only gates into the registry.
- *
- * These gates run when --docs-only is passed or when risk detection
- * identifies the change as documentation-only.
- *
- * @param registry - Gate registry to populate
- * @param options - Configuration options affecting gate behavior
- */
-export function registerDocsOnlyGates(registry, options) {
-    const { laneHealthMode, testsRequired, docsOnlyTestPlan } = options;
-    // WU-2252: Invariants check runs first (non-bypassable)
-    registry.register({
-        name: GATE_NAMES.INVARIANTS,
-        cmd: GATE_COMMANDS.INVARIANTS,
-    });
-    registry.register({
-        name: GATE_NAMES.FORMAT_CHECK,
-        scriptName: SCRIPTS.FORMAT_CHECK,
-        // run function is injected by the gate runner (runFormatCheckGate)
-        // We use a sentinel to indicate this gate needs its run function set
-        cmd: undefined,
-        run: undefined,
-    });
-    registry.register({
-        name: GATE_NAMES.SPEC_LINTER,
-        scriptName: SCRIPTS.SPEC_LINTER,
-    });
-    // WU-1467: prompts:lint removed -- was a stub (exit 0)
-    registry.register({
-        name: GATE_NAMES.BACKLOG_SYNC,
-    });
-    // WU-1191: Lane health check (configurable: warn/error/off)
-    registry.register({
-        name: GATE_NAMES.LANE_HEALTH,
-        warnOnly: laneHealthMode !== 'error',
-    });
-    // WU-1315: Onboarding smoke test
-    registry.register({
-        name: GATE_NAMES.ONBOARDING_SMOKE_TEST,
-        cmd: GATE_COMMANDS.ONBOARDING_SMOKE_TEST,
-    });
-    // WU-1299: Filtered tests for packages in code_paths (if UnsafeAny)
-    if (docsOnlyTestPlan && docsOnlyTestPlan.mode === 'filtered') {
-        registry.register({
-            name: GATE_NAMES.TEST,
-            warnOnly: !testsRequired,
-        });
-    }
-}
-/**
- * Register the default code gates into the registry.
- *
- * These gates run for non-docs-only changes and include the full
- * lint, typecheck, and test pipeline.
- *
- * @param registry - Gate registry to populate
- * @param options - Configuration options affecting gate behavior
- */
-export function registerCodeGates(registry, options) {
-    const { isFullLint, isFullTests, isFullCoverage, laneHealthMode, testsRequired, shouldRunIntegration, configuredTestFullCmd, } = options;
-    // WU-2252: Invariants check runs first (non-bypassable)
-    registry.register({
-        name: GATE_NAMES.INVARIANTS,
-        cmd: GATE_COMMANDS.INVARIANTS,
-    });
-    registry.register({
-        name: GATE_NAMES.FORMAT_CHECK,
-        scriptName: SCRIPTS.FORMAT_CHECK,
-    });
-    registry.register({
-        name: GATE_NAMES.LINT,
-        cmd: isFullLint ? `pnpm ${SCRIPTS.LINT}` : GATE_COMMANDS.INCREMENTAL,
-        scriptName: SCRIPTS.LINT,
-    });
-    registry.register({
-        name: GATE_NAMES.TYPECHECK,
-        cmd: `pnpm ${SCRIPTS.TYPECHECK}`,
-        scriptName: SCRIPTS.TYPECHECK,
-    });
-    registry.register({
-        name: GATE_NAMES.SPEC_LINTER,
-        scriptName: SCRIPTS.SPEC_LINTER,
-    });
-    // WU-1467: prompts:lint removed -- was a stub (exit 0)
-    registry.register({
-        name: GATE_NAMES.BACKLOG_SYNC,
-    });
-    registry.register({
-        name: GATE_NAMES.SUPABASE_DOCS_LINTER,
-    });
-    // WU-1191: Lane health check
-    registry.register({
-        name: GATE_NAMES.LANE_HEALTH,
-        warnOnly: laneHealthMode !== 'error',
-    });
-    // WU-1315: Onboarding smoke test
-    registry.register({
-        name: GATE_NAMES.ONBOARDING_SMOKE_TEST,
-        cmd: GATE_COMMANDS.ONBOARDING_SMOKE_TEST,
-    });
-    // WU-2062: Safety-critical tests ALWAYS run
-    registry.register({
-        name: GATE_NAMES.SAFETY_CRITICAL_TEST,
-        cmd: GATE_COMMANDS.SAFETY_CRITICAL_TEST,
-        warnOnly: !testsRequired,
-    });
-    // WU-1920: Changed tests by default, full suite with --full-tests
-    registry.register({
-        name: GATE_NAMES.TEST,
-        cmd: isFullTests || isFullCoverage ? configuredTestFullCmd : GATE_COMMANDS.INCREMENTAL_TEST,
-        warnOnly: !testsRequired,
-    });
-    // WU-2062: Integration tests only for high-risk changes
-    if (shouldRunIntegration) {
-        registry.register({
-            name: GATE_NAMES.INTEGRATION_TEST,
-            cmd: GATE_COMMANDS.TIERED_TEST,
-            warnOnly: !testsRequired,
-        });
-    }
-    // WU-1433: Coverage gate
-    registry.register({
-        name: GATE_NAMES.COVERAGE,
-        cmd: GATE_COMMANDS.COVERAGE_GATE,
-    });
-}
-//# sourceMappingURL=gate-defaults.js.map

package/dist/gate-defaults.js.map

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

package/dist/gate-registry.js

@@ -1,73 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * Registry for quality gates.
- *
- * Gates are registered in order and executed sequentially.
- * New gates can be added by calling `register()` without modifying
- * the core executeGates() function.
- */
-export class GateRegistry {
-    gates = [];
-    nameIndex = new Map();
-    /**
-     * Register a single gate definition.
-     *
-     * @param gate - Gate definition to register
-     * @throws Error if a gate with the same name is already registered
-     */
-    register(gate) {
-        if (this.nameIndex.has(gate.name)) {
-            throw new Error(`Gate "${gate.name}" is already registered`);
-        }
-        this.nameIndex.set(gate.name, this.gates.length);
-        this.gates.push(gate);
-    }
-    /**
-     * Register multiple gate definitions at once.
-     *
-     * @param gates - Array of gate definitions to register
-     */
-    registerAll(gates) {
-        for (const gate of gates) {
-            this.register(gate);
-        }
-    }
-    /**
-     * Get all registered gates in insertion order.
-     *
-     * @returns Copy of the gates array
-     */
-    getAll() {
-        return [...this.gates];
-    }
-    /**
-     * Get a gate by name.
-     *
-     * @param name - Gate name to look up
-     * @returns Gate definition or undefined if not found
-     */
-    get(name) {
-        const index = this.nameIndex.get(name);
-        if (index === undefined)
-            return undefined;
-        return this.gates[index];
-    }
-    /**
-     * Check if a gate with the given name is registered.
-     *
-     * @param name - Gate name to check
-     * @returns true if the gate exists
-     */
-    has(name) {
-        return this.nameIndex.has(name);
-    }
-    /**
-     * Remove all registered gates.
-     */
-    clear() {
-        this.gates.length = 0;
-        this.nameIndex.clear();
-    }
-}
-//# sourceMappingURL=gate-registry.js.map

package/dist/gate-registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"gate-registry.js","sourceRoot":"","sources":["../src/gate-registry.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAgDzC;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACN,KAAK,GAAqB,EAAE,CAAC;IAC7B,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEvD;;;;;OAKG;IACH,QAAQ,CAAC,IAAoB;QAC3B,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,IAAI,yBAAyB,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,KAAuB;QACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,IAAY;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/gates-graceful-degradation.js

@@ -1,153 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * Gates Graceful Degradation
- *
- * WU-1520: When gate scripts (format:check, lint, typecheck, spec:linter)
- * are missing from package.json, emit a warning and skip instead of failing.
- *
- * Defense in depth: even if scaffold adds scripts, gates should degrade
- * gracefully for UnsafeAny missing script.
- *
- * @module gates-graceful-degradation
- */
-import { readFileSync, existsSync } from 'node:fs';
-import path from 'node:path';
-/**
- * Scripts that can be skipped when missing from package.json.
- * These are optional tooling scripts that not every project configures.
- */
-export const SKIPPABLE_GATE_SCRIPTS = [
-    'format:check',
-    'lint',
-    'typecheck',
-    'spec:linter',
-];
-/**
- * Gates that are never skippable, regardless of configuration.
- * These enforce critical invariants and must always run.
- */
-export const NON_SKIPPABLE_GATES = ['invariants'];
-/**
- * Check whether a script exists in a package.json scripts object.
- *
- * @param scriptName - The script name to check (e.g., 'lint', 'format:check')
- * @param scripts - The scripts object from package.json, or undefined
- * @returns true if the script exists
- */
-export function checkScriptExists(scriptName, scripts) {
-    if (!scripts)
-        return false;
-    return Object.prototype.hasOwnProperty.call(scripts, scriptName);
-}
-/**
- * Load the scripts object from a package.json file.
- *
- * @param projectRoot - Project root directory containing package.json
- * @returns The scripts object, or undefined if package.json is missing or unreadable
- */
-export function loadPackageJsonScripts(projectRoot) {
-    const packageJsonPath = path.join(projectRoot, 'package.json');
-    if (!existsSync(packageJsonPath))
-        return undefined;
-    try {
-        const content = readFileSync(packageJsonPath, 'utf8');
-        const pkg = JSON.parse(content);
-        return pkg.scripts;
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Build a human-readable warning message for a missing gate script.
- * Includes instructions on how to add the missing script.
- *
- * @param scriptName - The missing script name
- * @returns Warning message string
- */
-export function buildMissingScriptWarning(scriptName) {
-    const suggestions = {
-        'format:check': '"format:check": "prettier --check ."',
-        lint: '"lint": "eslint ."',
-        typecheck: '"typecheck": "tsc --noEmit"',
-        'spec:linter': '"spec:linter": "node tools/spec-linter.js"',
-    };
-    const suggestion = suggestions[scriptName] ?? `"${scriptName}": "<your-command>"`;
-    return [
-        `Warning: "${scriptName}" script not found in package.json - skipping gate.`,
-        `  To enable this gate, add to your package.json scripts:`,
-        `    ${suggestion}`,
-    ].join('\n');
-}
-/**
- * Determine whether a gate should be skipped due to a missing script.
- *
- * @param gateName - The gate name (e.g., 'lint', 'invariants')
- * @param scriptName - The underlying script name, or null for non-script gates
- * @param scripts - The scripts object from package.json
- * @param strict - When true, missing scripts cause a hard failure instead of skip
- * @returns 'skip' if the gate should be skipped, 'run' if it should run, 'fail' if strict mode failure
- */
-export function resolveGateAction(gateName, scriptName, scripts, strict) {
-    // Non-skippable gates always run
-    if (NON_SKIPPABLE_GATES.includes(gateName)) {
-        return 'run';
-    }
-    // If no script name is associated (e.g., custom run functions), always run
-    if (!scriptName) {
-        return 'run';
-    }
-    // If script exists, run it
-    if (checkScriptExists(scriptName, scripts)) {
-        return 'run';
-    }
-    // Script is missing
-    if (strict) {
-        return 'fail';
-    }
-    return 'skip';
-}
-/**
- * Format a summary of gate results showing passed, skipped, and failed gates.
- *
- * @param results - Array of gate results
- * @returns Formatted summary string
- */
-export function formatGateSummary(results) {
-    if (results.length === 0) {
-        return 'No gates were executed.';
-    }
-    const passed = results.filter((r) => r.status === 'passed');
-    const skipped = results.filter((r) => r.status === 'skipped');
-    const failed = results.filter((r) => r.status === 'failed');
-    const warned = results.filter((r) => r.status === 'warned');
-    const lines = [];
-    lines.push('Gate Summary:');
-    lines.push('');
-    for (const result of results) {
-        const statusIcon = result.status === 'passed'
-            ? 'PASS'
-            : result.status === 'skipped'
-                ? 'SKIP'
-                : result.status === 'warned'
-                    ? 'WARN'
-                    : 'FAIL';
-        const duration = result.durationMs > 0 ? ` (${result.durationMs}ms)` : '';
-        const reason = result.reason ? ` - ${result.reason}` : '';
-        lines.push(`  [${statusIcon}] ${result.name}${duration}${reason}`);
-    }
-    lines.push('');
-    const parts = [];
-    if (passed.length > 0)
-        parts.push(`${passed.length} passed`);
-    if (skipped.length > 0)
-        parts.push(`${skipped.length} skipped`);
-    if (warned.length > 0)
-        parts.push(`${warned.length} warned`);
-    if (failed.length > 0)
-        parts.push(`${failed.length} failed`);
-    lines.push(parts.join(', '));
-    return lines.join('\n');
-}
-//# sourceMappingURL=gates-graceful-degradation.js.map

package/dist/gates-graceful-degradation.js.map

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