@lumenflow/packs-software-delivery 4.24.0 → 5.0.1

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

@@ -0,0 +1,142 @@
+/**
+ * Gates Schemas and Types
+ *
+ * WU-2037: Extracted from gates-config.ts
+ *
+ * Zod schema definitions, TypeScript types, and interfaces for gates configuration.
+ * This module contains only shape definitions -- no runtime logic.
+ *
+ * @module gates-schemas
+ */
+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;
+}
+/**
+ * WU-1191: Lane health gate mode
+ * Controls how lane health check behaves during gates
+ */
+export type LaneHealthMode = 'warn' | 'error' | 'off';
+/**
+ * Schema for lane health mode validation
+ */
+export declare const LaneHealthModeSchema: z.ZodEnum<{
+    error: "error";
+    warn: "warn";
+    off: "off";
+}>;
+/**
+ * Default lane health mode (advisory by default)
+ */
+export declare const DEFAULT_LANE_HEALTH_MODE: 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-2020: Focused coverage policy interface (ISP-compliant).
+ * Single-responsibility: coverage threshold and enforcement mode.
+ */
+export interface CoveragePolicy {
+    /** Coverage threshold (0-100) */
+    threshold: number;
+    /** Coverage mode (block, warn, or off) */
+    mode: CoverageMode;
+}
+/**
+ * WU-2020: Focused test runner policy interface (ISP-compliant).
+ * Single-responsibility: whether tests are mandatory for completion.
+ */
+export interface TestRunnerPolicy {
+    /** Whether tests are required for completion (from methodology.testing) */
+    tests_required: boolean;
+}
+/**
+ * WU-1280: Resolved test policy configuration
+ * Extends CoverageConfig with tests_required from methodology policy.
+ *
+ * WU-2020: Now defined as the intersection of CoveragePolicy and
+ * TestRunnerPolicy. Consumers that only need coverage or test-runner
+ * semantics should prefer the focused interfaces.
+ */
+export interface TestPolicy extends CoveragePolicy, TestRunnerPolicy {
+}
+/**
+ * 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;
+    migration_verify: string;
+}
+//# sourceMappingURL=gates-schemas.d.ts.map

package/dist/src/policy/gates-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gates-schemas.d.ts","sourceRoot":"","sources":["../../../src/policy/gates-schemas.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAkBxD;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;mBAAiD,CAAC;AAEtF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuBrC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAM9E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,eAAe,EAAE,OAAO,CAAC;IACzB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;EAAmC,CAAC;AAErE;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,cAAuB,CAAC;AAM/D;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,IAAI,EAAE,YAAY,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,IAAI,EAAE,YAAY,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,UAAW,SAAQ,cAAc,EAAE,gBAAgB;CAAG;AAMvE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;CAC1B"}

package/dist/src/policy/gates-schemas.js

@@ -0,0 +1,67 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Gates Schemas and Types
+ *
+ * WU-2037: Extracted from gates-config.ts
+ *
+ * Zod schema definitions, TypeScript types, and interfaces for gates configuration.
+ * This module contains only shape definitions -- no runtime logic.
+ *
+ * @module gates-schemas
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Gate command schemas
+// ---------------------------------------------------------------------------
+/**
+ * Schema for a gate command object with options
+ */
+const GateCommandObjectSchema = z.object({
+    /** The shell command to execute */
+    command: z.string(),
+    /** Whether to continue if this gate fails (default: false) */
+    continueOnError: z.boolean().optional(),
+    /** Timeout in milliseconds */
+    timeout: z.number().int().positive().optional(),
+});
+/**
+ * Schema for a gate command - either a string or an object with options
+ */
+export const GateCommandConfigSchema = z.union([z.string(), GateCommandObjectSchema]);
+/**
+ * Schema for the gates execution configuration section
+ */
+export const GatesExecutionConfigSchema = z.object({
+    /** Preset to use for default commands (node, python, go, rust, dotnet) */
+    preset: z.string().optional(),
+    /** Setup command (e.g., install dependencies) */
+    setup: GateCommandConfigSchema.optional(),
+    /** Format check command */
+    format: GateCommandConfigSchema.optional(),
+    /** Lint command */
+    lint: GateCommandConfigSchema.optional(),
+    /** Type check command */
+    typecheck: GateCommandConfigSchema.optional(),
+    /** Test command */
+    test: GateCommandConfigSchema.optional(),
+    /** Coverage configuration */
+    coverage: z
+        .union([
+        z.string(),
+        z.object({
+            command: z.string(),
+            threshold: z.number().min(0).max(100).optional(),
+        }),
+    ])
+        .optional(),
+});
+/**
+ * Schema for lane health mode validation
+ */
+export const LaneHealthModeSchema = z.enum(['warn', 'error', 'off']);
+/**
+ * Default lane health mode (advisory by default)
+ */
+export const DEFAULT_LANE_HEALTH_MODE = 'warn';
+//# sourceMappingURL=gates-schemas.js.map

package/dist/src/policy/gates-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gates-schemas.js","sourceRoot":"","sources":["../../../src/policy/gates-schemas.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,mCAAmC;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,8DAA8D;IAC9D,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACvC,8BAA8B;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,uBAAuB,CAAC,CAAC,CAAC;AAOtF;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,0EAA0E;IAC1E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,iDAAiD;IACjD,KAAK,EAAE,uBAAuB,CAAC,QAAQ,EAAE;IACzC,2BAA2B;IAC3B,MAAM,EAAE,uBAAuB,CAAC,QAAQ,EAAE;IAC1C,mBAAmB;IACnB,IAAI,EAAE,uBAAuB,CAAC,QAAQ,EAAE;IACxC,yBAAyB;IACzB,SAAS,EAAE,uBAAuB,CAAC,QAAQ,EAAE;IAC7C,mBAAmB;IACnB,IAAI,EAAE,uBAAuB,CAAC,QAAQ,EAAE;IACxC,6BAA6B;IAC7B,QAAQ,EAAE,CAAC;SACR,KAAK,CAAC;QACL,CAAC,CAAC,MAAM,EAAE;QACV,CAAC,CAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;YACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;SACjD,CAAC;KACH,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC;AAiCH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AAErE;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAmB,MAAM,CAAC"}

package/dist/src/policy/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Software Delivery Pack — Policy Barrel
+ *
+ * WU-2674 (INIT-058 L3): Cohesion-closed policy bundle moved from
+ * @lumenflow/core/src/. These modules share tight internal coupling
+ * (CoverageMode crosses them) and evolve together.
+ *
+ * @module packs/software-delivery/policy
+ */
+export * from './gates-schemas.js';
+export * from './resolve-policy.js';
+export * from './coverage-gate.js';
+export * from './gates-config.js';
+export * from './gates-presets.js';
+export * from './gates-config-internal.js';
+export * from './gates-agent-mode.js';
+export * from './gates-coverage.js';
+export * from './package-manager-resolver.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/policy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/policy/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC"}

package/dist/src/policy/index.js

@@ -0,0 +1,21 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Software Delivery Pack — Policy Barrel
+ *
+ * WU-2674 (INIT-058 L3): Cohesion-closed policy bundle moved from
+ * @lumenflow/core/src/. These modules share tight internal coupling
+ * (CoverageMode crosses them) and evolve together.
+ *
+ * @module packs/software-delivery/policy
+ */
+export * from './gates-schemas.js';
+export * from './resolve-policy.js';
+export * from './coverage-gate.js';
+export * from './gates-config.js';
+export * from './gates-presets.js';
+export * from './gates-config-internal.js';
+export * from './gates-agent-mode.js';
+export * from './gates-coverage.js';
+export * from './package-manager-resolver.js';
+//# sourceMappingURL=index.js.map

package/dist/src/policy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/policy/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;GAQG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC"}

package/dist/src/policy/package-manager-resolver.d.ts

@@ -0,0 +1,79 @@
+import type { GatesCommands } from './gates-schemas.js';
+declare const SUPPORTED_PACKAGE_MANAGERS: readonly ["pnpm", "npm", "yarn", "bun"];
+declare const SUPPORTED_TEST_RUNNERS: readonly ["vitest", "jest", "mocha"];
+/**
+ * WU-1356: Supported package managers type
+ */
+type PackageManager = (typeof SUPPORTED_PACKAGE_MANAGERS)[number];
+/**
+ * WU-1356: Supported test runners type
+ */
+type TestRunner = (typeof SUPPORTED_TEST_RUNNERS)[number];
+export type ScopedUnitTestExecutionPlan = {
+    mode: 'direct';
+    runner: TestRunner;
+    args: string[];
+} | {
+    mode: 'default-flow';
+    preset: string;
+};
+export declare function resolveGatePreset(projectRoot: string): string | undefined;
+export declare function resolveScopedUnitTestExecutionPlan(options: {
+    projectRoot: string;
+    scopedUnitTests: string[];
+}): ScopedUnitTestExecutionPlan | null;
+export declare function formatScopedUnitTestFallbackMessage(plan: Extract<ScopedUnitTestExecutionPlan, {
+    mode: 'default-flow';
+}>): string;
+/**
+ * WU-1356: Resolve package manager from configuration
+ *
+ * Reads the package_manager field from workspace.yaml software_delivery.
+ * 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 workspace.yaml software_delivery.
+ * 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 workspace.yaml software_delivery.
+ * 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 workspace.yaml software_delivery.
+ * 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=package-manager-resolver.d.ts.map

package/dist/src/policy/package-manager-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager-resolver.d.ts","sourceRoot":"","sources":["../../../src/policy/package-manager-resolver.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAcxD,QAAA,MAAM,0BAA0B,yCAA0C,CAAC;AAC3E,QAAA,MAAM,sBAAsB,sCAAuC,CAAC;AAIpE;;GAEG;AACH,KAAK,cAAc,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE;;GAEG;AACH,KAAK,UAAU,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,MAAM,MAAM,2BAA2B,GACnC;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAoFN,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWzE;AAED,wBAAgB,kCAAkC,CAAC,OAAO,EAAE;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,GAAG,2BAA2B,GAAG,IAAI,CAoBrC;AAED,wBAAgB,mCAAmC,CACjD,IAAI,EAAE,OAAO,CAAC,2BAA2B,EAAE;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,CAAC,GACnE,MAAM,CAKR;AAMD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAazE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAajE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAe/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CA+BvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,EAAE,CAKlE"}

package/dist/src/policy/package-manager-resolver.js

@@ -0,0 +1,245 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Package Manager and Test Runner Resolution
+ *
+ * WU-2037: Extracted from gates-config.ts
+ *
+ * Resolves package manager, test runner, build commands, gates commands,
+ * and ignore patterns from workspace.yaml software_delivery configuration.
+ *
+ * @module package-manager-resolver
+ */
+import { asRecord, isString } from '../constants/object-guards.js';
+import { GATES_RUNTIME_DEFAULTS, SOFTWARE_DELIVERY_FIELDS, GATES_FIELDS, GATES_COMMAND_FIELDS, loadSoftwareDeliveryConfig, getGatesSection, } from './gates-config-internal.js';
+// ---------------------------------------------------------------------------
+// Supported values
+// ---------------------------------------------------------------------------
+const SUPPORTED_PACKAGE_MANAGERS = ['pnpm', 'npm', 'yarn', 'bun'];
+const SUPPORTED_TEST_RUNNERS = ['vitest', 'jest', 'mocha'];
+const GATE_PRESET_FIELD = 'preset';
+const NODE_GATE_PRESET = 'node';
+// ---------------------------------------------------------------------------
+// Default command tables
+// ---------------------------------------------------------------------------
+/**
+ * WU-1356: Default gates commands by package manager
+ *
+ * Provides sensible defaults for different package manager and test runner combinations.
+ */
+const DEFAULT_GATES_COMMANDS = {
+    pnpm: {
+        test_full: 'pnpm turbo run test',
+        test_docs_only: '',
+        test_incremental: 'pnpm vitest run --changed origin/main',
+        lint: 'pnpm lint',
+        typecheck: 'pnpm typecheck',
+        format: 'pnpm format:check',
+        migration_verify: '',
+    },
+    npm: {
+        test_full: 'npm test',
+        test_docs_only: '',
+        test_incremental: 'npm test -- --onlyChanged',
+        lint: 'npm run lint',
+        typecheck: 'npm run typecheck',
+        format: 'npm run format:check',
+        migration_verify: '',
+    },
+    yarn: {
+        test_full: 'yarn test',
+        test_docs_only: '',
+        test_incremental: 'yarn test --onlyChanged',
+        lint: 'yarn lint',
+        typecheck: 'yarn typecheck',
+        format: 'yarn format:check',
+        migration_verify: '',
+    },
+    bun: {
+        test_full: 'bun test',
+        test_docs_only: '',
+        test_incremental: 'bun test --changed',
+        lint: 'bun run lint',
+        typecheck: 'bun run typecheck',
+        format: 'bun run format:check',
+        migration_verify: '',
+    },
+};
+/**
+ * WU-1356: Default build commands by package manager
+ */
+const DEFAULT_BUILD_COMMANDS = {
+    pnpm: 'pnpm --filter @lumenflow/cli build',
+    npm: 'npm run build --workspace @lumenflow/cli',
+    yarn: 'yarn workspace @lumenflow/cli build',
+    bun: 'bun run --filter @lumenflow/cli build',
+};
+/**
+ * WU-1356: Ignore patterns by test runner
+ *
+ * Different test runners use different cache directories that should be ignored.
+ */
+const IGNORE_PATTERNS_BY_RUNNER = {
+    vitest: ['.turbo'],
+    jest: ['coverage', '.jest-cache'],
+    mocha: ['coverage', '.nyc_output'],
+};
+const SCOPED_UNIT_TEST_ARGS_BY_RUNNER = {
+    vitest: (paths) => ['vitest', 'run', ...paths, '--passWithNoTests', '--maxWorkers=1'],
+    jest: (paths) => ['jest', ...paths, '--passWithNoTests'],
+    mocha: (paths) => ['mocha', ...paths],
+};
+function normalizeScopedUnitTestPaths(scopedUnitTests) {
+    return scopedUnitTests
+        .filter((entry) => typeof entry === 'string')
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+}
+export function resolveGatePreset(projectRoot) {
+    const gates = getGatesSection(projectRoot);
+    const execution = asRecord(gates?.[GATES_FIELDS.EXECUTION]);
+    const preset = execution?.[GATE_PRESET_FIELD];
+    if (!isString(preset)) {
+        return undefined;
+    }
+    const normalized = preset.trim();
+    return normalized.length > 0 ? normalized : undefined;
+}
+export function resolveScopedUnitTestExecutionPlan(options) {
+    const normalizedPaths = normalizeScopedUnitTestPaths(options.scopedUnitTests);
+    if (normalizedPaths.length === 0) {
+        return null;
+    }
+    const preset = resolveGatePreset(options.projectRoot);
+    if (preset && preset !== NODE_GATE_PRESET) {
+        return {
+            mode: 'default-flow',
+            preset,
+        };
+    }
+    const runner = resolveTestRunner(options.projectRoot);
+    return {
+        mode: 'direct',
+        runner,
+        args: SCOPED_UNIT_TEST_ARGS_BY_RUNNER[runner](normalizedPaths),
+    };
+}
+export function formatScopedUnitTestFallbackMessage(plan) {
+    return (`gates.execution.preset "${plan.preset}" does not support path-scoped tests.unit execution; ` +
+        'falling back to the configured default test flow.');
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * WU-1356: Resolve package manager from configuration
+ *
+ * Reads the package_manager field from workspace.yaml software_delivery.
+ * Returns 'pnpm' as default if not configured.
+ *
+ * @param projectRoot - Project root directory
+ * @returns Resolved package manager ('pnpm', 'npm', 'yarn', or 'bun')
+ */
+export function resolvePackageManager(projectRoot) {
+    const softwareDelivery = loadSoftwareDeliveryConfig(projectRoot);
+    if (!softwareDelivery) {
+        return GATES_RUNTIME_DEFAULTS.DEFAULT_PACKAGE_MANAGER;
+    }
+    const pm = softwareDelivery[SOFTWARE_DELIVERY_FIELDS.PACKAGE_MANAGER] ??
+        softwareDelivery[SOFTWARE_DELIVERY_FIELDS.PACKAGE_MANAGER_CAMEL];
+    if (isString(pm) && SUPPORTED_PACKAGE_MANAGERS.includes(pm)) {
+        return pm;
+    }
+    return GATES_RUNTIME_DEFAULTS.DEFAULT_PACKAGE_MANAGER;
+}
+/**
+ * WU-1356: Resolve test runner from configuration
+ *
+ * Reads the test_runner field from workspace.yaml software_delivery.
+ * Returns 'vitest' as default if not configured.
+ *
+ * @param projectRoot - Project root directory
+ * @returns Resolved test runner ('vitest', 'jest', or 'mocha')
+ */
+export function resolveTestRunner(projectRoot) {
+    const softwareDelivery = loadSoftwareDeliveryConfig(projectRoot);
+    if (!softwareDelivery) {
+        return GATES_RUNTIME_DEFAULTS.DEFAULT_TEST_RUNNER;
+    }
+    const runner = softwareDelivery[SOFTWARE_DELIVERY_FIELDS.TEST_RUNNER] ??
+        softwareDelivery[SOFTWARE_DELIVERY_FIELDS.TEST_RUNNER_CAMEL];
+    if (isString(runner) && SUPPORTED_TEST_RUNNERS.includes(runner)) {
+        return runner;
+    }
+    return GATES_RUNTIME_DEFAULTS.DEFAULT_TEST_RUNNER;
+}
+/**
+ * WU-1356: Resolve build command from configuration
+ *
+ * Reads the build_command field from workspace.yaml software_delivery.
+ * If not configured, uses default based on package_manager.
+ *
+ * @param projectRoot - Project root directory
+ * @returns Resolved build command
+ */
+export function resolveBuildCommand(projectRoot) {
+    const defaultPm = resolvePackageManager(projectRoot);
+    const softwareDelivery = loadSoftwareDeliveryConfig(projectRoot);
+    if (!softwareDelivery) {
+        return DEFAULT_BUILD_COMMANDS[defaultPm];
+    }
+    const configuredBuildCommand = softwareDelivery[SOFTWARE_DELIVERY_FIELDS.BUILD_COMMAND] ??
+        softwareDelivery[SOFTWARE_DELIVERY_FIELDS.BUILD_COMMAND_CAMEL];
+    if (isString(configuredBuildCommand) && configuredBuildCommand.length > 0) {
+        return configuredBuildCommand;
+    }
+    return DEFAULT_BUILD_COMMANDS[defaultPm];
+}
+/**
+ * WU-1356: Resolve gates commands from configuration
+ *
+ * Reads gates.commands from workspace.yaml software_delivery.
+ * Merges with defaults based on package_manager if not fully specified.
+ *
+ * @param projectRoot - Project root directory
+ * @returns Resolved gates commands configuration
+ */
+export function resolveGatesCommands(projectRoot) {
+    const pm = resolvePackageManager(projectRoot);
+    const defaults = DEFAULT_GATES_COMMANDS[pm];
+    const gates = getGatesSection(projectRoot);
+    if (!gates) {
+        return defaults;
+    }
+    const commands = asRecord(gates[GATES_FIELDS.COMMANDS]);
+    if (!commands) {
+        return defaults;
+    }
+    // Merge user config with defaults (user config wins)
+    return {
+        test_full: commands[GATES_COMMAND_FIELDS.TEST_FULL] ?? defaults.test_full,
+        test_docs_only: commands[GATES_COMMAND_FIELDS.TEST_DOCS_ONLY] ??
+            defaults.test_docs_only,
+        test_incremental: commands[GATES_COMMAND_FIELDS.TEST_INCREMENTAL] ??
+            defaults.test_incremental,
+        lint: commands[GATES_COMMAND_FIELDS.LINT] ?? defaults.lint,
+        typecheck: commands[GATES_COMMAND_FIELDS.TYPECHECK] ?? defaults.typecheck,
+        format: commands[GATES_COMMAND_FIELDS.FORMAT] ?? defaults.format,
+        migration_verify: commands[GATES_COMMAND_FIELDS.MIGRATION_VERIFY] ??
+            defaults.migration_verify,
+    };
+}
+/**
+ * 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 function getIgnorePatterns(testRunner) {
+    return (IGNORE_PATTERNS_BY_RUNNER[testRunner] ??
+        IGNORE_PATTERNS_BY_RUNNER[GATES_RUNTIME_DEFAULTS.DEFAULT_TEST_RUNNER]);
+}
+//# sourceMappingURL=package-manager-resolver.js.map

package/dist/src/policy/package-manager-resolver.js.map

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