@lumenflow/core 3.1.3 → 3.2.1

package/dist/force-bypass-audit.js

@@ -0,0 +1,146 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU-1070: Force Bypass Audit Logging
+ *
+ * Provides audit logging for LUMENFLOW_FORCE bypass usage.
+ * All hooks log bypass events to .lumenflow/force-bypasses.log for accountability.
+ *
+ * Key principles:
+ * - FAIL-OPEN: Audit logging must never block the bypass itself
+ * - WARN ON MISSING REASON: stderr warning if LUMENFLOW_FORCE_REASON not set
+ * - GIT-TRACKED: .lumenflow/force-bypasses.log is version controlled
+ *
+ * Log format:
+ *   ISO_TIMESTAMP | HOOK_NAME | GIT_USER | BRANCH | REASON | CWD
+ *
+ * Example:
+ *   2026-01-23T10:30:00.000Z | pre-commit | tom@hellm.ai | lane/ops/wu-1070 | Emergency hotfix | /project
+ */
+import { appendFileSync, existsSync, mkdirSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+import { join } from 'node:path';
+import { LUMENFLOW_PATHS } from './wu-constants.js';
+/**
+ * Environment variable names for force bypass
+ */
+export const FORCE_ENV_VAR = 'LUMENFLOW_FORCE';
+export const FORCE_REASON_ENV_VAR = 'LUMENFLOW_FORCE_REASON';
+/**
+ * Log file path relative to project root
+ */
+const LOG_FILE_NAME = LUMENFLOW_PATHS.FORCE_BYPASSES;
+/**
+ * Check if LUMENFLOW_FORCE bypass is active
+ *
+ * @returns true if LUMENFLOW_FORCE=1
+ */
+export function shouldBypass() {
+    return process.env[FORCE_ENV_VAR] === '1';
+}
+/**
+ * Get the audit log file path
+ *
+ * @param projectRoot - Project root directory
+ * @returns Full path to the audit log file
+ */
+export function getAuditLogPath(projectRoot) {
+    return join(projectRoot, LOG_FILE_NAME);
+}
+/**
+ * Get git user.name for audit logging
+ *
+ * @returns Git user name or 'unknown' if not configured
+ */
+function getGitUser() {
+    try {
+        // eslint-disable-next-line sonarjs/no-os-command-from-path -- git resolved from PATH; workflow tooling requires git
+        return execSync('git config user.name', { encoding: 'utf8' }).trim();
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/**
+ * Get current git branch name
+ *
+ * @returns Branch name or 'unknown' if not in a git repo
+ */
+function getGitBranch() {
+    try {
+        // eslint-disable-next-line sonarjs/no-os-command-from-path -- git resolved from PATH; workflow tooling requires git
+        return execSync('git rev-parse --abbrev-ref HEAD', { encoding: 'utf8' }).trim();
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/**
+ * Log a force bypass event to the audit log
+ *
+ * This function is FAIL-OPEN: if logging fails, it warns to stderr
+ * but does NOT throw or block the bypass operation.
+ *
+ * @param hookName - Name of the hook being bypassed (pre-commit, pre-push, etc.)
+ * @param projectRoot - Project root directory
+ */
+export function logForceBypass(hookName, projectRoot) {
+    // Only log when bypass is active
+    if (!shouldBypass()) {
+        return;
+    }
+    // Get reason from environment (warn if missing)
+    const reason = process.env[FORCE_REASON_ENV_VAR];
+    if (!reason) {
+        console.warn(`[${hookName}] Warning: ${FORCE_REASON_ENV_VAR} not set. ` +
+            'Consider providing a reason for the bypass: ' +
+            `${FORCE_REASON_ENV_VAR}="reason here" LUMENFLOW_FORCE=1 git ...`);
+    }
+    // Collect audit data
+    const timestamp = new Date().toISOString();
+    const user = getGitUser();
+    const branch = getGitBranch();
+    const cwd = projectRoot;
+    const reasonText = reason || '(no reason provided)';
+    // Format log line: ISO timestamp | hook | user | branch | reason | cwd
+    const logLine = `${timestamp} | ${hookName} | ${user} | ${branch} | ${reasonText} | ${cwd}\n`;
+    // Write to log file (fail-open)
+    try {
+        const logPath = getAuditLogPath(projectRoot);
+        const lumenflowDir = join(projectRoot, LUMENFLOW_PATHS.BASE);
+        // Ensure .lumenflow directory exists
+        if (!existsSync(lumenflowDir)) {
+            mkdirSync(lumenflowDir, { recursive: true });
+        }
+        appendFileSync(logPath, logLine);
+    }
+    catch (error) {
+        // Fail-open: warn but don't block
+        console.error(`[${hookName}] Warning: Failed to write to audit log: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Parse a single line from the audit log
+ *
+ * @param line - Raw log line
+ * @returns Parsed entry or null if invalid
+ */
+export function parseAuditLogLine(line) {
+    if (!line || line.trim() === '') {
+        return null;
+    }
+    const parts = line.split(' | ');
+    if (parts.length !== 6) {
+        return null;
+    }
+    const [timestamp, hook, user, branch, reason, cwd] = parts;
+    return {
+        timestamp: timestamp.trim(),
+        hook: hook.trim(),
+        user: user.trim(),
+        branch: branch.trim(),
+        reason: reason.trim(),
+        cwd: cwd.trim(),
+    };
+}
+//# sourceMappingURL=force-bypass-audit.js.map

package/dist/force-bypass-audit.js.map

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

package/dist/gates-agent-mode.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Options for agent mode detection
+ */
+interface GatesAgentModeOptions {
+    /** Command line arguments */
+    argv?: string[];
+    /** Environment variables */
+    env?: Record<string, string | undefined>;
+    /** stdout stream */
+    stdout?: {
+        isTTY?: boolean;
+    };
+}
+/**
+ * Options for log path functions
+ */
+interface GatesLogOptions {
+    /** Working directory */
+    cwd: string;
+    /** Environment variables */
+    env?: Record<string, string | undefined>;
+}
+/**
+ * Options for building gate log path
+ */
+interface BuildGatesLogPathOptions extends GatesLogOptions {
+    /** WU ID */
+    wuId?: string;
+    /** Lane name */
+    lane?: string;
+    /** Current timestamp */
+    now?: Date;
+}
+/**
+ * Options for updating symlink
+ */
+interface UpdateGatesLatestSymlinkOptions extends GatesLogOptions {
+    /** Path to the actual gate log file */
+    logPath: string;
+}
+/**
+ * Determine whether gates should run in low-noise "agent mode".
+ *
+ * Agent mode is intended for Claude Code sessions, where tool output is injected into the
+ * conversation context and can trigger "prompt too long".
+ *
+ * Detection strategy (WU-1827):
+ * 1. --verbose flag always forces full output (returns false)
+ * 2. CLAUDE_PROJECT_DIR env var is a strong hint (returns true if set)
+ * 3. TTY check: non-TTY + non-CI = likely agent mode (returns true)
+ * 4. Interactive TTY = human user (returns false)
+ *
+ * @param {GatesAgentModeOptions} options
+ * @returns {boolean} True if gates should run in agent mode
+ */
+export declare function shouldUseGatesAgentMode({ argv, env, stdout }?: GatesAgentModeOptions): boolean;
+export declare function getGatesLogDir({ cwd, env }: GatesLogOptions): string;
+export declare function buildGatesLogPath({ cwd, env, wuId, lane, now, }: BuildGatesLogPathOptions): string;
+/**
+ * Get the path to the gates-latest.log symlink (WU-2064)
+ *
+ * @param {Object} options
+ * @param {string} options.cwd - Working directory
+ * @param {Object} [options.env] - Environment variables
+ * @returns {string} Path to the symlink
+ */
+export declare function getGatesLatestSymlinkPath({ cwd, env }: GatesLogOptions): string;
+/**
+ * Create or update the gates-latest.log symlink to point to the most recent gate run (WU-2064)
+ *
+ * This provides a stable path for agents to access the most recent gate log
+ * without needing to know the timestamp-based filename.
+ *
+ * @param {Object} options
+ * @param {string} options.logPath - Path to the actual gate log file
+ * @param {string} options.cwd - Working directory
+ * @param {Object} [options.env] - Environment variables
+ * @returns {boolean} True if symlink was created/updated successfully
+ */
+export declare function updateGatesLatestSymlink({ logPath, cwd, env }: UpdateGatesLatestSymlinkOptions): boolean;
+export declare const WU_DONE_PRE_COMMIT_GATE_DECISION_REASONS: {
+    readonly SKIP_GATES_FLAG: "skip-gates-flag";
+    readonly REUSE_STEP_ZERO: "reuse-step-zero";
+    readonly REUSE_CHECKPOINT: "reuse-checkpoint";
+    readonly RUN_REQUIRED: "run-required";
+};
+export type WuDonePreCommitGateDecisionReason = (typeof WU_DONE_PRE_COMMIT_GATE_DECISION_REASONS)[keyof typeof WU_DONE_PRE_COMMIT_GATE_DECISION_REASONS];
+export interface WuDonePreCommitGateDecisionInput {
+    skipGates: boolean;
+    fullGatesRanInCurrentRun: boolean;
+    skippedByCheckpoint: boolean;
+    checkpointId?: string | null;
+}
+export interface WuDonePreCommitGateDecision {
+    runPreCommitFullSuite: boolean;
+    reason: WuDonePreCommitGateDecisionReason;
+    message: string;
+}
+/**
+ * Decide whether wu:done pre-flight hook validation should rerun full gates.
+ *
+ * WU-1659: Avoid duplicate full-suite execution when Step 0 already ran gates
+ * (or reused a valid checkpoint), while keeping operator-visible reasoning.
+ */
+export declare function resolveWuDonePreCommitGateDecision(input: WuDonePreCommitGateDecisionInput): WuDonePreCommitGateDecision;
+export {};
+//# sourceMappingURL=gates-agent-mode.d.ts.map

package/dist/gates-agent-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gates-agent-mode.d.ts","sourceRoot":"","sources":["../src/gates-agent-mode.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,UAAU,qBAAqB;IAC7B,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,oBAAoB;IACpB,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC9B;AAED;;GAEG;AACH,UAAU,eAAe;IACvB,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C;AAED;;GAEG;AACH,UAAU,wBAAyB,SAAQ,eAAe;IACxD,YAAY;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED;;GAEG;AACH,UAAU,+BAAgC,SAAQ,eAAe;IAC/D,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,GAAE,qBAA0B,WA4BxF;AAED,wBAAgB,cAAc,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,eAAe,UAG3D;AAED,wBAAgB,iBAAiB,CAAC,EAChC,GAAG,EACH,GAAG,EACH,IAAI,EACJ,IAAI,EACJ,GAAgB,GACjB,EAAE,wBAAwB,UAM1B;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,eAAe,UAGtE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,+BAA+B,WAmB9F;AAED,eAAO,MAAM,wCAAwC;;;;;CAK3C,CAAC;AAEX,MAAM,MAAM,iCAAiC,GAC3C,CAAC,OAAO,wCAAwC,CAAC,CAAC,MAAM,OAAO,wCAAwC,CAAC,CAAC;AAE3G,MAAM,WAAW,gCAAgC;IAC/C,SAAS,EAAE,OAAO,CAAC;IACnB,wBAAwB,EAAE,OAAO,CAAC;IAClC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,2BAA2B;IAC1C,qBAAqB,EAAE,OAAO,CAAC;IAC/B,MAAM,EAAE,iCAAiC,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,gCAAgC,GACtC,2BAA2B,CAiC7B"}

package/dist/gates-agent-mode.js

@@ -0,0 +1,138 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import path from 'node:path';
+import { existsSync, unlinkSync, symlinkSync } from 'node:fs';
+/**
+ * Determine whether gates should run in low-noise "agent mode".
+ *
+ * Agent mode is intended for Claude Code sessions, where tool output is injected into the
+ * conversation context and can trigger "prompt too long".
+ *
+ * Detection strategy (WU-1827):
+ * 1. --verbose flag always forces full output (returns false)
+ * 2. CLAUDE_PROJECT_DIR env var is a strong hint (returns true if set)
+ * 3. TTY check: non-TTY + non-CI = likely agent mode (returns true)
+ * 4. Interactive TTY = human user (returns false)
+ *
+ * @param {GatesAgentModeOptions} options
+ * @returns {boolean} True if gates should run in agent mode
+ */
+export function shouldUseGatesAgentMode({ argv, env, stdout } = {}) {
+    // --verbose flag always forces full output
+    const isVerbose = Array.isArray(argv) && argv.includes('--verbose');
+    if (isVerbose) {
+        return false;
+    }
+    // CLAUDE_PROJECT_DIR is a strong hint that we're in Claude Code
+    const hasClaudeProjectDir = Boolean(env?.CLAUDE_PROJECT_DIR);
+    if (hasClaudeProjectDir) {
+        return true;
+    }
+    // CI environments should get full output for debugging
+    const isCI = Boolean(env?.CI);
+    if (isCI) {
+        return false;
+    }
+    // Use provided stdout or fall back to process.stdout
+    const stdoutStream = stdout ?? process.stdout;
+    // TTY check: non-TTY = likely agent mode (Claude Code Bash tool doesn't have TTY)
+    // If stdout is undefined or isTTY is falsy, assume agent mode (safer default)
+    const isTTY = stdoutStream?.isTTY ?? false;
+    // Non-TTY + non-CI = likely agent mode
+    return !isTTY;
+}
+export function getGatesLogDir({ cwd, env }) {
+    const configured = env?.LUMENFLOW_LOG_DIR;
+    return path.resolve(cwd, configured || '.logs');
+}
+export function buildGatesLogPath({ cwd, env, wuId, lane, now = new Date(), }) {
+    const logDir = getGatesLogDir({ cwd, env });
+    const safeLane = (lane || 'unknown').toLowerCase().replace(/[^a-z0-9]+/g, '-');
+    const safeWu = (wuId || 'unknown').toLowerCase().replace(/[^a-z0-9]+/g, '-');
+    const stamp = now.toISOString().replace(/[:.]/g, '-');
+    return path.join(logDir, `gates-${safeLane}-${safeWu}-${stamp}.log`);
+}
+/**
+ * Get the path to the gates-latest.log symlink (WU-2064)
+ *
+ * @param {Object} options
+ * @param {string} options.cwd - Working directory
+ * @param {Object} [options.env] - Environment variables
+ * @returns {string} Path to the symlink
+ */
+export function getGatesLatestSymlinkPath({ cwd, env }) {
+    const logDir = getGatesLogDir({ cwd, env });
+    return path.join(logDir, 'gates-latest.log');
+}
+/**
+ * Create or update the gates-latest.log symlink to point to the most recent gate run (WU-2064)
+ *
+ * This provides a stable path for agents to access the most recent gate log
+ * without needing to know the timestamp-based filename.
+ *
+ * @param {Object} options
+ * @param {string} options.logPath - Path to the actual gate log file
+ * @param {string} options.cwd - Working directory
+ * @param {Object} [options.env] - Environment variables
+ * @returns {boolean} True if symlink was created/updated successfully
+ */
+export function updateGatesLatestSymlink({ logPath, cwd, env }) {
+    const symlinkPath = getGatesLatestSymlinkPath({ cwd, env });
+    try {
+        // Remove existing symlink if present
+        if (existsSync(symlinkPath)) {
+            unlinkSync(symlinkPath);
+        }
+        // Create relative symlink (so it works regardless of absolute path)
+        const logDir = path.dirname(symlinkPath);
+        const relativePath = path.relative(logDir, logPath);
+        symlinkSync(relativePath, symlinkPath);
+        return true;
+    }
+    catch {
+        // Symlink creation is best-effort, don't fail gates
+        return false;
+    }
+}
+export const WU_DONE_PRE_COMMIT_GATE_DECISION_REASONS = {
+    SKIP_GATES_FLAG: 'skip-gates-flag',
+    REUSE_STEP_ZERO: 'reuse-step-zero',
+    REUSE_CHECKPOINT: 'reuse-checkpoint',
+    RUN_REQUIRED: 'run-required',
+};
+/**
+ * Decide whether wu:done pre-flight hook validation should rerun full gates.
+ *
+ * WU-1659: Avoid duplicate full-suite execution when Step 0 already ran gates
+ * (or reused a valid checkpoint), while keeping operator-visible reasoning.
+ */
+export function resolveWuDonePreCommitGateDecision(input) {
+    if (input.skipGates) {
+        return {
+            runPreCommitFullSuite: false,
+            reason: WU_DONE_PRE_COMMIT_GATE_DECISION_REASONS.SKIP_GATES_FLAG,
+            message: 'Pre-flight hook validation skipped because --skip-gates is active.',
+        };
+    }
+    if (input.fullGatesRanInCurrentRun) {
+        return {
+            runPreCommitFullSuite: false,
+            reason: WU_DONE_PRE_COMMIT_GATE_DECISION_REASONS.REUSE_STEP_ZERO,
+            message: 'Pre-flight hook validation reuses Step 0 gate results; duplicate full-suite run skipped.',
+        };
+    }
+    if (input.skippedByCheckpoint) {
+        const checkpointSuffix = input.checkpointId ? ` (${input.checkpointId})` : '';
+        return {
+            runPreCommitFullSuite: false,
+            reason: WU_DONE_PRE_COMMIT_GATE_DECISION_REASONS.REUSE_CHECKPOINT,
+            message: `Pre-flight hook validation reuses checkpoint gate attestation${checkpointSuffix}; duplicate full-suite run skipped.`,
+        };
+    }
+    return {
+        runPreCommitFullSuite: true,
+        reason: WU_DONE_PRE_COMMIT_GATE_DECISION_REASONS.RUN_REQUIRED,
+        message: 'No gate attestation found for this wu:done run; executing pre-flight hook gate suite.',
+    };
+}
+//# sourceMappingURL=gates-agent-mode.js.map

package/dist/gates-agent-mode.js.map

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

package/dist/gates-config-internal.d.ts

@@ -0,0 +1,51 @@
+export declare const GATES_RUNTIME_DEFAULTS: {
+    readonly COMMAND_TIMEOUT_MS: 120000;
+    readonly MAX_ESLINT_WARNINGS: 100;
+    readonly DEFAULT_MIN_COVERAGE: number;
+    readonly DEFAULT_ENABLE_COVERAGE: true;
+    readonly DEFAULT_PACKAGE_MANAGER: "pnpm";
+    readonly DEFAULT_TEST_RUNNER: "vitest";
+};
+export declare const SOFTWARE_DELIVERY_FIELDS: {
+    readonly GATES: "gates";
+    readonly METHODOLOGY: "methodology";
+    readonly PACKAGE_MANAGER: "package_manager";
+    readonly PACKAGE_MANAGER_CAMEL: "packageManager";
+    readonly TEST_RUNNER: "test_runner";
+    readonly TEST_RUNNER_CAMEL: "testRunner";
+    readonly BUILD_COMMAND: "build_command";
+    readonly BUILD_COMMAND_CAMEL: "buildCommand";
+};
+export declare const GATES_FIELDS: {
+    readonly EXECUTION: "execution";
+    readonly LANE_HEALTH: "lane_health";
+    readonly LANE_HEALTH_CAMEL: "laneHealth";
+    readonly MIN_COVERAGE: "minCoverage";
+    readonly MIN_COVERAGE_SNAKE: "min_coverage";
+    readonly ENABLE_COVERAGE: "enableCoverage";
+    readonly ENABLE_COVERAGE_SNAKE: "enable_coverage";
+    readonly COMMANDS: "commands";
+};
+export declare const GATES_COMMAND_FIELDS: {
+    readonly TEST_FULL: "test_full";
+    readonly TEST_DOCS_ONLY: "test_docs_only";
+    readonly TEST_INCREMENTAL: "test_incremental";
+    readonly LINT: "lint";
+    readonly TYPECHECK: "typecheck";
+    readonly FORMAT: "format";
+};
+/**
+ * Load the software_delivery section from workspace.yaml
+ *
+ * @param projectRoot - Project root directory
+ * @returns Parsed software_delivery record, or null
+ */
+export declare function loadSoftwareDeliveryConfig(projectRoot: string): Record<string, unknown> | null;
+/**
+ * Load the gates sub-section from workspace.yaml software_delivery
+ *
+ * @param projectRoot - Project root directory
+ * @returns Parsed gates record, or null
+ */
+export declare function getGatesSection(projectRoot: string): Record<string, unknown> | null;
+//# sourceMappingURL=gates-config-internal.d.ts.map

package/dist/gates-config-internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gates-config-internal.d.ts","sourceRoot":"","sources":["../src/gates-config-internal.ts"],"names":[],"mappings":"AA8BA,eAAO,MAAM,sBAAsB;;;;;;;CAOzB,CAAC;AAQX,eAAO,MAAM,wBAAwB;;;;;;;;;CAS3B,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;;;;;CASf,CAAC;AAEX,eAAO,MAAM,oBAAoB;;;;;;;CAOvB,CAAC;AAMX;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAiB9F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAMnF"}

package/dist/gates-config-internal.js

@@ -0,0 +1,105 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Gates Configuration Internals
+ *
+ * WU-2037: Shared infrastructure for gates modules
+ *
+ * Contains runtime defaults, field-name constants, and config-loading helpers
+ * used by gates-config.ts, gates-coverage.ts, and package-manager-resolver.ts.
+ *
+ * This module exists to break circular imports between the facade (gates-config.ts)
+ * and its extracted sub-modules.
+ *
+ * @module gates-config-internal
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as yaml from 'yaml';
+import { WORKSPACE_CONFIG_FILE_NAME, WORKSPACE_V2_KEYS } from './config-contract.js';
+import { asRecord } from './object-guards.js';
+import { getDefaultPolicy } from './resolve-policy.js';
+// ---------------------------------------------------------------------------
+// Runtime defaults
+// ---------------------------------------------------------------------------
+const DEFAULT_POLICY = getDefaultPolicy();
+export const GATES_RUNTIME_DEFAULTS = {
+    COMMAND_TIMEOUT_MS: 120000,
+    MAX_ESLINT_WARNINGS: 100,
+    DEFAULT_MIN_COVERAGE: DEFAULT_POLICY.coverage_threshold,
+    DEFAULT_ENABLE_COVERAGE: true,
+    DEFAULT_PACKAGE_MANAGER: 'pnpm',
+    DEFAULT_TEST_RUNNER: 'vitest',
+};
+// ---------------------------------------------------------------------------
+// Field-name constants (avoid magic strings across modules)
+// ---------------------------------------------------------------------------
+const SOFTWARE_DELIVERY_KEY = WORKSPACE_V2_KEYS.SOFTWARE_DELIVERY;
+export const SOFTWARE_DELIVERY_FIELDS = {
+    GATES: 'gates',
+    METHODOLOGY: 'methodology',
+    PACKAGE_MANAGER: 'package_manager',
+    PACKAGE_MANAGER_CAMEL: 'packageManager',
+    TEST_RUNNER: 'test_runner',
+    TEST_RUNNER_CAMEL: 'testRunner',
+    BUILD_COMMAND: 'build_command',
+    BUILD_COMMAND_CAMEL: 'buildCommand',
+};
+export const GATES_FIELDS = {
+    EXECUTION: 'execution',
+    LANE_HEALTH: 'lane_health',
+    LANE_HEALTH_CAMEL: 'laneHealth',
+    MIN_COVERAGE: 'minCoverage',
+    MIN_COVERAGE_SNAKE: 'min_coverage',
+    ENABLE_COVERAGE: 'enableCoverage',
+    ENABLE_COVERAGE_SNAKE: 'enable_coverage',
+    COMMANDS: 'commands',
+};
+export const GATES_COMMAND_FIELDS = {
+    TEST_FULL: 'test_full',
+    TEST_DOCS_ONLY: 'test_docs_only',
+    TEST_INCREMENTAL: 'test_incremental',
+    LINT: 'lint',
+    TYPECHECK: 'typecheck',
+    FORMAT: 'format',
+};
+// ---------------------------------------------------------------------------
+// Config loading helpers
+// ---------------------------------------------------------------------------
+/**
+ * Load the software_delivery section from workspace.yaml
+ *
+ * @param projectRoot - Project root directory
+ * @returns Parsed software_delivery record, or null
+ */
+export function loadSoftwareDeliveryConfig(projectRoot) {
+    const configPath = path.join(projectRoot, WORKSPACE_CONFIG_FILE_NAME);
+    if (!fs.existsSync(configPath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(configPath, 'utf8');
+        const data = asRecord(yaml.parse(content));
+        if (!data) {
+            return null;
+        }
+        return asRecord(data[SOFTWARE_DELIVERY_KEY]);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Load the gates sub-section from workspace.yaml software_delivery
+ *
+ * @param projectRoot - Project root directory
+ * @returns Parsed gates record, or null
+ */
+export function getGatesSection(projectRoot) {
+    const softwareDelivery = loadSoftwareDeliveryConfig(projectRoot);
+    if (!softwareDelivery) {
+        return null;
+    }
+    return asRecord(softwareDelivery[SOFTWARE_DELIVERY_FIELDS.GATES]);
+}
+//# sourceMappingURL=gates-config-internal.js.map

package/dist/gates-config-internal.js.map

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

package/dist/gates-config.d.ts

@@ -0,0 +1,65 @@
+import type { GateCommandConfig, GatesExecutionConfig, ParsedGateCommand, LaneHealthMode } from './gates-schemas.js';
+export type { GateCommandConfig, GatesExecutionConfig, ParsedGateCommand, LaneHealthMode, CoverageConfig, CoveragePolicy, TestRunnerPolicy, TestPolicy, GatesCommands, } from './gates-schemas.js';
+export { GateCommandConfigSchema, GatesExecutionConfigSchema, LaneHealthModeSchema, DEFAULT_LANE_HEALTH_MODE, } from './gates-schemas.js';
+export { GATE_PRESETS, expandPreset } from './gates-presets.js';
+export { resolveCoverageConfig, resolveTestPolicy } from './gates-coverage.js';
+export { resolvePackageManager, resolveTestRunner, resolveBuildCommand, resolveGatesCommands, getIgnorePatterns, } from './package-manager-resolver.js';
+export { GATES_RUNTIME_DEFAULTS, SOFTWARE_DELIVERY_FIELDS, GATES_FIELDS, GATES_COMMAND_FIELDS, loadSoftwareDeliveryConfig, getGatesSection, } from './gates-config-internal.js';
+/**
+ * Parse a gate command configuration into executable form
+ *
+ * @param config - Gate command configuration (string or object)
+ * @returns Parsed command with defaults applied, or null if undefined
+ */
+export declare function parseGateCommand(config: GateCommandConfig | undefined): ParsedGateCommand | null;
+/**
+ * Load gates configuration from workspace.yaml software_delivery.gates.execution
+ *
+ * @param projectRoot - Project root directory
+ * @returns Gates execution config, or null if not configured
+ */
+export declare function loadGatesConfig(projectRoot: string): GatesExecutionConfig | null;
+/**
+ * Get default gates configuration for auto-detection fallback
+ *
+ * Used when no gates config is present in workspace.yaml software_delivery.
+ * These are generic commands that work across common setups.
+ *
+ * @returns Default gates configuration
+ */
+export declare function getDefaultGatesConfig(): GatesExecutionConfig;
+/**
+ * Resolve the effective gates configuration
+ *
+ * Priority order:
+ * 1. Explicit config from workspace.yaml software_delivery
+ * 2. Preset defaults (if preset specified)
+ * 3. Auto-detection defaults
+ *
+ * @param projectRoot - Project root directory
+ * @returns Resolved gates configuration
+ */
+export declare function resolveGatesConfig(projectRoot: string): GatesExecutionConfig;
+/**
+ * Check if a specific gate should be skipped
+ *
+ * @param gateName - Name of the gate (format, lint, typecheck, test)
+ * @param config - Gates execution configuration
+ * @param skipFlags - Map of skip flags from CLI/Action inputs
+ * @returns True if the gate should be skipped
+ */
+export declare function shouldSkipGate(gateName: keyof Omit<GatesExecutionConfig, 'preset' | 'coverage'>, config: GatesExecutionConfig, skipFlags: Record<string, boolean>): boolean;
+/**
+ * WU-1191: Load lane health configuration from workspace.yaml software_delivery
+ *
+ * Configuration format:
+ * ```yaml
+ * gates:
+ *   lane_health: warn|error|off
+ * ```
+ *
+ * @param projectRoot - Project root directory
+ * @returns Lane health mode ('warn', 'error', or 'off'), defaults to 'warn'
+ */
+export declare function loadLaneHealthConfig(projectRoot: string): LaneHealthMode;
+//# sourceMappingURL=gates-config.d.ts.map

package/dist/gates-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gates-config.d.ts","sourceRoot":"","sources":["../src/gates-config.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACf,MAAM,oBAAoB,CAAC;AAQ5B,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGhE,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG/E,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,YAAY,EACZ,oBAAoB,EACpB,0BAA0B,EAC1B,eAAe,GAChB,MAAM,4BAA4B,CAAC;AAQpC;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,GAAG,iBAAiB,GAAG,IAAI,CAkBhG;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAmChF;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,oBAAoB,CAS5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,oBAAoB,CAS5E;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,IAAI,CAAC,oBAAoB,EAAE,QAAQ,GAAG,UAAU,CAAC,EACjE,MAAM,EAAE,oBAAoB,EAC5B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAaT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CA+BxE"}