@lumenflow/core 2.2.1 → 2.3.1

package/dist/wu-backlog-updater.js

@@ -1,7 +1,7 @@
 /**
  * Backlog.md Update Utilities
  *
- * Centralized backlog.md update functions (extracted from wu-done.mjs)
+ * Centralized backlog.md update functions (extracted from wu-done.ts)
  * Refactored to use BacklogManager (WU-1212) for AST-based manipulation
  *
  * Used by both main wu:done flow AND recovery mode (DRY principle)

package/dist/wu-claim-helpers.d.ts

@@ -1,5 +1,5 @@
 /**
- * @file wu-claim-helpers.mjs
+ * @file wu-claim-helpers.ts
  * Helper functions for wu:claim (WU-1423)
  *
  * Extracted email validation logic for testability and SOLID compliance.

package/dist/wu-claim-helpers.js

@@ -1,5 +1,5 @@
 /**
- * @file wu-claim-helpers.mjs
+ * @file wu-claim-helpers.ts
  * Helper functions for wu:claim (WU-1423)
  *
  * Extracted email validation logic for testability and SOLID compliance.

package/dist/wu-claim-resume.d.ts

@@ -1,5 +1,5 @@
 /**
- * @file wu-claim-resume.mjs
+ * @file wu-claim-resume.ts
  * Helper functions for wu:claim --resume agent handoff (WU-2411)
  *
  * When an agent crashes or is killed, its worktree remains with uncommitted work.

package/dist/wu-claim-resume.js

@@ -1,5 +1,5 @@
 /**
- * @file wu-claim-resume.mjs
+ * @file wu-claim-resume.ts
  * Helper functions for wu:claim --resume agent handoff (WU-2411)
  *
  * When an agent crashes or is killed, its worktree remains with uncommitted work.

package/dist/wu-consistency-checker.d.ts

@@ -10,7 +10,7 @@
  * - ORPHAN_WORKTREE_DONE: Done WU still has worktree
  * - STAMP_EXISTS_YAML_NOT_DONE: Stamp exists but YAML status is not done (WU-2412)
  *
- * @see {@link ../wu-repair.mjs} CLI interface
+ * @see {@link ../wu-repair.ts} CLI interface
  */
 /**
  * Check a single WU for state inconsistencies

package/dist/wu-consistency-checker.js

@@ -10,13 +10,13 @@
  * - ORPHAN_WORKTREE_DONE: Done WU still has worktree
  * - STAMP_EXISTS_YAML_NOT_DONE: Stamp exists but YAML status is not done (WU-2412)
  *
- * @see {@link ../wu-repair.mjs} CLI interface
+ * @see {@link ../wu-repair.ts} CLI interface
  */
 import { readFile, writeFile, readdir, mkdir, access } from 'node:fs/promises';
 import { constants, existsSync, mkdirSync, writeFileSync, readFileSync } from 'node:fs';
 import path from 'node:path';
 import { parseYAML, stringifyYAML } from './wu-yaml.js';
-import { WU_PATHS } from './wu-paths.js';
+import { createWuPaths, WU_PATHS } from './wu-paths.js';
 import { CONSISTENCY_TYPES, CONSISTENCY_MESSAGES, LOG_PREFIX, REMOTES, STRING_LITERALS, toKebab, WU_STATUS, YAML_OPTIONS, } from './wu-constants.js';
 import { todayISO } from './date-utils.js';
 import { createGitForPath } from './git-adapter.js';
@@ -30,10 +30,11 @@ import { withMicroWorktree } from './micro-worktree.js';
  */
 export async function checkWUConsistency(id, projectRoot = process.cwd()) {
     const errors = [];
-    const wuPath = path.join(projectRoot, WU_PATHS.WU(id));
-    const stampPath = path.join(projectRoot, WU_PATHS.STAMP(id));
-    const backlogPath = path.join(projectRoot, WU_PATHS.BACKLOG());
-    const statusPath = path.join(projectRoot, WU_PATHS.STATUS());
+    const paths = createWuPaths({ projectRoot });
+    const wuPath = path.join(projectRoot, paths.WU(id));
+    const stampPath = path.join(projectRoot, paths.STAMP(id));
+    const backlogPath = path.join(projectRoot, paths.BACKLOG());
+    const statusPath = path.join(projectRoot, paths.STATUS());
     // Handle missing WU YAML gracefully
     try {
         await access(wuPath, constants.R_OK);
@@ -166,7 +167,8 @@ export async function checkWUConsistency(id, projectRoot = process.cwd()) {
  * @returns {Promise<object>} Aggregated report with valid, errors, and checked count
  */
 export async function checkAllWUConsistency(projectRoot = process.cwd()) {
-    const wuDir = path.join(projectRoot, 'docs/04-operations/tasks/wu');
+    const paths = createWuPaths({ projectRoot });
+    const wuDir = path.join(projectRoot, paths.WU_DIR());
     try {
         await access(wuDir, constants.R_OK);
     }
@@ -195,7 +197,8 @@ export async function checkAllWUConsistency(projectRoot = process.cwd()) {
  * @returns {Promise<object>} Result with valid, orphans list, and reports
  */
 export async function checkLaneForOrphanDoneWU(lane, excludeId, projectRoot = process.cwd()) {
-    const wuDir = path.join(projectRoot, 'docs/04-operations/tasks/wu');
+    const paths = createWuPaths({ projectRoot });
+    const wuDir = path.join(projectRoot, paths.WU_DIR());
     try {
         await access(wuDir, constants.R_OK);
     }
@@ -486,7 +489,8 @@ async function createStampInProject(id, title, projectRoot) {
  * @returns {Promise<string[]>} List of files modified (relative paths)
  */
 async function updateYamlToDoneInWorktree(id, worktreePath, projectRoot) {
-    const wuRelPath = WU_PATHS.WU(id);
+    const paths = createWuPaths({ projectRoot });
+    const wuRelPath = paths.WU(id);
     const wuSrcPath = path.join(projectRoot, wuRelPath);
     const wuDestPath = path.join(worktreePath, wuRelPath);
     // Read current YAML from project root
@@ -522,7 +526,8 @@ async function updateYamlToDoneInWorktree(id, worktreePath, projectRoot) {
  * @returns {Promise<void>}
  */
 async function updateYamlToDone(id, projectRoot) {
-    const wuPath = path.join(projectRoot, WU_PATHS.WU(id));
+    const paths = createWuPaths({ projectRoot });
+    const wuPath = path.join(projectRoot, paths.WU(id));
     // Read current YAML
     const content = await readFile(wuPath, { encoding: 'utf-8' });
     const wuDoc = parseYAML(content);
@@ -690,7 +695,8 @@ async function removeOrphanWorktree(id, lane, projectRoot) {
         // Worktree doesn't exist, that's fine
     }
     // 🚨 SAFETY GUARD 3: Check stamp exists (not rollback state)
-    const stampPath = path.join(projectRoot, WU_PATHS.STAMP(id));
+    const paths = createWuPaths({ projectRoot });
+    const stampPath = path.join(projectRoot, paths.STAMP(id));
     try {
         await access(stampPath, constants.R_OK);
     }

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 */
@@ -958,17 +960,6 @@ export declare const GATE_COMMANDS: {
     /** 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
  *
@@ -1064,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
  *
@@ -1186,10 +1193,6 @@ export declare const AUDIT_ARGS: {
  * Centralized paths to validation scripts.
  */
 export declare const SCRIPT_PATHS: {
-    /** Gates runner */
-    GATES: string;
-    /** WU YAML validation */
-    VALIDATE: string;
     /** Prompt registry validation */
     VALIDATE_PROMPT_REGISTRY: string;
 };
@@ -1217,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
  *
@@ -1258,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.
@@ -1299,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
@@ -1478,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) */
@@ -1665,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";