@lumenflow/core 2.2.2 → 2.3.2

package/dist/active-wu-detector.d.ts

@@ -2,7 +2,7 @@
  * Active WU Detection Utilities
  *
  * Detects which WU YAMLs are "active" (referenced in backlog.md/status.md)
- * vs "orphan" (legacy/unreferenced). Used by validate.mjs to suppress
+ * vs "orphan" (legacy/unreferenced). Used by validate.ts to suppress
  * lane-checker warnings for orphan WUs.
  *
  * WU-1814: Stop lane-checker warnings for orphan WU YAMLs

package/dist/active-wu-detector.js

@@ -2,7 +2,7 @@
  * Active WU Detection Utilities
  *
  * Detects which WU YAMLs are "active" (referenced in backlog.md/status.md)
- * vs "orphan" (legacy/unreferenced). Used by validate.mjs to suppress
+ * vs "orphan" (legacy/unreferenced). Used by validate.ts to suppress
  * lane-checker warnings for orphan WUs.
  *
  * WU-1814: Stop lane-checker warnings for orphan WU YAMLs

package/dist/arg-parser.js

@@ -5,6 +5,12 @@ import { EXIT_CODES } from './wu-constants.js';
  * Collector function for Commander.js repeatable options.
  * Accumulates multiple flag values into an array.
  *
+ * Usage: --flag a --flag b → ['a', 'b']
+ *
+ * This follows Commander.js best practices - use repeatable pattern for
+ * multi-value options. Do NOT split on commas here; that's a separate
+ * pattern with different semantics (see Commander.js docs).
+ *
  * @param {string} value - New value from CLI
  * @param {string[]} previous - Previously accumulated values
  * @returns {string[]} Updated array with new value appended
@@ -28,7 +34,7 @@ export const WU_OPTIONS = {
     id: {
         name: 'id',
         flags: '-i, --id <wuId>',
-        description: 'Work Unit ID (e.g., WU-123)',
+        description: 'Work Unit ID (e.g., WU-123). If not provided, auto-generates next sequential ID.',
     },
     wu: {
         name: 'wu',
@@ -205,17 +211,20 @@ export const WU_OPTIONS = {
     blockedBy: {
         name: 'blockedBy',
         flags: '--blocked-by <wuIds>',
-        description: 'Comma-separated WU IDs that block this WU',
+        description: 'WU IDs that block this WU (repeatable)',
+        isRepeatable: true,
     },
     blocks: {
         name: 'blocks',
         flags: '--blocks <wuIds>',
-        description: 'Comma-separated WU IDs this WU blocks',
+        description: 'WU IDs this WU blocks (repeatable)',
+        isRepeatable: true,
     },
     labels: {
         name: 'labels',
         flags: '--labels <labels>',
-        description: 'Comma-separated labels',
+        description: 'Labels (repeatable)',
+        isRepeatable: true,
     },
     slug: {
         name: 'slug',
@@ -311,22 +320,26 @@ export const WU_OPTIONS = {
     codePaths: {
         name: 'codePaths',
         flags: '--code-paths <paths>',
-        description: 'Code paths (comma-separated)',
+        description: 'Code paths (repeatable)',
+        isRepeatable: true,
     },
     testPathsManual: {
         name: 'testPathsManual',
         flags: '--test-paths-manual <tests>',
-        description: 'Manual test descriptions (comma-separated)',
+        description: 'Manual test descriptions (repeatable)',
+        isRepeatable: true,
     },
     testPathsUnit: {
         name: 'testPathsUnit',
         flags: '--test-paths-unit <paths>',
-        description: 'Unit test file paths (comma-separated)',
+        description: 'Unit test file paths (repeatable)',
+        isRepeatable: true,
     },
     testPathsE2e: {
         name: 'testPathsE2e',
         flags: '--test-paths-e2e <paths>',
-        description: 'E2E test file paths (comma-separated)',
+        description: 'E2E test file paths (repeatable)',
+        isRepeatable: true,
     },
     validate: {
         name: 'validate',
@@ -337,7 +350,8 @@ export const WU_OPTIONS = {
     specRefs: {
         name: 'specRefs',
         flags: '--spec-refs <paths>',
-        description: 'Spec/plan references (comma-separated paths to docs, required for type: feature)',
+        description: 'Spec/plan references (repeatable or comma-separated, required for type: feature)',
+        isRepeatable: true,
     },
     // WU-1998: Exposure field options
     exposure: {
@@ -353,7 +367,8 @@ export const WU_OPTIONS = {
     uiPairingWus: {
         name: 'uiPairingWus',
         flags: '--ui-pairing-wus <wuIds>',
-        description: 'Comma-separated UI WU IDs that consume this API (for api exposure)',
+        description: 'UI WU IDs that consume this API (repeatable or comma-separated, for api exposure)',
+        isRepeatable: true,
     },
     // WU-1577: Thinking mode options for wu:spawn
     thinking: {
@@ -384,11 +399,18 @@ export const WU_OPTIONS = {
         flags: '--parent-wu <wuId>',
         description: 'Parent WU ID for orchestrator context (e.g., WU-1000)',
     },
+    // WU-1240: Skip memory context injection in spawn prompts
+    noContext: {
+        name: 'noContext',
+        flags: '--no-context',
+        description: 'Skip memory context injection in spawn prompts',
+        isNegated: true,
+    },
     // WU-1542: Mandatory agent enforcement for wu:done
     requireAgents: {
         name: 'requireAgents',
         flags: '--require-agents',
-        description: 'Block wu:done if mandatory agents (security-auditor, beacon-guardian) were not invoked for WUs touching their trigger paths',
+        description: 'Block wu:done if mandatory agents (configured in MANDATORY_TRIGGERS) were not invoked for WUs touching their trigger paths',
     },
     // WU-2411: Agent handoff for crashed/killed agents
     resume: {
@@ -433,22 +455,33 @@ const NEGATED_OPTIONS = ['auto', 'remove', 'merge', 'autoRebase', 'push'];
  * @returns {object} Processed options with noFoo properties
  */
 function processNegatedOptions(opts) {
-    const result = { ...opts };
+    // Build a new object, excluding keys that need removal
+    // This avoids dynamic delete which violates @typescript-eslint/no-dynamic-delete
+    const keysToRemove = new Set();
+    const keysToAdd = {};
     for (const key of NEGATED_OPTIONS) {
         // Commander sets the property to false when --no-foo is used
         // and undefined when not specified
-        if (key in result && result[key] === false) {
+        if (key in opts && opts[key] === false) {
             // Convert: auto=false → noAuto=true
             const camelKey = `no${key.charAt(0).toUpperCase()}${key.slice(1)}`;
-            result[camelKey] = true;
-            delete result[key];
+            keysToAdd[camelKey] = true;
+            keysToRemove.add(key);
         }
-        else if (key in result && result[key] === true) {
+        else if (key in opts && opts[key] === true) {
             // Default value (not negated) - remove it
-            delete result[key];
+            keysToRemove.add(key);
+        }
+    }
+    // Build result by filtering out removed keys and adding new ones
+    const result = {};
+    for (const [key, value] of Object.entries(opts)) {
+        if (!keysToRemove.has(key)) {
+            result[key] = value;
         }
     }
-    return result;
+    // Add the transformed keys
+    return { ...result, ...keysToAdd };
 }
 /**
  * Create a commander-based CLI parser for a WU script.

package/dist/backlog-generator.d.ts

@@ -11,10 +11,10 @@
  * - computeStoreChecksum(): Computes deterministic checksum of store state
  * - getCompletionDate(): Retrieves completion date from event timestamp
  *
- * @see {@link tools/__tests__/backlog-generator.test.mjs} - Tests
- * @see {@link tools/__tests__/backlog-checksum.test.mjs} - Checksum tests
- * @see {@link tools/__tests__/status-date-from-event.test.mjs} - Date tests
- * @see {@link tools/lib/wu-state-store.mjs} - State store
+ * @see {@link packages/@lumenflow/cli/src/__tests__/backlog-generator.test.ts} - Tests
+ * @see {@link packages/@lumenflow/cli/src/__tests__/backlog-checksum.test.ts} - Checksum tests
+ * @see {@link packages/@lumenflow/cli/src/__tests__/status-date-from-event.test.ts} - Date tests
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-state-store.ts} - State store
  */
 interface BacklogYamlOptions {
     wuDir?: string;

package/dist/backlog-generator.js

@@ -11,10 +11,10 @@
  * - computeStoreChecksum(): Computes deterministic checksum of store state
  * - getCompletionDate(): Retrieves completion date from event timestamp
  *
- * @see {@link tools/__tests__/backlog-generator.test.mjs} - Tests
- * @see {@link tools/__tests__/backlog-checksum.test.mjs} - Checksum tests
- * @see {@link tools/__tests__/status-date-from-event.test.mjs} - Date tests
- * @see {@link tools/lib/wu-state-store.mjs} - State store
+ * @see {@link packages/@lumenflow/cli/src/__tests__/backlog-generator.test.ts} - Tests
+ * @see {@link packages/@lumenflow/cli/src/__tests__/backlog-checksum.test.ts} - Checksum tests
+ * @see {@link packages/@lumenflow/cli/src/__tests__/status-date-from-event.test.ts} - Date tests
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-state-store.ts} - State store
  */
 import { createHash } from 'node:crypto';
 import { existsSync, readdirSync } from 'node:fs';

package/dist/backlog-sync-validator.js

@@ -151,7 +151,7 @@ export function validateBacklogSync(backlogPath) {
             `   Fix: Migrate to sub-lane format using:${STRING_LITERALS.NEWLINE}` +
             `        pnpm wu:infer-lane --id WU-123     # Suggest a sub-lane${STRING_LITERALS.NEWLINE}` +
             `        pnpm wu:edit --id WU-123 --lane "Parent: Sub"${STRING_LITERALS.NEWLINE}` +
-            `   See: docs/04-operations/_frameworks/lumenflow/sub-lanes.md`);
+            `   See: https://lumenflow.dev/reference/sub-lanes/`);
     }
     return {
         valid: errors.length === 0,

package/dist/cleanup-lock.d.ts

@@ -1,5 +1,6 @@
 /**
  * WU-2241: Cleanup Lock Module
+ * WU-1174: Lock files moved to temp directory to avoid polluting main checkout
  *
  * Provides atomic locking mechanism for wu:done cleanup operations
  * to prevent race conditions during concurrent worktree/branch cleanup.
@@ -10,11 +11,12 @@
  * - Zombie lock detection (PID not running)
  * - Idempotent re-acquisition for same WU
  * - Guaranteed cleanup via withCleanupLock wrapper
+ * - Lock files stored in temp directory (not main checkout)
  *
  * Lock ordering (WU-2241):
  *   Lane lock (phase-scoped) -> Merge lock -> Cleanup lock -> State store lock
  *
- * Pattern: Follows lane-lock.mjs and merge-lock.mjs internal patterns.
+ * Pattern: Follows lane-lock.ts and merge-lock.ts internal patterns.
  *
  * @module cleanup-lock
  */
@@ -49,7 +51,12 @@ export declare const CLEANUP_LOCK_STALE_MS: number;
  * Options for lock file operations
  */
 interface BaseDirOptions {
-    /** Base directory (defaults to cwd) */
+    /**
+     * Base directory override (for testing only)
+     *
+     * WU-1174: In production, locks are always stored in LUMENFLOW_PATHS.LOCK_DIR
+     * (a temp directory). This option allows tests to use isolated directories.
+     */
     baseDir?: string;
 }
 /**

package/dist/cleanup-lock.js

@@ -1,5 +1,6 @@
 /**
  * WU-2241: Cleanup Lock Module
+ * WU-1174: Lock files moved to temp directory to avoid polluting main checkout
  *
  * Provides atomic locking mechanism for wu:done cleanup operations
  * to prevent race conditions during concurrent worktree/branch cleanup.
@@ -10,11 +11,12 @@
  * - Zombie lock detection (PID not running)
  * - Idempotent re-acquisition for same WU
  * - Guaranteed cleanup via withCleanupLock wrapper
+ * - Lock files stored in temp directory (not main checkout)
  *
  * Lock ordering (WU-2241):
  *   Lane lock (phase-scoped) -> Merge lock -> Cleanup lock -> State store lock
  *
- * Pattern: Follows lane-lock.mjs and merge-lock.mjs internal patterns.
+ * Pattern: Follows lane-lock.ts and merge-lock.ts internal patterns.
  *
  * @module cleanup-lock
  */
@@ -22,7 +24,7 @@
 import { existsSync, readFileSync, writeFileSync, unlinkSync, mkdirSync, openSync, closeSync, } from 'node:fs';
 import path from 'node:path';
 import crypto from 'node:crypto';
-import { LOG_PREFIX, EMOJI, LUMENFLOW_PATHS } from './wu-constants.js';
+import { LOG_PREFIX, EMOJI, LUMENFLOW_PATHS, LOCK_DIR_NAME } from './wu-constants.js';
 import { createError, ErrorCodes } from './error-handler.js';
 /**
  * Default timeout for waiting to acquire lock (ms)
@@ -44,12 +46,19 @@ const LOCK_POLL_INTERVAL_MS = 500;
 /**
  * Get the path to the cleanup lock file
  *
+ * WU-1174: Lock files are stored in a temp directory to avoid polluting
+ * the main checkout. The baseDir option is only for testing isolation.
+ *
  * @param {BaseDirOptions} [options]
  * @returns {string} Path to lock file
  */
 function getLockPath(options = {}) {
-    const baseDir = options.baseDir || process.cwd();
-    return path.join(baseDir, LUMENFLOW_PATHS.BASE, LOCK_FILE_NAME);
+    // WU-1174: Use temp directory for locks (not main checkout's .lumenflow/)
+    // baseDir is only used for test isolation
+    const lockDir = options.baseDir
+        ? path.join(options.baseDir, LOCK_DIR_NAME)
+        : LUMENFLOW_PATHS.LOCK_DIR;
+    return path.join(lockDir, LOCK_FILE_NAME);
 }
 /**
  * Read lock file contents
@@ -168,9 +177,10 @@ export function getCleanupLockInfo(options = {}) {
  */
 function tryAtomicLockCreate(lockInfo, options) {
     const lockPath = getLockPath(options);
-    const beaconDir = path.dirname(lockPath);
-    if (!existsSync(beaconDir)) {
-        mkdirSync(beaconDir, { recursive: true });
+    const lockDir = path.dirname(lockPath);
+    // WU-1174: Ensure lock directory exists (temp directory, not .lumenflow/)
+    if (!existsSync(lockDir)) {
+        mkdirSync(lockDir, { recursive: true });
     }
     try {
         // Use 'wx' flag for atomic creation

package/dist/code-path-validator.d.ts

@@ -3,9 +3,9 @@
  * Unified Code Path Validator (WU-1825)
  *
  * Consolidates three separate code path validators into one module:
- * - validateCodePathsExist (wu-done-validators.mjs) - file existence for wu:done
- * - validateLaneCodePaths (lane-validator.mjs) - lane pattern matching
- * - validateWUCodePaths (wu-validator.mjs) - code quality (TODOs, mocks)
+ * - validateCodePathsExist (wu-done-validators.ts) - file existence for wu:done
+ * - validateLaneCodePaths (lane-validator.ts) - lane pattern matching
+ * - validateWUCodePaths (wu-validator.ts) - code quality (TODOs, mocks)
  *
  * Usage:
  *   import { validate } from './code-path-validator.js';

package/dist/code-path-validator.js

@@ -3,9 +3,9 @@
  * Unified Code Path Validator (WU-1825)
  *
  * Consolidates three separate code path validators into one module:
- * - validateCodePathsExist (wu-done-validators.mjs) - file existence for wu:done
- * - validateLaneCodePaths (lane-validator.mjs) - lane pattern matching
- * - validateWUCodePaths (wu-validator.mjs) - code quality (TODOs, mocks)
+ * - validateCodePathsExist (wu-done-validators.ts) - file existence for wu:done
+ * - validateLaneCodePaths (lane-validator.ts) - lane pattern matching
+ * - validateWUCodePaths (wu-validator.ts) - code quality (TODOs, mocks)
  *
  * Usage:
  *   import { validate } from './code-path-validator.js';

package/dist/compliance-parser.d.ts

@@ -2,7 +2,7 @@
  * Compliance Parser
  *
  * Parses markdown compliance documentation into structured data.
- * Used by compliance-snapshot.mjs tool to create snapshots.
+ * Used by compliance-snapshot.ts tool to create snapshots.
  *
  * @module tools/lib/compliance-parser
  */

package/dist/compliance-parser.js

@@ -2,7 +2,7 @@
  * Compliance Parser
  *
  * Parses markdown compliance documentation into structured data.
- * Used by compliance-snapshot.mjs tool to create snapshots.
+ * Used by compliance-snapshot.ts tool to create snapshots.
  *
  * @module tools/lib/compliance-parser
  */

package/dist/constants/backlog-patterns.d.ts

@@ -2,7 +2,7 @@
  * Backlog Parsing Patterns
  *
  * Centralizes patterns for parsing status.md and backlog.md files.
- * Used by lane-checker.mjs and related backlog utilities.
+ * Used by lane-checker.ts and related backlog utilities.
  */
 /** Markdown section header patterns for In Progress section */
 export declare const IN_PROGRESS_HEADERS: string[];

package/dist/constants/backlog-patterns.js

@@ -2,7 +2,7 @@
  * Backlog Parsing Patterns
  *
  * Centralizes patterns for parsing status.md and backlog.md files.
- * Used by lane-checker.mjs and related backlog utilities.
+ * Used by lane-checker.ts and related backlog utilities.
  */
 /** Markdown section header patterns for In Progress section */
 export const IN_PROGRESS_HEADERS = ['## in progress', '## 🔧 in progress'];

package/dist/constants/dora-constants.d.ts

@@ -2,7 +2,7 @@
  * DORA Metrics Constants
  *
  * Thresholds based on "Accelerate" research by Nicole Forsgren, Jez Humble, Gene Kim.
- * Used by calculate-dora-metrics.mjs.
+ * Used by calculate-dora-metrics.ts.
  */
 /** Deployment frequency classification thresholds (deploys per week) */
 export declare const DEPLOYMENT_FREQUENCY: {

package/dist/constants/dora-constants.js

@@ -2,7 +2,7 @@
  * DORA Metrics Constants
  *
  * Thresholds based on "Accelerate" research by Nicole Forsgren, Jez Humble, Gene Kim.
- * Used by calculate-dora-metrics.mjs.
+ * Used by calculate-dora-metrics.ts.
  */
 /** Deployment frequency classification thresholds (deploys per week) */
 export const DEPLOYMENT_FREQUENCY = {

package/dist/constants/gate-constants.d.ts

@@ -2,7 +2,7 @@
  * Gate Configuration Constants
  *
  * Centralizes magic numbers for pre-commit and local gates.
- * Used by gates-pre-commit.mjs and gates-local.mjs.
+ * Used by gates-pre-commit.ts and gates-local.ts.
  */
 /** Gate execution configuration */
 export declare const GATE_CONFIG: {

package/dist/constants/gate-constants.js

@@ -2,7 +2,7 @@
  * Gate Configuration Constants
  *
  * Centralizes magic numbers for pre-commit and local gates.
- * Used by gates-pre-commit.mjs and gates-local.mjs.
+ * Used by gates-pre-commit.ts and gates-local.ts.
  */
 /** Gate execution configuration */
 export const GATE_CONFIG = {

package/dist/constants/linter-constants.d.ts

@@ -2,7 +2,7 @@
  * Linter Configuration Constants
  *
  * Centralizes magic numbers for spec-linter and related validation tools.
- * Used by packages/linters/spec-linter.mjs.
+ * Used by packages/linters/spec-linter.ts.
  */
 /** Spec linter configuration */
 export declare const LINTER_CONFIG: {

package/dist/constants/linter-constants.js

@@ -2,7 +2,7 @@
  * Linter Configuration Constants
  *
  * Centralizes magic numbers for spec-linter and related validation tools.
- * Used by packages/linters/spec-linter.mjs.
+ * Used by packages/linters/spec-linter.ts.
  */
 /** Spec linter configuration */
 export const LINTER_CONFIG = {

package/dist/constants/tokenizer-constants.d.ts

@@ -2,7 +2,7 @@
  * Tokenizer Constants
  *
  * Configuration for token estimation in documentation files.
- * Used by token-count.mjs.
+ * Used by token-count.ts.
  */
 /** Token estimation configuration */
 export declare const TOKENIZER: {

package/dist/constants/tokenizer-constants.js

@@ -2,7 +2,7 @@
  * Tokenizer Constants
  *
  * Configuration for token estimation in documentation files.
- * Used by token-count.mjs.
+ * Used by token-count.ts.
  */
 /** Token estimation configuration */
 export const TOKENIZER = {

package/dist/context/location-resolver.js

@@ -38,7 +38,8 @@ export async function resolveLocation(cwd = process.cwd()) {
         const gitRoot = (await git.revparse(['--show-toplevel'])).trim();
         const gitDir = (await git.revparse(['--git-dir'])).trim();
         // Detect if we're in a worktree (in worktrees, .git is a file not a dir)
-        const isWorktree = isGitDirFile(gitDir);
+        // WU-1223: Fixed - check .git in gitRoot, not the gitDir path returned by rev-parse
+        const isWorktree = isGitDirFile(resolve(gitRoot, '.git'));
         const mainCheckout = isWorktree ? await findMainCheckout(git) : gitRoot;
         // Parse worktree info
         const worktreeName = isWorktree ? parseWorktreeName(gitRoot, mainCheckout) : null;

package/dist/context-validation-integration.d.ts

@@ -12,6 +12,7 @@ import type { WuContext, ValidationResult } from './validation/types.js';
 declare const 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/core/scope-checker.d.ts

@@ -1,5 +1,5 @@
 /**
- * @file scope-checker.mjs
+ * @file scope-checker.ts
  * @description WU scope validation and code_paths enforcement (WU-1397)
  *
  * Provides runtime validation that file modifications stay within WU code_paths.
@@ -13,8 +13,8 @@
  *
  * Used by wu- scripts and future file operation guards.
  *
- * @see {@link tools/lib/core/worktree-guard.mjs} - WU context detection
- * @see {@link tools/lib/wu-schema.mjs} - WU YAML parsing
+ * @see {@link packages/@lumenflow/cli/src/lib/core/worktree-guard.ts} - WU context detection
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-schema.ts} - WU YAML parsing
  */
 import { getWUContext } from './worktree-guard.js';
 /**

package/dist/core/scope-checker.js

@@ -1,5 +1,5 @@
 /**
- * @file scope-checker.mjs
+ * @file scope-checker.ts
  * @description WU scope validation and code_paths enforcement (WU-1397)
  *
  * Provides runtime validation that file modifications stay within WU code_paths.
@@ -13,8 +13,8 @@
  *
  * Used by wu- scripts and future file operation guards.
  *
- * @see {@link tools/lib/core/worktree-guard.mjs} - WU context detection
- * @see {@link tools/lib/wu-schema.mjs} - WU YAML parsing
+ * @see {@link packages/@lumenflow/cli/src/lib/core/worktree-guard.ts} - WU context detection
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-schema.ts} - WU YAML parsing
  */
 import micromatch from 'micromatch';
 import { getWUContext } from './worktree-guard.js';

package/dist/core/tool-runner.d.ts

@@ -1,11 +1,11 @@
 /**
- * @file tool-runner.mjs
+ * @file tool-runner.ts
  * @description Unified tool execution layer integrating all core components (WU-1398)
  *
  * This module provides a higher-order function pattern for executing tools with:
  * - Input validation via Zod schemas (tool.schemas.ts)
- * - Worktree context detection (worktree-guard.mjs)
- * - Scope validation against code_paths (scope-checker.mjs)
+ * - Worktree context detection (worktree-guard.ts)
+ * - Scope validation against code_paths (scope-checker.ts)
  * - Audit logging for telemetry (.lumenflow/telemetry/tools.ndjson)
  * - Consistent error handling with agent-friendly messages
  *
@@ -21,8 +21,8 @@
  *   const result = await runner.run('tool:name', { arg: 'value' });
  *
  * @see tools/lib/core/tool.schemas.ts - Zod schemas for tool I/O
- * @see tools/lib/core/worktree-guard.mjs - WU context detection
- * @see tools/lib/core/scope-checker.mjs - Code path validation
+ * @see tools/lib/core/worktree-guard.ts - WU context detection
+ * @see tools/lib/core/scope-checker.ts - Code path validation
  */
 interface ToolMetadata {
     name: string;

package/dist/core/tool-runner.js

@@ -1,11 +1,11 @@
 /**
- * @file tool-runner.mjs
+ * @file tool-runner.ts
  * @description Unified tool execution layer integrating all core components (WU-1398)
  *
  * This module provides a higher-order function pattern for executing tools with:
  * - Input validation via Zod schemas (tool.schemas.ts)
- * - Worktree context detection (worktree-guard.mjs)
- * - Scope validation against code_paths (scope-checker.mjs)
+ * - Worktree context detection (worktree-guard.ts)
+ * - Scope validation against code_paths (scope-checker.ts)
  * - Audit logging for telemetry (.lumenflow/telemetry/tools.ndjson)
  * - Consistent error handling with agent-friendly messages
  *
@@ -21,8 +21,8 @@
  *   const result = await runner.run('tool:name', { arg: 'value' });
  *
  * @see tools/lib/core/tool.schemas.ts - Zod schemas for tool I/O
- * @see tools/lib/core/worktree-guard.mjs - WU context detection
- * @see tools/lib/core/scope-checker.mjs - Code path validation
+ * @see tools/lib/core/worktree-guard.ts - WU context detection
+ * @see tools/lib/core/scope-checker.ts - Code path validation
  */
 import { TOOL_ERROR_CODES, PERMISSION_LEVELS, TOOL_STATUS, DEFAULT_TOOL_TIMEOUT_MS, } from './tool.constants.js';
 import { validateToolInput, createErrorOutput } from './tool.schemas.js';

package/dist/core/tool.constants.d.ts

@@ -48,7 +48,7 @@ export declare const PERMISSION_LEVELS: {
 };
 export type PermissionLevel = (typeof PERMISSION_LEVELS)[keyof typeof PERMISSION_LEVELS];
 /**
- * Tool error codes (extends existing ErrorCodes from error-handler.mjs)
+ * Tool error codes (extends existing ErrorCodes from error-handler.ts)
  */
 export declare const TOOL_ERROR_CODES: {
     /** Tool not found in registry */

package/dist/core/tool.constants.js

@@ -46,7 +46,7 @@ export const PERMISSION_LEVELS = {
     ADMIN: 'admin',
 };
 /**
- * Tool error codes (extends existing ErrorCodes from error-handler.mjs)
+ * Tool error codes (extends existing ErrorCodes from error-handler.ts)
  */
 export const TOOL_ERROR_CODES = {
     /** Tool not found in registry */

package/dist/core/tool.schemas.d.ts

@@ -6,7 +6,7 @@
  * outputs, and metadata. Supports JSON Schema export for provider adapters
  * (MCP, OpenAI, Gemini).
  *
- * Reference: tools/lib/arg-parser.mjs for current argument handling patterns
+ * Reference: tools/lib/arg-parser.ts for current argument handling patterns
  */
 import { z, type ZodTypeAny } from 'zod';
 /**
@@ -140,8 +140,8 @@ export declare const ToolExecutionResultSchema: z.ZodObject<{
     tool: z.ZodString;
     status: z.ZodEnum<{
         cancelled: "cancelled";
-        timeout: "timeout";
         success: "success";
+        timeout: "timeout";
         failed: "failed";
         pending: "pending";
         running: "running";

package/dist/core/tool.schemas.js

@@ -6,7 +6,7 @@
  * outputs, and metadata. Supports JSON Schema export for provider adapters
  * (MCP, OpenAI, Gemini).
  *
- * Reference: tools/lib/arg-parser.mjs for current argument handling patterns
+ * Reference: tools/lib/arg-parser.ts for current argument handling patterns
  */
 import { z } from 'zod';
 import { TOOL_DOMAINS, PERMISSION_LEVELS, TOOL_STATUS, } from './tool.constants.js';

package/dist/core/worktree-guard.d.ts

@@ -1,5 +1,5 @@
 /**
- * @file worktree-guard.mjs
+ * @file worktree-guard.ts
  * @description WU context validation and main branch protection (WU-1396)
  *
  * Provides runtime guards to enforce worktree discipline: