@lumenflow/core 2.15.2 → 2.16.0

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

@@ -0,0 +1,305 @@
+/**
+ * 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
+ */
+/**
+ * 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 patientpath.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 any 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;
+}>;
+//# 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":"AAAA;;;;;;;;;GASG;AAMH;;;;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,mBAwBrC,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;;;;;GA+CtF"}