@lumenflow/core 2.2.2 → 2.3.1

package/dist/wu-constants.d.ts

@@ -4,12 +4,12 @@
  * 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-1214: Extract hardcoded strings to wu-constants.ts
  * 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)
+ * @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
@@ -70,7 +70,7 @@ export declare const WU_STATUS: {
 /**
  * WU status groups for state management (WU-1742)
  *
- * Used by state-bootstrap.mjs to categorize YAML statuses.
+ * Used by state-bootstrap.ts to categorize YAML statuses.
  */
 export declare const WU_STATUS_GROUPS: {
     /** Statuses representing unclaimed work (not tracked in state store) */
@@ -140,7 +140,7 @@ export declare const STATUS_SECTIONS: {
 /**
  * Regex patterns for WU operations
  *
- * Note: WU_ID pattern is also in wu-schema.mjs for Zod validation
+ * Note: WU_ID pattern is also in wu-schema.ts for Zod validation
  */
 export declare const PATTERNS: {
     /** WU identifier format: WU-123 */
@@ -252,7 +252,7 @@ export declare const LOG_PREFIX: {
     REPAIR: string;
     CONSISTENCY: string;
     PREFLIGHT: string;
-    INIT_PLAN: string;
+    INITIATIVE_PLAN: string;
 };
 /**
  * Consistency check types (WU-1276)
@@ -457,7 +457,7 @@ export declare const YAML_OPTIONS: {
 /**
  * UI display constants
  *
- * WU-1281: Centralized from hardcoded values in wu-done.mjs
+ * WU-1281: Centralized from hardcoded values in wu-done.ts
  */
 export declare const UI: {
     /** Width for error/info boxes in console output */
@@ -559,14 +559,14 @@ export declare const GIT: {
  * 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
+ * @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.mjs and other git operation utilities.
+ * Used by git-adapter.ts and other git operation utilities.
  */
 export declare const GIT_FLAGS: {
     /** Show abbreviated ref names (for branch name resolution) */
@@ -690,8 +690,8 @@ export declare const WU_TYPES: {
  * 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
+ * @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) */
@@ -759,7 +759,7 @@ export declare const EMOJI: {
  * 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
+ * Used by wu-schema.ts Zod transformations to provide sensible defaults
  * when agents omit optional fields, reducing validation errors.
  */
 export declare const WU_DEFAULTS: {
@@ -801,7 +801,7 @@ export declare const WU_DEFAULTS: {
  * WU-1068: Removed hardcoded @patientpath references. These patterns
  * should be configured in .lumenflow.config.yaml per-project.
  *
- * @see {@link tools/lib/lane-validator.mjs} - Validation logic
+ * @see {@link packages/@lumenflow/cli/src/lib/lane-validator.ts} - Validation logic
  */
 export declare const LANE_PATH_PATTERNS: {
     /**
@@ -824,7 +824,7 @@ export declare const LANE_PATH_PATTERNS: {
 /**
  * Process detection constants for background process warning (WU-1381)
  *
- * Used by process-detector.mjs to identify processes that may interfere
+ * Used by process-detector.ts to identify processes that may interfere
  * with wu:done gates execution.
  */
 export declare const PROCESS_DETECTION: {
@@ -918,7 +918,7 @@ export declare const SCRIPTS: {
 /**
  * Gate names for quality gates
  *
- * Centralized gate identifiers for gates.mjs and telemetry.
+ * Centralized gate identifiers for gates.ts and telemetry.
  */
 export declare const GATE_NAMES: {
     /** WU-2252: Invariants check (runs first, non-bypassable) */
@@ -938,11 +938,13 @@ export declare const GATE_NAMES: {
     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;
 };
 /**
  * Gate command sentinels (special values for non-shell commands)
  *
- * These are not shell commands but trigger special handling in gates.mjs.
+ * These are not shell commands but trigger special handling in gates.ts.
  */
 export declare const GATE_COMMANDS: {
     /** WU-2252: Triggers invariants check */
@@ -1053,6 +1055,22 @@ export declare const EXIT_CODES: {
     /** 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
  *
@@ -1202,6 +1220,13 @@ export declare const ERROR_CODES: {
     /** 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
  *
@@ -1243,10 +1268,23 @@ export declare const LUMENFLOW_PATHS: {
     SESSION_CURRENT: string;
     /** WU events log */
     WU_EVENTS: string;
-    /** Lock files directory */
+    /** Lock files directory (lane locks - persisted) */
     LOCKS_DIR: string;
     /** Force bypass audit log */
     FORCE_BYPASSES: 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;
 };
 /**
  * @deprecated Use LUMENFLOW_PATHS instead. Will be removed in v2.0.
@@ -1284,10 +1322,23 @@ export declare const BEACON_PATHS: {
     SESSION_CURRENT: string;
     /** WU events log */
     WU_EVENTS: string;
-    /** Lock files directory */
+    /** Lock files directory (lane locks - persisted) */
     LOCKS_DIR: string;
     /** Force bypass audit log */
     FORCE_BYPASSES: 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
@@ -1463,8 +1514,8 @@ export declare const PHI_CONFIG: {
  * 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()
+ * @see tools/wu-create.ts - displayReadinessSummary()
+ * @see tools/wu-edit.ts - displayReadinessSummary()
  */
 export declare const READINESS_UI: {
     /** Box width (inner content area) */
@@ -1650,6 +1701,7 @@ export declare const CONTEXT_VALIDATION: {
     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";

package/dist/wu-constants.js

@@ -4,14 +4,15 @@
  * 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-1214: Extract hardcoded strings to wu-constants.ts
  * 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)
+ * @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)
  */
 import path from 'node:path';
+import { tmpdir } from 'node:os';
 import { kebabCase } from 'change-case';
 /**
  * Git branch names
@@ -76,7 +77,7 @@ export const WU_STATUS = {
 /**
  * WU status groups for state management (WU-1742)
  *
- * Used by state-bootstrap.mjs to categorize YAML statuses.
+ * Used by state-bootstrap.ts to categorize YAML statuses.
  */
 export const WU_STATUS_GROUPS = {
     /** Statuses representing unclaimed work (not tracked in state store) */
@@ -116,7 +117,7 @@ export const INCIDENT_SEVERITY = {
     MINOR: 'minor',
     INFO: 'info',
 };
-// Note: PATHS object removed in WU-1240 - use WU_PATHS from wu-paths.mjs instead
+// Note: PATHS object removed in WU-1240 - use WU_PATHS from wu-paths.ts instead
 /**
  * Backlog section headings (with emojis)
  *
@@ -155,7 +156,7 @@ export const STATUS_SECTIONS = {
 /**
  * Regex patterns for WU operations
  *
- * Note: WU_ID pattern is also in wu-schema.mjs for Zod validation
+ * Note: WU_ID pattern is also in wu-schema.ts for Zod validation
  */
 export const PATTERNS = {
     /** WU identifier format: WU-123 */
@@ -267,7 +268,7 @@ export const LOG_PREFIX = {
     REPAIR: '[wu:repair]',
     CONSISTENCY: '[wu-consistency]',
     PREFLIGHT: '[wu-preflight]',
-    INIT_PLAN: '[init:plan]',
+    INITIATIVE_PLAN: '[initiative:plan]',
 };
 /**
  * Consistency check types (WU-1276)
@@ -479,7 +480,7 @@ export const YAML_OPTIONS = {
 /**
  * UI display constants
  *
- * WU-1281: Centralized from hardcoded values in wu-done.mjs
+ * WU-1281: Centralized from hardcoded values in wu-done.ts
  */
 export const UI = {
     /** Width for error/info boxes in console output */
@@ -525,6 +526,7 @@ export const CLEANUP_GUARD = {
         MISSING_STAMP: 'WU stamp is missing. Refusing to delete.',
         PR_NOT_MERGED: 'PR is not merged (or cannot be verified). Refusing to delete.',
     },
+    /* eslint-disable sonarjs/no-duplicate-string -- Intentional: cleanup instructions repeated for each error type for readability */
     NEXT_STEPS: {
         DEFAULT: [
             { text: '1. Resolve the issue above', appendId: false },
@@ -554,6 +556,7 @@ export const CLEANUP_GUARD = {
             { text: '2. Re-run: pnpm wu:cleanup --id', appendId: true },
         ],
     },
+    /* eslint-enable sonarjs/no-duplicate-string */
     PR_CHECK: {
         START: 'Verifying PR merge status...',
         RESULT: 'PR merge verification via',
@@ -584,14 +587,14 @@ export const GIT = {
  * 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
+ * @see tools/lib/wu-helpers.ts - Uses REAL_GIT to avoid recursion
  */
 export 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.
+ * Used by git-adapter.ts and other git operation utilities.
  */
 export const GIT_FLAGS = {
     /** Show abbreviated ref names (for branch name resolution) */
@@ -715,8 +718,8 @@ export const WU_TYPES = {
  * 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
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-schema.ts} - Schema validation
+ * @see {@link packages/linters/wu-schema-linter.ts} - Linter validation
  */
 export const WU_EXPOSURE = {
     /** User-facing UI changes (pages, components, widgets) */
@@ -803,7 +806,7 @@ export const EMOJI = {
  * 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
+ * Used by wu-schema.ts Zod transformations to provide sensible defaults
  * when agents omit optional fields, reducing validation errors.
  */
 export const WU_DEFAULTS = {
@@ -840,7 +843,7 @@ export const WU_DEFAULTS = {
  * WU-1068: Removed hardcoded @patientpath references. These patterns
  * should be configured in .lumenflow.config.yaml per-project.
  *
- * @see {@link tools/lib/lane-validator.mjs} - Validation logic
+ * @see {@link packages/@lumenflow/cli/src/lib/lane-validator.ts} - Validation logic
  */
 export const LANE_PATH_PATTERNS = {
     /**
@@ -863,7 +866,7 @@ export const LANE_PATH_PATTERNS = {
 /**
  * Process detection constants for background process warning (WU-1381)
  *
- * Used by process-detector.mjs to identify processes that may interfere
+ * Used by process-detector.ts to identify processes that may interfere
  * with wu:done gates execution.
  */
 export const PROCESS_DETECTION = {
@@ -960,7 +963,7 @@ export const SCRIPTS = {
 /**
  * Gate names for quality gates
  *
- * Centralized gate identifiers for gates.mjs and telemetry.
+ * Centralized gate identifiers for gates.ts and telemetry.
  */
 export const GATE_NAMES = {
     /** WU-2252: Invariants check (runs first, non-bypassable) */
@@ -980,11 +983,13 @@ export const GATE_NAMES = {
     INTEGRATION_TEST: 'integration-test',
     /** WU-2315: System map validation (warn-only until orphan docs are indexed) */
     SYSTEM_MAP_VALIDATE: 'system-map:validate',
+    /** WU-1191: Lane health check (overlap detection) */
+    LANE_HEALTH: 'lane-health',
 };
 /**
  * Gate command sentinels (special values for non-shell commands)
  *
- * These are not shell commands but trigger special handling in gates.mjs.
+ * These are not shell commands but trigger special handling in gates.ts.
  */
 export const GATE_COMMANDS = {
     /** WU-2252: Triggers invariants check */
@@ -1096,6 +1101,22 @@ export const EXIT_CODES = {
     /** Fatal or distinct failure exit code */
     FAILURE: 2,
 };
+/**
+ * Stream error codes
+ *
+ * WU-1233: Error codes for stream operations (stdout/stderr).
+ * Used by StreamErrorHandler for graceful pipe closure handling.
+ */
+export 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).
+     */
+    EPIPE: 'EPIPE',
+};
 /**
  * ESLint command names
  *
@@ -1245,6 +1266,13 @@ export const ERROR_CODES = {
     /** Timeout error code */
     ETIMEDOUT: 'ETIMEDOUT',
 };
+/**
+ * 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 const LOCK_DIR_NAME = '.lumenflow-locks';
 /**
  * LumenFlow directory paths
  *
@@ -1286,10 +1314,23 @@ export const LUMENFLOW_PATHS = {
     SESSION_CURRENT: '.lumenflow/sessions/current.json',
     /** WU events log */
     WU_EVENTS: '.lumenflow/state/wu-events.jsonl',
-    /** Lock files directory */
+    /** Lock files directory (lane locks - persisted) */
     LOCKS_DIR: '.lumenflow/locks',
     /** Force bypass audit log */
     FORCE_BYPASSES: '.lumenflow/force-bypasses.log',
+    /**
+     * 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: path.join(tmpdir(), LOCK_DIR_NAME),
 };
 /**
  * @deprecated Use LUMENFLOW_PATHS instead. Will be removed in v2.0.
@@ -1351,6 +1392,7 @@ export const PATH_LITERALS = {
     /** Plan file suffix for WU plans */
     PLAN_FILE_SUFFIX: '-plan.md',
     /** Trailing slash regex pattern */
+    // eslint-disable-next-line sonarjs/slow-regex -- False positive: simple end-anchor regex, no catastrophic backtracking possible
     TRAILING_SLASH_REGEX: /\/+$/,
 };
 /**
@@ -1414,7 +1456,7 @@ export function getLaneBranch(lane, id) {
     return `lane/${laneKebab}/${idLower}`;
 }
 // Note: getWuYamlPath and getStampPath removed in WU-1240
-// Use WU_PATHS.WU(id) and WU_PATHS.STAMP(id) from wu-paths.mjs instead
+// Use WU_PATHS.WU(id) and WU_PATHS.STAMP(id) from wu-paths.ts instead
 /**
  * File tool constants (WU-1403)
  *
@@ -1487,8 +1529,8 @@ export const PHI_CONFIG = {
  * 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()
+ * @see tools/wu-create.ts - displayReadinessSummary()
+ * @see tools/wu-edit.ts - displayReadinessSummary()
  */
 export const READINESS_UI = {
     /** Box width (inner content area) */
@@ -1730,6 +1772,7 @@ export const CONTEXT_VALIDATION = {
     COMMANDS: {
         WU_CREATE: 'wu:create',
         WU_CLAIM: 'wu:claim',
+        WU_PREP: 'wu:prep',
         WU_DONE: 'wu:done',
         WU_BLOCK: 'wu:block',
         WU_UNBLOCK: 'wu:unblock',

package/dist/wu-done-branch-only.d.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
  * Branch-Only mode completion workflow for wu:done
- * Extracted from wu-done.mjs (WU-1215 refactoring)
+ * Extracted from wu-done.ts (WU-1215 refactoring)
  *
  * Flow:
  * 1. Switch to main branch

package/dist/wu-done-branch-only.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
  * Branch-Only mode completion workflow for wu:done
- * Extracted from wu-done.mjs (WU-1215 refactoring)
+ * Extracted from wu-done.ts (WU-1215 refactoring)
  *
  * Flow:
  * 1. Switch to main branch

package/dist/wu-done-docs-generate.d.ts

@@ -11,7 +11,7 @@
  * Pathspecs for files that affect generated documentation.
  * When any of these files change, docs:generate should be run.
  *
- * Based on .husky/hooks/docs-sync.mjs patterns, expanded to match
+ * Based on .husky/hooks/docs-sync.ts patterns, expanded to match
  * all files that can affect CLI/config documentation.
  */
 export declare const DOC_SOURCE_PATHSPECS: readonly ["tools/generate-cli-docs.ts", "packages/@lumenflow/core/src/arg-parser.ts", "packages/@lumenflow/core/src/lumenflow-config-schema.ts", "packages/@lumenflow/core/src/index.ts", "packages/@lumenflow/cli/package.json", "packages/@lumenflow/cli/src/"];

package/dist/wu-done-docs-generate.js

@@ -14,7 +14,7 @@ import { STDIO, PKG_MANAGER, SCRIPTS, PRETTIER_FLAGS } from './wu-constants.js';
  * Pathspecs for files that affect generated documentation.
  * When any of these files change, docs:generate should be run.
  *
- * Based on .husky/hooks/docs-sync.mjs patterns, expanded to match
+ * Based on .husky/hooks/docs-sync.ts patterns, expanded to match
  * all files that can affect CLI/config documentation.
  */
 export const DOC_SOURCE_PATHSPECS = [

package/dist/wu-done-messages.d.ts

@@ -1,8 +1,8 @@
 /**
- * @file wu-done-messages.mjs
+ * @file wu-done-messages.ts
  * @description Constants and message templates for wu-done operations
  * WU-1159: Eliminate string literals (DRY/SOLID compliance)
- * WU-1281: Use centralized LOG_PREFIX and EMOJI from wu-constants.mjs
+ * WU-1281: Use centralized LOG_PREFIX and EMOJI from wu-constants.ts
  *
  * All log messages, error messages, and text templates extracted to constants.
  * Prevents duplication and makes text maintainable.

package/dist/wu-done-messages.js

@@ -1,8 +1,8 @@
 /**
- * @file wu-done-messages.mjs
+ * @file wu-done-messages.ts
  * @description Constants and message templates for wu-done operations
  * WU-1159: Eliminate string literals (DRY/SOLID compliance)
- * WU-1281: Use centralized LOG_PREFIX and EMOJI from wu-constants.mjs
+ * WU-1281: Use centralized LOG_PREFIX and EMOJI from wu-constants.ts
  *
  * All log messages, error messages, and text templates extracted to constants.
  * Prevents duplication and makes text maintainable.

package/dist/wu-done-metadata.d.ts

@@ -3,7 +3,7 @@
  */
 /**
  * Generate commit message for WU completion
- * Extracted from wu-done.mjs (WU-1215 Phase 2 Extraction #1 Helper)
+ * Extracted from wu-done.ts (WU-1215 Phase 2 Extraction #1 Helper)
  * @param {string} id - WU ID (e.g., "WU-1215")
  * @param {string} title - WU title
  * @param {number} maxLength - Maximum commit header length from commitlint config
@@ -26,7 +26,7 @@ export declare function validateMetadataFilesExist({ statusPath, backlogPath }:
 }): void;
 /**
  * Update all metadata files for WU completion
- * Extracted from wu-done.mjs (WU-1215 Phase 2 Extraction #1 Helper)
+ * Extracted from wu-done.ts (WU-1215 Phase 2 Extraction #1 Helper)
  * WU-1572: Made async for WUStateStore integration
  * @param {object} params - Parameters object
  * @param {string} params.id - WU ID
@@ -82,7 +82,7 @@ export declare function collectMetadataToTransaction({ id, title, doc, wuPath, s
 }): Promise<void>;
 /**
  * Stage and format metadata files
- * Extracted from wu-done.mjs (WU-1215 Phase 2 Extraction #1 Helper)
+ * Extracted from wu-done.ts (WU-1215 Phase 2 Extraction #1 Helper)
  * @param {object} params - Parameters object
  * @param {string} params.id - WU ID (for error reporting)
  * @param {string} params.wuPath - Path to WU YAML file

package/dist/wu-done-metadata.js

@@ -18,7 +18,7 @@ import { writeWU } from './wu-yaml.js';
 const execAsync = promisify(execCallback);
 /**
  * Generate commit message for WU completion
- * Extracted from wu-done.mjs (WU-1215 Phase 2 Extraction #1 Helper)
+ * Extracted from wu-done.ts (WU-1215 Phase 2 Extraction #1 Helper)
  * @param {string} id - WU ID (e.g., "WU-1215")
  * @param {string} title - WU title
  * @param {number} maxLength - Maximum commit header length from commitlint config
@@ -71,7 +71,7 @@ export function validateMetadataFilesExist({ statusPath, backlogPath }) {
 }
 /**
  * Update all metadata files for WU completion
- * Extracted from wu-done.mjs (WU-1215 Phase 2 Extraction #1 Helper)
+ * Extracted from wu-done.ts (WU-1215 Phase 2 Extraction #1 Helper)
  * WU-1572: Made async for WUStateStore integration
  * @param {object} params - Parameters object
  * @param {string} params.id - WU ID
@@ -156,7 +156,7 @@ export async function collectMetadataToTransaction({ id, title, doc, wuPath, sta
 }
 /**
  * Stage and format metadata files
- * Extracted from wu-done.mjs (WU-1215 Phase 2 Extraction #1 Helper)
+ * Extracted from wu-done.ts (WU-1215 Phase 2 Extraction #1 Helper)
  * @param {object} params - Parameters object
  * @param {string} params.id - WU ID (for error reporting)
  * @param {string} params.wuPath - Path to WU YAML file

package/dist/wu-done-pr.d.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
  * PR mode completion workflow for wu:done
- * Extracted from wu-done.mjs (WU-1215 refactoring)
+ * Extracted from wu-done.ts (WU-1215 refactoring)
  *
  * PR mode creates a GitHub PR instead of auto-merging to main.
  * Used for:

package/dist/wu-done-pr.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
  * PR mode completion workflow for wu:done
- * Extracted from wu-done.mjs (WU-1215 refactoring)
+ * Extracted from wu-done.ts (WU-1215 refactoring)
  *
  * PR mode creates a GitHub PR instead of auto-merging to main.
  * Used for:
@@ -13,6 +13,7 @@ import { execSync } from 'node:child_process';
 import { getGitForCwd } from './git-adapter.js';
 import { createError, ErrorCodes } from './error-handler.js';
 import { LOG_PREFIX, EMOJI, REMOTES, STDIO } from './wu-constants.js';
+import { createWuPaths } from './wu-paths.js';
 /**
  * @typedef {Object} PRContext
  * @property {string} branch - Lane branch name
@@ -105,7 +106,8 @@ export async function createPR(context) {
  * @returns {string} PR body markdown
  */
 export function buildPRBody(doc, id) {
-    const wuPath = `docs/04-operations/tasks/wu/${id}.yaml`;
+    const paths = createWuPaths();
+    const wuPath = paths.WU(id);
     const description = doc.description || doc.problem || '';
     const acceptance = doc.acceptance_criteria || doc.acceptance || {};
     let body = `## Summary\n\n${description}\n\n`;

package/dist/wu-done-preflight.d.ts

@@ -19,6 +19,14 @@ export declare function executePreflightCodePathValidation(id: any, paths: any,
     missingCodePaths: any[];
     missingTestPaths: any[];
     abortedBeforeGates: boolean;
+    suggestedTestPaths?: undefined;
+} | {
+    valid: boolean;
+    errors: any[];
+    missingCodePaths: any[];
+    missingTestPaths: any[];
+    suggestedTestPaths: {};
+    abortedBeforeGates: boolean;
 }>;
 /**
  * WU-1805: Build preflight code_paths error message with actionable guidance