@lumenflow/core 3.1.2 → 3.2.0

package/dist/force-bypass-audit.js

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

@@ -1 +0,0 @@
-{"version":3,"file":"force-bypass-audit.js","sourceRoot":"","sources":["../src/force-bypass-audit.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAC/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,wBAAwB,CAAC;AAE7D;;GAEG;AACH,MAAM,aAAa,GAAG,eAAe,CAAC,cAAc,CAAC;AAcrD;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,GAAG,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,OAAO,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,oHAAoH;QACpH,OAAO,QAAQ,CAAC,sBAAsB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY;IACnB,IAAI,CAAC;QACH,oHAAoH;QACpH,OAAO,QAAQ,CAAC,iCAAiC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,WAAmB;IAClE,iCAAiC;IACjC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;QACpB,OAAO;IACT,CAAC;IAED,gDAAgD;IAChD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CACV,IAAI,QAAQ,cAAc,oBAAoB,YAAY;YACxD,8CAA8C;YAC9C,GAAG,oBAAoB,0CAA0C,CACpE,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,GAAG,GAAG,WAAW,CAAC;IACxB,MAAM,UAAU,GAAG,MAAM,IAAI,sBAAsB,CAAC;IAEpD,uEAAuE;IACvE,MAAM,OAAO,GAAG,GAAG,SAAS,MAAM,QAAQ,MAAM,IAAI,MAAM,MAAM,MAAM,UAAU,MAAM,GAAG,IAAI,CAAC;IAE9F,gCAAgC;IAChC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;QAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;QAE7D,qCAAqC;QACrC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,kCAAkC;QAClC,OAAO,CAAC,KAAK,CACX,IAAI,QAAQ,4CAA4C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACjH,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,GAAG,KAOpD,CAAC;IAEF,OAAO;QACL,SAAS,EAAE,SAAS,CAAC,IAAI,EAAE;QAC3B,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;QACjB,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;QACrB,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;QACrB,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE;KAChB,CAAC;AACJ,CAAC"}

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

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"gates-agent-mode.js","sourceRoot":"","sources":["../src/gates-agent-mode.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AA4C9D;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,uBAAuB,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,KAA4B,EAAE;IACvF,2CAA2C;IAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACpE,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,KAAK,CAAC;IACf,CAAC;IAED,gEAAgE;IAChE,MAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;IAC7D,IAAI,mBAAmB,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uDAAuD;IACvD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC9B,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,KAAK,CAAC;IACf,CAAC;IAED,qDAAqD;IACrD,MAAM,YAAY,GAAG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAE9C,kFAAkF;IAClF,8EAA8E;IAC9E,MAAM,KAAK,GAAG,YAAY,EAAE,KAAK,IAAI,KAAK,CAAC;IAE3C,uCAAuC;IACvC,OAAO,CAAC,KAAK,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAE,GAAG,EAAE,GAAG,EAAmB;IAC1D,MAAM,UAAU,GAAG,GAAG,EAAE,iBAAiB,CAAC;IAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,IAAI,OAAO,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAChC,GAAG,EACH,GAAG,EACH,IAAI,EACJ,IAAI,EACJ,GAAG,GAAG,IAAI,IAAI,EAAE,GACS;IACzB,MAAM,MAAM,GAAG,cAAc,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,CAAC,IAAI,IAAI,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IAC/E,MAAM,MAAM,GAAG,CAAC,IAAI,IAAI,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IAC7E,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,QAAQ,IAAI,MAAM,IAAI,KAAK,MAAM,CAAC,CAAC;AACvE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CAAC,EAAE,GAAG,EAAE,GAAG,EAAmB;IACrE,MAAM,MAAM,GAAG,cAAc,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,wBAAwB,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAmC;IAC7F,MAAM,WAAW,GAAG,yBAAyB,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IAE5D,IAAI,CAAC;QACH,qCAAqC;QACrC,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,UAAU,CAAC,WAAW,CAAC,CAAC;QAC1B,CAAC;QAED,oEAAoE;QACpE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACzC,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpD,WAAW,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;QAEvC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,oDAAoD;QACpD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,wCAAwC,GAAG;IACtD,eAAe,EAAE,iBAAiB;IAClC,eAAe,EAAE,iBAAiB;IAClC,gBAAgB,EAAE,kBAAkB;IACpC,YAAY,EAAE,cAAc;CACpB,CAAC;AAkBX;;;;;GAKG;AACH,MAAM,UAAU,kCAAkC,CAChD,KAAuC;IAEvC,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,OAAO;YACL,qBAAqB,EAAE,KAAK;YAC5B,MAAM,EAAE,wCAAwC,CAAC,eAAe;YAChE,OAAO,EAAE,oEAAoE;SAC9E,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,wBAAwB,EAAE,CAAC;QACnC,OAAO;YACL,qBAAqB,EAAE,KAAK;YAC5B,MAAM,EAAE,wCAAwC,CAAC,eAAe;YAChE,OAAO,EACL,0FAA0F;SAC7F,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,mBAAmB,EAAE,CAAC;QAC9B,MAAM,gBAAgB,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,OAAO;YACL,qBAAqB,EAAE,KAAK;YAC5B,MAAM,EAAE,wCAAwC,CAAC,gBAAgB;YACjE,OAAO,EAAE,gEAAgE,gBAAgB,qCAAqC;SAC/H,CAAC;IACJ,CAAC;IAED,OAAO;QACL,qBAAqB,EAAE,IAAI;QAC3B,MAAM,EAAE,wCAAwC,CAAC,YAAY;QAC7D,OAAO,EACL,uFAAuF;KAC1F,CAAC;AACJ,CAAC"}

package/dist/gates-config.d.ts

@@ -1,268 +0,0 @@
-import { z } from 'zod';
-import { type CoverageMode } from './resolve-policy.js';
-/**
- * Schema for a gate command - either a string or an object with options
- */
-export declare const GateCommandConfigSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-    command: z.ZodString;
-    continueOnError: z.ZodOptional<z.ZodBoolean>;
-    timeout: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>]>;
-/**
- * Type for parsed gate command configuration
- */
-export type GateCommandConfig = z.infer<typeof GateCommandConfigSchema>;
-/**
- * Schema for the gates execution configuration section
- */
-export declare const GatesExecutionConfigSchema: z.ZodObject<{
-    preset: z.ZodOptional<z.ZodString>;
-    setup: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-        command: z.ZodString;
-        continueOnError: z.ZodOptional<z.ZodBoolean>;
-        timeout: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>]>>;
-    format: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-        command: z.ZodString;
-        continueOnError: z.ZodOptional<z.ZodBoolean>;
-        timeout: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>]>>;
-    lint: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-        command: z.ZodString;
-        continueOnError: z.ZodOptional<z.ZodBoolean>;
-        timeout: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>]>>;
-    typecheck: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-        command: z.ZodString;
-        continueOnError: z.ZodOptional<z.ZodBoolean>;
-        timeout: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>]>>;
-    test: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-        command: z.ZodString;
-        continueOnError: z.ZodOptional<z.ZodBoolean>;
-        timeout: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>]>>;
-    coverage: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-        command: z.ZodString;
-        threshold: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>]>>;
-}, z.core.$strip>;
-/**
- * Type for gates execution configuration
- */
-export type GatesExecutionConfig = z.infer<typeof GatesExecutionConfigSchema>;
-/**
- * Parsed gate command ready for execution
- */
-export interface ParsedGateCommand {
-    /** The shell command to execute */
-    command: string;
-    /** Whether to continue if this gate fails */
-    continueOnError: boolean;
-    /** Timeout in milliseconds */
-    timeout: number;
-}
-/**
- * Gate preset definitions
- *
- * These provide sensible defaults for common language ecosystems.
- * Users can override UnsafeAny field via .lumenflow.config.yaml
- */
-export declare const GATE_PRESETS: Record<string, Partial<GatesExecutionConfig>>;
-/**
- * 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;
-/**
- * Expand a preset name into its default gate commands
- *
- * @param preset - Preset name (node, python, go, rust, dotnet) or undefined
- * @returns Partial gates config with preset defaults, or empty object if unknown
- */
-export declare function expandPreset(preset: string | undefined): Partial<GatesExecutionConfig>;
-/**
- * Load gates configuration from .lumenflow.config.yaml
- *
- * @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 .lumenflow.config.yaml.
- * 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 .lumenflow.config.yaml
- * 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: Lane health gate mode
- * Controls how lane health check behaves during gates
- */
-export type LaneHealthMode = 'warn' | 'error' | 'off';
-/**
- * WU-1191: Load lane health configuration from .lumenflow.config.yaml
- *
- * 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;
-/**
- * WU-1262: Resolved coverage configuration
- * Contains threshold and mode derived from methodology policy
- */
-export interface CoverageConfig {
-    /** Coverage threshold (0-100) */
-    threshold: number;
-    /** Coverage mode (block, warn, or off) */
-    mode: CoverageMode;
-}
-/**
- * WU-1262: Resolve coverage configuration from methodology policy
- *
- * Uses resolvePolicy() to determine coverage defaults based on methodology.testing:
- * - tdd: 90% threshold, block mode
- * - test-after: 70% threshold, warn mode
- * - none: 0% threshold, off mode
- *
- * Precedence (highest to lowest):
- * 1. Explicit gates.minCoverage / gates.enableCoverage
- * 2. methodology.overrides.coverage_threshold / coverage_mode
- * 3. methodology.testing template defaults
- *
- * @param projectRoot - Project root directory
- * @returns Resolved coverage configuration
- */
-export declare function resolveCoverageConfig(projectRoot: string): CoverageConfig;
-/**
- * WU-1280: Resolved test policy configuration
- * Extends CoverageConfig with tests_required from methodology policy
- */
-export interface TestPolicy extends CoverageConfig {
-    /** Whether tests are required for completion (from methodology.testing) */
-    tests_required: boolean;
-}
-/**
- * WU-1280: Resolve test policy from methodology configuration
- *
- * Returns the full test policy including coverage config AND tests_required.
- * This is used by gates to determine whether test failures should block or warn.
- *
- * Methodology mapping:
- * - tdd: 90% threshold, block mode, tests_required=true
- * - test-after: 70% threshold, warn mode, tests_required=true
- * - none: 0% threshold, off mode, tests_required=false
- *
- * When tests_required=false:
- * - Test failures produce WARNINGS instead of FAILURES
- * - Gates continue but log the test failures
- * - Coverage gate is effectively skipped (mode='off')
- *
- * @param projectRoot - Project root directory
- * @returns Resolved test policy including tests_required
- */
-export declare function resolveTestPolicy(projectRoot: string): TestPolicy;
-/**
- * WU-1356: Supported package managers type
- * Re-exported from lumenflow-config-schema to avoid circular import
- */
-type PackageManager = 'pnpm' | 'npm' | 'yarn' | 'bun';
-/**
- * WU-1356: Supported test runners type
- * Re-exported from lumenflow-config-schema to avoid circular import
- */
-type TestRunner = 'vitest' | 'jest' | 'mocha';
-/**
- * WU-1356: Gates commands configuration type
- */
-export interface GatesCommands {
-    test_full: string;
-    test_docs_only: string;
-    test_incremental: string;
-    lint?: string;
-    typecheck?: string;
-    format?: string;
-}
-/**
- * WU-1356: Resolve package manager from configuration
- *
- * Reads the package_manager field from .lumenflow.config.yaml.
- * Returns 'pnpm' as default if not configured.
- *
- * @param projectRoot - Project root directory
- * @returns Resolved package manager ('pnpm', 'npm', 'yarn', or 'bun')
- */
-export declare function resolvePackageManager(projectRoot: string): PackageManager;
-/**
- * WU-1356: Resolve test runner from configuration
- *
- * Reads the test_runner field from .lumenflow.config.yaml.
- * Returns 'vitest' as default if not configured.
- *
- * @param projectRoot - Project root directory
- * @returns Resolved test runner ('vitest', 'jest', or 'mocha')
- */
-export declare function resolveTestRunner(projectRoot: string): TestRunner;
-/**
- * WU-1356: Resolve build command from configuration
- *
- * Reads the build_command field from .lumenflow.config.yaml.
- * If not configured, uses default based on package_manager.
- *
- * @param projectRoot - Project root directory
- * @returns Resolved build command
- */
-export declare function resolveBuildCommand(projectRoot: string): string;
-/**
- * WU-1356: Resolve gates commands from configuration
- *
- * Reads gates.commands from .lumenflow.config.yaml.
- * Merges with defaults based on package_manager if not fully specified.
- *
- * @param projectRoot - Project root directory
- * @returns Resolved gates commands configuration
- */
-export declare function resolveGatesCommands(projectRoot: string): GatesCommands;
-/**
- * WU-1356: Get ignore patterns for test runner
- *
- * Returns patterns to ignore when detecting changed tests,
- * based on the test runner configuration.
- *
- * @param testRunner - Test runner type (vitest, jest, mocha)
- * @returns Array of ignore patterns
- */
-export declare function getIgnorePatterns(testRunner: TestRunner): string[];
-export {};
-//# sourceMappingURL=gates-config.d.ts.map