@lumenflow/core 2.2.2 → 2.3.1

package/dist/wu-state-schema.d.ts

@@ -4,7 +4,7 @@
  * Zod schemas for WU state event validation.
  * Defines event types for WU lifecycle: create, claim, block, unblock, complete.
  *
- * @see {@link tools/lib/__tests__/wu-state-store.test.mjs} - Tests
+ * @see {@link packages/@lumenflow/cli/src/lib/__tests__/wu-state-store.test.ts} - Tests
  */
 import { z } from 'zod';
 /**

package/dist/wu-state-schema.js

@@ -4,7 +4,7 @@
  * Zod schemas for WU state event validation.
  * Defines event types for WU lifecycle: create, claim, block, unblock, complete.
  *
- * @see {@link tools/lib/__tests__/wu-state-store.test.mjs} - Tests
+ * @see {@link packages/@lumenflow/cli/src/lib/__tests__/wu-state-store.test.ts} - Tests
  */
 import { z } from 'zod';
 /**

package/dist/wu-state-store.d.ts

@@ -12,8 +12,8 @@
  * - File locking with stale detection (WU-2240)
  * - Corruption recovery via repairStateFile (WU-2240)
  *
- * @see {@link tools/__tests__/state-store-concurrent.test.mjs} - Concurrent access tests
- * @see {@link tools/lib/wu-state-schema.mjs} - Schema definitions
+ * @see {@link packages/@lumenflow/cli/src/__tests__/state-store-concurrent.test.ts} - Concurrent access tests
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-state-schema.ts} - Schema definitions
  */
 import { type WUEvent } from './wu-state-schema.js';
 /**
@@ -174,7 +174,7 @@ export declare class WUStateStore {
      * @example
      * await store.checkpoint('WU-1748', 'Completed worktree scanner', {
      *   progress: 'Scanner implemented and tests passing',
-     *   nextSteps: 'Integrate into orchestrate:status'
+     *   nextSteps: 'Integrate into orchestrate:monitor'
      * });
      */
     checkpoint(wuId: string, note: string, options?: CheckpointOptions): Promise<void>;

package/dist/wu-state-store.js

@@ -12,8 +12,8 @@
  * - File locking with stale detection (WU-2240)
  * - Corruption recovery via repairStateFile (WU-2240)
  *
- * @see {@link tools/__tests__/state-store-concurrent.test.mjs} - Concurrent access tests
- * @see {@link tools/lib/wu-state-schema.mjs} - Schema definitions
+ * @see {@link packages/@lumenflow/cli/src/__tests__/state-store-concurrent.test.ts} - Concurrent access tests
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-state-schema.ts} - Schema definitions
  */
 import fs from 'node:fs/promises';
 import { existsSync, readFileSync, writeFileSync, mkdirSync, renameSync, unlinkSync, openSync, closeSync, fsyncSync, } from 'node:fs';
@@ -376,7 +376,7 @@ export class WUStateStore {
      * @example
      * await store.checkpoint('WU-1748', 'Completed worktree scanner', {
      *   progress: 'Scanner implemented and tests passing',
-     *   nextSteps: 'Integrate into orchestrate:status'
+     *   nextSteps: 'Integrate into orchestrate:monitor'
      * });
      */
     async checkpoint(wuId, note, options = {}) {

package/dist/wu-status-transition.d.ts

@@ -2,7 +2,7 @@
  * WU Status Transition Module
  *
  * Shared logic for block/unblock status transitions.
- * Eliminates 90% code duplication between wu-block.mjs and wu-unblock.mjs.
+ * Eliminates 90% code duplication between wu-block.ts and wu-unblock.ts.
  *
  * Responsibilities:
  * - Validate state transitions (via state-machine)

package/dist/wu-status-transition.js

@@ -2,7 +2,7 @@
  * WU Status Transition Module
  *
  * Shared logic for block/unblock status transitions.
- * Eliminates 90% code duplication between wu-block.mjs and wu-unblock.mjs.
+ * Eliminates 90% code duplication between wu-block.ts and wu-unblock.ts.
  *
  * Responsibilities:
  * - Validate state transitions (via state-machine)

package/dist/wu-status-updater.d.ts

@@ -1,14 +1,14 @@
 /**
  * Status.md Update Utilities
  *
- * Centralized status.md update functions (extracted from wu-done.mjs)
+ * Centralized status.md update functions (extracted from wu-done.ts)
  * Refactored to use frontmatter-based section headings (no magic strings)
  *
  * Used by both main wu:done flow AND recovery mode (DRY principle)
  */
 /**
  * Remove WU from In Progress section (idempotent)
- * Refactored from wu-done.mjs line 471 to use frontmatter headings
+ * Refactored from wu-done.ts line 471 to use frontmatter headings
  *
  * @param {string} statusPath - Path to status.md
  * @param {string} id - WU ID
@@ -16,7 +16,7 @@
 export declare function updateStatusRemoveInProgress(statusPath: any, id: any): void;
 /**
  * Add WU to Completed section (idempotent - checks for duplicates)
- * Refactored from wu-done.mjs line 499 to use frontmatter headings
+ * Refactored from wu-done.ts line 499 to use frontmatter headings
  *
  * @param {string} statusPath - Path to status.md
  * @param {string} id - WU ID

package/dist/wu-status-updater.js

@@ -1,7 +1,7 @@
 /**
  * Status.md Update Utilities
  *
- * Centralized status.md update functions (extracted from wu-done.mjs)
+ * Centralized status.md update functions (extracted from wu-done.ts)
  * Refactored to use frontmatter-based section headings (no magic strings)
  *
  * Used by both main wu:done flow AND recovery mode (DRY principle)
@@ -15,7 +15,7 @@ import { die, createError, ErrorCodes } from './error-handler.js';
 import { STRING_LITERALS } from './wu-constants.js';
 /**
  * Remove WU from In Progress section (idempotent)
- * Refactored from wu-done.mjs line 471 to use frontmatter headings
+ * Refactored from wu-done.ts line 471 to use frontmatter headings
  *
  * @param {string} statusPath - Path to status.md
  * @param {string} id - WU ID
@@ -67,7 +67,7 @@ export function updateStatusRemoveInProgress(statusPath, id) {
 }
 /**
  * Add WU to Completed section (idempotent - checks for duplicates)
- * Refactored from wu-done.mjs line 499 to use frontmatter headings
+ * Refactored from wu-done.ts line 499 to use frontmatter headings
  *
  * @param {string} statusPath - Path to status.md
  * @param {string} id - WU ID

package/dist/wu-validation-constants.d.ts

@@ -2,7 +2,7 @@
  * WU Validation Constants (WU-1243)
  *
  * Centralizes magic numbers for lane inference and incident validation.
- * Extracted from lane-inference.mjs and agent-incidents.mjs for DRY compliance.
+ * Extracted from lane-inference.ts and agent-incidents.ts for DRY compliance.
  *
  * @module wu-validation-constants
  */
@@ -55,6 +55,6 @@ export declare const VALIDATION_LIMITS: {
 };
 /**
  * Valid incident categories for agent issue logging.
- * Duplicated from agent-incidents.mjs z.enum for use in default arrays.
+ * Duplicated from agent-incidents.ts z.enum for use in default arrays.
  */
 export declare const INCIDENT_CATEGORIES: readonly ["workflow", "tooling", "confusion", "violation", "error"];

package/dist/wu-validation-constants.js

@@ -2,7 +2,7 @@
  * WU Validation Constants (WU-1243)
  *
  * Centralizes magic numbers for lane inference and incident validation.
- * Extracted from lane-inference.mjs and agent-incidents.mjs for DRY compliance.
+ * Extracted from lane-inference.ts and agent-incidents.ts for DRY compliance.
  *
  * @module wu-validation-constants
  */
@@ -55,7 +55,7 @@ export const VALIDATION_LIMITS = {
 };
 /**
  * Valid incident categories for agent issue logging.
- * Duplicated from agent-incidents.mjs z.enum for use in default arrays.
+ * Duplicated from agent-incidents.ts z.enum for use in default arrays.
  */
 export const INCIDENT_CATEGORIES = [
     'workflow',

package/dist/wu-validation.d.ts

@@ -9,9 +9,9 @@
  *
  * Part of INIT-031 Phase 4: Prevent backend-without-UI pattern.
  *
- * @see {@link tools/wu-done.mjs} - Consumer
- * @see {@link tools/lib/wu-schema.mjs} - WU schema with exposure field
- * @see {@link tools/lib/wu-constants.mjs} - WU_EXPOSURE values
+ * @see {@link packages/@lumenflow/cli/src/wu-done.ts} - Consumer
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-schema.ts} - WU schema with exposure field
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-constants.ts} - WU_EXPOSURE values
  */
 export declare function resolveExposureDefault(lane: any): "documentation" | "backend-only";
 /**

package/dist/wu-validation.js

@@ -9,9 +9,9 @@
  *
  * Part of INIT-031 Phase 4: Prevent backend-without-UI pattern.
  *
- * @see {@link tools/wu-done.mjs} - Consumer
- * @see {@link tools/lib/wu-schema.mjs} - WU schema with exposure field
- * @see {@link tools/lib/wu-constants.mjs} - WU_EXPOSURE values
+ * @see {@link packages/@lumenflow/cli/src/wu-done.ts} - Consumer
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-schema.ts} - WU schema with exposure field
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-constants.ts} - WU_EXPOSURE values
  */
 import { WU_EXPOSURE } from './wu-constants.js';
 const LANE_PARENTS = {

package/dist/wu-yaml-fixer.d.ts

@@ -10,8 +10,8 @@
  * - docs → documentation (type field)
  * - String numbers → number (phase field)
  *
- * @see {@link tools/lib/wu-schema.mjs} - WU schema definition
- * @see {@link tools/wu-claim.mjs} - Consumer
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-schema.ts} - WU schema definition
+ * @see {@link packages/@lumenflow/cli/src/wu-claim.ts} - Consumer
  */
 /**
  * Issue types that can be detected and auto-fixed

package/dist/wu-yaml-fixer.js

@@ -10,13 +10,13 @@
  * - docs → documentation (type field)
  * - String numbers → number (phase field)
  *
- * @see {@link tools/lib/wu-schema.mjs} - WU schema definition
- * @see {@link tools/wu-claim.mjs} - Consumer
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-schema.ts} - WU schema definition
+ * @see {@link packages/@lumenflow/cli/src/wu-claim.ts} - Consumer
  */
 import { readFileSync, writeFileSync, copyFileSync } from 'node:fs';
 import { parseYAML, stringifyYAML } from './wu-yaml.js';
 import { DEFAULTS, STRING_LITERALS } from './wu-constants.js';
-// Valid type values from wu-schema.mjs
+// Valid type values from wu-schema.ts
 const VALID_TYPES = ['feature', 'bug', 'documentation', 'process', 'tooling', 'chore', 'refactor'];
 // Common type aliases that should be auto-fixed
 const TYPE_ALIASES = {

package/dist/wu-yaml.d.ts

@@ -27,6 +27,20 @@ export declare const YAML_STRINGIFY_OPTIONS: Readonly<{
  * @throws {Error} If file not found, YAML invalid, or ID mismatch
  */
 export declare function readWU(wuPath: any, expectedId: any): any;
+/**
+ * Read and parse WU YAML file asynchronously.
+ *
+ * Validates:
+ * - File exists
+ * - YAML is valid
+ * - WU ID matches expected ID
+ *
+ * @param {string} wuPath - Path to WU YAML file
+ * @param {string} expectedId - Expected WU ID (e.g., 'WU-123')
+ * @returns {Promise<object>} Parsed YAML document
+ * @throws {Error} If file not found, YAML invalid, or ID mismatch
+ */
+export declare function readWUAsync(wuPath: any, expectedId: any): Promise<any>;
 /**
  * Parse YAML string to object.
  * WU-1352: Centralized YAML parsing for consistency.
@@ -54,6 +68,15 @@ export declare function stringifyYAML(doc: any, options?: {}): string;
  * @throws {Error} If file not found or YAML invalid
  */
 export declare function readWURaw(yamlPath: any): any;
+/**
+ * Read and parse YAML file without ID validation asynchronously.
+ * WU-1352: For cases where you don't know/need to validate the WU ID.
+ *
+ * @param {string} yamlPath - Path to YAML file
+ * @returns {Promise<object>} Parsed YAML document
+ * @throws {Error} If file not found or YAML invalid
+ */
+export declare function readWURawAsync(yamlPath: any): Promise<any>;
 /**
  * Write WU YAML file with consistent formatting.
  * WU-1352: Uses YAML_STRINGIFY_OPTIONS for consistent output.

package/dist/wu-yaml.js

@@ -1,7 +1,8 @@
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, readFileSync, writeFileSync, promises as fs } from 'node:fs';
 import { parse, stringify } from 'yaml';
 import { createError, ErrorCodes } from './error-handler.js';
 import { STRING_LITERALS } from './wu-constants.js';
+import { createWuPaths } from './wu-paths.js';
 /**
  * Unified WU YAML I/O module.
  *
@@ -102,6 +103,48 @@ export function readWU(wuPath, expectedId) {
     }
     return doc;
 }
+/**
+ * Read and parse WU YAML file asynchronously.
+ *
+ * Validates:
+ * - File exists
+ * - YAML is valid
+ * - WU ID matches expected ID
+ *
+ * @param {string} wuPath - Path to WU YAML file
+ * @param {string} expectedId - Expected WU ID (e.g., 'WU-123')
+ * @returns {Promise<object>} Parsed YAML document
+ * @throws {Error} If file not found, YAML invalid, or ID mismatch
+ */
+export async function readWUAsync(wuPath, expectedId) {
+    try {
+        const text = await fs.readFile(wuPath, { encoding: 'utf-8' });
+        let doc;
+        try {
+            doc = parse(text);
+        }
+        catch (e) {
+            throw createError(ErrorCodes.YAML_PARSE_ERROR, `Failed to parse YAML ${wuPath}: ${e.message}`, {
+                path: wuPath,
+                originalError: e.message,
+            });
+        }
+        // Validate ID matches
+        if (!doc || doc.id !== expectedId) {
+            throw createError(ErrorCodes.WU_NOT_FOUND, `WU YAML id mismatch. Expected ${expectedId}, found ${doc && doc.id}`, { path: wuPath, expectedId, foundId: doc && doc.id });
+        }
+        return doc;
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw createError(ErrorCodes.FILE_NOT_FOUND, `WU file not found: ${wuPath}`, {
+                path: wuPath,
+                expectedId,
+            });
+        }
+        throw err;
+    }
+}
 /**
  * Parse YAML string to object.
  * WU-1352: Centralized YAML parsing for consistency.
@@ -149,6 +192,36 @@ export function readWURaw(yamlPath) {
         });
     }
 }
+/**
+ * Read and parse YAML file without ID validation asynchronously.
+ * WU-1352: For cases where you don't know/need to validate the WU ID.
+ *
+ * @param {string} yamlPath - Path to YAML file
+ * @returns {Promise<object>} Parsed YAML document
+ * @throws {Error} If file not found or YAML invalid
+ */
+export async function readWURawAsync(yamlPath) {
+    try {
+        const text = await fs.readFile(yamlPath, { encoding: 'utf-8' });
+        try {
+            return parse(text);
+        }
+        catch (e) {
+            throw createError(ErrorCodes.YAML_PARSE_ERROR, `Failed to parse YAML ${yamlPath}: ${e.message}`, {
+                path: yamlPath,
+                originalError: e.message,
+            });
+        }
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw createError(ErrorCodes.FILE_NOT_FOUND, `YAML file not found: ${yamlPath}`, {
+                path: yamlPath,
+            });
+        }
+        throw err;
+    }
+}
 /**
  * Write WU YAML file with consistent formatting.
  * WU-1352: Uses YAML_STRINGIFY_OPTIONS for consistent output.
@@ -205,7 +278,8 @@ export function appendNote(doc, note) {
  * @throws {Error} if WU file not found
  */
 export function appendAgentSession(wuId, sessionData) {
-    const wuPath = `docs/04-operations/tasks/wu/${wuId}.yaml`;
+    const paths = createWuPaths();
+    const wuPath = paths.WU(wuId);
     if (!existsSync(wuPath)) {
         throw new Error(`WU file not found: ${wuPath}`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/core",
-  "version": "2.2.2",
+  "version": "2.3.1",
   "description": "Core WU lifecycle tools for LumenFlow workflow framework",
   "keywords": [
     "lumenflow",
@@ -40,6 +40,7 @@
     "./spawn-monitor": "./dist/spawn-monitor.js",
     "./spawn-escalation": "./dist/spawn-escalation.js",
     "./spawn-prompt-schema": "./dist/spawn-prompt-schema.js",
+    "./wu-spawn-context": "./dist/wu-spawn-context.js",
     "./backlog-generator": "./dist/backlog-generator.js",
     "./backlog-parser": "./dist/backlog-parser.js",
     "./backlog-editor": "./dist/backlog-editor.js",
@@ -52,8 +53,10 @@
     "./dependency-guard": "./dist/dependency-guard.js",
     "./worktree-scanner": "./dist/worktree-scanner.js",
     "./worktree-ownership": "./dist/worktree-ownership.js",
+    "./lane-suggest-prompt": "./dist/lane-suggest-prompt.js",
     "./config": "./dist/lumenflow-config.js",
     "./config-schema": "./dist/lumenflow-config-schema.js",
+    "./test-baseline": "./dist/test-baseline.js",
     "./dist/*": "./dist/*",
     "./lib/*": "./dist/*"
   },
@@ -95,7 +98,7 @@
     "vitest": "^4.0.17"
   },
   "peerDependencies": {
-    "@lumenflow/memory": "2.2.2"
+    "@lumenflow/memory": "2.3.1"
   },
   "peerDependenciesMeta": {
     "@lumenflow/memory": {