@lumenflow/cli 3.1.3 → 3.2.1

package/dist/formatters.js

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

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

package/dist/gate-defaults.js

@@ -0,0 +1,137 @@
+// 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,
+    });
+    registry.register({
+        name: GATE_NAMES.CLAIM_VALIDATION,
+    });
+    // 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.CLAIM_VALIDATION,
+    });
+    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

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

package/dist/gate-registry.js

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

@@ -0,0 +1 @@
+{"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

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

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