@lumenflow/cli 5.4.0 → 5.5.0

package/dist/gate-defaults.js

@@ -1,7 +1,75 @@
 // Copyright (c) 2026 Hellmai Ltd
 // SPDX-License-Identifier: LicenseRef-LumenFlow-Proprietary
 import { GATE_NAMES, GATE_COMMANDS, SCRIPTS } from '@lumenflow/core/wu-constants';
-import { runCoChangeGate } from './gates-runners.js';
+import { runCoChangeGate, 
+// WU-2926: per-gate applicability + precondition checks
+checkSafetyCriticalApplicability, checkMigrationVerifyApplicability, checkMigrationVerifyPreconditions, checkInvariantsPreconditions, checkLaneHealthApplicability, checkLaneHealthPreconditions, checkCoChangeApplicability, checkClaimValidationApplicability, 
+// WU-2927: opt-in local-prep gate checks
+checkBuildApplicability, checkBuildPreconditions, checkIntegrationTestApplicability, checkIntegrationTestPreconditions, checkE2eSmokeApplicability, checkE2eSmokePreconditions, } from './gates-runners.js';
+/**
+ * WU-2925: Framework gate skippability allow-list.
+ *
+ * Fail-closed default: every gate is `skippable: false` unless explicitly listed
+ * here. Per WU-2925 acceptance, only environmental or per-WU policy gates are
+ * skippable by default:
+ *
+ *   - `migration-verify`: opt-in DB verification, often absent in agent worktrees
+ *   - `lane-health`: file-pattern coverage gap, tracked separately
+ *   - `tdd-diff-evidence`: per-WU type policy (also config-driven via
+ *     `software_delivery.gates.tdd_diff_evidence`)
+ *
+ * All other framework gates (format, lint, typecheck, invariants,
+ * safety-critical-test, backlog-sync, claim-validation, co-change, spec:linter,
+ * integration-test, onboarding-smoke-test, incremental-test, coverage-gate,
+ * tiered-test, unread-directed-signal) default to `skippable: false` and require
+ * a per-repo override at `software_delivery.gates.overrides.<gate_id>.skippable=true`
+ * to be skipped.
+ *
+ * Repo-specific gates not present in this map default to `false` unless the
+ * repo declares an override.
+ *
+ * Resolution helper: see `getEffectiveSkippable()`.
+ */
+export const FRAMEWORK_GATE_SKIPPABLE_DEFAULTS = Object.freeze({
+    [GATE_NAMES.MIGRATION_VERIFY]: true,
+    [GATE_NAMES.LANE_HEALTH]: true,
+    // 'tdd-diff-evidence' is enforced through a different surface (config-driven),
+    // but its skippable default is recorded here for completeness when consulted
+    // via getEffectiveSkippable().
+    'tdd-diff-evidence': true,
+    // WU-2927: opt-in local-prep gates (extends the WU-2925 allow-list).
+    // Rationale: these are opt-in environmental gates; agents need --skip-gate
+    // for legitimate hotfix scenarios where the gate is broken/irrelevant for
+    // that WU. Skips captured in audit per WU-2925 semantics with source: 'agent'.
+    [GATE_NAMES.BUILD]: true,
+    [GATE_NAMES.INTEGRATION_TEST]: true,
+    [GATE_NAMES.E2E_SMOKE]: true,
+});
+/**
+ * WU-2925: Resolve effective skippability for a gate.
+ *
+ * Resolution order:
+ *   1. Repo override at `software_delivery.gates.overrides.<gate_id>.skippable`
+ *   2. GateDefinition.skippable_default (when registered)
+ *   3. FRAMEWORK_GATE_SKIPPABLE_DEFAULTS map
+ *   4. Fail-closed default: false
+ *
+ * @param gateName - Gate identifier (e.g. 'lane-health')
+ * @param overrides - The `software_delivery.gates.overrides` map from workspace.yaml (may be undefined)
+ * @param registeredDefault - The `skippable_default` from the registered GateDefinition (may be undefined)
+ * @returns true if `--skip-gate <gateName>` is permitted; false otherwise
+ */
+export function getEffectiveSkippable(gateName, overrides, registeredDefault) {
+    const override = overrides?.[gateName]?.skippable;
+    if (typeof override === 'boolean')
+        return override;
+    if (typeof registeredDefault === 'boolean')
+        return registeredDefault;
+    const baked = FRAMEWORK_GATE_SKIPPABLE_DEFAULTS[gateName];
+    if (typeof baked === 'boolean')
+        return baked;
+    return false;
+}
 /**
  * Register the default docs-only gates into the registry.
  *
@@ -14,9 +82,11 @@ import { runCoChangeGate } from './gates-runners.js';
 export function registerDocsOnlyGates(registry, options) {
     const { laneHealthMode, testsRequired, docsOnlyTestPlan, enableDeliveryReview = false } = options;
     // WU-2252: Invariants check runs first (non-bypassable)
+    // WU-2926: invariants is always applicable; preconditions = config present
     registry.register({
         name: GATE_NAMES.INVARIANTS,
         cmd: GATE_COMMANDS.INVARIANTS,
+        checkPreconditions: checkInvariantsPreconditions,
     });
     registry.register({
         name: GATE_NAMES.FORMAT_CHECK,
@@ -34,13 +104,20 @@ export function registerDocsOnlyGates(registry, options) {
     registry.register({
         name: GATE_NAMES.BACKLOG_SYNC,
     });
+    // WU-2926: claim-validation is applicable only when a WU is claimed
     registry.register({
         name: GATE_NAMES.CLAIM_VALIDATION,
+        checkApplicability: checkClaimValidationApplicability,
     });
     // WU-1191: Lane health check (configurable: warn/error/off)
+    // WU-2925: skippable_default: true (allow-list — file-pattern coverage gap)
+    // WU-2926: applicable when lane-state.json exists; preconditions = state writable
     registry.register({
         name: GATE_NAMES.LANE_HEALTH,
         warnOnly: laneHealthMode !== 'error',
+        skippable_default: true,
+        checkApplicability: checkLaneHealthApplicability,
+        checkPreconditions: checkLaneHealthPreconditions,
     });
     // WU-1315: Onboarding smoke test
     registry.register({
@@ -72,9 +149,11 @@ export function registerDocsOnlyGates(registry, options) {
 export function registerCodeGates(registry, options) {
     const { isFullLint, isFullTests, isFullCoverage, laneHealthMode, testsRequired, shouldRunIntegration, configuredTestFullCmd, enableDeliveryReview = false, } = options;
     // WU-2252: Invariants check runs first (non-bypassable)
+    // WU-2926: invariants is always applicable; preconditions = config present
     registry.register({
         name: GATE_NAMES.INVARIANTS,
         cmd: GATE_COMMANDS.INVARIANTS,
+        checkPreconditions: checkInvariantsPreconditions,
     });
     registry.register({
         name: GATE_NAMES.FORMAT_CHECK,
@@ -85,12 +164,23 @@ export function registerCodeGates(registry, options) {
         cmd: isFullLint ? `pnpm ${SCRIPTS.LINT}` : GATE_COMMANDS.INCREMENTAL,
         scriptName: SCRIPTS.LINT,
     });
+    // WU-2926: co-change is applicable only when workspace.yaml has co-change rules
     registry.register({
         name: GATE_NAMES.CO_CHANGE,
         run: runCoChangeGate,
+        checkApplicability: checkCoChangeApplicability,
     });
+    // WU-2380: Optional migration-state verification gate
+    // WU-2925: skippable_default: true (allow-list — environmental DB infra)
+    // WU-2926: applicability + DB-prereq detection so non-migration WUs auto-skip
+    // not-applicable, and migration WUs without DB infra auto-skip missing-prereq
+    // (or BLOCK when override flips skippable=false).
     registry.register({
         name: GATE_NAMES.MIGRATION_VERIFY,
+        skippable_default: true,
+        checkApplicability: checkMigrationVerifyApplicability,
+        checkPreconditions: checkMigrationVerifyPreconditions,
+        prereq_strategy: 'auto-skip',
     });
     registry.register({
         name: GATE_NAMES.TYPECHECK,
@@ -105,16 +195,23 @@ export function registerCodeGates(registry, options) {
     registry.register({
         name: GATE_NAMES.BACKLOG_SYNC,
     });
+    // WU-2926: claim-validation is applicable only when a WU is claimed
     registry.register({
         name: GATE_NAMES.CLAIM_VALIDATION,
+        checkApplicability: checkClaimValidationApplicability,
     });
     registry.register({
         name: GATE_NAMES.SUPABASE_DOCS_LINTER,
     });
     // WU-1191: Lane health check
+    // WU-2925: skippable_default: true (allow-list — file-pattern coverage gap)
+    // WU-2926: applicable when lane-state.json exists; preconditions = state writable
     registry.register({
         name: GATE_NAMES.LANE_HEALTH,
         warnOnly: laneHealthMode !== 'error',
+        skippable_default: true,
+        checkApplicability: checkLaneHealthApplicability,
+        checkPreconditions: checkLaneHealthPreconditions,
     });
     // WU-1315: Onboarding smoke test
     registry.register({
@@ -122,10 +219,18 @@ export function registerCodeGates(registry, options) {
         cmd: GATE_COMMANDS.ONBOARDING_SMOKE_TEST,
     });
     // WU-2062: Safety-critical tests ALWAYS run
+    // WU-2926: ships with skippable_default: false (explicit) and a default
+    //   checkApplicability that returns 'applicable' for every change set,
+    //   preserving today's gate-defaults.ts:195 / gates-runners.ts:743 behaviour.
+    //   Per-repo override at
+    //   software_delivery.gates.overrides.safety-critical-test.applicability_paths
+    //   narrows applicability without flipping the default.
     registry.register({
         name: GATE_NAMES.SAFETY_CRITICAL_TEST,
         cmd: GATE_COMMANDS.SAFETY_CRITICAL_TEST,
         warnOnly: !testsRequired,
+        skippable_default: false,
+        checkApplicability: (ctx) => checkSafetyCriticalApplicability(ctx),
     });
     // WU-1920: Changed tests by default, full suite with --full-tests
     registry.register({
@@ -133,14 +238,54 @@ export function registerCodeGates(registry, options) {
         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-2927: Integration-test gate is now UNCONDITIONALLY registered.
+    // Pre-WU-2927: registered conditionally behind `shouldRunIntegration`
+    // (hardcoded false at gates.ts:450/486). That made
+    // `software_delivery.gates.local_prep.integration_test.enabled` ineffective
+    // for opting in. Now: always registered, applicability is the only knob.
+    //
+    // Decision matrix (WU-2926 + WU-2927):
+    //   local_prep.integration_test.enabled = false (default) → not-applicable → auto-skip
+    //   enabled = true + script present                       → run
+    //   enabled = true + script missing                       → 'failed' (prereq_strategy: 'fail')
+    //   enabled = true + script missing + override skippable=false → blocked-missing-prereq
+    //
+    // The legacy `shouldRunIntegration` flag is intentionally read but no longer
+    // gates registration — it is preserved as a compatibility no-op so callers
+    // (and the WU-1550 registry-defaults tests) continue to compile unchanged.
+    void shouldRunIntegration;
+    registry.register({
+        name: GATE_NAMES.INTEGRATION_TEST,
+        cmd: GATE_COMMANDS.TIERED_TEST,
+        warnOnly: !testsRequired,
+        skippable_default: true,
+        prereq_strategy: 'fail',
+        checkApplicability: checkIntegrationTestApplicability,
+        checkPreconditions: (ctx) => Promise.resolve(checkIntegrationTestPreconditions(ctx)),
+    });
+    // WU-2927: Opt-in local-prep build gate. Registered always; applicable only
+    // when local_prep.build.enabled = true. Wraps SCRIPTS.BUILD via a sentinel
+    // dispatched in gates.ts.
+    registry.register({
+        name: GATE_NAMES.BUILD,
+        cmd: GATE_COMMANDS.BUILD,
+        scriptName: SCRIPTS.BUILD,
+        skippable_default: true,
+        prereq_strategy: 'fail',
+        checkApplicability: checkBuildApplicability,
+        checkPreconditions: (ctx) => Promise.resolve(checkBuildPreconditions(ctx)),
+    });
+    // WU-2927: Opt-in local-prep e2e-smoke gate. Applicable only when
+    // local_prep.e2e_smoke.enabled = true AND playwright.config.{ts,js,mjs}
+    // exists at repo root (absence of Playwright is a clean opt-out).
+    registry.register({
+        name: GATE_NAMES.E2E_SMOKE,
+        cmd: GATE_COMMANDS.E2E_SMOKE,
+        skippable_default: true,
+        prereq_strategy: 'fail',
+        checkApplicability: checkE2eSmokeApplicability,
+        checkPreconditions: (ctx) => Promise.resolve(checkE2eSmokePreconditions(ctx)),
+    });
     if (enableDeliveryReview) {
         registry.register({
             name: GATE_NAMES.DELIVERY_REVIEW,

package/dist/gate-defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"gate-defaults.js","sourceRoot":"","sources":["../src/gate-defaults.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gate-defaults.js","sourceRoot":"","sources":["../src/gate-defaults.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,4DAA4D;AAe5D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAClF,OAAO,EACL,eAAe;AACf,wDAAwD;AACxD,gCAAgC,EAChC,iCAAiC,EACjC,iCAAiC,EACjC,4BAA4B,EAC5B,4BAA4B,EAC5B,4BAA4B,EAC5B,0BAA0B,EAC1B,iCAAiC;AACjC,yCAAyC;AACzC,uBAAuB,EACvB,uBAAuB,EACvB,iCAAiC,EACjC,iCAAiC,EACjC,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAsC,MAAM,CAAC,MAAM,CAAC;IAChG,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,IAAI;IACnC,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,IAAI;IAC9B,+EAA+E;IAC/E,6EAA6E;IAC7E,+BAA+B;IAC/B,mBAAmB,EAAE,IAAI;IACzB,qEAAqE;IACrE,2EAA2E;IAC3E,0EAA0E;IAC1E,+EAA+E;IAC/E,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,IAAI;IACxB,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,IAAI;IACnC,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,IAAI;CAC7B,CAAC,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAChB,SAA+D,EAC/D,iBAA2B;IAE3B,MAAM,QAAQ,GAAG,SAAS,EAAE,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAClD,IAAI,OAAO,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACnD,IAAI,OAAO,iBAAiB,KAAK,SAAS;QAAE,OAAO,iBAAiB,CAAC;IACrE,MAAM,KAAK,GAAG,iCAAiC,CAAC,QAAQ,CAAC,CAAC;IAC1D,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,OAAO,KAAK,CAAC;AACf,CAAC;AA0BD;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAsB,EAAE,OAA4B;IACxF,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAElG,wDAAwD;IACxD,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,UAAU;QAC3B,GAAG,EAAE,aAAa,CAAC,UAAU;QAC7B,kBAAkB,EAAE,4BAA4B;KACjD,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,YAAY;QAC7B,UAAU,EAAE,OAAO,CAAC,YAAY;QAChC,mEAAmE;QACnE,qEAAqE;QACrE,GAAG,EAAE,SAAS;QACd,GAAG,EAAE,SAAS;KACG,CAAC,CAAC;IAErB,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,WAAW;QAC5B,UAAU,EAAE,OAAO,CAAC,WAAW;KACd,CAAC,CAAC;IAErB,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,YAAY;KACZ,CAAC,CAAC;IAErB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,gBAAgB;QACjC,kBAAkB,EAAE,iCAAiC;KACpC,CAAC,CAAC;IAErB,4DAA4D;IAC5D,4EAA4E;IAC5E,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,WAAW;QAC5B,QAAQ,EAAE,cAAc,KAAK,OAAO;QACpC,iBAAiB,EAAE,IAAI;QACvB,kBAAkB,EAAE,4BAA4B;QAChD,kBAAkB,EAAE,4BAA4B;KAC/B,CAAC,CAAC;IAErB,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,qBAAqB;QACtC,GAAG,EAAE,aAAa,CAAC,qBAAqB;KACzC,CAAC,CAAC;IAEH,oEAAoE;IACpE,IAAI,gBAAgB,IAAI,gBAAgB,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC7D,QAAQ,CAAC,QAAQ,CAAC;YAChB,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,QAAQ,EAAE,CAAC,aAAa;SACP,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,oBAAoB,EAAE,CAAC;QACzB,QAAQ,CAAC,QAAQ,CAAC;YAChB,IAAI,EAAE,UAAU,CAAC,eAAe;SACf,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAsB,EAAE,OAAwB;IAChF,MAAM,EACJ,UAAU,EACV,WAAW,EACX,cAAc,EACd,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,GAAG,KAAK,GAC7B,GAAG,OAAO,CAAC;IAEZ,wDAAwD;IACxD,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,UAAU;QAC3B,GAAG,EAAE,aAAa,CAAC,UAAU;QAC7B,kBAAkB,EAAE,4BAA4B;KACjD,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,YAAY;QAC7B,UAAU,EAAE,OAAO,CAAC,YAAY;KACf,CAAC,CAAC;IAErB,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,WAAW;QACpE,UAAU,EAAE,OAAO,CAAC,IAAI;KACzB,CAAC,CAAC;IAEH,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,SAAS;QAC1B,GAAG,EAAE,eAAe;QACpB,kBAAkB,EAAE,0BAA0B;KAC7B,CAAC,CAAC;IAErB,sDAAsD;IACtD,yEAAyE;IACzE,8EAA8E;IAC9E,8EAA8E;IAC9E,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,gBAAgB;QACjC,iBAAiB,EAAE,IAAI;QACvB,kBAAkB,EAAE,iCAAiC;QACrD,kBAAkB,EAAE,iCAAiC;QACrD,eAAe,EAAE,WAAW;KACX,CAAC,CAAC;IAErB,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,SAAS;QAC1B,GAAG,EAAE,QAAQ,OAAO,CAAC,SAAS,EAAE;QAChC,UAAU,EAAE,OAAO,CAAC,SAAS;KAC9B,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,WAAW;QAC5B,UAAU,EAAE,OAAO,CAAC,WAAW;KACd,CAAC,CAAC;IAErB,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,YAAY;KACZ,CAAC,CAAC;IAErB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,gBAAgB;QACjC,kBAAkB,EAAE,iCAAiC;KACpC,CAAC,CAAC;IAErB,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,oBAAoB;KACpB,CAAC,CAAC;IAErB,6BAA6B;IAC7B,4EAA4E;IAC5E,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,WAAW;QAC5B,QAAQ,EAAE,cAAc,KAAK,OAAO;QACpC,iBAAiB,EAAE,IAAI;QACvB,kBAAkB,EAAE,4BAA4B;QAChD,kBAAkB,EAAE,4BAA4B;KAC/B,CAAC,CAAC;IAErB,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,qBAAqB;QACtC,GAAG,EAAE,aAAa,CAAC,qBAAqB;KACzC,CAAC,CAAC;IAEH,4CAA4C;IAC5C,wEAAwE;IACxE,uEAAuE;IACvE,8EAA8E;IAC9E,yBAAyB;IACzB,+EAA+E;IAC/E,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,oBAAoB;QACrC,GAAG,EAAE,aAAa,CAAC,oBAAoB;QACvC,QAAQ,EAAE,CAAC,aAAa;QACxB,iBAAiB,EAAE,KAAK;QACxB,kBAAkB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,gCAAgC,CAAC,GAAG,CAAC;KACnE,CAAC,CAAC;IAEH,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,GAAG,EAAE,WAAW,IAAI,cAAc,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,aAAa,CAAC,gBAAgB;QAC3F,QAAQ,EAAE,CAAC,aAAa;KACzB,CAAC,CAAC;IAEH,oEAAoE;IACpE,sEAAsE;IACtE,mDAAmD;IACnD,4EAA4E;IAC5E,yEAAyE;IACzE,EAAE;IACF,uCAAuC;IACvC,uFAAuF;IACvF,gEAAgE;IAChE,+FAA+F;IAC/F,wFAAwF;IACxF,EAAE;IACF,6EAA6E;IAC7E,2EAA2E;IAC3E,2EAA2E;IAC3E,KAAK,oBAAoB,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,gBAAgB;QACjC,GAAG,EAAE,aAAa,CAAC,WAAW;QAC9B,QAAQ,EAAE,CAAC,aAAa;QACxB,iBAAiB,EAAE,IAAI;QACvB,eAAe,EAAE,MAAM;QACvB,kBAAkB,EAAE,iCAAiC;QACrD,kBAAkB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,iCAAiC,CAAC,GAAG,CAAC,CAAC;KACnE,CAAC,CAAC;IAErB,4EAA4E;IAC5E,2EAA2E;IAC3E,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,KAAK;QACtB,GAAG,EAAE,aAAa,CAAC,KAAK;QACxB,UAAU,EAAE,OAAO,CAAC,KAAK;QACzB,iBAAiB,EAAE,IAAI;QACvB,eAAe,EAAE,MAAM;QACvB,kBAAkB,EAAE,uBAAuB;QAC3C,kBAAkB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC;KACzD,CAAC,CAAC;IAErB,kEAAkE;IAClE,wEAAwE;IACxE,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,SAAS;QAC1B,GAAG,EAAE,aAAa,CAAC,SAAS;QAC5B,iBAAiB,EAAE,IAAI;QACvB,eAAe,EAAE,MAAM;QACvB,kBAAkB,EAAE,0BAA0B;QAC9C,kBAAkB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,0BAA0B,CAAC,GAAG,CAAC,CAAC;KAC5D,CAAC,CAAC;IAErB,IAAI,oBAAoB,EAAE,CAAC;QACzB,QAAQ,CAAC,QAAQ,CAAC;YAChB,IAAI,EAAE,UAAU,CAAC,eAAe;SACf,CAAC,CAAC;IACvB,CAAC;IAED,yBAAyB;IACzB,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,UAAU,CAAC,QAAQ;QACzB,GAAG,EAAE,aAAa,CAAC,aAAa;KACjC,CAAC,CAAC;AACL,CAAC"}

package/dist/gate-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"gate-registry.js","sourceRoot":"","sources":["../src/gate-registry.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,4DAA4D;AAE5D;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AA+B1D;;;;;;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,WAAW,CACf,UAAU,CAAC,uBAAuB,EAClC,SAAS,IAAI,CAAC,IAAI,yBAAyB,CAC5C,CAAC;QACJ,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"}
+{"version":3,"file":"gate-registry.js","sourceRoot":"","sources":["../src/gate-registry.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,4DAA4D;AAE5D;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAyJ1D;;;;;;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,WAAW,CACf,UAAU,CAAC,uBAAuB,EAClC,SAAS,IAAI,CAAC,IAAI,yBAAyB,CAC5C,CAAC;QACJ,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-runners.js

@@ -585,6 +585,181 @@ export async function runIntegrationTests({ agentLog, cwd, }) {
         return { ok: false, duration: Date.now() - start };
     }
 }
+// ── WU-2927: Opt-in local-prep gates (build / integration-test / e2e-smoke) ──
+/**
+ * WU-2927: Resolve `software_delivery.gates.local_prep` from workspace.yaml.
+ *
+ * Returns the typed sub-shape (or undefined when the section is missing or
+ * malformed). The runtime callers fall through to "not applicable" semantics
+ * when this returns undefined or `{ enabled: false }` — backward-compat for
+ * repos that have not opted in.
+ */
+function readLocalPrepConfig(cwd) {
+    try {
+        const section = getGatesSection(cwd);
+        const lp = section?.local_prep;
+        if (lp && typeof lp === 'object' && !Array.isArray(lp)) {
+            return lp;
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function readPackageScripts(cwd) {
+    try {
+        const pkgPath = path.join(cwd, 'package.json');
+        if (!existsSync(pkgPath))
+            return undefined;
+        const raw = readFileSync(pkgPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        return parsed.scripts;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * WU-2927: build gate applicability — only when the local-prep profile opts in
+ * (`local_prep.build.enabled = true`). Default false → not-applicable.
+ */
+export function checkBuildApplicability(ctx) {
+    const cwd = ctx.cwd ?? process.cwd();
+    const lp = readLocalPrepConfig(cwd);
+    return Promise.resolve(lp?.build?.enabled === true ? 'applicable' : 'not-applicable');
+}
+/**
+ * WU-2927: build gate preconditions — `build` script must exist in
+ * package.json. With `prereq_strategy: 'fail'` a missing script is treated as
+ * a misconfiguration, not an environmental gap.
+ */
+export function checkBuildPreconditions(ctx) {
+    const cwd = ctx.cwd ?? process.cwd();
+    const scripts = readPackageScripts(cwd);
+    return scripts && Object.prototype.hasOwnProperty.call(scripts, SCRIPTS.BUILD)
+        ? 'satisfied'
+        : 'missing';
+}
+/**
+ * WU-2927: integration-test gate applicability — opt-in via
+ * `local_prep.integration_test.enabled = true`. Replaces the pre-WU-2927
+ * conditional registration (gate-defaults.ts:209 / gates.ts:450/486) so that
+ * the gate is unconditionally registered and applicability is the only knob.
+ */
+export function checkIntegrationTestApplicability(ctx) {
+    const cwd = ctx.cwd ?? process.cwd();
+    const lp = readLocalPrepConfig(cwd);
+    return Promise.resolve(lp?.integration_test?.enabled === true ? 'applicable' : 'not-applicable');
+}
+/**
+ * WU-2927: integration-test gate preconditions — `test:integration` script
+ * must exist. Same fail-on-missing semantics as build (misconfig).
+ */
+export function checkIntegrationTestPreconditions(ctx) {
+    const cwd = ctx.cwd ?? process.cwd();
+    const scripts = readPackageScripts(cwd);
+    return scripts && Object.prototype.hasOwnProperty.call(scripts, SCRIPTS.TEST_INTEGRATION)
+        ? 'satisfied'
+        : 'missing';
+}
+/**
+ * WU-2927: e2e-smoke gate applicability — applicable iff
+ *   (a) `local_prep.e2e_smoke.enabled = true`, AND
+ *   (b) `playwright.config.{ts,js,mjs}` exists at repo root.
+ *
+ * Per stated policy: the absence of a Playwright config is a clean opt-out,
+ * not a missing precondition (no explicit disable required for repos that do
+ * not use Playwright).
+ */
+export function checkE2eSmokeApplicability(ctx) {
+    const cwd = ctx.cwd ?? process.cwd();
+    const lp = readLocalPrepConfig(cwd);
+    if (lp?.e2e_smoke?.enabled !== true)
+        return Promise.resolve('not-applicable');
+    for (const ext of ['ts', 'js', 'mjs']) {
+        if (existsSync(path.join(cwd, `playwright.config.${ext}`))) {
+            return Promise.resolve('applicable');
+        }
+    }
+    return Promise.resolve('not-applicable');
+}
+/**
+ * WU-2927: e2e-smoke gate preconditions — once applicable (Playwright config
+ * present + opted in), the `test:e2e` script must exist. Missing = misconfig
+ * → 'failed' under `prereq_strategy: 'fail'`.
+ */
+export function checkE2eSmokePreconditions(ctx) {
+    const cwd = ctx.cwd ?? process.cwd();
+    const scripts = readPackageScripts(cwd);
+    return scripts && Object.prototype.hasOwnProperty.call(scripts, SCRIPTS.TEST_E2E)
+        ? 'satisfied'
+        : 'missing';
+}
+/**
+ * WU-2927: Read the configured e2e_smoke.tag (default 'smoke').
+ */
+export function getE2eSmokeTag(cwd) {
+    const lp = readLocalPrepConfig(cwd);
+    const tag = lp?.e2e_smoke?.tag;
+    return typeof tag === 'string' && tag.length > 0 ? tag : 'smoke';
+}
+/**
+ * WU-2927: Read the configured latency_budget_warn_ms (default 180_000).
+ */
+export function getLocalPrepLatencyBudgetMs(cwd) {
+    const lp = readLocalPrepConfig(cwd);
+    const budget = lp?.latency_budget_warn_ms;
+    return typeof budget === 'number' && budget >= 0 ? budget : 180_000;
+}
+/**
+ * WU-2927: Run the opt-in build gate (`pnpm build`). Wraps SCRIPTS.BUILD.
+ */
+export async function runBuildGate({ agentLog, cwd, }) {
+    const start = Date.now();
+    const logLine = (line) => {
+        if (!agentLog) {
+            console.log(line);
+            return;
+        }
+        writeSync(agentLog.logFd, `${line}\n`);
+    };
+    try {
+        logLine('\n> Build gate (local_prep)\n');
+        const result = await run(pnpmRun(SCRIPTS.BUILD), { agentLog, cwd });
+        return { ok: result.ok, duration: Date.now() - start };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logLine(`⚠️  Build gate failed: ${message}`);
+        return { ok: false, duration: Date.now() - start };
+    }
+}
+/**
+ * WU-2927: Run the opt-in e2e-smoke gate. Executes
+ *   `pnpm test:e2e --tag <local_prep.e2e_smoke.tag>` (default tag 'smoke').
+ */
+export async function runE2eSmokeGate({ agentLog, cwd, }) {
+    const start = Date.now();
+    const logLine = (line) => {
+        if (!agentLog) {
+            console.log(line);
+            return;
+        }
+        writeSync(agentLog.logFd, `${line}\n`);
+    };
+    try {
+        const tag = getE2eSmokeTag(cwd);
+        logLine(`\n> E2E smoke gate (local_prep, tag=${tag})\n`);
+        const result = await run(pnpmRun(SCRIPTS.TEST_E2E, '--tag', tag), { agentLog, cwd });
+        return { ok: result.ok, duration: Date.now() - start };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logLine(`⚠️  E2E smoke gate failed: ${message}`);
+        return { ok: false, duration: Date.now() - start };
+    }
+}
 // ── Co-change gate ────────────────────────────────────────────────────
 const CoChangeRulesConfigSchema = CoChangeRuleConfigSchema.array();
 const ConditionalCommandsConfigSchema = ConditionalCommandConfigSchema.array();
@@ -1099,4 +1274,187 @@ export async function runDocsOnlyFilteredTests({ packages, agentLog, cwd = proce
     const result = await run(filteredCmd, { agentLog });
     return { ok: result.ok, duration: Date.now() - start };
 }
+// ── WU-2926: Per-gate applicability + precondition helpers ─────────────
+/**
+ * WU-2926: Test whether any changed file matches one of the
+ * `applicability_paths` patterns. Returns `true` (applicable) when the override
+ * is undefined or empty so safety-critical-test preserves today's "always
+ * runs" behaviour at gate-defaults.ts:195.
+ */
+export function applicabilityPathsMatch(input) {
+    const { applicabilityPaths } = input;
+    if (!applicabilityPaths || applicabilityPaths.length === 0) {
+        // Default applicable — preserves backward-compat (no override, no narrowing).
+        return true;
+    }
+    return micromatch.isMatch.length >= 0
+        ? input.changedFiles.some((file) => micromatch.isMatch(file, applicabilityPaths))
+        : false;
+}
+/**
+ * WU-2926: Default safety-critical applicability check.
+ *
+ * Backward-compat preservation (load-bearing): with no per-repo
+ * `applicability_paths` override, returns 'applicable' for every change set —
+ * matching the always-runs behaviour at gate-defaults.ts:195 and
+ * gates-runners.ts:743 (runSafetyCriticalTests).
+ *
+ * With an override (e.g. `['app/security/**', 'lib/auth/**']`), returns
+ * 'applicable' only when at least one changed file matches.
+ */
+export async function checkSafetyCriticalApplicability(input) {
+    // Resolve applicability_paths: explicit input wins; else read from
+    // software_delivery.gates.overrides.safety-critical-test.applicability_paths.
+    let paths = input.applicabilityPaths;
+    if (paths === undefined) {
+        paths = readApplicabilityPathsOverride('safety-critical-test', input.cwd ?? process.cwd());
+    }
+    if (!paths || paths.length === 0) {
+        return 'applicable';
+    }
+    let files = input.changedFiles;
+    if (!files) {
+        try {
+            const git = createGitForPath(input.cwd ?? process.cwd());
+            files = await getChangedFilesForIncremental({ git });
+        }
+        catch {
+            files = [];
+        }
+    }
+    return applicabilityPathsMatch({ changedFiles: files, applicabilityPaths: paths })
+        ? 'applicable'
+        : 'not-applicable';
+}
+/**
+ * WU-2926: Read `software_delivery.gates.overrides.<gate_id>.applicability_paths`
+ * from workspace.yaml. Returns undefined when no override is set so callers
+ * can fall through to default-applicable behaviour.
+ */
+function readApplicabilityPathsOverride(gateId, cwd) {
+    try {
+        const required = require;
+        const cfgMod = required('@lumenflow/core/config');
+        if (!cfgMod || typeof cfgMod.getConfig !== 'function')
+            return undefined;
+        const cfg = cfgMod.getConfig();
+        const sd = cfg &&
+            cfg.software_delivery;
+        const gates = sd?.gates;
+        const overrides = gates?.overrides;
+        const entry = overrides?.[gateId];
+        const ap = entry?.applicability_paths;
+        if (Array.isArray(ap) && ap.every((s) => typeof s === 'string')) {
+            return ap;
+        }
+        return undefined;
+    }
+    catch {
+        void cwd;
+        return undefined;
+    }
+}
+/**
+ * WU-2926: migration-verify applicability — only when migrations/.sql or
+ * schema files have changed.
+ */
+export async function checkMigrationVerifyApplicability(ctx) {
+    try {
+        const git = createGitForPath(ctx.cwd ?? process.cwd());
+        const changed = await getChangedFilesForIncremental({ git });
+        return shouldRunMigrationVerifyForChanges({ changedFiles: changed })
+            ? 'applicable'
+            : 'not-applicable';
+    }
+    catch {
+        return 'not-applicable';
+    }
+}
+/**
+ * WU-2926: migration-verify preconditions — DATABASE_URL set OR PGlite available.
+ *
+ * PGlite presence is approximated by node_modules/@electric-sql/pglite, the
+ * canonical package the migration toolchain uses for in-process Postgres in
+ * agent worktrees.
+ */
+export function checkMigrationVerifyPreconditions(ctx) {
+    if (process.env.DATABASE_URL && process.env.DATABASE_URL.trim().length > 0) {
+        return Promise.resolve('satisfied');
+    }
+    const cwd = ctx.cwd ?? process.cwd();
+    const pgliteDir = path.join(cwd, 'node_modules', '@electric-sql', 'pglite');
+    return Promise.resolve(existsSync(pgliteDir) ? 'satisfied' : 'missing');
+}
+/**
+ * WU-2926: invariants gate — always applicable; preconditions satisfied when
+ * an invariants config is present (best-effort detection at standard paths).
+ */
+export function checkInvariantsPreconditions(ctx) {
+    const cwd = ctx.cwd ?? process.cwd();
+    const candidates = [
+        'invariants.yaml',
+        'invariants.yml',
+        '.lumenflow/invariants.yaml',
+        'docs/operations/_frameworks/lumenflow/invariants.yaml',
+    ];
+    for (const rel of candidates) {
+        if (existsSync(path.join(cwd, rel)))
+            return Promise.resolve('satisfied');
+    }
+    // Fallback: invariants runner has internal defaults (the existing gate
+    // already runs without explicit config). Return 'satisfied' to preserve
+    // today's behaviour.
+    return Promise.resolve('satisfied');
+}
+/**
+ * WU-2926: lane-health applicability — only when `.lumenflow/state/lane-state.json`
+ * exists. Preconditions = state path is writable.
+ */
+export function checkLaneHealthApplicability(ctx) {
+    const cwd = ctx.cwd ?? process.cwd();
+    return Promise.resolve(existsSync(path.join(cwd, '.lumenflow', 'state', 'lane-state.json'))
+        ? 'applicable'
+        : 'not-applicable');
+}
+export async function checkLaneHealthPreconditions(ctx) {
+    const cwd = ctx.cwd ?? process.cwd();
+    const stateDir = path.join(cwd, '.lumenflow', 'state');
+    try {
+        await access(stateDir);
+        return 'satisfied';
+    }
+    catch {
+        return 'missing';
+    }
+}
+/**
+ * WU-2926: co-change applicability — only when workspace.yaml has co-change
+ * rules (otherwise the gate has nothing to evaluate).
+ */
+export function checkCoChangeApplicability(ctx) {
+    const cwd = ctx.cwd ?? process.cwd();
+    try {
+        const section = getGatesSection(cwd);
+        const rules = section?.co_change?.rules;
+        return Promise.resolve(Array.isArray(rules) && rules.length > 0 ? 'applicable' : 'not-applicable');
+    }
+    catch {
+        return Promise.resolve('not-applicable');
+    }
+}
+/**
+ * WU-2926: claim-validation applicability — only when a claimed WU YAML
+ * exists for the current worktree. Without a claim, the gate has nothing to
+ * validate.
+ */
+export async function checkClaimValidationApplicability(ctx) {
+    const cwd = ctx.cwd ?? process.cwd();
+    try {
+        const wuId = await detectCurrentWUForCwd(cwd);
+        return wuId ? 'applicable' : 'not-applicable';
+    }
+    catch {
+        return 'not-applicable';
+    }
+}
 //# sourceMappingURL=gates-runners.js.map