@lumenflow/packs-software-delivery 4.24.0 → 5.0.0

package/dist/src/policy/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/src/policy/gates-agent-mode.d.ts.map

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

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

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

@@ -0,0 +1,54 @@
+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 TDD_DIFF_EVIDENCE: "tdd_diff_evidence";
+    readonly TDD_ORDERING: "tdd_ordering";
+    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";
+    readonly MIGRATION_VERIFY: "migration_verify";
+};
+/**
+ * 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/src/policy/gates-config-internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gates-config-internal.d.ts","sourceRoot":"","sources":["../../../src/policy/gates-config-internal.ts"],"names":[],"mappings":"AA8BA,eAAO,MAAM,sBAAsB;;;;;;;CAOzB,CAAC;AAQX,eAAO,MAAM,wBAAwB;;;;;;;;;CAS3B,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;;;;;;;CAWf,CAAC;AAEX,eAAO,MAAM,oBAAoB;;;;;;;;CAQvB,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/src/policy/gates-config-internal.js

@@ -0,0 +1,108 @@
+// 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 '../constants/config-contract.js';
+import { asRecord } from '../constants/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',
+    TDD_DIFF_EVIDENCE: 'tdd_diff_evidence',
+    TDD_ORDERING: 'tdd_ordering',
+    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',
+    MIGRATION_VERIFY: 'migration_verify',
+};
+// ---------------------------------------------------------------------------
+// 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/src/policy/gates-config-internal.js.map

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

package/dist/src/policy/gates-config.d.ts

@@ -0,0 +1,67 @@
+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 type { TddDiffEvidencePolicy, TddOrderingPolicy } from './resolve-policy.js';
+export type { ScopedUnitTestExecutionPlan } from './package-manager-resolver.js';
+export { GateCommandConfigSchema, GatesExecutionConfigSchema, LaneHealthModeSchema, DEFAULT_LANE_HEALTH_MODE, } from './gates-schemas.js';
+export { GATE_PRESETS, expandPreset, PRESET_FIX_COMMANDS, getFormatFixCommand, } from './gates-presets.js';
+export { resolveCoverageConfig, resolveTestPolicy, resolveTddDiffEvidencePolicy, resolveTddOrderingPolicy, } from './gates-coverage.js';
+export { resolvePackageManager, resolveTestRunner, resolveBuildCommand, resolveGatesCommands, getIgnorePatterns, resolveGatePreset, resolveScopedUnitTestExecutionPlan, formatScopedUnitTestFallbackMessage, } 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/src/policy/gates-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gates-config.d.ts","sourceRoot":"","sources":["../../../src/policy/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;AAC5B,YAAY,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAEpF,YAAY,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAEjF,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,kCAAkC,EAClC,mCAAmC,GACpC,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"}