@lumenflow/core 2.2.2 → 2.3.1

package/dist/patrol-loop.js

@@ -0,0 +1,186 @@
+/**
+ * Patrol Loop Module (WU-1242)
+ *
+ * Continuous patrol loop for monitoring spawn health.
+ * The 'Witness patrol' pattern - keeps the spawn fleet healthy by
+ * checking status at configurable intervals with exponential backoff
+ * on repeated failures.
+ *
+ * Features:
+ * - Configurable patrol interval (default 5min)
+ * - Exponential backoff on failures (max 1hr)
+ * - Graceful shutdown support
+ * - Cycle callbacks for status reporting
+ * - Error handling with continuation
+ *
+ * @see {@link packages/@lumenflow/cli/src/orchestrate-monitor.ts} - CLI integration
+ * @see {@link packages/@lumenflow/core/src/__tests__/patrol-loop.test.ts} - Tests
+ */
+/**
+ * Default patrol interval (5 minutes in milliseconds)
+ */
+export const DEFAULT_PATROL_INTERVAL_MS = 5 * 60 * 1000;
+/**
+ * Maximum backoff interval (1 hour in milliseconds)
+ */
+export const MAX_BACKOFF_MS = 60 * 60 * 1000;
+/**
+ * Calculates the backoff interval based on consecutive failures.
+ * Uses exponential backoff with a maximum of 1 hour.
+ *
+ * Backoff formula: baseInterval * 2^(failures-1), capped at MAX_BACKOFF_MS
+ *
+ * @param consecutiveFailures - Number of consecutive failures (1-indexed)
+ * @param baseIntervalMs - Base interval in milliseconds
+ * @returns Backoff interval in milliseconds
+ *
+ * @example
+ * calculateBackoff(1, 5*60*1000) // 5 minutes (no backoff yet)
+ * calculateBackoff(2, 5*60*1000) // 10 minutes (2x)
+ * calculateBackoff(3, 5*60*1000) // 20 minutes (4x)
+ */
+export function calculateBackoff(consecutiveFailures, baseIntervalMs) {
+    if (consecutiveFailures <= 1) {
+        return baseIntervalMs;
+    }
+    // Exponential backoff: baseInterval * 2^(failures-1)
+    const multiplier = Math.pow(2, consecutiveFailures - 1);
+    const backoffMs = baseIntervalMs * multiplier;
+    // Cap at maximum backoff
+    return Math.min(backoffMs, MAX_BACKOFF_MS);
+}
+/**
+ * Patrol loop for continuous spawn monitoring.
+ *
+ * @example
+ * const patrol = new PatrolLoop({
+ *   checkFn: async () => {
+ *     const result = await runMonitor();
+ *     return {
+ *       healthy: result.stuckSpawns.length === 0,
+ *       stuckCount: result.stuckSpawns.length,
+ *       zombieCount: result.zombieLocks.length,
+ *     };
+ *   },
+ *   intervalMs: 5 * 60 * 1000, // 5 minutes
+ *   onCycle: (result, meta) => {
+ *     console.log(`Cycle ${meta.cycleNumber}: ${result.healthy ? 'healthy' : 'issues detected'}`);
+ *   },
+ * });
+ *
+ * patrol.start();
+ * // Later...
+ * patrol.stop();
+ */
+export class PatrolLoop {
+    checkFn;
+    baseIntervalMs;
+    onCycle;
+    onError;
+    timer = null;
+    running = false;
+    failures = 0;
+    cycles = 0;
+    /**
+     * Creates a new PatrolLoop instance.
+     *
+     * @param options - Patrol loop configuration
+     */
+    constructor(options) {
+        this.checkFn = options.checkFn;
+        this.baseIntervalMs = options.intervalMs ?? DEFAULT_PATROL_INTERVAL_MS;
+        this.onCycle = options.onCycle;
+        this.onError = options.onError;
+    }
+    /**
+     * The configured base interval in milliseconds.
+     */
+    get intervalMs() {
+        return this.baseIntervalMs;
+    }
+    /**
+     * Whether the patrol loop is currently running.
+     */
+    get isRunning() {
+        return this.running;
+    }
+    /**
+     * Number of consecutive failures (resets on success).
+     */
+    get consecutiveFailures() {
+        return this.failures;
+    }
+    /**
+     * Total number of completed patrol cycles.
+     */
+    get totalCycles() {
+        return this.cycles;
+    }
+    /**
+     * Starts the patrol loop.
+     * Does nothing if already running.
+     */
+    start() {
+        if (this.running) {
+            return; // Already running, don't create duplicate timers
+        }
+        this.running = true;
+        this.scheduleNextCycle();
+    }
+    /**
+     * Stops the patrol loop.
+     * Safe to call even if not running.
+     */
+    stop() {
+        this.running = false;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+    /**
+     * Schedules the next patrol cycle.
+     */
+    scheduleNextCycle() {
+        if (!this.running) {
+            return;
+        }
+        const intervalMs = calculateBackoff(this.failures, this.baseIntervalMs);
+        this.timer = setTimeout(() => {
+            void this.runCycle().then(() => this.scheduleNextCycle());
+        }, intervalMs);
+    }
+    /**
+     * Runs a single patrol cycle.
+     */
+    async runCycle() {
+        if (!this.running) {
+            return;
+        }
+        this.cycles++;
+        const cycleNumber = this.cycles;
+        try {
+            const result = await this.checkFn();
+            // Success - reset failure count
+            this.failures = 0;
+            // Call cycle callback
+            if (this.onCycle) {
+                const meta = {
+                    cycleNumber,
+                    intervalMs: this.baseIntervalMs,
+                    consecutiveFailures: this.failures,
+                    timestamp: new Date(),
+                };
+                this.onCycle(result, meta);
+            }
+        }
+        catch (error) {
+            // Failure - increment failure count
+            this.failures++;
+            // Call error callback
+            if (this.onError) {
+                this.onError(error instanceof Error ? error : new Error(String(error)), cycleNumber);
+            }
+        }
+    }
+}

package/dist/process-detector.d.ts

@@ -7,12 +7,12 @@
  *
  * This is a NON-BLOCKING pre-flight check - it warns but doesn't fail wu:done.
  *
- * @see {@link tools/wu-done.mjs} - Integrates this as pre-flight check
- * @see {@link tools/lib/wu-constants.mjs} - Constants for log prefixes
+ * @see {@link packages/@lumenflow/cli/src/wu-done.ts} - Integrates this as pre-flight check
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-constants.ts} - Constants for log prefixes
  */
 /**
  * Re-export interfering process names for external consumers.
- * Source of truth is PROCESS_DETECTION.INTERFERING_NAMES in wu-constants.mjs
+ * Source of truth is PROCESS_DETECTION.INTERFERING_NAMES in wu-constants.ts
  */
 export declare const INTERFERING_PROCESS_NAMES: string[];
 /**
@@ -71,14 +71,14 @@ export declare function detectBackgroundProcesses(worktreePath: any): Promise<{
 /**
  * Run background process detection as a pre-flight check.
  *
- * This is the main entry point for wu-done.mjs integration.
+ * This is the main entry point for wu-done.ts integration.
  * Logs warnings if background processes are detected but does NOT fail.
  *
  * @param {string} worktreePath - Path to the worktree directory
  * @returns {Promise<void>}
  *
  * @example
- * // In wu-done.mjs pre-flight checks:
+ * // In wu-done.ts pre-flight checks:
  * await runBackgroundProcessCheck(worktreePath);
  */
 export declare function runBackgroundProcessCheck(worktreePath: any): Promise<void>;

package/dist/process-detector.js

@@ -7,14 +7,14 @@
  *
  * This is a NON-BLOCKING pre-flight check - it warns but doesn't fail wu:done.
  *
- * @see {@link tools/wu-done.mjs} - Integrates this as pre-flight check
- * @see {@link tools/lib/wu-constants.mjs} - Constants for log prefixes
+ * @see {@link packages/@lumenflow/cli/src/wu-done.ts} - Integrates this as pre-flight check
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-constants.ts} - Constants for log prefixes
  */
 import psList from 'ps-list';
 import { LOG_PREFIX, EMOJI, PROCESS_DETECTION, STRING_LITERALS } from './wu-constants.js';
 /**
  * Re-export interfering process names for external consumers.
- * Source of truth is PROCESS_DETECTION.INTERFERING_NAMES in wu-constants.mjs
+ * Source of truth is PROCESS_DETECTION.INTERFERING_NAMES in wu-constants.ts
  */
 export const INTERFERING_PROCESS_NAMES = PROCESS_DETECTION.INTERFERING_NAMES;
 /**
@@ -148,14 +148,14 @@ export async function detectBackgroundProcesses(worktreePath) {
 /**
  * Run background process detection as a pre-flight check.
  *
- * This is the main entry point for wu-done.mjs integration.
+ * This is the main entry point for wu-done.ts integration.
  * Logs warnings if background processes are detected but does NOT fail.
  *
  * @param {string} worktreePath - Path to the worktree directory
  * @returns {Promise<void>}
  *
  * @example
- * // In wu-done.mjs pre-flight checks:
+ * // In wu-done.ts pre-flight checks:
  * await runBackgroundProcessCheck(worktreePath);
  */
 export async function runBackgroundProcessCheck(worktreePath) {

package/dist/rebase-artifact-cleanup.d.ts

@@ -10,9 +10,9 @@
  * Part of WU-1371: Post-rebase artifact cleanup
  * WU-1449: Extended to handle backlog/status duplicates after rebase
  *
- * @see {@link tools/wu-done.mjs} - Creates completion artifacts
- * @see {@link tools/lib/stamp-utils.mjs} - Stamp file utilities
- * @see {@link tools/lib/wu-recovery.mjs} - Related zombie state handling
+ * @see {@link packages/@lumenflow/cli/src/wu-done.ts} - Creates completion artifacts
+ * @see {@link packages/@lumenflow/cli/src/lib/stamp-utils.ts} - Stamp file utilities
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-recovery.ts} - Related zombie state handling
  */
 /**
  * Detect rebased completion artifacts in a worktree

package/dist/rebase-artifact-cleanup.js

@@ -10,9 +10,9 @@
  * Part of WU-1371: Post-rebase artifact cleanup
  * WU-1449: Extended to handle backlog/status duplicates after rebase
  *
- * @see {@link tools/wu-done.mjs} - Creates completion artifacts
- * @see {@link tools/lib/stamp-utils.mjs} - Stamp file utilities
- * @see {@link tools/lib/wu-recovery.mjs} - Related zombie state handling
+ * @see {@link packages/@lumenflow/cli/src/wu-done.ts} - Creates completion artifacts
+ * @see {@link packages/@lumenflow/cli/src/lib/stamp-utils.ts} - Stamp file utilities
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-recovery.ts} - Related zombie state handling
  */
 import { readFile, writeFile, unlink, access } from 'node:fs/promises';
 import { existsSync, rmSync } from 'node:fs';

package/dist/resolve-policy.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Resolve Policy - Single Source of Truth for Methodology Decisions
+ *
+ * WU-1259: Provides a unified policy resolver that both wu:spawn and gates use.
+ *
+ * This module:
+ * - Defines the methodology.* config schema
+ * - Implements resolvePolicy() to produce ResolvedPolicy
+ * - Applies precedence: template defaults -> methodology.overrides -> explicit gates.* -> CLI flags
+ *
+ * @module resolve-policy
+ */
+import { z } from 'zod';
+import type { LumenFlowConfig } from './lumenflow-config-schema.js';
+/**
+ * Testing methodology options
+ */
+export declare const TESTING_METHODOLOGY: {
+    readonly TDD: "tdd";
+    readonly TEST_AFTER: "test-after";
+    readonly NONE: "none";
+};
+export type TestingMethodology = (typeof TESTING_METHODOLOGY)[keyof typeof TESTING_METHODOLOGY];
+/**
+ * Architecture methodology options
+ */
+export declare const ARCHITECTURE_METHODOLOGY: {
+    readonly HEXAGONAL: "hexagonal";
+    readonly LAYERED: "layered";
+    readonly NONE: "none";
+};
+export type ArchitectureMethodology = (typeof ARCHITECTURE_METHODOLOGY)[keyof typeof ARCHITECTURE_METHODOLOGY];
+/**
+ * Coverage mode options
+ */
+export declare const COVERAGE_MODE: {
+    readonly BLOCK: "block";
+    readonly WARN: "warn";
+    readonly OFF: "off";
+};
+export type CoverageMode = (typeof COVERAGE_MODE)[keyof typeof COVERAGE_MODE];
+/**
+ * Zod schema for testing methodology enum
+ */
+export declare const TestingMethodologySchema: z.ZodEnum<{
+    tdd: "tdd";
+    "test-after": "test-after";
+    none: "none";
+}>;
+/**
+ * Zod schema for architecture methodology enum
+ */
+export declare const ArchitectureMethodologySchema: z.ZodEnum<{
+    none: "none";
+    hexagonal: "hexagonal";
+    layered: "layered";
+}>;
+/**
+ * Zod schema for coverage mode enum
+ */
+export declare const CoverageModeSchema: z.ZodEnum<{
+    off: "off";
+    warn: "warn";
+    block: "block";
+}>;
+/**
+ * Methodology overrides schema
+ *
+ * These allow tweaking template defaults without changing methodology.
+ */
+export declare const MethodologyOverridesSchema: z.ZodObject<{
+    coverage_threshold: z.ZodOptional<z.ZodNumber>;
+    coverage_mode: z.ZodOptional<z.ZodEnum<{
+        off: "off";
+        warn: "warn";
+        block: "block";
+    }>>;
+}, z.core.$strip>;
+export type MethodologyOverrides = z.infer<typeof MethodologyOverridesSchema>;
+/**
+ * Main methodology configuration schema
+ *
+ * Config example in .lumenflow.config.yaml:
+ * ```yaml
+ * methodology:
+ *   testing: 'tdd'              # tdd | test-after | none
+ *   architecture: 'hexagonal'   # hexagonal | layered | none
+ *   overrides:
+ *     coverage_threshold: 85    # Override TDD's default 90%
+ *     coverage_mode: 'warn'     # Override TDD's default 'block'
+ * ```
+ */
+export declare const MethodologyConfigSchema: z.ZodObject<{
+    testing: z.ZodDefault<z.ZodEnum<{
+        tdd: "tdd";
+        "test-after": "test-after";
+        none: "none";
+    }>>;
+    architecture: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        hexagonal: "hexagonal";
+        layered: "layered";
+    }>>;
+    overrides: z.ZodOptional<z.ZodObject<{
+        coverage_threshold: z.ZodOptional<z.ZodNumber>;
+        coverage_mode: z.ZodOptional<z.ZodEnum<{
+            off: "off";
+            warn: "warn";
+            block: "block";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type MethodologyConfig = z.infer<typeof MethodologyConfigSchema>;
+/**
+ * The resolved policy used by wu:spawn and gates
+ *
+ * This is the single source of truth for methodology decisions.
+ * All consumers (spawn prompts, gate runners, etc.) should use this type.
+ */
+export interface ResolvedPolicy {
+    /** Active testing methodology */
+    testing: TestingMethodology;
+    /** Active architecture methodology */
+    architecture: ArchitectureMethodology;
+    /** Resolved coverage threshold (0-100) */
+    coverage_threshold: number;
+    /** Resolved coverage mode */
+    coverage_mode: CoverageMode;
+    /** Whether tests are required for completion */
+    tests_required: boolean;
+}
+/**
+ * Options for resolvePolicy
+ */
+export interface ResolvePolicyOptions {
+    /**
+     * Raw config object before Zod defaults were applied.
+     * Used to detect explicit vs default values for gates.* fields.
+     *
+     * When provided, only EXPLICIT gates.* settings override methodology.
+     * When not provided, any gates.* value (including defaults) overrides methodology.
+     */
+    rawConfig?: {
+        gates?: {
+            minCoverage?: number;
+            enableCoverage?: boolean;
+        };
+    };
+}
+/**
+ * Resolve the effective policy from configuration
+ *
+ * Precedence (highest to lowest):
+ * 1. CLI flags (not handled here - handled by command layer)
+ * 2. Explicit gates.* configuration (only if rawConfig provided to detect explicit vs default)
+ * 3. methodology.overrides
+ * 4. methodology template defaults
+ *
+ * This ensures backwards compatibility: existing users with explicit
+ * gates.* config see no change, while new users can use methodology
+ * config for a higher-level abstraction.
+ *
+ * @param config - The full LumenFlow configuration
+ * @param options - Options including rawConfig for explicit detection
+ * @returns The resolved policy for use by wu:spawn and gates
+ *
+ * @example
+ * ```typescript
+ * import { getConfig } from './lumenflow-config.js';
+ * import { resolvePolicy } from './resolve-policy.js';
+ *
+ * const config = getConfig();
+ * const policy = resolvePolicy(config);
+ *
+ * console.log(policy.coverage_threshold); // 90 (or configured value)
+ * console.log(policy.testing); // 'tdd' (or configured value)
+ * ```
+ *
+ * @example With raw config for explicit detection
+ * ```typescript
+ * const rawConfig = { methodology: { testing: 'test-after' } };
+ * const config = parseConfig(rawConfig);
+ * const policy = resolvePolicy(config, { rawConfig });
+ * // policy.coverage_threshold will be 70 (test-after template default)
+ * // because gates.minCoverage wasn't EXPLICITLY set
+ * ```
+ */
+export declare function resolvePolicy(config: LumenFlowConfig, options?: ResolvePolicyOptions): ResolvedPolicy;
+/**
+ * Create a default resolved policy
+ *
+ * Convenience function for when no config is available.
+ * Returns strict TDD defaults.
+ */
+export declare function getDefaultPolicy(): ResolvedPolicy;

package/dist/resolve-policy.js

@@ -0,0 +1,203 @@
+/**
+ * Resolve Policy - Single Source of Truth for Methodology Decisions
+ *
+ * WU-1259: Provides a unified policy resolver that both wu:spawn and gates use.
+ *
+ * This module:
+ * - Defines the methodology.* config schema
+ * - Implements resolvePolicy() to produce ResolvedPolicy
+ * - Applies precedence: template defaults -> methodology.overrides -> explicit gates.* -> CLI flags
+ *
+ * @module resolve-policy
+ */
+import { z } from 'zod';
+/**
+ * Testing methodology options
+ */
+export const TESTING_METHODOLOGY = {
+    TDD: 'tdd',
+    TEST_AFTER: 'test-after',
+    NONE: 'none',
+};
+/**
+ * Architecture methodology options
+ */
+export const ARCHITECTURE_METHODOLOGY = {
+    HEXAGONAL: 'hexagonal',
+    LAYERED: 'layered',
+    NONE: 'none',
+};
+/**
+ * Coverage mode options
+ */
+export const COVERAGE_MODE = {
+    BLOCK: 'block',
+    WARN: 'warn',
+    OFF: 'off',
+};
+/**
+ * Zod schema for testing methodology enum
+ */
+export const TestingMethodologySchema = z.enum(['tdd', 'test-after', 'none']);
+/**
+ * Zod schema for architecture methodology enum
+ */
+export const ArchitectureMethodologySchema = z.enum(['hexagonal', 'layered', 'none']);
+/**
+ * Zod schema for coverage mode enum
+ */
+export const CoverageModeSchema = z.enum(['block', 'warn', 'off']);
+/**
+ * Methodology overrides schema
+ *
+ * These allow tweaking template defaults without changing methodology.
+ */
+export const MethodologyOverridesSchema = z.object({
+    /** Override the default coverage threshold from the testing methodology */
+    coverage_threshold: z.number().min(0).max(100).optional(),
+    /** Override the default coverage mode from the testing methodology */
+    coverage_mode: CoverageModeSchema.optional(),
+});
+/**
+ * Main methodology configuration schema
+ *
+ * Config example in .lumenflow.config.yaml:
+ * ```yaml
+ * methodology:
+ *   testing: 'tdd'              # tdd | test-after | none
+ *   architecture: 'hexagonal'   # hexagonal | layered | none
+ *   overrides:
+ *     coverage_threshold: 85    # Override TDD's default 90%
+ *     coverage_mode: 'warn'     # Override TDD's default 'block'
+ * ```
+ */
+export const MethodologyConfigSchema = z.object({
+    /** Testing methodology (default: 'tdd') */
+    testing: TestingMethodologySchema.default('tdd'),
+    /** Architecture methodology (default: 'hexagonal') */
+    architecture: ArchitectureMethodologySchema.default('hexagonal'),
+    /** Optional overrides for template defaults */
+    overrides: MethodologyOverridesSchema.optional(),
+});
+const TESTING_TEMPLATE_DEFAULTS = {
+    tdd: {
+        coverage_threshold: 90,
+        coverage_mode: 'block',
+        tests_required: true,
+    },
+    'test-after': {
+        coverage_threshold: 70,
+        coverage_mode: 'warn',
+        tests_required: true,
+    },
+    none: {
+        coverage_threshold: 0,
+        coverage_mode: 'off',
+        tests_required: false,
+    },
+};
+/**
+ * Resolve the effective policy from configuration
+ *
+ * Precedence (highest to lowest):
+ * 1. CLI flags (not handled here - handled by command layer)
+ * 2. Explicit gates.* configuration (only if rawConfig provided to detect explicit vs default)
+ * 3. methodology.overrides
+ * 4. methodology template defaults
+ *
+ * This ensures backwards compatibility: existing users with explicit
+ * gates.* config see no change, while new users can use methodology
+ * config for a higher-level abstraction.
+ *
+ * @param config - The full LumenFlow configuration
+ * @param options - Options including rawConfig for explicit detection
+ * @returns The resolved policy for use by wu:spawn and gates
+ *
+ * @example
+ * ```typescript
+ * import { getConfig } from './lumenflow-config.js';
+ * import { resolvePolicy } from './resolve-policy.js';
+ *
+ * const config = getConfig();
+ * const policy = resolvePolicy(config);
+ *
+ * console.log(policy.coverage_threshold); // 90 (or configured value)
+ * console.log(policy.testing); // 'tdd' (or configured value)
+ * ```
+ *
+ * @example With raw config for explicit detection
+ * ```typescript
+ * const rawConfig = { methodology: { testing: 'test-after' } };
+ * const config = parseConfig(rawConfig);
+ * const policy = resolvePolicy(config, { rawConfig });
+ * // policy.coverage_threshold will be 70 (test-after template default)
+ * // because gates.minCoverage wasn't EXPLICITLY set
+ * ```
+ */
+export function resolvePolicy(config, options = {}) {
+    const { rawConfig } = options;
+    // Parse methodology config (provides defaults if not specified)
+    const methodology = MethodologyConfigSchema.parse(config.methodology ?? {});
+    // Get template defaults based on testing methodology
+    const templateDefaults = TESTING_TEMPLATE_DEFAULTS[methodology.testing];
+    // Layer 1: Start with template defaults
+    let coverage_threshold = templateDefaults.coverage_threshold;
+    let coverage_mode = templateDefaults.coverage_mode;
+    const tests_required = templateDefaults.tests_required;
+    // Layer 2: Apply methodology.overrides (if specified)
+    if (methodology.overrides?.coverage_threshold !== undefined) {
+        coverage_threshold = methodology.overrides.coverage_threshold;
+    }
+    if (methodology.overrides?.coverage_mode !== undefined) {
+        coverage_mode = methodology.overrides.coverage_mode;
+    }
+    // Layer 3: Apply explicit gates.* configuration (highest precedence)
+    // This ensures backwards compatibility with existing gates config
+    //
+    // Key insight: We only want EXPLICIT gates.* to override methodology.
+    // If rawConfig is provided, we check if gates values were explicitly set.
+    // If rawConfig is NOT provided (legacy mode), we check if methodology
+    // was specified - if so, methodology controls unless gates differ from default.
+    const gates = config.gates;
+    // Determine if gates.minCoverage was explicitly set
+    const gatesMinCoverageExplicit = rawConfig !== undefined ? rawConfig.gates?.minCoverage !== undefined : false;
+    // Determine if gates.enableCoverage was explicitly set
+    const gatesEnableCoverageExplicit = rawConfig !== undefined ? rawConfig.gates?.enableCoverage !== undefined : false;
+    // Apply gates.minCoverage only if explicitly set, or if no methodology was specified
+    // (for backwards compatibility with pre-methodology configs)
+    const methodologySpecified = config.methodology !== undefined;
+    if (gatesMinCoverageExplicit || (!methodologySpecified && !rawConfig)) {
+        // gates.minCoverage overrides methodology coverage_threshold
+        if (gates?.minCoverage !== undefined) {
+            coverage_threshold = gates.minCoverage;
+        }
+    }
+    // gates.enableCoverage: false effectively sets coverage_mode to 'off'
+    if (gatesEnableCoverageExplicit || (!methodologySpecified && !rawConfig)) {
+        if (gates?.enableCoverage === false) {
+            coverage_mode = 'off';
+        }
+    }
+    return {
+        testing: methodology.testing,
+        architecture: methodology.architecture,
+        coverage_threshold,
+        coverage_mode,
+        tests_required,
+    };
+}
+/**
+ * Create a default resolved policy
+ *
+ * Convenience function for when no config is available.
+ * Returns strict TDD defaults.
+ */
+export function getDefaultPolicy() {
+    return {
+        testing: 'tdd',
+        architecture: 'hexagonal',
+        coverage_threshold: 90,
+        coverage_mode: 'block',
+        tests_required: true,
+    };
+}

package/dist/risk-detector.d.ts

@@ -15,8 +15,8 @@
  * healthcare domain (PHI, RLS, auth). No standard library exists for this
  * domain-specific classification.
  *
- * @see {@link tools/gates.mjs} - Consumer of risk detection
- * @see {@link tools/lib/file-classifiers.mjs} - File classification utilities
+ * @see {@link packages/@lumenflow/cli/src/gates.ts} - Consumer of risk detection
+ * @see {@link packages/@lumenflow/cli/src/lib/file-classifiers.ts} - File classification utilities
  */
 /**
  * Risk tier constants