@lumenflow/core 2.15.1 → 2.16.0

package/dist/wu-constants.d.ts

@@ -1,1841 +1,28 @@
 /**
- * Work Unit Constants
+ * Work Unit Constants - Barrel Re-export
  *
- * Centralized constants for wu- scripts to ensure consistency and DRY compliance.
- * Single source of truth for magic strings, section headings, and patterns.
+ * WU-1549: This file was decomposed from a 2,300+ line monolith into
+ * domain-specific modules. It now serves as a backward-compatible barrel
+ * re-exporting all constants from their domain modules.
  *
- * Part of WU-1214: Extract hardcoded strings to wu-constants.ts
- * Part of WU-1240: Consolidated toKebab using change-case library
+ * Domain modules:
+ * - wu-statuses.ts: WU status values, groups, exposure types, claimed modes
+ * - wu-git-constants.ts: Git branch names, remotes, refs, flags, commands
+ * - wu-paths-constants.ts: LumenFlow paths, file system, PHI config
+ * - wu-cli-constants.ts: CLI flags, gates, tooling, process constants
+ * - wu-ui-constants.ts: Display, formatting, UI, box drawing
+ * - wu-domain-constants.ts: Patterns, commit formats, defaults, safety tests
+ * - wu-context-constants.ts: Context validation, hooks, derived types
  *
  * @see {@link packages/@lumenflow/cli/src/wu-done.ts} - Primary consumer
  * @see {@link packages/@lumenflow/cli/src/wu-claim.ts} - Branch/worktree creation
- * @see {@link packages/@lumenflow/cli/src/lib/wu-schema.ts} - PLACEHOLDER_SENTINEL (already centralized)
- */
-/**
- * Git branch names
- */
-export declare const BRANCHES: {
-    MAIN: string;
-    MASTER: string;
-    /** Temporary branch prefix for micro-worktree operations */
-    TEMP_PREFIX: string;
-};
-/**
- * Git remote names
- *
- * WU-1302: Centralized to eliminate hardcoded 'origin' strings
- */
-export declare const REMOTES: {
-    ORIGIN: string;
-};
-/**
- * Git ref construction helpers
- *
- * Centralized to eliminate hardcoded 'origin/main' strings
- */
-export declare const GIT_REFS: {
-    /** Construct remote ref like 'origin/main' */
-    remote: (remoteName: any, branchName: any) => string;
-    /** Shortcut for origin/main */
-    ORIGIN_MAIN: string;
-    /** Current HEAD ref */
-    HEAD: string;
-    /** Upstream ref */
-    UPSTREAM: string;
-    /** Range of upstream..HEAD */
-    UPSTREAM_RANGE: string;
-    /** Fetch head ref */
-    FETCH_HEAD: string;
-};
-/**
- * WU status values
- *
- * Centralized status strings to avoid magic strings in wu-* scripts.
- * Includes both canonical statuses and legacy variants found in YAML files.
- */
-export declare const WU_STATUS: {
-    TODO: string;
-    READY: string;
-    BACKLOG: string;
-    IN_PROGRESS: string;
-    BLOCKED: string;
-    DONE: string;
-    COMPLETED: string;
-    CANCELLED: string;
-    ABANDONED: string;
-    DEFERRED: string;
-    CLOSED: string;
-    SUPERSEDED: string;
-};
-/**
- * WU status groups for state management (WU-1742)
- *
- * Used by state-bootstrap.ts to categorize YAML statuses.
- */
-export declare const WU_STATUS_GROUPS: {
-    /** Statuses representing unclaimed work (not tracked in state store) */
-    UNCLAIMED: string[];
-    /** Terminal statuses (all map to 'done' in state store) */
-    TERMINAL: string[];
-};
-/**
- * WU claimed workspace modes
- *
- * Centralized workspace mode strings for wu:claim operations.
- */
-export declare const CLAIMED_MODES: {
-    /** Standard worktree mode (isolated worktree per WU) */
-    WORKTREE: string;
-    /** Branch-only mode (no worktree, direct branch work) */
-    BRANCH_ONLY: string;
-    /** Worktree PR mode (worktree with manual PR workflow) */
-    WORKTREE_PR: string;
-    /** Branch PR mode (no worktree, PR-based completion for cloud agents) */
-    BRANCH_PR: string;
-};
-/**
- * Agent incident severity levels
- *
- * Centralized severity strings for agent incident reporting.
- */
-export declare const INCIDENT_SEVERITY: {
-    BLOCKER: string;
-    MAJOR: string;
-    MINOR: string;
-    INFO: string;
-};
-/**
- * Backlog section headings (with emojis)
- *
- * These match the frontmatter config in backlog.md
- */
-export declare const BACKLOG_SECTIONS: {
-    READY: string;
-    IN_PROGRESS: string;
-    BLOCKED: string;
-    DONE: string;
-};
-/**
- * Backlog bullet format types (WU-1444)
- *
- * Used by BacklogManager to format list items in each section.
- * Each format produces a different markdown bullet style.
- */
-export declare const BACKLOG_BULLET_FORMAT: {
-    /** Ready format: '- [ ] [WU-ID — Title](link)' */
-    READY: string;
-    /** Progress format: '- [WU-ID — Title](link)' */
-    PROGRESS: string;
-    /** Blocked format: '- [ ] [WU-ID — Title](link) — Reason' */
-    BLOCKED: string;
-    /** Done format: '- [x] [WU-ID — Title](link) (YYYY-MM-DD)' */
-    DONE: string;
-};
-/**
- * Status.md section headings (simpler format)
- */
-export declare const STATUS_SECTIONS: {
-    IN_PROGRESS: string;
-    BLOCKED: string;
-    COMPLETED: string;
-};
-/**
- * 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: {
-    /**
-     * wu:claim commit message
-     * @param {string} id - WU ID (e.g., 'wu-123')
-     * @param {string} laneKebab - Lane in kebab-case (e.g., 'operations-tooling')
-     * @returns {string} Commit message
-     */
-    CLAIM: (id: any, laneKebab: any) => string;
-    /**
-     * wu:done commit message
-     * @param {string} id - WU ID (e.g., 'wu-123')
-     * @param {string} title - WU title (will be truncated if needed)
-     * @returns {string} Commit message
-     */
-    DONE: (id: any, title: any) => string;
-    /**
-     * wu:create commit message
-     * @param {string} id - WU ID (e.g., 'wu-123')
-     * @param {string} title - WU title (will be truncated if needed)
-     * @returns {string} Commit message
-     */
-    CREATE: (id: any, title: any) => string;
-    /**
-     * wu:edit commit message (for ready WUs via micro-worktree)
-     * @param {string} id - WU ID (e.g., 'wu-123')
-     * @returns {string} Commit message
-     */
-    EDIT: (id: any) => string;
-    /**
-     * wu:edit spec update commit message (for in_progress WUs in active worktree)
-     * WU-1365: Worktree-aware editing applies edits directly in the worktree
-     * @param {string} id - WU ID (e.g., 'wu-123')
-     * @returns {string} Commit message
-     */
-    SPEC_UPDATE: (id: any) => string;
-    /**
-     * wu:block commit message
-     * @param {string} id - WU ID (e.g., 'wu-123')
-     * @returns {string} Commit message
-     */
-    BLOCK: (id: any) => string;
-    /**
-     * wu:unblock commit message
-     * @param {string} id - WU ID (e.g., 'wu-123')
-     * @returns {string} Commit message
-     */
-    UNBLOCK: (id: any) => string;
-    /**
-     * wu:repair commit message
-     * @param {string} id - WU ID (e.g., 'wu-123')
-     * @returns {string} Commit message
-     */
-    REPAIR: (id: any) => string;
-    /**
-     * Rebase artifact cleanup commit message
-     * WU-1371: Used when rebasing brings in completion artifacts from main
-     * @param {string} id - WU ID (e.g., 'wu-123')
-     * @returns {string} Commit message
-     */
-    REBASE_ARTIFACT_CLEANUP: (id: any) => string;
-    /**
-     * Backlog repair commit message
-     * WU-1506: Used when backlog invariant repair removes duplicates after rebase
-     * @param {string} id - WU ID (e.g., 'wu-123')
-     * @returns {string} Commit message
-     */
-    BACKLOG_REPAIR: (id: any) => string;
-};
-/**
- * Log prefixes for wu- scripts
- *
- * Consistent prefixes for console output
- */
-export declare const LOG_PREFIX: {
-    DONE: string;
-    CLAIM: string;
-    CREATE: string;
-    EDIT: string;
-    DELETE: string;
-    BLOCK: string;
-    UNBLOCK: string;
-    UNLOCK_LANE: string;
-    CLEANUP: string;
-    PRUNE: string;
-    REPAIR: string;
-    CONSISTENCY: string;
-    PREFLIGHT: string;
-    INITIATIVE_PLAN: string;
-    PLAN_CREATE: string;
-    PLAN_LINK: string;
-    PLAN_EDIT: string;
-    PLAN_PROMOTE: 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: any, status: any, worktreePath: any) => string;
-    MISSING_WORKTREE_CLAIMED_REPAIR: string;
-};
-/**
- * Worktree warning messages
- */
-export declare const WORKTREE_WARNINGS: {
-    MISSING_TRACKED_HEADER: string;
-    MISSING_TRACKED_LINE: (worktreePath: any) => string;
-};
-/**
- * File system constants
- *
- * WU-923: Centralized to eliminate hardcoded strings
- */
-export declare const FILE_SYSTEM: {
-    /** Standard file encoding */
-    ENCODING: string;
-    /** UTF-8 encoding (alias for compatibility) */
-    UTF8: string;
-};
-/**
- * Build artifact cleanup globs
- *
- * Centralized glob patterns for worktree artifact cleanup.
- */
-export declare const BUILD_ARTIFACT_GLOBS: {
-    /** Common dist directories inside worktrees */
-    DIST_DIRS: string[];
-    /** TypeScript build info files */
-    TSBUILDINFO_FILES: string[];
-};
-/**
- * Build artifact cleanup ignore patterns
- *
- * Centralized ignore globs for artifact cleanup.
- */
-export declare const BUILD_ARTIFACT_IGNORES: string[];
-/**
- * Process stdio constants
- *
- * Standard values for child_process execSync stdio option.
- */
-export declare const STDIO: {
-    /** Pipe stdout/stderr (capture output) */
-    readonly PIPE: "pipe";
-    /** Inherit stdio from parent process */
-    readonly INHERIT: "inherit";
-    /** Ignore stdio (silent execution) */
-    readonly IGNORE: "ignore";
-};
-/**
- * Configuration file paths
- *
- * WU-923: Centralized config file names
- */
-export declare const CONFIG_FILES: {
-    /** LumenFlow main config */
-    LUMENFLOW_CONFIG: string;
-    /** Lane inference taxonomy */
-    LANE_INFERENCE: string;
-};
-/**
- * Micro-worktree operation identifiers
- *
- * WU-923: Centralized operation names for withMicroWorktree()
- */
-export declare const MICRO_WORKTREE_OPERATIONS: {
-    WU_CREATE: string;
-    WU_EDIT: string;
-    WU_DELETE: string;
-    WU_DONE: string;
-    WU_BLOCK: string;
-    WU_UNBLOCK: string;
-    WU_CLAIM: string;
-    ORPHAN_REPAIR: string;
-    INITIATIVE_EDIT: string;
-    INITIATIVE_BULK_ASSIGN: string;
-};
-/**
- * Telemetry step identifiers
- *
- * WU-1584: Centralized telemetry step names to eliminate string literals.
- */
-export declare const TELEMETRY_STEPS: {
-    GATES: string;
-    /** WU-1467: COS_GATES removed -- was a stub (exit 0), not an authoritative step */
-    PARALLEL_DETECTION: string;
-    PARALLEL_AUTO_REBASE: string;
-};
-/**
- * WU-1747: Skip gates reason constants
- */
-export declare const SKIP_GATES_REASONS: {
-    CHECKPOINT_VALID: string;
-};
-/**
- * WU-1747: Checkpoint-related log messages
- */
-export declare const CHECKPOINT_MESSAGES: {
-    SKIPPING_GATES_VALID: string;
-    CHECKPOINT_LABEL: string;
-    GATES_PASSED_AT: string;
-    COULD_NOT_CREATE: string;
-};
-/**
- * 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;
-};
-/**
- * Process argv indices (WU-1068)
- *
- * Centralized indices for process.argv access to eliminate magic numbers.
- * In Node.js: argv[0] = node, argv[1] = script, argv[2+] = args
- */
-export declare const ARGV_INDICES: {
-    /** Node executable path */
-    NODE: number;
-    /** Script path */
-    SCRIPT: number;
-    /** First user argument */
-    FIRST_ARG: number;
-    /** Second user argument */
-    SECOND_ARG: number;
-};
-/**
- * Display limits for CLI output (WU-1068)
- *
- * Centralized limits for truncating display strings to avoid magic numbers.
- */
-export declare const DISPLAY_LIMITS: {
-    /** Maximum items to show in lists before truncating */
-    LIST_ITEMS: number;
-    /** Maximum items to show in short lists */
-    SHORT_LIST: number;
-    /** Maximum characters for content preview */
-    CONTENT_PREVIEW: number;
-    /** Maximum characters for short preview */
-    SHORT_PREVIEW: number;
-    /** Maximum characters for title display */
-    TITLE: number;
-    /** Maximum characters for truncated title */
-    TRUNCATED_TITLE: number;
-    /** Maximum characters for command preview */
-    CMD_PREVIEW: number;
-    /** Maximum lines to preview from files */
-    FILE_LINES: number;
-    /** Maximum commits to show in lists */
-    COMMITS: number;
-    /** Maximum overlaps to display */
-    OVERLAPS: number;
-};
-/**
- * YAML serialization options
- *
- * Centralized from duplicated { lineWidth: 100 } across wu-* scripts (WU-1256).
- * Use with yaml stringify() options.
- */
-export declare const YAML_OPTIONS: {
-    /** Standard line width for YAML dump (100 chars) */
-    LINE_WIDTH: number;
-    /** No line wrapping (-1 disables wrapping) */
-    NO_WRAP: number;
-};
-/**
- * UI display constants
- *
- * WU-1281: Centralized from hardcoded values in wu-done.ts
- */
-export declare const UI: {
-    /** Width for error/info boxes in console output */
-    ERROR_BOX_WIDTH: number;
-    /** Number of lines to show in status file preview */
-    STATUS_PREVIEW_LINES: number;
-};
-/**
- * Box drawing characters for console output
- *
- * Emergency fix (Session 2): Centralized to eliminate sonarjs/no-duplicate-string errors
- * Used for recovery dialogs and error boxes in wu-* scripts
- */
-export declare const BOX: {
-    /** Top border: ╔══...══╗ (66 chars inside + corners = 68 total) */
-    TOP: string;
-    /** Middle separator: ╠══...══╣ */
-    MID: string;
-    /** Bottom border: ╚══...══╝ */
-    BOT: string;
-    /** Side border for content lines */
-    SIDE: 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;
-    };
-};
-/**
- * Git display constants
- *
- * Emergency fix (Session 2): Centralized from hardcoded magic numbers
- * Used for display truncation of SHAs and session IDs
- */
-export declare const GIT: {
-    /** Standard length for displaying short SHA hashes (e.g., "abc12345") */
-    SHA_SHORT_LENGTH: number;
-    /** Max number of commits to inspect in git log lookbacks */
-    LOG_MAX_COUNT: number;
-};
-/**
- * Real git executable path - MUST bypass tools/shims to prevent recursion.
- *
- * CRITICAL: The git shim (tools/shims/git) calls functions that need to run git
- * commands. If those functions use 'git' (which resolves to the shim), we get
- * infinite recursion: shim → helper → git → shim → helper → git → ...
- *
- * With VS Code extensions making dozens of git calls per second, this causes
- * memory exhaustion within seconds → OOM crash → system reboot.
- *
- * P0 incident: 2025-12-10 server crash due to recursive fork bomb.
- *
- * @see tools/shims/git - The git shim that blocks destructive commands
- * @see tools/lib/wu-helpers.ts - Uses REAL_GIT to avoid recursion
- */
-export declare const REAL_GIT = "/usr/bin/git";
-/**
- * Git command flags
- *
- * Centralized git flag constants to eliminate hardcoded strings.
- * Used by git-adapter.ts and other git operation utilities.
- */
-export declare const GIT_FLAGS: {
-    /** Show abbreviated ref names (for branch name resolution) */
-    ABBREV_REF: string;
-    /** Porcelain format (machine-readable output) */
-    PORCELAIN: string;
-    /** Create new branch and switch to it */
-    BRANCH: string;
-    /** Force flag (long form) */
-    FORCE: string;
-    /** Force flag (short form) */
-    FORCE_SHORT: string;
-    /** Fast-forward only merge */
-    FF_ONLY: string;
-    /** Rebase local commits on top of fetched branch */
-    REBASE: string;
-    /** Check ancestry without output (merge-base) */
-    IS_ANCESTOR: string;
-    /** Set upstream tracking */
-    UPSTREAM: string;
-    /** Delete branch (safe - only if merged) */
-    DELETE: string;
-    /** Delete branch (force - even if not merged) */
-    DELETE_FORCE: string;
-    /** Delete remote branch flag (for git push --delete) */
-    DELETE_REMOTE: string;
-    /** Hard reset flag */
-    HARD: string;
-    /** Soft reset flag */
-    SOFT: string;
-    /** fd flags for clean (force delete directories) */
-    FD_SHORT: string;
-    /** df flags for clean (delete force directories) */
-    DF_SHORT: string;
-    /** No verify flag (skip pre-commit/commit-msg hooks) */
-    NO_VERIFY: string;
-    /** No GPG sign flag (skip commit signing) */
-    NO_GPG_SIGN: string;
-    /** One-line log format */
-    ONELINE: string;
-    /** List heads only (for ls-remote) */
-    HEADS: string;
-    /** Path separator (separates git options from file paths) */
-    PATH_SEPARATOR: string;
-};
-/**
- * Git commands
- *
- * Centralized git command strings to eliminate hardcoded strings.
- * Used for direct git command execution via execSync/execa.
- */
-export declare const GIT_COMMANDS: {
-    /** Git binary */
-    GIT: string;
-    /** Git reset command */
-    RESET: string;
-    /** List tree objects (check file existence on branch) */
-    LS_TREE: string;
-    /** List remote references */
-    LS_REMOTE: string;
-    /** Push command */
-    PUSH: string;
-    /** Pull command */
-    PULL: string;
-    /** Git diff command */
-    DIFF: string;
-    /** Git log command */
-    LOG: string;
-    /** Git merge-base command */
-    MERGE_BASE: string;
-    /** Git rev-parse command */
-    REV_PARSE: string;
-    /** Git diff flags */
-    CACHED: string;
-    NAME_ONLY: string;
-    DIFF_FILTER_ACM: 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;
-};
-/**
- * WU type values
- *
- * WU-1281: Centralized from hardcoded strings in validators
- */
-export declare const WU_TYPES: {
-    DOCUMENTATION: string;
-    PROCESS: string;
-    FEATURE: string;
-    TOOLING: string;
-    BUG: string;
-};
-/**
- * WU exposure values (WU-1998)
- *
- * Defines how a WU exposes its functionality to users.
- * Used to ensure backend features have corresponding UI coverage.
- *
- * @see {@link packages/@lumenflow/cli/src/lib/wu-schema.ts} - Schema validation
- * @see {@link packages/linters/wu-schema-linter.ts} - Linter validation
- */
-export declare const WU_EXPOSURE: {
-    /** User-facing UI changes (pages, components, widgets) */
-    readonly UI: "ui";
-    /** API endpoints that are called by UI or external clients */
-    readonly API: "api";
-    /** Backend-only changes (no user visibility) */
-    readonly BACKEND_ONLY: "backend-only";
-    /** Documentation changes only */
-    readonly DOCUMENTATION: "documentation";
-};
-/**
- * Array of valid exposure values for schema validation
- * Note: Defined as tuple for Zod enum compatibility
- */
-export declare const WU_EXPOSURE_VALUES: readonly ["ui", "api", "backend-only", "documentation"];
-/**
- * Test type keys
- *
- * WU-1281: Centralized from hardcoded keys in validators
- */
-export declare const TEST_TYPES: {
-    UNIT: string;
-    E2E: string;
-    MANUAL: string;
-    INTEGRATION: string;
-};
-/**
- * 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.
- *
- * These patterns identify tests for:
- * - PHI (Protected Health Information) protection
- * - Escalation triggers
- * - Privacy detection
- * - Constitutional enforcement
- * - Safe prompt wrapping
- * - Crisis/emergency handling
- *
- * @type {string[]}
- */
-export declare const SAFETY_CRITICAL_TEST_GLOBS: readonly string[];
-/**
- * Emoji constants for consistent console output
- *
- * WU-1281: Centralized from hardcoded emojis across wu-* scripts
- */
-export declare const EMOJI: {
-    SUCCESS: string;
-    FAILURE: string;
-    WARNING: string;
-    INFO: string;
-    BLOCKED: string;
-    ROCKET: string;
-    WRENCH: string;
-    TARGET: string;
-    MEMO: string;
-    FOLDER: 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: any[];
-    /** Default test structure (includes all test types) */
-    tests: {
-        manual: any[];
-        unit: any[];
-        integration: any[];
-        e2e: any[];
-    };
-    /** Default artifacts (empty - wu:done adds stamp) */
-    artifacts: any[];
-    /** Default dependencies (no blockers) */
-    dependencies: any[];
-    /** Default risks (none identified) */
-    risks: any[];
-    /** Default notes (empty string, not undefined) */
-    notes: string;
-    /** Default review requirement (agent-completed WUs) */
-    requires_review: boolean;
-};
-/**
- * Lane-to-code_paths validation patterns (WU-1372)
- *
- * Advisory patterns to warn when a WU's lane doesn't match its code_paths.
- * Each lane parent can define paths to exclude (paths that shouldn't appear
- * for that lane) and paths that are exceptionally allowed.
- *
- * Validation is advisory only - never blocks wu:claim or wu:done.
- *
- * WU-1068: Removed hardcoded @patientpath references. These patterns
- * should be configured in .lumenflow.config.yaml per-project.
- *
- * @see {@link packages/@lumenflow/cli/src/lib/lane-validator.ts} - Validation logic
- */
-export declare const LANE_PATH_PATTERNS: {
-    /**
-     * Operations lane should not touch prompt-related paths.
-     * These paths belong to the Intelligence lane.
-     */
-    Operations: {
-        exclude: string[];
-        allowExceptions: any[];
-    };
-    /**
-     * Intelligence lane should not touch tooling paths.
-     * Exception: tools/lib/prompt-* files are Intelligence-owned.
-     */
-    Intelligence: {
-        exclude: string[];
-        allowExceptions: string[];
-    };
-};
-/**
- * Process detection constants for background process warning (WU-1381)
- *
- * Used by process-detector.ts to identify processes that may interfere
- * with wu:done gates execution.
- */
-export declare const PROCESS_DETECTION: {
-    /**
-     * Process names that commonly interfere with gates execution.
-     * These processes may:
-     * - Write to stdout/stderr (causing mixed output)
-     * - Hold file locks that may cause test failures
-     * - Consume resources that affect gate performance
-     */
-    INTERFERING_NAMES: string[];
-    /** Maximum characters to display for command in warnings */
-    CMD_DISPLAY_LIMIT: number;
-};
-/**
- * CLI argument flags
- *
- * Centralized command-line argument strings to eliminate hardcoded flags.
- * Used across wu-* scripts, gates, and validation tools.
- */
-export declare const CLI_FLAGS: {
-    DRY_RUN: string;
-    EXECUTE: string;
-    HELP: string;
-    HELP_SHORT: string;
-    VERBOSE: string;
-    FIX: string;
-    JSON: string;
-    FORCE: string;
-    DOCS_ONLY: string;
-    FULL_LINT: string;
-    FULL_TESTS: string;
-    FULL_COVERAGE: string;
-    COVERAGE_MODE: string;
-    WU: string;
-    ID: string;
-    ALL: string;
-    CHECK: string;
-    TIER: string;
-    AGENT_TYPE: string;
-    DESCRIPTION: string;
-    ACCEPTANCE: string;
-    VALIDATE: string;
-    REASON: string;
-    WEEK: string;
-    SINCE: string;
-};
-/**
- * pnpm/npm command flags
- *
- * Centralized package manager flag strings.
- */
-export declare const PKG_FLAGS: {
-    FILTER: string;
-    FROZEN_LOCKFILE: string;
-    /** WU-1527: Required for pnpm add at workspace root in monorepos */
-    WORKSPACE_ROOT: string;
-    SAVE_DEV: string;
-    SAVE_EXACT: string;
-};
-/**
- * ESLint command flags
- *
- * Centralized ESLint CLI flag strings.
- */
-export declare const ESLINT_FLAGS: {
-    MAX_WARNINGS: string;
-    NO_WARN_IGNORED: string;
-    CACHE: string;
-    CACHE_STRATEGY: string;
-    CACHE_LOCATION: string;
-    PASS_ON_UNPRUNED: string;
-};
-/**
- * pnpm script names
- *
- * Centralized script names for package.json commands.
- */
-export declare const SCRIPTS: {
-    LINT: string;
-    TEST: string;
-    TEST_UNIT: string;
-    BUILD: string;
-    FORMAT: string;
-    FORMAT_CHECK: string;
-    TYPECHECK: string;
-    DEV: string;
-    SPEC_LINTER: string;
-    /** WU-1467: Stub script -- not an enforced gate. Retained for script surface only. */
-    PROMPTS_LINT: string;
-    RUN: string;
-    GATES: string;
-    /** WU-1467: Stub script -- not an enforced gate. Retained for script surface only. */
-    COS_GATES: string;
-    PRETTIER: string;
-    /** WU-1467: Root script surface for tasks:validate (delegates to wu:validate --all) */
-    TASKS_VALIDATE: string;
-};
-/**
- * Gate names for quality gates
- *
- * Centralized gate identifiers for gates.ts and telemetry.
- */
-export declare const GATE_NAMES: {
-    /** WU-2252: Invariants check (runs first, non-bypassable) */
-    INVARIANTS: string;
-    FORMAT_CHECK: string;
-    SPEC_LINTER: string;
-    /** WU-1467: PROMPTS_LINT removed -- was a stub (exit 0), not an authoritative gate */
-    BACKLOG_SYNC: string;
-    SUPABASE_DOCS_LINTER: string;
-    LINT: string;
-    TYPECHECK: string;
-    TEST: string;
-    COVERAGE: string;
-    /** WU-2062: Safety-critical tests (always run) */
-    SAFETY_CRITICAL_TEST: string;
-    /** WU-2062: Integration tests (for high-risk changes) */
-    INTEGRATION_TEST: string;
-    /** WU-2315: System map validation (warn-only until orphan docs are indexed) */
-    SYSTEM_MAP_VALIDATE: string;
-    /** WU-1191: Lane health check (overlap detection) */
-    LANE_HEALTH: string;
-    /** WU-1315: Onboarding smoke test (init + wu:create validation) */
-    ONBOARDING_SMOKE_TEST: string;
-};
-/**
- * Gate command sentinels (special values for non-shell commands)
- *
- * These are not shell commands but trigger special handling in gates.ts.
- */
-export declare const GATE_COMMANDS: {
-    /** WU-2252: Triggers invariants check */
-    INVARIANTS: string;
-    /** Triggers incremental lint (only changed files) */
-    INCREMENTAL: string;
-    /** Triggers incremental tests (only tests related to changed files) - WU-1920 */
-    INCREMENTAL_TEST: string;
-    /** Triggers coverage gate check */
-    COVERAGE_GATE: string;
-    /** WU-2062: Triggers safety-critical tests (always run) */
-    SAFETY_CRITICAL_TEST: string;
-    /** WU-2062: Triggers tiered test execution based on risk */
-    TIERED_TEST: string;
-    /** WU-1315: Triggers onboarding smoke test */
-    ONBOARDING_SMOKE_TEST: string;
-};
-/**
- * CLI mode flags
- *
- * Command-line mode arguments.
- */
-export declare const CLI_MODES: {
-    LOCAL: string;
-};
-/**
- * Prettier command flags
- *
- * Centralized prettier CLI flag strings.
- */
-export declare const PRETTIER_FLAGS: {
-    WRITE: string;
-};
-/**
- * Package manager commands
- *
- * Centralized pnpm command strings.
- */
-export declare const PKG_MANAGER = "pnpm";
-/**
- * Package manager subcommands
- *
- * Centralized pnpm subcommand strings.
- */
-export declare const PKG_COMMANDS: {
-    INSTALL: string;
-    /** WU-1527: Used by lumenflow-upgrade and deps-add */
-    ADD: string;
-    REMOVE: string;
-};
-/**
- * Package names (monorepo workspaces)
- *
- * Centralized package names for --filter usage.
- * WU-1068: Changed from @patientpath to @lumenflow for framework reusability.
- * Project-specific packages should be configured in .lumenflow.config.yaml.
- */
-export declare const PACKAGES: {
-    WEB: string;
-    APPLICATION: string;
-    DOMAIN: string;
-    INFRASTRUCTURE: string;
-};
-/**
- * Directory paths within the monorepo
- *
- * Centralized directory path strings.
- */
-export declare const DIRECTORIES: {
-    APPS_WEB: string;
-    WORKTREES: string;
-    AI: string;
-    CLAUDE: string;
-    CLAUDE_HOOKS: string;
-    DOCS: string;
-    PACKAGES: string;
-    TOOLS: string;
-    MEMORY_BANK: string;
-    WU_DIR: string;
-    INITIATIVES_DIR: string;
-    BACKLOG_PATH: string;
-    STATUS_PATH: string;
-};
-/**
- * Claude Code hook script constants (WU-1394)
- *
- * Centralized constants for Claude Code enforcement and recovery hooks.
- * Used by enforcement-generator.ts, enforcement-sync.ts, and init.ts.
- *
- * @see packages/@lumenflow/cli/src/hooks/enforcement-generator.ts
- * @see packages/@lumenflow/cli/src/hooks/enforcement-sync.ts
- */
-export declare const CLAUDE_HOOKS: {
-    /** Hook script filenames */
-    readonly SCRIPTS: {
-        readonly ENFORCE_WORKTREE: "enforce-worktree.sh";
-        readonly REQUIRE_WU: "require-wu.sh";
-        readonly WARN_INCOMPLETE: "warn-incomplete.sh";
-        readonly PRE_COMPACT_CHECKPOINT: "pre-compact-checkpoint.sh";
-        readonly SESSION_START_RECOVERY: "session-start-recovery.sh";
-        /** WU-1471: Auto-checkpoint hook for PostToolUse and SubagentStop events */
-        readonly AUTO_CHECKPOINT: "auto-checkpoint.sh";
-        /** WU-1502: PostToolUse Bash hook for dirty-main warning */
-        readonly WARN_DIRTY_MAIN: "warn-dirty-main.sh";
-    };
-    /** Hook command path prefix (uses Claude Code's $CLAUDE_PROJECT_DIR variable) */
-    readonly PATH_PREFIX: "$CLAUDE_PROJECT_DIR/.claude/hooks";
-    /** Hook matchers for settings.json */
-    readonly MATCHERS: {
-        readonly ALL: ".*";
-        readonly WRITE_EDIT: "Write|Edit";
-        readonly COMPACT: "compact";
-        readonly RESUME: "resume";
-        readonly CLEAR: "clear";
-        /** WU-1471: Matcher for SubagentStop hook event */
-        readonly SUBAGENT_STOP: ".*";
-        /** WU-1502: Matcher for Bash tool PostToolUse */
-        readonly BASH: "Bash";
-    };
-    /** Template paths (relative to templates directory) */
-    readonly TEMPLATES: {
-        readonly SETTINGS: "vendors/claude/.claude/settings.json.template";
-        readonly PRE_COMPACT: "vendors/claude/.claude/hooks/pre-compact-checkpoint.sh";
-        readonly SESSION_START: "vendors/claude/.claude/hooks/session-start-recovery.sh";
-    };
-};
-/** Build full hook command path from script name */
-export declare const getHookCommand: (scriptName: string) => string;
-/**
- * ESLint cache strategy values
- */
-export declare const CACHE_STRATEGIES: {
-    CONTENT: string;
-    METADATA: string;
-};
-/**
- * Process stdio modes
- *
- * Centralized stdio configuration values for child_process operations.
- */
-export declare const STDIO_MODES: {
-    /** Inherit stdio from parent process (shows output in console) */
-    readonly INHERIT: "inherit";
-    /** Pipe stdio to parent process (capture output) */
-    readonly PIPE: "pipe";
-    /** Ignore stdio (discard output) */
-    readonly IGNORE: "ignore";
-};
-/**
- * Process exit codes
- *
- * Standard exit code values for CLI scripts.
- */
-export declare const EXIT_CODES: {
-    /** Success exit code */
-    SUCCESS: number;
-    /** Generic error exit code */
-    ERROR: number;
-    /** Fatal or distinct failure exit code */
-    FAILURE: number;
-};
-/**
- * Stream error codes
- *
- * WU-1233: Error codes for stream operations (stdout/stderr).
- * Used by StreamErrorHandler for graceful pipe closure handling.
- */
-export declare const STREAM_ERRORS: {
-    /**
-     * EPIPE error code
-     *
-     * Occurs when writing to a pipe whose read end has been closed.
-     * This is normal behavior when CLI output is piped through head/tail.
-     * Unix convention: exit with code 0 on EPIPE (consumer got what it needed).
-     */
-    readonly EPIPE: "EPIPE";
-};
-/**
- * ESLint command names
- *
- * Centralized ESLint command strings.
- */
-export declare const ESLINT_COMMANDS: {
-    /** ESLint CLI command */
-    ESLINT: string;
-};
-/**
- * ESLint default values
- *
- * Default configuration values for ESLint operations.
- */
-export declare const ESLINT_DEFAULTS: {
-    /**
-     * Maximum allowed warnings
-     *
-     * WU-1866: Temporarily increased from 0 to 100 to unblock gates.
-     * There are ~82 pre-existing warnings that need proper fixes.
-     */
-    MAX_WARNINGS: string;
-};
-/**
- * Git command combinations
- *
- * Full git command strings for common operations.
- */
-export declare const GIT_COMMAND_STRINGS: {
-    /** Get diff of cached (staged) files */
-    DIFF_CACHED: string;
-    /** Get names of cached files */
-    DIFF_CACHED_NAMES: string;
-    /** Get names of cached files (added, copied, modified) */
-    DIFF_CACHED_ACM: string;
-    /** Get cached diff with zero context (used for hook validation) */
-    DIFF_CACHED_UNIFIED_ZERO: string;
-    /** Get current branch name */
-    REV_PARSE_ABBREV_REF_HEAD: string;
-};
-/**
- * Path patterns for WU-related files
- */
-export declare const PATH_PATTERNS: {
-    /** Matches WU YAML paths in both legacy and current locations */
-    WU_YAML: RegExp;
-    /** Matches stamp file paths */
-    STAMP: RegExp;
-};
-/**
- * Common shell commands
- *
- * Centralized command names for child_process operations.
- */
-export declare const SHELL_COMMANDS: {
-    /** Which command (check if executable exists) */
-    WHICH: string;
-    /** Cat command (concatenate files) */
-    CAT: string;
-    /** Node.js executable */
-    NODE: string;
-};
-/**
- * External tool commands
- *
- * Centralized tool command names.
- */
-export declare const TOOLS: {
-    /** Gitleaks secret scanner */
-    GITLEAKS: string;
-    /** ESLint linter */
-    ESLINT: string;
-    /** Prettier formatter */
-    PRETTIER: string;
-    /** TypeScript compiler */
-    TSC: string;
-};
-/**
- * Gitleaks command arguments
- *
- * Centralized gitleaks CLI arguments.
- */
-export declare const GITLEAKS_ARGS: {
-    /** Protect mode (scan staged files) */
-    PROTECT: string;
-    /** Staged flag */
-    STAGED: string;
-    /** Verbose output */
-    VERBOSE: string;
-};
-/**
- * Prettier command arguments
- *
- * Centralized prettier CLI arguments.
- */
-export declare const PRETTIER_ARGS: {
-    /** Check formatting without writing */
-    CHECK: string;
-    /** List files with formatting differences */
-    LIST_DIFFERENT: string;
-};
-/**
- * Audit command arguments
- *
- * Centralized pnpm audit CLI arguments.
- */
-export declare const AUDIT_ARGS: {
-    /** Audit subcommand */
-    AUDIT: string;
-    /** Audit level flag */
-    AUDIT_LEVEL_MODERATE: string;
-    /** Ignore registry errors */
-    IGNORE_REGISTRY_ERRORS: string;
-    /** Auto-fix flag */
-    FIX: string;
-};
-/**
- * Script file paths
- *
- * Centralized paths to validation scripts.
- */
-export declare const SCRIPT_PATHS: {
-    /** Prompt registry validation */
-    VALIDATE_PROMPT_REGISTRY: string;
-};
-/**
- * Known package names for vulnerability tracking
- *
- * Package identifiers used in dependency auditing.
- */
-export declare const KNOWN_PACKAGES: {
-    /** node-forge crypto library */
-    NODE_FORGE: string;
-    /** Next.js framework */
-    NEXT: string;
-    /** jsPDF PDF generation library */
-    JSPDF: string;
-};
-/**
- * Error codes and messages
- *
- * Centralized error identifiers for consistency.
- */
-export declare const ERROR_CODES: {
-    /** Socket timeout error */
-    ERR_SOCKET_TIMEOUT: string;
-    /** Timeout error code */
-    ETIMEDOUT: string;
-};
-/**
- * WU-1174: Lock directory name constant
- *
- * Defined separately so it can be used both in LUMENFLOW_PATHS.LOCK_DIR
- * and for test isolation in cleanup-lock.ts/merge-lock.ts.
- */
-export declare const LOCK_DIR_NAME = ".lumenflow-locks";
-/**
- * LumenFlow directory paths
- *
- * Centralized paths for .lumenflow directory structure to eliminate hardcoded strings.
- * Used by telemetry, agent-session, agent-incidents, memory, and commands-logger modules.
- */
-export declare const LUMENFLOW_PATHS: {
-    /** Base directory for all LumenFlow runtime data */
-    BASE: string;
-    /** WU state store directory */
-    STATE_DIR: string;
-    /** Stamp directory (WU completion markers) */
-    STAMPS_DIR: string;
-    /** Archive directory for old WU events (WU-1430) */
-    ARCHIVE_DIR: string;
-    /** Merge lock file (runtime coordination, WU-1747) */
-    MERGE_LOCK: string;
-    /** Base telemetry directory */
-    TELEMETRY: string;
-    /** Flow log file (WU flow events) */
-    FLOW_LOG: string;
-    /** Agent sessions directory */
-    SESSIONS: string;
-    /** Agent incidents directory */
-    INCIDENTS: string;
-    /** Git commands log file */
-    COMMANDS_LOG: string;
-    /** Memory layer directory */
-    MEMORY_DIR: string;
-    /** Memory layer JSONL file */
-    MEMORY_JSONL: string;
-    /** Audit log for tool calls */
-    AUDIT_LOG: string;
-    /** Feedback drafts directory */
-    FEEDBACK_DRAFTS: string;
-    /** Feedback index file */
-    FEEDBACK_INDEX: string;
-    /** Current session file */
-    SESSION_CURRENT: string;
-    /** WU events log */
-    WU_EVENTS: string;
-    /** Lock files directory (lane locks - persisted) */
-    LOCKS_DIR: string;
-    /** Force bypass audit log */
-    FORCE_BYPASSES: string;
-    /** Test baseline file for ratchet pattern (WU-1430) */
-    TEST_BASELINE: string;
-    /** Templates directory (WU-1430) */
-    TEMPLATES_DIR: string;
-    /** Spawn prompt templates (WU-1430) */
-    SPAWN_PROMPT_DIR: string;
-    /** Template manifest file (WU-1430) */
-    TEMPLATE_MANIFEST: string;
-    /** Skills directory for agent skills (WU-1430) */
-    SKILLS_DIR: string;
-    /** Agents directory for agent definitions (WU-1430) */
-    AGENTS_DIR: string;
-    /** Methodology log for spawn telemetry (WU-1430) */
-    METHODOLOGY_LOG: string;
-    /** Prompt metrics cache (WU-1430) */
-    PROMPT_METRICS: string;
-    /** Prompt lint results (WU-1430) */
-    PROMPT_LINT: string;
-    /** Recovery markers directory (WU-1430) */
-    RECOVERY_DIR: string;
-    /** Checkpoints directory (WU-1430) */
-    CHECKPOINTS_DIR: string;
-    /** WU-1471: Hook counters directory for auto-checkpoint interval tracking */
-    HOOK_COUNTERS_DIR: string;
-    /** Cache directory under user home (WU-1430) */
-    HOME_CACHE: string;
-    /**
-     * WU-1174: Runtime lock directory for merge/cleanup locks
-     *
-     * These locks are transient and should NOT be created in the main checkout
-     * because wu:done runs from main. Using os.tmpdir() ensures:
-     * 1. Locks don't pollute the git working tree
-     * 2. Locks work across processes on the same machine
-     * 3. No "Working tree is not clean" errors if process crashes
-     *
-     * Note: Lane locks still use LOCKS_DIR (.lumenflow/locks) because they need
-     * to persist across sessions and be visible to other agents.
-     */
-    LOCK_DIR: string;
-};
-/**
- * File extensions
- *
- * Centralized file extension strings to avoid magic strings.
- */
-export declare const FILE_EXTENSIONS: {
-    /** Newline-delimited JSON format */
-    NDJSON: string;
-    /** Markdown format */
-    MARKDOWN: string;
-    /** YAML format */
-    YAML: string;
-    /** Log format */
-    LOG: string;
-    /** Stamp files (completion markers) */
-    STAMP: string;
-};
-/**
- * String formatting constants
- *
- * Centralized string literals for consistent formatting across scripts.
- * Eliminates hardcoded '\n', ' ', etc. throughout the codebase.
- */
-export declare const STRING_LITERALS: {
-    /** Newline character */
-    NEWLINE: string;
-    /** Double newline (paragraph separator) */
-    DOUBLE_NEWLINE: string;
-    /** Space character */
-    SPACE: string;
-    /** Empty string */
-    EMPTY: string;
-    /** Tab character */
-    TAB: string;
-    /** Comma separator */
-    COMMA: string;
-    /** Colon separator */
-    COLON: string;
-    /** Dash/hyphen */
-    DASH: string;
-    /** Forward slash */
-    SLASH: string;
-};
-/**
- * Path-related constants
- *
- * WU-1062: Centralized path literals for lumenflow-home and spec-branch operations.
- */
-export declare const PATH_LITERALS: {
-    /** Tilde prefix for home directory expansion (e.g., ~/path) */
-    TILDE_PREFIX: string;
-    /** Tilde character for home directory */
-    TILDE: string;
-    /** Plan file suffix for WU plans */
-    PLAN_FILE_SUFFIX: string;
-    /** Trailing slash regex pattern */
-    TRAILING_SLASH_REGEX: RegExp;
-    /** .lumenflow path prefix for internal path detection (WU-1430) */
-    LUMENFLOW_PREFIX: string;
-    /** Current directory prefix for repo-internal paths (WU-1430) */
-    CURRENT_DIR_PREFIX: string;
-};
-/**
- * Slice lengths for path operations
- *
- * WU-1062: Magic numbers extracted for path manipulation.
- */
-export declare const PATH_SLICE_LENGTHS: {
-    /** Length of '~/' prefix for tilde expansion */
-    TILDE_PREFIX_LENGTH: number;
-    /** Length of '/' for leading slash removal */
-    LEADING_SLASH_LENGTH: number;
-};
-/**
- * Convert lane name to kebab-case using change-case library
- *
- * Provides null-safe wrapper around paramCase for lane naming.
- * Handles sub-lanes with colon separator and special characters.
- *
- * @param {string|null|undefined} lane - Lane name (e.g., 'Operations: Tooling')
- * @returns {string} Kebab-case lane (e.g., 'operations-tooling')
- *
- * @example
- * toKebab('Operations: Tooling') // 'operations-tooling'
- * toKebab('Core Systems') // 'core-systems'
- * toKebab('Intelligence') // 'intelligence'
- * toKebab(null) // ''
- * toKebab(undefined) // ''
- */
-export declare function toKebab(lane: any): string;
-/**
- * Generate worktree path from lane and WU ID
- *
- * @param {string} lane - Lane name
- * @param {string} id - WU ID
- * @returns {string} Worktree path (e.g., 'worktrees/operations-tooling-wu-123')
- */
-export declare function getWorktreePath(lane: any, id: any): string;
-/**
- * Generate lane branch name from lane and WU ID
- *
- * @param {string} lane - Lane name
- * @param {string} id - WU ID
- * @returns {string} Branch name (e.g., 'lane/operations-tooling/wu-123')
- */
-export declare function getLaneBranch(lane: any, id: any): string;
-/**
- * File tool constants (WU-1403)
- *
- * Centralized strings for file:read, file:write, file:edit tools.
- * Prevents duplicate string literals and hardcoded magic values.
- */
-export declare const FILE_TOOLS: {
-    /** Tool name prefixes */
-    NAMES: {
-        READ: string;
-        WRITE: string;
-        EDIT: string;
-        DELETE: string;
-    };
-    /** Tool domain */
-    DOMAIN: string;
-    /** Permission levels */
-    PERMISSIONS: {
-        READ: string;
-        WRITE: string;
-    };
-    /** Worktree instruction templates (WU-1403: provides reusable instruction strings) */
-    WORKTREE_INSTRUCTIONS: {
-        CLAIM_COMMAND: string;
-        CD_COMMAND: string;
-        DOC_REFERENCE: string;
-    };
-};
-/**
- * PHI (Protected Health Information) error codes (WU-1404)
- *
- * Error codes for PHI detection in file tools.
- * Used by file:write and file:edit to block PHI leakage.
- *
- * WU-1068: PHI scanning is healthcare-specific functionality.
- * Enable via PHI_CONFIG.ENABLED flag or .lumenflow.config.yaml phi.enabled: true
- */
-export declare const PHI_ERRORS: {
-    /** PHI detected in content - write blocked */
-    PHI_DETECTED: string;
-    /** PHI override requested - audit logged */
-    PHI_OVERRIDE_ALLOWED: string;
-};
-/**
- * PHI scanning configuration (WU-1068)
- *
- * Controls whether PHI (Protected Health Information) scanning is enabled.
- * This is healthcare-specific functionality (NHS numbers, UK postcodes)
- * that should only be enabled for healthcare projects.
- *
- * Projects can enable via:
- * 1. Setting PHI_CONFIG.ENABLED = true in code
- * 2. Setting LUMENFLOW_PHI_ENABLED=1 environment variable
- * 3. Adding phi.enabled: true to .lumenflow.config.yaml
- */
-export declare const PHI_CONFIG: {
-    /**
-     * Whether PHI scanning is enabled
-     * Default: false - projects must explicitly opt-in
-     */
-    ENABLED: boolean;
-    /**
-     * Whether to block on PHI detection (true) or just warn (false)
-     */
-    BLOCKING: boolean;
-};
-/**
- * Readiness summary UI constants (WU-1620)
- *
- * Constants for the readiness summary box displayed after wu:create and wu:edit.
- * Provides visual feedback on whether WU is ready for wu:claim.
- *
- * @see tools/wu-create.ts - displayReadinessSummary()
- * @see tools/wu-edit.ts - displayReadinessSummary()
- */
-export declare const READINESS_UI: {
-    /** Box width (inner content area) */
-    BOX_WIDTH: number;
-    /** Box drawing characters */
-    BOX: {
-        TOP_LEFT: string;
-        TOP_RIGHT: string;
-        BOTTOM_LEFT: string;
-        BOTTOM_RIGHT: string;
-        HORIZONTAL: string;
-        VERTICAL: string;
-    };
-    /** Status messages */
-    MESSAGES: {
-        READY_YES: string;
-        READY_NO: string;
-        MISSING_HEADER: string;
-        BULLET: string;
-    };
-    /** Error truncation length */
-    ERROR_MAX_LENGTH: number;
-    ERROR_TRUNCATE_LENGTH: number;
-    TRUNCATION_SUFFIX: string;
-    /** Padding calculations (relative to BOX_WIDTH) */
-    PADDING: {
-        READY_YES: number;
-        READY_NO: number;
-        MISSING_HEADER: number;
-        ERROR_BULLET: number;
-    };
-};
-/**
- * Get project root directory from a module URL
- *
- * WU-923: Centralized path resolution to eliminate '../..' magic strings
- *
- * @param {string} moduleUrl - import.meta.url of the calling module
- * @returns {string} Absolute path to project root
- *
- * @example
- * import { getProjectRoot } from './lib/wu-constants.js';
- * const projectRoot = getProjectRoot(import.meta.url);
- */
-export declare function getProjectRoot(moduleUrl: any): 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 {DiscoverSafetyTestsOptions} options - Discovery options
- * @returns {Promise<string[]>} List of discovered test file paths
- */
-export declare function discoverSafetyTests(options?: DiscoverSafetyTestsOptions): Promise<any[]>;
-/**
- * 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.
- *
- * @param {DiscoverSafetyTestsOptions} options - Validation options
- * @returns {Promise<{valid: boolean, missingTests: string[], foundTests: string[], error?: string}>}
- */
-export declare function validateSafetyTestsExist(options?: DiscoverSafetyTestsOptions): Promise<{
-    valid: boolean;
-    missingTests: any[];
-    foundTests: any[];
-    error: string;
-}>;
-/**
- * Context validation constants (WU-1090)
- *
- * Constants for the context-aware state machine for WU lifecycle commands.
- * Supports unified context model, declarative command requirements,
- * smart validation, and recovery paths.
- */
-export declare const CONTEXT_VALIDATION: {
-    /** Location types for WU operations */
-    readonly LOCATION_TYPES: {
-        /** Main checkout (not a worktree) */
-        readonly MAIN: "main";
-        /** Inside a worktree */
-        readonly WORKTREE: "worktree";
-        /** Detached HEAD state */
-        readonly DETACHED: "detached";
-        /** Unknown location (not a git repo or error) */
-        readonly UNKNOWN: "unknown";
-    };
-    /** Validation error codes */
-    readonly ERROR_CODES: {
-        /** Command run from wrong location type */
-        readonly WRONG_LOCATION: "WRONG_LOCATION";
-        /** Target WU does not exist */
-        readonly WU_NOT_FOUND: "WU_NOT_FOUND";
-        /** WU with this ID already exists */
-        readonly WU_ALREADY_EXISTS: "WU_ALREADY_EXISTS";
-        /** WU in unexpected status for command */
-        readonly WRONG_WU_STATUS: "WRONG_WU_STATUS";
-        /** Lane already has WU in progress */
-        readonly LANE_OCCUPIED: "LANE_OCCUPIED";
-        /** Worktree already exists for WU */
-        readonly WORKTREE_EXISTS: "WORKTREE_EXISTS";
-        /** Expected worktree not found */
-        readonly WORKTREE_MISSING: "WORKTREE_MISSING";
-        /** Gates haven't run or failed */
-        readonly GATES_NOT_PASSED: "GATES_NOT_PASSED";
-        /** Uncommitted changes exist */
-        readonly DIRTY_GIT: "DIRTY_GIT";
-        /** Cannot reach origin remote */
-        readonly REMOTE_UNAVAILABLE: "REMOTE_UNAVAILABLE";
-        /** YAML and state store disagree */
-        readonly INCONSISTENT_STATE: "INCONSISTENT_STATE";
-    };
-    /** Recovery action types */
-    readonly RECOVERY_ACTIONS: {
-        /** Reconcile state and continue working (preserves work) */
-        readonly RESUME: "resume";
-        /** Discard worktree, reset WU to ready */
-        readonly RESET: "reset";
-        /** Remove all artifacts completely (requires --force) */
-        readonly NUKE: "nuke";
-        /** Remove leftover worktree (for done WUs) */
-        readonly CLEANUP: "cleanup";
-    };
-    /** Recovery issue codes */
-    readonly RECOVERY_ISSUES: {
-        /** Worktree exists but WU status is "ready" */
-        readonly PARTIAL_CLAIM: "PARTIAL_CLAIM";
-        /** WU is "in_progress" but worktree does not exist */
-        readonly ORPHAN_CLAIM: "ORPHAN_CLAIM";
-        /** YAML status differs from state store */
-        readonly INCONSISTENT_STATE: "INCONSISTENT_STATE";
-        /** Branch exists but worktree does not */
-        readonly ORPHAN_BRANCH: "ORPHAN_BRANCH";
-        /** Lock file from different WU */
-        readonly STALE_LOCK: "STALE_LOCK";
-        /** WU is done but worktree was not cleaned up */
-        readonly LEFTOVER_WORKTREE: "LEFTOVER_WORKTREE";
-    };
-    /** Predicate severity levels */
-    readonly SEVERITY: {
-        /** Blocks command execution */
-        readonly ERROR: "error";
-        /** Shows warning but allows execution */
-        readonly WARNING: "warning";
-    };
-    /** Performance thresholds */
-    readonly THRESHOLDS: {
-        /** Max context computation time (ms) - acceptance criterion */
-        readonly CONTEXT_COMPUTATION_MS: 100;
-        /** Max stale lock age (hours) */
-        readonly STALE_LOCK_HOURS: 24;
-    };
-    /** Feature flag keys for .lumenflow.config.yaml */
-    readonly FEATURE_FLAGS: {
-        /** Enable context-aware validation */
-        readonly CONTEXT_VALIDATION: "context_validation";
-        /** Validation behavior: 'off' | 'warn' | 'error' */
-        readonly VALIDATION_MODE: "validation_mode";
-        /** Show next steps after successful commands */
-        readonly SHOW_NEXT_STEPS: "show_next_steps";
-        /** Enable wu:recover command */
-        readonly RECOVERY_COMMAND: "recovery_command";
-    };
-    /** Validation modes */
-    readonly VALIDATION_MODES: {
-        /** No validation (legacy behavior) */
-        readonly OFF: "off";
-        /** Show warnings but proceed */
-        readonly WARN: "warn";
-        /** Block on validation failures */
-        readonly ERROR: "error";
-    };
-    /** Command names for the registry */
-    readonly COMMANDS: {
-        readonly WU_CREATE: "wu:create";
-        readonly WU_CLAIM: "wu:claim";
-        readonly WU_PREP: "wu:prep";
-        readonly WU_DONE: "wu:done";
-        readonly WU_BLOCK: "wu:block";
-        readonly WU_UNBLOCK: "wu:unblock";
-        readonly WU_STATUS: "wu:status";
-        readonly WU_RECOVER: "wu:recover";
-        readonly GATES: "gates";
-    };
-};
-/**
- * Git hook error messages (WU-1357)
- *
- * Educational, structured messages for git hook blocks.
- * Follows the "message bag" pattern: TITLE, WHY, ACTIONS, HELP, BYPASS.
- *
- * Design principles:
- * - Explain WHY before showing WHAT to do
- * - Provide multiple paths forward (not just one command)
- * - Put emergency bypass LAST with clear warnings
- * - Include help resources for learning
- *
- * @see .husky/hooks/pre-commit.mjs - Primary consumer
- */
-export declare const HOOK_MESSAGES: {
-    /**
-     * Main branch protection block message components
-     */
-    readonly MAIN_BRANCH_BLOCK: {
-        /** Box drawing for visual structure */
-        readonly BOX: {
-            readonly TOP: "══════════════════════════════════════════════════════════════";
-            readonly DIVIDER: "──────────────────────────────────────────────────────────────";
-        };
-        /** Title shown at the top */
-        readonly TITLE: (branch: string) => string;
-        /** Educational explanation of WHY the block exists */
-        readonly WHY: {
-            readonly HEADER: "WHY THIS HAPPENS";
-            readonly LINES: readonly ["LumenFlow protects main from direct commits to ensure:", "  • All work is tracked in Work Units (WUs)", "  • Changes can be reviewed and coordinated", "  • Parallel work across lanes stays isolated"];
-        };
-        /** Action paths - multiple ways forward */
-        readonly ACTIONS: {
-            readonly HEADER: "WHAT TO DO";
-            readonly HAVE_WU: {
-                readonly HEADER: "1. If you have a Work Unit to implement:";
-                readonly COMMANDS: readonly ["pnpm wu:claim --id WU-XXXX --lane \"<Lane>\"", "cd worktrees/<lane>-wu-xxxx"];
-                readonly NOTE: "Then make your commits there";
-            };
-            readonly NEED_WU: {
-                readonly HEADER: "2. If you need to create a new Work Unit:";
-                readonly COMMANDS: readonly ["pnpm wu:create --lane \"<Lane>\" --title \"Your task\""];
-                readonly NOTE: "This generates a WU ID, then claim it as above";
-            };
-            readonly LIST_LANES: {
-                readonly HEADER: "3. Not sure what lane to use?";
-                readonly COMMANDS: readonly ["pnpm wu:list-lanes"];
-            };
-        };
-        /** Help resources */
-        readonly HELP: {
-            readonly HEADER: "NEED HELP?";
-            readonly RESOURCES: readonly ["• Read: LUMENFLOW.md (workflow overview)", "• Read: docs/04-operations/_frameworks/lumenflow/agent/onboarding/", "• Run:  pnpm wu:help"];
-        };
-        /** Emergency bypass (shown last, with warnings) */
-        readonly BYPASS: {
-            readonly HEADER: "EMERGENCY BYPASS (logged, use sparingly)";
-            readonly WARNING: "Bypasses are audit-logged. Only use for genuine emergencies.";
-            readonly COMMAND: "LUMENFLOW_FORCE=1 LUMENFLOW_FORCE_REASON=\"<reason>\" git commit ...";
-        };
-    };
-    /**
-     * Worktree discipline block message components
-     */
-    readonly WORKTREE_BLOCK: {
-        readonly TITLE: "LANE BRANCH WORK SHOULD BE IN WORKTREE";
-        readonly WHY: "Worktrees provide isolation for parallel work. Working on a lane branch from the main checkout bypasses this isolation.";
-    };
-};
-/** Type for location types */
-export type LocationType = (typeof CONTEXT_VALIDATION.LOCATION_TYPES)[keyof typeof CONTEXT_VALIDATION.LOCATION_TYPES];
-/** Type for validation error codes */
-export type ValidationErrorCode = (typeof CONTEXT_VALIDATION.ERROR_CODES)[keyof typeof CONTEXT_VALIDATION.ERROR_CODES];
-/** Type for recovery action types */
-export type RecoveryActionType = (typeof CONTEXT_VALIDATION.RECOVERY_ACTIONS)[keyof typeof CONTEXT_VALIDATION.RECOVERY_ACTIONS];
-/** Type for recovery issue codes */
-export type RecoveryIssueCode = (typeof CONTEXT_VALIDATION.RECOVERY_ISSUES)[keyof typeof CONTEXT_VALIDATION.RECOVERY_ISSUES];
-/** Type for predicate severity levels */
-export type PredicateSeverity = (typeof CONTEXT_VALIDATION.SEVERITY)[keyof typeof CONTEXT_VALIDATION.SEVERITY];
-/** Type for validation modes */
-export type ValidationMode = (typeof CONTEXT_VALIDATION.VALIDATION_MODES)[keyof typeof CONTEXT_VALIDATION.VALIDATION_MODES];
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-schema.ts} - PLACEHOLDER_SENTINEL
+ */
+export { WU_STATUS, PROTECTED_WU_STATUSES, PROGRESSABLE_WU_STATUSES, WU_STATUS_GROUPS, CLAIMED_MODES, INCIDENT_SEVERITY, WU_TYPES, WU_EXPOSURE, WU_EXPOSURE_VALUES, TEST_TYPES, } from './wu-statuses.js';
+export { BRANCHES, REMOTES, GIT_REFS, GIT, REAL_GIT, GIT_FLAGS, GIT_COMMANDS, GIT_COMMAND_STRINGS, } from './wu-git-constants.js';
+export { FILE_SYSTEM, CONFIG_FILES, DIRECTORIES, BUILD_ARTIFACT_GLOBS, BUILD_ARTIFACT_IGNORES, SCRIPT_PATHS, FILE_EXTENSIONS, PATH_PATTERNS, PATH_LITERALS, PATH_SLICE_LENGTHS, LOCK_DIR_NAME, LUMENFLOW_PATHS, FILE_TOOLS, PHI_ERRORS, PHI_CONFIG, type NodeFsError, } from './wu-paths-constants.js';
+export { CLI_FLAGS, PKG_FLAGS, ESLINT_FLAGS, SCRIPTS, GATE_NAMES, GATE_COMMANDS, CLI_MODES, PRETTIER_FLAGS, PKG_MANAGER, PKG_COMMANDS, PACKAGES, STDIO, STDIO_MODES, EXIT_CODES, STREAM_ERRORS, ESLINT_COMMANDS, ESLINT_DEFAULTS, CACHE_STRATEGIES, PRETTIER_ARGS, AUDIT_ARGS, SHELL_COMMANDS, TOOLS, GITLEAKS_ARGS, KNOWN_PACKAGES, ERROR_CODES, MICRO_WORKTREE_OPERATIONS, TELEMETRY_STEPS, SKIP_GATES_REASONS, CHECKPOINT_MESSAGES, PROCESS_DETECTION, } from './wu-cli-constants.js';
+export { BACKLOG_SECTIONS, BACKLOG_BULLET_FORMAT, STATUS_SECTIONS, LOG_PREFIX, EMOJI, BOX, UI, DISPLAY_LIMITS, YAML_OPTIONS, ARGV_INDICES, STRING_LITERALS, READINESS_UI, } from './wu-ui-constants.js';
+export { PATTERNS, COMMIT_FORMATS, CONSISTENCY_TYPES, CONSISTENCY_MESSAGES, WORKTREE_WARNINGS, CLEANUP_GUARD, SESSION, VALIDATION, THRESHOLDS, DEFAULTS, WU_DEFAULTS, SAFETY_CRITICAL_TEST_GLOBS, LANE_PATH_PATTERNS, toKebab, getWorktreePath, getLaneBranch, getProjectRoot, discoverSafetyTests, validateSafetyTestsExist, type DiscoverSafetyTestsOptions, } from './wu-domain-constants.js';
+export { CONTEXT_VALIDATION, HOOK_MESSAGES, CLAUDE_HOOKS, getHookCommand, type LocationType, type ValidationErrorCode, type RecoveryActionType, type RecoveryIssueCode, type PredicateSeverity, type ValidationMode, } from './wu-context-constants.js';
 //# sourceMappingURL=wu-constants.d.ts.map