@lumenflow/core 3.2.0 → 3.2.1

package/dist/wu-domain-constants.d.ts

@@ -0,0 +1,295 @@
+/**
+ * Regex patterns for WU operations
+ *
+ * Note: WU_ID pattern is also in wu-schema.ts for Zod validation
+ */
+export declare const PATTERNS: {
+    /** WU identifier format: WU-123 */
+    WU_ID: RegExp;
+    /** Extract WU ID from text: captures "WU-123" */
+    WU_ID_EXTRACT: RegExp;
+    /**
+     * Extract WU ID from worktree paths (case-insensitive)
+     *
+     * WU-1090: Worktree names use lowercase like 'framework-core-wu-1090'
+     * This pattern matches both 'WU-123' and 'wu-123' to support
+     * extracting WU IDs from worktree paths.
+     */
+    WU_ID_EXTRACT_CI: RegExp;
+    /** Lane branch format: lane/<lane-kebab>/wu-<id> */
+    LANE_BRANCH: RegExp;
+    /** Worktree path format: worktrees/<lane-kebab>-wu-<id> */
+    WORKTREE_PATH: RegExp;
+};
+/**
+ * Commit message formats
+ *
+ * These are functions that generate properly formatted commit messages
+ */
+export declare const COMMIT_FORMATS: {
+    CLAIM: (id: string, laneKebab: string) => string;
+    DONE: (id: string, title: string) => string;
+    CREATE: (id: string, title: string) => string;
+    EDIT: (id: string) => string;
+    SPEC_UPDATE: (id: string) => string;
+    BLOCK: (id: string) => string;
+    UNBLOCK: (id: string) => string;
+    REPAIR: (id: string) => string;
+    REBASE_ARTIFACT_CLEANUP: (id: string) => string;
+    BACKLOG_REPAIR: (id: string) => string;
+};
+/**
+ * Consistency check types (WU-1276)
+ *
+ * Layer 2 defense-in-depth: detect and repair WU state inconsistencies
+ */
+export declare const CONSISTENCY_TYPES: {
+    /** WU YAML has status 'done' but WU appears in status.md In Progress section */
+    YAML_DONE_STATUS_IN_PROGRESS: string;
+    /** WU appears in both Done AND In Progress sections of backlog.md */
+    BACKLOG_DUAL_SECTION: string;
+    /** WU YAML has status 'done' but no stamp file exists */
+    YAML_DONE_NO_STAMP: string;
+    /** WU has status 'done' but still has an associated worktree */
+    ORPHAN_WORKTREE_DONE: string;
+    /** Stamp file exists but WU YAML status is not 'done' (partial wu:done failure) */
+    STAMP_EXISTS_YAML_NOT_DONE: string;
+    /** WU is claimed but its worktree directory is missing */
+    MISSING_WORKTREE_CLAIMED: string;
+};
+/**
+ * Consistency check messages
+ */
+export declare const CONSISTENCY_MESSAGES: {
+    MISSING_WORKTREE_CLAIMED: (id: string, status: string, worktreePath: string) => string;
+    MISSING_WORKTREE_CLAIMED_REPAIR: string;
+};
+/**
+ * Worktree warning messages
+ */
+export declare const WORKTREE_WARNINGS: {
+    MISSING_TRACKED_HEADER: string;
+    MISSING_TRACKED_LINE: (worktreePath: string) => string;
+};
+/**
+ * Cleanup guard constants
+ */
+export declare const CLEANUP_GUARD: {
+    REASONS: {
+        UNCOMMITTED_CHANGES: string;
+        UNPUSHED_COMMITS: string;
+        STATUS_NOT_DONE: string;
+        MISSING_STAMP: string;
+        PR_NOT_MERGED: string;
+    };
+    TITLES: {
+        BLOCKED: string;
+        NEXT_STEPS: string;
+    };
+    MESSAGES: {
+        UNCOMMITTED_CHANGES: string;
+        UNPUSHED_COMMITS: string;
+        STATUS_NOT_DONE: string;
+        MISSING_STAMP: string;
+        PR_NOT_MERGED: string;
+    };
+    NEXT_STEPS: {
+        DEFAULT: {
+            text: string;
+            appendId: boolean;
+        }[];
+        UNCOMMITTED_CHANGES: {
+            text: string;
+            appendId: boolean;
+        }[];
+        UNPUSHED_COMMITS: {
+            text: string;
+            appendId: boolean;
+        }[];
+        STATUS_NOT_DONE: {
+            text: string;
+            appendId: boolean;
+        }[];
+        MISSING_STAMP: {
+            text: string;
+            appendId: boolean;
+        }[];
+        PR_NOT_MERGED: {
+            text: string;
+            appendId: boolean;
+        }[];
+    };
+    PR_CHECK: {
+        START: string;
+        RESULT: string;
+    };
+};
+/**
+ * Session display constants
+ *
+ * Emergency fix (Session 2): Centralized from hardcoded magic numbers
+ */
+export declare const SESSION: {
+    /** Standard length for displaying session ID prefix (e.g., "sess-123") */
+    ID_DISPLAY_LENGTH: number;
+};
+/**
+ * Validation constants
+ *
+ * WU-1281: Centralized from local constants in validators
+ */
+export declare const VALIDATION: {
+    /** Minimum description length for WU spec completeness */
+    MIN_DESCRIPTION_LENGTH: number;
+};
+/**
+ * Threshold constants for pre-flight checks
+ *
+ * WU-1302: Centralized to eliminate magic numbers
+ * WU-1370: Added graduated drift thresholds for early warnings
+ */
+export declare const THRESHOLDS: {
+    /** Info threshold: commits behind main to suggest rebasing (WU-1370) */
+    BRANCH_DRIFT_INFO: number;
+    /** Warning threshold: commits behind main where rebase is recommended (WU-1370) */
+    BRANCH_DRIFT_WARNING: number;
+    /** Maximum commits behind main before requiring rebase (WU-755 pre-flight) */
+    BRANCH_DRIFT_MAX: number;
+};
+/**
+ * Default values
+ */
+export declare const DEFAULTS: {
+    /** Default worktrees directory */
+    WORKTREES_DIR: string;
+    /** Maximum commit subject length (commitlint default) */
+    MAX_COMMIT_SUBJECT: number;
+    /** Parent directory traversal depth from tools/lib to project root */
+    PROJECT_ROOT_DEPTH: number;
+    /**
+     * Default email domain for username -> email conversion
+     * WU-1068: Made configurable, no longer hardcoded to exampleapp.co.uk
+     * @see user-normalizer.ts - Infers from git config first
+     */
+    EMAIL_DOMAIN: string;
+};
+/**
+ * Default values for WU YAML fields
+ *
+ * WU-1337: Centralized defaults for auto-repair in schema validation
+ * DRY principle: Single source of truth for optional field defaults
+ *
+ * Used by wu-schema.ts Zod transformations to provide sensible defaults
+ * when agents omit optional fields, reducing validation errors.
+ */
+export declare const WU_DEFAULTS: {
+    /** Default priority level (medium priority) */
+    priority: string;
+    /** Default status for new WUs */
+    status: string;
+    /** Default work type */
+    type: string;
+    /** Default code paths (empty until populated) */
+    code_paths: string[];
+    /** Default test structure (includes all test types) */
+    tests: {
+        manual: string[];
+        unit: string[];
+        integration: string[];
+        e2e: string[];
+    };
+    /** Default artifacts (empty - wu:done adds stamp) */
+    artifacts: string[];
+    /** Default dependencies (no blockers) */
+    dependencies: string[];
+    /** Default risks (none identified) */
+    risks: string[];
+    /** Default notes (empty string, not undefined) */
+    notes: string;
+    /** Default review requirement (agent-completed WUs) */
+    requires_review: boolean;
+};
+/**
+ * Safety-critical test glob patterns
+ *
+ * WU-2242: Centralized list of glob patterns for safety tests that MUST exist.
+ * Gates fail if UnsafeAny of these patterns find no matches.
+ */
+export declare const SAFETY_CRITICAL_TEST_GLOBS: readonly string[];
+/**
+ * Lane-to-code_paths validation patterns (WU-1372)
+ *
+ * Advisory patterns to warn when a WU's lane doesn't match its code_paths.
+ */
+export declare const LANE_PATH_PATTERNS: {
+    Operations: {
+        exclude: string[];
+        allowExceptions: string[];
+    };
+    Intelligence: {
+        exclude: string[];
+        allowExceptions: string[];
+    };
+};
+/**
+ * Convert lane name to kebab-case using change-case library
+ *
+ * @param lane - Lane name (e.g., 'Operations: Tooling')
+ * @returns Kebab-case lane (e.g., 'operations-tooling')
+ */
+export declare function toKebab(lane: string | null | undefined): string;
+/**
+ * Generate worktree path from lane and WU ID
+ *
+ * @param lane - Lane name
+ * @param id - WU ID
+ * @returns Worktree path (e.g., 'worktrees/operations-tooling-wu-123')
+ */
+export declare function getWorktreePath(lane: string, id: string): string;
+/**
+ * Generate lane branch name from lane and WU ID
+ *
+ * @param lane - Lane name
+ * @param id - WU ID
+ * @returns Branch name (e.g., 'lane/operations-tooling/wu-123')
+ */
+export declare function getLaneBranch(lane: string, id: string): string;
+/**
+ * Get project root directory from a module URL
+ *
+ * WU-923: Centralized path resolution to eliminate '../..' magic strings
+ *
+ * @param moduleUrl - import.meta.url of the calling module
+ * @returns Absolute path to project root
+ */
+export declare function getProjectRoot(moduleUrl: string): string;
+/**
+ * Options for discovering safety tests
+ */
+export interface DiscoverSafetyTestsOptions {
+    /** Project root directory */
+    projectRoot?: string;
+}
+/**
+ * Discover safety-critical test files
+ *
+ * WU-2242: Scans for test files matching safety-critical patterns.
+ * Uses glob to find all matching files.
+ *
+ * @param options - Discovery options
+ * @returns List of discovered test file paths
+ */
+export declare function discoverSafetyTests(options?: DiscoverSafetyTestsOptions): Promise<string[]>;
+/**
+ * Validate that required safety-critical tests exist
+ *
+ * WU-2242: Checks that each pattern category has at least one matching test file.
+ * Returns a validation result with missing patterns and found files.
+ */
+export declare function validateSafetyTestsExist(options?: DiscoverSafetyTestsOptions): Promise<{
+    valid: boolean;
+    missingTests: string[];
+    foundTests: string[];
+    error: string | undefined;
+}>;
+//# sourceMappingURL=wu-domain-constants.d.ts.map

package/dist/wu-domain-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-domain-constants.d.ts","sourceRoot":"","sources":["../src/wu-domain-constants.ts"],"names":[],"mappings":"AAkBA;;;;GAIG;AACH,eAAO,MAAM,QAAQ;IACnB,mCAAmC;;IAGnC,iDAAiD;;IAGjD;;;;;;OAMG;;IAGH,oDAAoD;;IAGpD,2DAA2D;;CAE5D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc;gBACb,MAAM,aAAa,MAAM;eAC1B,MAAM,SAAS,MAAM;iBACnB,MAAM,SAAS,MAAM;eACvB,MAAM;sBACC,MAAM;gBACZ,MAAM;kBACJ,MAAM;iBACP,MAAM;kCACW,MAAM;yBAEf,MAAM;CAE5B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;IAC5B,gFAAgF;;IAGhF,qEAAqE;;IAGrE,yDAAyD;;IAGzD,gEAAgE;;IAGhE,mFAAmF;;IAGnF,0DAA0D;;CAE3D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB;mCACA,MAAM,UAAU,MAAM,gBAAgB,MAAM;;CAG5E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB;;yCAES,MAAM;CAC5C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsDzB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,OAAO;IAClB,0EAA0E;;CAE3E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU;IACrB,0DAA0D;;CAE3D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,UAAU;IACrB,wEAAwE;;IAGxE,mFAAmF;;IAGnF,8EAA8E;;CAE/E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ;IACnB,kCAAkC;;IAGlC,yDAAyD;;IAGzD,sEAAsE;;IAGtE;;;;OAIG;;CAEJ,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW;IACtB,+CAA+C;;IAG/C,iCAAiC;;IAGjC,wBAAwB;;IAGxB,iDAAiD;gBAC/B,MAAM,EAAE;IAE1B,uDAAuD;;gBAEvC,MAAM,EAAE;cACV,MAAM,EAAE;qBACD,MAAM,EAAE;aAChB,MAAM,EAAE;;IAGrB,qDAAqD;eACpC,MAAM,EAAE;IAEzB,yCAAyC;kBACrB,MAAM,EAAE;IAE5B,sCAAsC;WACzB,MAAM,EAAE;IAErB,kDAAkD;;IAGlD,uDAAuD;;CAExD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,mBAoBrC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;yBAGJ,MAAM,EAAE;;;;;;CAMlC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAK/D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CASxD;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,MAAM,EAAE,CAAC,CAkBnB;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,GAAE,0BAA+B;;;;;GA8CtF"}

package/dist/wu-domain-constants.js

@@ -0,0 +1,399 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Domain Constants
+ *
+ * WU-1549: Extracted from wu-constants.ts for domain-specific modularity.
+ * Contains WU patterns, commit formats, consistency checks, cleanup guards,
+ * defaults, validation thresholds, safety tests, lane path patterns, and
+ * utility functions (toKebab, getWorktreePath, getLaneBranch, getProjectRoot).
+ *
+ * @module wu-domain-constants
+ */
+import path from 'node:path';
+import { kebabCase } from 'change-case';
+import { LOG_PREFIX } from './wu-ui-constants.js';
+/**
+ * Regex patterns for WU operations
+ *
+ * Note: WU_ID pattern is also in wu-schema.ts for Zod validation
+ */
+export const PATTERNS = {
+    /** WU identifier format: WU-123 */
+    WU_ID: /^WU-\d+$/,
+    /** Extract WU ID from text: captures "WU-123" */
+    WU_ID_EXTRACT: /WU-\d+/,
+    /**
+     * Extract WU ID from worktree paths (case-insensitive)
+     *
+     * WU-1090: Worktree names use lowercase like 'framework-core-wu-1090'
+     * This pattern matches both 'WU-123' and 'wu-123' to support
+     * extracting WU IDs from worktree paths.
+     */
+    WU_ID_EXTRACT_CI: /wu-\d+/i,
+    /** Lane branch format: lane/<lane-kebab>/wu-<id> */
+    LANE_BRANCH: /^lane\/[\w-]+\/wu-\d+$/,
+    /** Worktree path format: worktrees/<lane-kebab>-wu-<id> */
+    WORKTREE_PATH: /^worktrees\/[\w-]+-wu-\d+$/,
+};
+/**
+ * Commit message formats
+ *
+ * These are functions that generate properly formatted commit messages
+ */
+export const COMMIT_FORMATS = {
+    CLAIM: (id, laneKebab) => `wu(${id}): claim for ${laneKebab} lane`,
+    DONE: (id, title) => `wu(${id}): done - ${title}`,
+    CREATE: (id, title) => `docs: create ${id.toLowerCase()} for ${title}`,
+    EDIT: (id) => `docs: edit ${id.toLowerCase()} spec`,
+    SPEC_UPDATE: (id) => `wu(${id.toLowerCase()}): spec update`,
+    BLOCK: (id) => `wu(${id}): block`,
+    UNBLOCK: (id) => `wu(${id}): unblock`,
+    REPAIR: (id) => `fix(${id}): repair state inconsistency`,
+    REBASE_ARTIFACT_CLEANUP: (id) => `chore(${id.toLowerCase()}): remove rebased completion artifacts`,
+    BACKLOG_REPAIR: (id) => `chore(repair): repair backlog duplicates for ${id.toLowerCase()}`,
+};
+/**
+ * Consistency check types (WU-1276)
+ *
+ * Layer 2 defense-in-depth: detect and repair WU state inconsistencies
+ */
+export const CONSISTENCY_TYPES = {
+    /** WU YAML has status 'done' but WU appears in status.md In Progress section */
+    YAML_DONE_STATUS_IN_PROGRESS: 'YAML_DONE_STATUS_IN_PROGRESS',
+    /** WU appears in both Done AND In Progress sections of backlog.md */
+    BACKLOG_DUAL_SECTION: 'BACKLOG_DUAL_SECTION',
+    /** WU YAML has status 'done' but no stamp file exists */
+    YAML_DONE_NO_STAMP: 'YAML_DONE_NO_STAMP',
+    /** WU has status 'done' but still has an associated worktree */
+    ORPHAN_WORKTREE_DONE: 'ORPHAN_WORKTREE_DONE',
+    /** Stamp file exists but WU YAML status is not 'done' (partial wu:done failure) */
+    STAMP_EXISTS_YAML_NOT_DONE: 'STAMP_EXISTS_YAML_NOT_DONE',
+    /** WU is claimed but its worktree directory is missing */
+    MISSING_WORKTREE_CLAIMED: 'MISSING_WORKTREE_CLAIMED',
+};
+/**
+ * Consistency check messages
+ */
+export const CONSISTENCY_MESSAGES = {
+    MISSING_WORKTREE_CLAIMED: (id, status, worktreePath) => `WU ${id} is '${status}' but worktree path is missing (${worktreePath})`,
+    MISSING_WORKTREE_CLAIMED_REPAIR: 'Recover worktree or re-claim WU',
+};
+/**
+ * Worktree warning messages
+ */
+export const WORKTREE_WARNINGS = {
+    MISSING_TRACKED_HEADER: 'Tracked worktrees missing on disk (possible manual deletion):',
+    MISSING_TRACKED_LINE: (worktreePath) => `Missing: ${worktreePath}`,
+};
+/**
+ * Cleanup guard constants
+ */
+export const CLEANUP_GUARD = {
+    REASONS: {
+        UNCOMMITTED_CHANGES: 'UNCOMMITTED_CHANGES',
+        UNPUSHED_COMMITS: 'UNPUSHED_COMMITS',
+        STATUS_NOT_DONE: 'STATUS_NOT_DONE',
+        MISSING_STAMP: 'MISSING_STAMP',
+        PR_NOT_MERGED: 'PR_NOT_MERGED',
+    },
+    TITLES: {
+        BLOCKED: 'CLEANUP BLOCKED',
+        NEXT_STEPS: 'Next steps:',
+    },
+    MESSAGES: {
+        UNCOMMITTED_CHANGES: 'Worktree has uncommitted changes. Refusing to delete.',
+        UNPUSHED_COMMITS: 'Worktree has unpushed commits. Refusing to delete.',
+        STATUS_NOT_DONE: 'WU YAML status is not done. Refusing to delete.',
+        MISSING_STAMP: 'WU stamp is missing. Refusing to delete.',
+        PR_NOT_MERGED: 'PR is not merged (or cannot be verified). Refusing to delete.',
+    },
+    /* eslint-disable sonarjs/no-duplicate-string -- Intentional: cleanup instructions repeated for each error type for readability */
+    NEXT_STEPS: {
+        DEFAULT: [
+            { text: '1. Resolve the issue above', appendId: false },
+            { text: '2. Re-run: pnpm wu:cleanup --id', appendId: true },
+        ],
+        UNCOMMITTED_CHANGES: [
+            { text: '1. Commit or stash changes in the worktree', appendId: false },
+            { text: '2. Re-run: pnpm wu:cleanup --id', appendId: true },
+        ],
+        UNPUSHED_COMMITS: [
+            { text: '1. Push the lane branch to origin', appendId: false },
+            { text: '2. Re-run: pnpm wu:cleanup --id', appendId: true },
+        ],
+        STATUS_NOT_DONE: [
+            {
+                text: `1. Complete the WU with ${LOG_PREFIX.DONE} (creates stamp + done status)`,
+                appendId: false,
+            },
+            { text: '2. Re-run: pnpm wu:cleanup --id', appendId: true },
+        ],
+        MISSING_STAMP: [
+            { text: '1. Run wu:done to create the stamp file', appendId: false },
+            { text: '2. Re-run: pnpm wu:cleanup --id', appendId: true },
+        ],
+        PR_NOT_MERGED: [
+            { text: '1. Merge the PR in GitHub', appendId: false },
+            { text: '2. Re-run: pnpm wu:cleanup --id', appendId: true },
+        ],
+    },
+    /* eslint-enable sonarjs/no-duplicate-string */
+    PR_CHECK: {
+        START: 'Verifying PR merge status...',
+        RESULT: 'PR merge verification via',
+    },
+};
+/**
+ * Session display constants
+ *
+ * Emergency fix (Session 2): Centralized from hardcoded magic numbers
+ */
+export const SESSION = {
+    /** Standard length for displaying session ID prefix (e.g., "sess-123") */
+    ID_DISPLAY_LENGTH: 8,
+};
+/**
+ * Validation constants
+ *
+ * WU-1281: Centralized from local constants in validators
+ */
+export const VALIDATION = {
+    /** Minimum description length for WU spec completeness */
+    MIN_DESCRIPTION_LENGTH: 50,
+};
+/**
+ * Threshold constants for pre-flight checks
+ *
+ * WU-1302: Centralized to eliminate magic numbers
+ * WU-1370: Added graduated drift thresholds for early warnings
+ */
+export const THRESHOLDS = {
+    /** Info threshold: commits behind main to suggest rebasing (WU-1370) */
+    BRANCH_DRIFT_INFO: 10,
+    /** Warning threshold: commits behind main where rebase is recommended (WU-1370) */
+    BRANCH_DRIFT_WARNING: 15,
+    /** Maximum commits behind main before requiring rebase (WU-755 pre-flight) */
+    BRANCH_DRIFT_MAX: 20,
+};
+/**
+ * Default values
+ */
+export const DEFAULTS = {
+    /** Default worktrees directory */
+    WORKTREES_DIR: 'worktrees',
+    /** Maximum commit subject length (commitlint default) */
+    MAX_COMMIT_SUBJECT: 100,
+    /** Parent directory traversal depth from tools/lib to project root */
+    PROJECT_ROOT_DEPTH: 2,
+    /**
+     * Default email domain for username -> email conversion
+     * WU-1068: Made configurable, no longer hardcoded to exampleapp.co.uk
+     * @see user-normalizer.ts - Infers from git config first
+     */
+    EMAIL_DOMAIN: 'example.com',
+};
+/**
+ * Default values for WU YAML fields
+ *
+ * WU-1337: Centralized defaults for auto-repair in schema validation
+ * DRY principle: Single source of truth for optional field defaults
+ *
+ * Used by wu-schema.ts Zod transformations to provide sensible defaults
+ * when agents omit optional fields, reducing validation errors.
+ */
+export const WU_DEFAULTS = {
+    /** Default priority level (medium priority) */
+    priority: 'P2',
+    /** Default status for new WUs */
+    status: 'ready',
+    /** Default work type */
+    type: 'feature',
+    /** Default code paths (empty until populated) */
+    code_paths: [],
+    /** Default test structure (includes all test types) */
+    tests: {
+        manual: [],
+        unit: [],
+        integration: [],
+        e2e: [],
+    },
+    /** Default artifacts (empty - wu:done adds stamp) */
+    artifacts: [],
+    /** Default dependencies (no blockers) */
+    dependencies: [],
+    /** Default risks (none identified) */
+    risks: [],
+    /** Default notes (empty string, not undefined) */
+    notes: '',
+    /** Default review requirement (agent-completed WUs) */
+    requires_review: false,
+};
+/**
+ * Safety-critical test glob patterns
+ *
+ * WU-2242: Centralized list of glob patterns for safety tests that MUST exist.
+ * Gates fail if UnsafeAny of these patterns find no matches.
+ */
+export const SAFETY_CRITICAL_TEST_GLOBS = Object.freeze([
+    // Escalation trigger tests
+    'apps/web/src/**/*escalation*.test.{ts,tsx}',
+    'apps/web/src/**/*Escalation*.test.{ts,tsx}',
+    // Privacy detection tests
+    'apps/web/src/**/*privacy*.test.{ts,tsx}',
+    'apps/web/src/**/*Privacy*.test.{ts,tsx}',
+    // Constitutional enforcer tests
+    'apps/web/src/**/*constitutional*.test.{ts,tsx}',
+    'apps/web/src/**/*Constitutional*.test.{ts,tsx}',
+    // Safe prompt wrapper tests
+    'apps/web/src/**/*safePrompt*.test.{ts,tsx}',
+    'apps/web/src/**/*SafePrompt*.test.{ts,tsx}',
+    // Crisis/emergency handling tests
+    'apps/web/src/**/*crisis*.test.{ts,tsx}',
+    'apps/web/src/**/*Crisis*.test.{ts,tsx}',
+]);
+/**
+ * Lane-to-code_paths validation patterns (WU-1372)
+ *
+ * Advisory patterns to warn when a WU's lane doesn't match its code_paths.
+ */
+export const LANE_PATH_PATTERNS = {
+    Operations: {
+        exclude: ['ai/prompts/**', 'apps/web/src/lib/prompts/**'],
+        allowExceptions: [],
+    },
+    Intelligence: {
+        exclude: ['tools/**'],
+        allowExceptions: ['tools/lib/prompt-*', 'tools/prompts-eval/**'],
+    },
+};
+/**
+ * Convert lane name to kebab-case using change-case library
+ *
+ * @param lane - Lane name (e.g., 'Operations: Tooling')
+ * @returns Kebab-case lane (e.g., 'operations-tooling')
+ */
+export function toKebab(lane) {
+    if (lane == null)
+        return '';
+    const normalized = String(lane).trim();
+    if (normalized === '')
+        return '';
+    return kebabCase(normalized);
+}
+/**
+ * Generate worktree path from lane and WU ID
+ *
+ * @param lane - Lane name
+ * @param id - WU ID
+ * @returns Worktree path (e.g., 'worktrees/operations-tooling-wu-123')
+ */
+export function getWorktreePath(lane, id) {
+    const laneKebab = toKebab(lane);
+    const idLower = id.toLowerCase();
+    return `${DEFAULTS.WORKTREES_DIR}/${laneKebab}-${idLower}`;
+}
+/**
+ * Generate lane branch name from lane and WU ID
+ *
+ * @param lane - Lane name
+ * @param id - WU ID
+ * @returns Branch name (e.g., 'lane/operations-tooling/wu-123')
+ */
+export function getLaneBranch(lane, id) {
+    const laneKebab = toKebab(lane);
+    const idLower = id.toLowerCase();
+    return `lane/${laneKebab}/${idLower}`;
+}
+/**
+ * Get project root directory from a module URL
+ *
+ * WU-923: Centralized path resolution to eliminate '../..' magic strings
+ *
+ * @param moduleUrl - import.meta.url of the calling module
+ * @returns Absolute path to project root
+ */
+export function getProjectRoot(moduleUrl) {
+    const { dirname } = path;
+    const currentDir = dirname(new URL(moduleUrl).pathname);
+    let root = currentDir;
+    for (let i = 0; i < DEFAULTS.PROJECT_ROOT_DEPTH; i++) {
+        root = dirname(root);
+    }
+    return root;
+}
+/**
+ * Discover safety-critical test files
+ *
+ * WU-2242: Scans for test files matching safety-critical patterns.
+ * Uses glob to find all matching files.
+ *
+ * @param options - Discovery options
+ * @returns List of discovered test file paths
+ */
+export async function discoverSafetyTests(options = {}) {
+    const { projectRoot = process.cwd() } = options;
+    const { glob } = await import('glob');
+    const foundFiles = [];
+    for (const pattern of SAFETY_CRITICAL_TEST_GLOBS) {
+        try {
+            const matches = await glob(pattern, {
+                cwd: projectRoot,
+                absolute: false,
+            });
+            foundFiles.push(...matches);
+        }
+        catch {
+            // Pattern may not match anything, that's fine
+        }
+    }
+    return [...new Set(foundFiles)]; // Deduplicate
+}
+/**
+ * Validate that required safety-critical tests exist
+ *
+ * WU-2242: Checks that each pattern category has at least one matching test file.
+ * Returns a validation result with missing patterns and found files.
+ */
+export async function validateSafetyTestsExist(options = {}) {
+    const { projectRoot = process.cwd() } = options;
+    const { glob } = await import('glob');
+    const missingTests = [];
+    const foundTests = [];
+    const categories = [
+        { name: 'Escalation', patterns: SAFETY_CRITICAL_TEST_GLOBS.slice(0, 2) },
+        { name: 'Privacy detection', patterns: SAFETY_CRITICAL_TEST_GLOBS.slice(2, 4) },
+        { name: 'Constitutional', patterns: SAFETY_CRITICAL_TEST_GLOBS.slice(4, 6) },
+        { name: 'Safe prompt wrapper', patterns: SAFETY_CRITICAL_TEST_GLOBS.slice(6, 8) },
+        { name: 'Crisis handling', patterns: SAFETY_CRITICAL_TEST_GLOBS.slice(8, 10) },
+    ];
+    for (const category of categories) {
+        let categoryHasTests = false;
+        for (const pattern of category.patterns) {
+            try {
+                const matches = await glob(pattern, {
+                    cwd: projectRoot,
+                    absolute: false,
+                });
+                if (matches.length > 0) {
+                    categoryHasTests = true;
+                    foundTests.push(...matches);
+                }
+            }
+            catch {
+                // Pattern error, treat as no matches
+            }
+        }
+        if (!categoryHasTests) {
+            missingTests.push(`${category.name}: ${category.patterns.join(', ')}`);
+        }
+    }
+    const valid = missingTests.length === 0;
+    return {
+        valid,
+        missingTests,
+        foundTests: [...new Set(foundTests)],
+        error: valid ? undefined : `Missing safety-critical tests: ${missingTests.join('; ')}`,
+    };
+}
+//# sourceMappingURL=wu-domain-constants.js.map