@lumenflow/core 4.23.0 → 5.0.0

package/dist/wu-doc-types.d.ts

@@ -1,49 +1,3 @@
 /// <reference path="./types.d.ts" />
-/**
- * WU Document Type Definitions (WU-2044)
- *
- * Canonical type for parsed WU YAML documents. Previously independently
- * defined in 7+ files (spawn-agent-guidance.ts, wu-done-paths.ts,
- * code-path-validator.ts, lane-checker.ts, wu-repair-core.ts,
- * wu-status-transition.ts, wu-transaction-collectors.ts).
- *
- * This module defines a base type covering the superset of fields
- * needed across consumers. Files needing only a subset can use
- * Pick<WUDocBase, 'field1' | 'field2'>.
- *
- * @module wu-doc-types
- */
-/**
- * Base WU document interface representing a parsed WU YAML file.
- *
- * All fields are optional since they may not be present depending
- * on the WU's lifecycle stage or type.
- */
-export interface WUDocBase extends Record<string, unknown> {
-    id?: string;
-    title?: string;
-    lane?: string;
-    type?: string;
-    status?: string;
-    description?: string;
-    acceptance?: string[];
-    code_paths?: string[];
-    spec_refs?: string[];
-    notes?: string;
-    risks?: string[];
-    initiative?: string;
-    worktree_path?: string;
-    claimed_mode?: string;
-    claimed_branch?: string;
-    claimed_at?: string;
-    locked?: boolean;
-    created?: unknown;
-    completed?: unknown;
-    completed_at?: string;
-    tests?: {
-        manual?: string[];
-        unit?: string[];
-        e2e?: string[];
-    };
-}
+export type { WUDocBase } from '@lumenflow/packs-software-delivery/state/wu-doc-types';
 //# sourceMappingURL=wu-doc-types.d.ts.map

package/dist/wu-doc-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wu-doc-types.d.ts","sourceRoot":"","sources":["../src/wu-doc-types.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,SAAU,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;CACH"}
+{"version":3,"file":"wu-doc-types.d.ts","sourceRoot":"","sources":["../src/wu-doc-types.ts"],"names":[],"mappings":"AAMA,YAAY,EAAE,SAAS,EAAE,MAAM,uDAAuD,CAAC"}

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

@@ -1,297 +1,3 @@
 /// <reference path="./types.d.ts" />
-/**
- * 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;
-    ESCALATE: (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;
-}>;
+export * from '@lumenflow/packs-software-delivery/constants/wu-domain-constants';
 //# sourceMappingURL=wu-domain-constants.d.ts.map

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

@@ -1 +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;mBAEZ,MAAM;CACtB,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"}
+{"version":3,"file":"wu-domain-constants.d.ts","sourceRoot":"","sources":["../src/wu-domain-constants.ts"],"names":[],"mappings":"AAMA,cAAc,kEAAkE,CAAC"}