@lumenflow/core 1.0.0

package/dist/wu-constants.d.ts

@@ -0,0 +1,1275 @@
+/**
+ * Work Unit Constants
+ *
+ * Centralized constants for wu- scripts to ensure consistency and DRY compliance.
+ * Single source of truth for magic strings, section headings, and patterns.
+ *
+ * Part of WU-1214: Extract hardcoded strings to wu-constants.mjs
+ * Part of WU-1240: Consolidated toKebab using change-case library
+ *
+ * @see {@link tools/wu-done.mjs} - Primary consumer
+ * @see {@link tools/wu-claim.mjs} - Branch/worktree creation
+ * @see {@link tools/lib/wu-schema.mjs} - 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;
+    /** 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.mjs 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;
+};
+/**
+ * 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.mjs 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;
+    /** 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;
+    INIT_PLAN: 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;
+};
+/**
+ * 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;
+};
+/**
+ * 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;
+    COS_GATES: string;
+    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;
+};
+/**
+ * YAML serialization options
+ *
+ * Centralized from duplicated { lineWidth: 100 } across wu-* scripts (WU-1256).
+ * Use with js-yaml dump() function.
+ */
+export declare const YAML_OPTIONS: {
+    /** Standard line width for YAML dump (100 chars) */
+    LINE_WIDTH: number;
+    /** No line wrapping (-1 disables wrapping in js-yaml) */
+    NO_WRAP: number;
+};
+/**
+ * UI display constants
+ *
+ * WU-1281: Centralized from hardcoded values in wu-done.mjs
+ */
+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;
+};
+/**
+ * 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.mjs - 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.mjs 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;
+    /** 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;
+    /** 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;
+};
+/**
+ * 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;
+    /** Git diff command */
+    DIFF: 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 tools/lib/wu-schema.mjs} - Schema validation
+ * @see {@link packages/linters/wu-schema-linter.mjs} - 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.mjs 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.
+ *
+ * @see {@link tools/lib/lane-validator.mjs} - 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.mjs 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;
+};
+/**
+ * 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;
+    PROMPTS_LINT: string;
+    RUN: string;
+    GATES: string;
+    COS_GATES: string;
+    PRETTIER: string;
+};
+/**
+ * Gate names for quality gates
+ *
+ * Centralized gate identifiers for gates.mjs and telemetry.
+ */
+export declare const GATE_NAMES: {
+    /** WU-2252: Invariants check (runs first, non-bypassable) */
+    INVARIANTS: string;
+    FORMAT_CHECK: string;
+    SPEC_LINTER: string;
+    PROMPTS_LINT: string;
+    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;
+};
+/**
+ * Gate command sentinels (special values for non-shell commands)
+ *
+ * These are not shell commands but trigger special handling in gates.mjs.
+ */
+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;
+};
+/**
+ * Tool paths for scripts
+ *
+ * Centralized paths to tool scripts.
+ */
+export declare const TOOL_PATHS: {
+    VALIDATE_BACKLOG_SYNC: string;
+    SUPABASE_DOCS_LINTER: string;
+    /** WU-2315: System map validator script */
+    SYSTEM_MAP_VALIDATE: 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;
+};
+/**
+ * Package names (monorepo workspaces)
+ *
+ * Centralized package names for --filter usage.
+ */
+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;
+    DOCS: string;
+    PACKAGES: string;
+    TOOLS: string;
+    MEMORY_BANK: string;
+    WU_DIR: string;
+    INITIATIVES_DIR: string;
+    BACKLOG_PATH: string;
+    STATUS_PATH: 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;
+};
+/**
+ * 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.
+     * TODO: Create follow-up WU to fix warnings and restore zero-warnings policy.
+     */
+    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;
+};
+/**
+ * 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: {
+    /** WU YAML validation */
+    VALIDATE: string;
+    /** 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;
+};
+/**
+ * Beacon directory paths
+ *
+ * Centralized paths for .beacon directory structure to eliminate hardcoded strings.
+ * Used by telemetry, agent-session, agent-incidents, and commands-logger modules.
+ */
+export declare const BEACON_PATHS: {
+    /** WU state store directory */
+    STATE_DIR: string;
+    /** Stamp directory (WU completion markers) */
+    STAMPS_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;
+};
+/**
+ * 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;
+};
+/**
+ * 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.
+ */
+export declare const PHI_ERRORS: {
+    /** PHI detected in content - write blocked */
+    PHI_DETECTED: string;
+    /** PHI override requested - audit logged */
+    PHI_OVERRIDE_ALLOWED: string;
+};
+/**
+ * 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.mjs - displayReadinessSummary()
+ * @see tools/wu-edit.mjs - 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;
+}>;