@lumenflow/core 3.1.1 → 3.1.3

package/dist/recovery/recovery-analyzer.js

@@ -1,149 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * Recovery Analyzer for WU State Issues
- *
- * WU-1090: Context-aware state machine for WU lifecycle commands
- *
- * Analyzes WU context to detect state inconsistencies and suggests
- * appropriate recovery actions.
- *
- * Issue types detected:
- * - Partial claim: worktree exists but status is ready
- * - Orphan claim: status is in_progress but worktree missing
- * - Inconsistent state: YAML and state store disagree
- * - Orphan branch: branch exists but worktree missing
- * - Stale lock: lock file from old session
- * - Leftover worktree: WU is done but worktree exists
- * - Merged not done: branch merged to main but WU not stamped (WU-1746)
- *
- * @module
- */
-import { existsSync } from 'node:fs';
-import { join } from 'node:path';
-import { CONTEXT_VALIDATION, WU_STATUS, DEFAULTS, toKebab, } from '../wu-constants.js';
-const { RECOVERY_ISSUES, RECOVERY_ACTIONS } = CONTEXT_VALIDATION;
-/**
- * Get expected worktree path for a WU.
- */
-function getExpectedWorktreePath(mainCheckout, lane, wuId) {
-    const laneKebab = toKebab(lane);
-    const wuIdLower = wuId.toLowerCase();
-    return join(mainCheckout, DEFAULTS.WORKTREES_DIR, `${laneKebab}-${wuIdLower}`);
-}
-/**
- * Check if worktree exists for a WU.
- */
-function worktreeExists(mainCheckout, lane, wuId) {
-    const worktreePath = getExpectedWorktreePath(mainCheckout, lane, wuId);
-    return existsSync(worktreePath);
-}
-/**
- * Analyze context for recovery issues.
- *
- * @param context - Current WU context
- * @returns Recovery analysis with issues and suggested actions
- */
-export async function analyzeRecovery(context) {
-    const issues = [];
-    const actions = [];
-    // No WU context means nothing to analyze
-    if (!context.wu) {
-        return {
-            hasIssues: false,
-            issues: [],
-            actions: [],
-            wuId: null,
-        };
-    }
-    const { wu } = context;
-    const mainCheckout = context.location.mainCheckout;
-    const hasWorktree = worktreeExists(mainCheckout, wu.lane, wu.id);
-    const worktreePath = getExpectedWorktreePath(mainCheckout, wu.lane, wu.id);
-    // Check for partial claim: worktree exists but status is ready
-    if (hasWorktree && wu.status === WU_STATUS.READY) {
-        issues.push({
-            code: RECOVERY_ISSUES.PARTIAL_CLAIM,
-            description: `Worktree exists for ${wu.id} but status is 'ready'. The claim may have been interrupted.`,
-            context: { worktreePath, status: wu.status },
-        });
-        actions.push({
-            type: RECOVERY_ACTIONS.RESUME,
-            description: 'Reconcile state and continue working (preserves work)',
-            command: `pnpm wu:recover --id ${wu.id} --action resume`,
-            requiresForce: false,
-        });
-        actions.push({
-            type: RECOVERY_ACTIONS.RESET,
-            description: 'Discard worktree and reset WU to ready',
-            command: `pnpm wu:recover --id ${wu.id} --action reset`,
-            requiresForce: false,
-            warning: 'This will discard UnsafeAny uncommitted work in the worktree',
-        });
-    }
-    // Check for orphan claim: status is in_progress but worktree missing
-    if (!hasWorktree && wu.status === WU_STATUS.IN_PROGRESS) {
-        issues.push({
-            code: RECOVERY_ISSUES.ORPHAN_CLAIM,
-            description: `${wu.id} is 'in_progress' but worktree is missing. The worktree may have been manually deleted.`,
-            context: { expectedPath: worktreePath, status: wu.status },
-        });
-        actions.push({
-            type: RECOVERY_ACTIONS.RESET,
-            description: 'Reset WU status back to ready for re-claiming',
-            command: `pnpm wu:recover --id ${wu.id} --action reset`,
-            requiresForce: false,
-        });
-    }
-    // Check for leftover worktree: WU is done but worktree exists
-    if (hasWorktree && wu.status === WU_STATUS.DONE) {
-        issues.push({
-            code: RECOVERY_ISSUES.LEFTOVER_WORKTREE,
-            description: `${wu.id} is 'done' but worktree still exists. The cleanup may have failed.`,
-            context: { worktreePath, status: wu.status },
-        });
-        actions.push({
-            type: RECOVERY_ACTIONS.CLEANUP,
-            description: 'Remove leftover worktree for completed WU',
-            command: `pnpm wu:recover --id ${wu.id} --action cleanup`,
-            requiresForce: false,
-        });
-    }
-    // Check for inconsistent state
-    if (!wu.isConsistent && wu.inconsistencyReason) {
-        issues.push({
-            code: RECOVERY_ISSUES.INCONSISTENT_STATE,
-            description: wu.inconsistencyReason,
-            context: { wuId: wu.id },
-        });
-        actions.push({
-            type: RECOVERY_ACTIONS.RESET,
-            description: 'Reconcile YAML and state store',
-            command: `pnpm wu:recover --id ${wu.id} --action reset`,
-            requiresForce: false,
-        });
-    }
-    // WU-1746: Check for merged-not-done: branch is merged to main but WU is not stamped
-    // This happens when a worktree is manually merged and deleted without running wu:done
-    if (wu.branchMergedToMain && !hasWorktree && wu.status !== WU_STATUS.DONE) {
-        issues.push({
-            code: RECOVERY_ISSUES.MERGED_NOT_DONE,
-            description: `${wu.id} branch commits are merged to main but WU is not marked as done (status: '${wu.status}'). ` +
-                `The worktree was likely manually merged and deleted without running wu:done.`,
-            context: { expectedPath: worktreePath, status: wu.status, branchMergedToMain: true },
-        });
-        actions.push({
-            type: RECOVERY_ACTIONS.COMPLETE,
-            description: 'Complete WU stamping and state cleanup (branch already merged)',
-            command: `pnpm wu:done --id ${wu.id}`,
-            requiresForce: false,
-        });
-    }
-    return {
-        hasIssues: issues.length > 0,
-        issues,
-        actions,
-        wuId: wu.id,
-    };
-}
-//# sourceMappingURL=recovery-analyzer.js.map

package/dist/recovery/recovery-analyzer.js.map

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

package/dist/resolve-policy.d.ts

@@ -1,257 +0,0 @@
-/**
- * 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>;
-/**
- * WU-1899: Work classification UI pattern configuration
- *
- * Allows extending default UI detection patterns with project-specific
- * code path patterns and lane hints. Custom values EXTEND defaults,
- * they do not replace them.
- *
- * @example
- * ```yaml
- * methodology:
- *   work_classification:
- *     ui:
- *       code_path_patterns:
- *         - 'src/widgets/*.tsx'
- *       lane_hints:
- *         - 'Design'
- * ```
- */
-export declare const WorkClassificationUiSchema: z.ZodObject<{
-    code_path_patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    lane_hints: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>;
-/** WU-1899: TypeScript type for work classification UI config */
-export type WorkClassificationUi = z.infer<typeof WorkClassificationUiSchema>;
-/**
- * WU-1899: Work classification configuration schema
- *
- * Controls signal-based work domain detection for code-path-aware
- * UI/backend/docs/infra classification.
- *
- * @example
- * ```yaml
- * methodology:
- *   work_classification:
- *     ui:
- *       code_path_patterns:
- *         - 'src/widgets/*.tsx'
- *       lane_hints:
- *         - 'Design'
- * ```
- */
-export declare const WorkClassificationConfigSchema: z.ZodObject<{
-    ui: z.ZodOptional<z.ZodObject<{
-        code_path_patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        lane_hints: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-/** WU-1899: TypeScript type for work classification config */
-export type WorkClassificationSchemaConfig = z.infer<typeof WorkClassificationConfigSchema>;
-/**
- * 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'
- *   work_classification:
- *     ui:
- *       code_path_patterns:
- *         - 'src/widgets/*.tsx'
- *       lane_hints:
- *         - 'Design'
- * ```
- */
-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>>;
-    work_classification: z.ZodOptional<z.ZodObject<{
-        ui: z.ZodOptional<z.ZodObject<{
-            code_path_patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            lane_hints: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>>;
-    }, 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, UnsafeAny 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;
-//# sourceMappingURL=resolve-policy.d.ts.map

package/dist/resolve-policy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolve-policy.d.ts","sourceRoot":"","sources":["../src/resolve-policy.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAEhG;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;CAI3B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;EAAwC,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;EAA2C,CAAC;AAEtF;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;EAAmC,CAAC;AAEnE;;;;GAIG;AACH,eAAO,MAAM,0BAA0B;;;;;;;iBAKrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,0BAA0B;;;iBAcrC,CAAC;AAEH,iEAAiE;AACjE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,8BAA8B;;;;;iBAGzC,CAAC;AAEH,8DAA8D;AAC9D,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAE5F;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;iBAalC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAqCxE;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,sCAAsC;IACtC,YAAY,EAAE,uBAAuB,CAAC;IACtC,0CAA0C;IAC1C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6BAA6B;IAC7B,aAAa,EAAE,YAAY,CAAC;IAC5B,gDAAgD;IAChD,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE;QACV,KAAK,CAAC,EAAE;YACN,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,cAAc,CAAC,EAAE,OAAO,CAAC;SAC1B,CAAC;KACH,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,oBAAyB,GACjC,cAAc,CA+DhB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,cAAc,CAQjD"}

package/dist/resolve-policy.js

@@ -1,269 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * 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(),
-});
-/**
- * WU-1899: Work classification UI pattern configuration
- *
- * Allows extending default UI detection patterns with project-specific
- * code path patterns and lane hints. Custom values EXTEND defaults,
- * they do not replace them.
- *
- * @example
- * ```yaml
- * methodology:
- *   work_classification:
- *     ui:
- *       code_path_patterns:
- *         - 'src/widgets/*.tsx'
- *       lane_hints:
- *         - 'Design'
- * ```
- */
-export const WorkClassificationUiSchema = z.object({
-    /**
-     * Additional glob patterns for detecting UI work via code paths.
-     * These extend the built-in defaults (CSS, SCSS, LESS, components, pages, etc.).
-     * Uses minimatch glob syntax.
-     */
-    code_path_patterns: z.array(z.string()).optional(),
-    /**
-     * Additional lane parent hints for detecting UI work.
-     * These extend the built-in defaults (Experience, Frontend, UI, Design).
-     * Matched case-insensitively against the lane parent (part before the colon).
-     */
-    lane_hints: z.array(z.string()).optional(),
-});
-/**
- * WU-1899: Work classification configuration schema
- *
- * Controls signal-based work domain detection for code-path-aware
- * UI/backend/docs/infra classification.
- *
- * @example
- * ```yaml
- * methodology:
- *   work_classification:
- *     ui:
- *       code_path_patterns:
- *         - 'src/widgets/*.tsx'
- *       lane_hints:
- *         - 'Design'
- * ```
- */
-export const WorkClassificationConfigSchema = z.object({
-    /** UI detection pattern overrides (extend defaults) */
-    ui: WorkClassificationUiSchema.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'
- *   work_classification:
- *     ui:
- *       code_path_patterns:
- *         - 'src/widgets/*.tsx'
- *       lane_hints:
- *         - 'Design'
- * ```
- */
-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(),
-    /**
-     * WU-1899: Work classification configuration.
-     * Extends default signal patterns for UI/backend/docs/infra detection.
-     * Custom patterns extend defaults, they do not replace them.
-     */
-    work_classification: WorkClassificationConfigSchema.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 === undefined)) {
-        // gates.minCoverage overrides methodology coverage_threshold
-        coverage_threshold = gates.minCoverage;
-    }
-    // gates.enableCoverage: false effectively sets coverage_mode to 'off'
-    if (gatesEnableCoverageExplicit || (!methodologySpecified && rawConfig === undefined)) {
-        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,
-    };
-}
-//# sourceMappingURL=resolve-policy.js.map