@lumenflow/core 2.4.0 → 2.5.1

package/dist/wu-constants.d.ts

@@ -253,6 +253,10 @@ export declare const LOG_PREFIX: {
     CONSISTENCY: string;
     PREFLIGHT: string;
     INITIATIVE_PLAN: string;
+    PLAN_CREATE: string;
+    PLAN_LINK: string;
+    PLAN_EDIT: string;
+    PLAN_PROMOTE: string;
 };
 /**
  * Consistency check types (WU-1276)
@@ -940,6 +944,8 @@ export declare const GATE_NAMES: {
     SYSTEM_MAP_VALIDATE: string;
     /** WU-1191: Lane health check (overlap detection) */
     LANE_HEALTH: string;
+    /** WU-1315: Onboarding smoke test (init + wu:create validation) */
+    ONBOARDING_SMOKE_TEST: string;
 };
 /**
  * Gate command sentinels (special values for non-shell commands)
@@ -959,6 +965,8 @@ export declare const GATE_COMMANDS: {
     SAFETY_CRITICAL_TEST: string;
     /** WU-2062: Triggers tiered test execution based on risk */
     TIERED_TEST: string;
+    /** WU-1315: Triggers onboarding smoke test */
+    ONBOARDING_SMOKE_TEST: string;
 };
 /**
  * CLI mode flags

package/dist/wu-constants.js

@@ -269,6 +269,10 @@ export const LOG_PREFIX = {
     CONSISTENCY: '[wu-consistency]',
     PREFLIGHT: '[wu-preflight]',
     INITIATIVE_PLAN: '[initiative:plan]',
+    PLAN_CREATE: '[plan:create]',
+    PLAN_LINK: '[plan:link]',
+    PLAN_EDIT: '[plan:edit]',
+    PLAN_PROMOTE: '[plan:promote]',
 };
 /**
  * Consistency check types (WU-1276)
@@ -985,6 +989,8 @@ export const GATE_NAMES = {
     SYSTEM_MAP_VALIDATE: 'system-map:validate',
     /** WU-1191: Lane health check (overlap detection) */
     LANE_HEALTH: 'lane-health',
+    /** WU-1315: Onboarding smoke test (init + wu:create validation) */
+    ONBOARDING_SMOKE_TEST: 'onboarding-smoke-test',
 };
 /**
  * Gate command sentinels (special values for non-shell commands)
@@ -1004,6 +1010,8 @@ export const GATE_COMMANDS = {
     SAFETY_CRITICAL_TEST: 'safety-critical-test',
     /** WU-2062: Triggers tiered test execution based on risk */
     TIERED_TEST: 'tiered-test',
+    /** WU-1315: Triggers onboarding smoke test */
+    ONBOARDING_SMOKE_TEST: 'onboarding-smoke-test',
 };
 /**
  * CLI mode flags

package/dist/wu-done-concurrent-merge.d.ts

@@ -86,6 +86,19 @@ export declare function mergeWithMainState(worktreeStateDir: string): Promise<WU
  * @returns Merged backlog.md content
  */
 export declare function computeBacklogContentWithMainMerge(backlogPath: string, wuId: string): Promise<string>;
+/**
+ * Compute status.md content with merged state from origin/main.
+ *
+ * WU-1319: This function generates status.md from the merged state store
+ * instead of editing the local file snapshot. This prevents reintroducing
+ * stale "In Progress" entries when concurrent WUs complete on main.
+ *
+ * @param backlogPath - Path to backlog.md in the worktree (used to find state dir)
+ * @param wuId - WU ID being completed
+ * @param mainStateDir - Optional explicit path to main state dir (for testing)
+ * @returns Merged status.md content
+ */
+export declare function computeStatusContentWithMainMerge(backlogPath: string, wuId: string, mainStateDir?: string): Promise<string>;
 /**
  * Compute wu-events.jsonl content with merged state from origin/main.
  *

package/dist/wu-done-concurrent-merge.js

@@ -15,7 +15,7 @@ import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { WUStateStore, WU_EVENTS_FILE_NAME } from './wu-state-store.js';
 import { validateWUEvent } from './wu-state-schema.js';
-import { generateBacklog } from './backlog-generator.js';
+import { generateBacklog, generateStatus } from './backlog-generator.js';
 import { getStateStoreDirFromBacklog } from './wu-paths.js';
 import { getGitForCwd } from './git-adapter.js';
 import { REMOTES, BRANCHES, BEACON_PATHS } from './wu-constants.js';
@@ -286,6 +286,46 @@ export async function computeBacklogContentWithMainMerge(backlogPath, wuId) {
     // Generate backlog from merged state
     return generateBacklog(mergedStore);
 }
+/**
+ * Compute status.md content with merged state from origin/main.
+ *
+ * WU-1319: This function generates status.md from the merged state store
+ * instead of editing the local file snapshot. This prevents reintroducing
+ * stale "In Progress" entries when concurrent WUs complete on main.
+ *
+ * @param backlogPath - Path to backlog.md in the worktree (used to find state dir)
+ * @param wuId - WU ID being completed
+ * @param mainStateDir - Optional explicit path to main state dir (for testing)
+ * @returns Merged status.md content
+ */
+export async function computeStatusContentWithMainMerge(backlogPath, wuId, mainStateDir) {
+    const worktreeStateDir = getStateStoreDirFromBacklog(backlogPath);
+    let mergedStore;
+    if (mainStateDir) {
+        // Direct merge with provided main state dir (for testing)
+        mergedStore = await mergeStateStores(worktreeStateDir, mainStateDir);
+    }
+    else {
+        // Merge with main state via git show
+        mergedStore = await mergeWithMainState(worktreeStateDir);
+    }
+    // Check if the WU exists in the merged state
+    const currentState = mergedStore.getWUState(wuId);
+    if (!currentState) {
+        throw new Error(`WU ${wuId} not found in merged state store. ` +
+            `This may indicate the WU was never properly claimed.`);
+    }
+    // If not already done, create and apply the complete event
+    if (currentState.status !== 'done') {
+        if (currentState.status !== 'in_progress') {
+            throw new Error(`WU ${wuId} is in status "${currentState.status}", expected "in_progress"`);
+        }
+        const completeEvent = mergedStore.createCompleteEvent(wuId);
+        mergedStore.applyEvent(completeEvent);
+    }
+    // Generate status from merged state
+    return generateStatus(mergedStore);
+}
 /**
  * Compute wu-events.jsonl content with merged state from origin/main.
  *

package/dist/wu-done-metadata.js

@@ -10,7 +10,7 @@ import { updateStatusRemoveInProgress, addToStatusCompleted } from './wu-status-
 import { moveWUToDoneBacklog } from './wu-backlog-updater.js';
 import { createStamp } from './stamp-utils.js';
 import { WU_EVENTS_FILE_NAME } from './wu-state-store.js';
-import { computeWUYAMLContent, computeStatusContent, computeBacklogContent, computeWUEventsContentAfterComplete, computeStampContent, } from './wu-transaction-collectors.js';
+import { computeWUYAMLContent, computeStatusContentFromMergedState, computeBacklogContent, computeWUEventsContentAfterComplete, computeStampContent, } from './wu-transaction-collectors.js';
 import { DEFAULTS, LOG_PREFIX, EMOJI, PKG_MANAGER, SCRIPTS, PRETTIER_FLAGS, BEACON_PATHS, } from './wu-constants.js';
 import { applyExposureDefaults } from './wu-done-validation.js';
 import { createFileNotFoundError, createValidationError } from './wu-done-errors.js';
@@ -139,8 +139,8 @@ export async function collectMetadataToTransaction({ id, title, doc, wuPath, sta
     // Compute WU YAML content (mutates doc, returns YAML string)
     const wuYAMLContent = computeWUYAMLContent(doc);
     transaction.addWrite(wuPath, wuYAMLContent, 'WU YAML');
-    // Compute status.md content
-    const statusContent = computeStatusContent(statusPath, id, title);
+    // Compute status.md content (WU-1319: now uses merged state)
+    const statusContent = await computeStatusContentFromMergedState(backlogPath, id);
     transaction.addWrite(statusPath, statusContent, 'status.md');
     // Compute backlog.md content (WU-1574: now async)
     const backlogContent = await computeBacklogContent(backlogPath, id, title);

package/dist/wu-paths.d.ts

@@ -82,6 +82,16 @@ export declare function createWuPaths(options?: {
      * @returns Path to plans directory (WU-1301)
      */
     PLANS_DIR: () => string;
+    /**
+     * Get path to templates directory
+     * @returns Path to templates directory (WU-1310)
+     */
+    TEMPLATES_DIR: () => string;
+    /**
+     * Get path to onboarding directory
+     * @returns Path to onboarding directory (WU-1310)
+     */
+    ONBOARDING_DIR: () => string;
 };
 /**
  * Default WU paths using default config
@@ -140,6 +150,16 @@ export declare const WU_PATHS: {
      * @returns Path to plans directory (WU-1301)
      */
     PLANS_DIR: () => string;
+    /**
+     * Get path to templates directory
+     * @returns Path to templates directory (WU-1310)
+     */
+    TEMPLATES_DIR: () => string;
+    /**
+     * Get path to onboarding directory
+     * @returns Path to onboarding directory (WU-1310)
+     */
+    ONBOARDING_DIR: () => string;
 };
 /**
  * Generate default worktree path from WU document

package/dist/wu-paths.js

@@ -109,6 +109,16 @@ export function createWuPaths(options = {}) {
          * @returns Path to plans directory (WU-1301)
          */
         PLANS_DIR: () => config.directories.plansDir,
+        /**
+         * Get path to templates directory
+         * @returns Path to templates directory (WU-1310)
+         */
+        TEMPLATES_DIR: () => config.directories.templatesDir,
+        /**
+         * Get path to onboarding directory
+         * @returns Path to onboarding directory (WU-1310)
+         */
+        ONBOARDING_DIR: () => config.directories.onboardingDir,
     };
 }
 /**

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

@@ -50,6 +50,36 @@ export declare function createPreflightResult({ valid, errors, missingCodePaths,
     missingTestPaths: any[];
     suggestedTestPaths: {};
 };
+/**
+ * Validate code_paths files exist
+ *
+ * WU-1329: Exported for use by wu:create strict validation.
+ *
+ * @param {string[]} codePaths - List of code paths from WU YAML
+ * @param {string} rootDir - Root directory to resolve paths against
+ * @returns {{ valid: boolean, errors: string[], missing: string[] }}
+ */
+export declare function validateCodePathsExistence(codePaths: any, rootDir: any): {
+    valid: boolean;
+    errors: string[];
+    missing: any[];
+};
+/**
+ * Validate test file paths exist (unit, e2e, integration - not manual)
+ *
+ * Manual tests are descriptions, not file paths, so they're skipped.
+ *
+ * WU-1329: Exported for use by wu:create strict validation.
+ *
+ * @param {object} tests - tests object from WU YAML
+ * @param {string} rootDir - Root directory to resolve paths against
+ * @returns {{ valid: boolean, errors: string[], missing: string[] }}
+ */
+export declare function validateTestPathsExistence(tests: any, rootDir: any): {
+    valid: boolean;
+    errors: string[];
+    missing: any[];
+};
 /**
  * Run preflight validation for a WU
  *

package/dist/wu-preflight-validators.js

@@ -105,11 +105,13 @@ function validateSchema(doc, id) {
 /**
  * Validate code_paths files exist
  *
+ * WU-1329: Exported for use by wu:create strict validation.
+ *
  * @param {string[]} codePaths - List of code paths from WU YAML
  * @param {string} rootDir - Root directory to resolve paths against
  * @returns {{ valid: boolean, errors: string[], missing: string[] }}
  */
-function validateCodePathsExistence(codePaths, rootDir) {
+export function validateCodePathsExistence(codePaths, rootDir) {
     if (!codePaths || !Array.isArray(codePaths) || codePaths.length === 0) {
         return { valid: true, errors: [], missing: [] };
     }
@@ -136,11 +138,13 @@ function validateCodePathsExistence(codePaths, rootDir) {
  *
  * Manual tests are descriptions, not file paths, so they're skipped.
  *
+ * WU-1329: Exported for use by wu:create strict validation.
+ *
  * @param {object} tests - tests object from WU YAML
  * @param {string} rootDir - Root directory to resolve paths against
  * @returns {{ valid: boolean, errors: string[], missing: string[] }}
  */
-function validateTestPathsExistence(tests, rootDir) {
+export function validateTestPathsExistence(tests, rootDir) {
     if (!tests || typeof tests !== 'object') {
         return { valid: true, errors: [], missing: [] };
     }

package/dist/wu-transaction-collectors.d.ts

@@ -71,6 +71,18 @@ export declare function computeWUEventsContentAfterComplete(backlogPath: any, wu
  * @returns {Promise<string>} New backlog.md content
  */
 export declare function computeBacklogContent(backlogPath: any, id: any, _title: any): Promise<string>;
+/**
+ * Compute updated status.md content from merged state store
+ *
+ * WU-1319: Generates status.md from merged state (origin/main + worktree events)
+ * instead of editing the local file snapshot. This prevents reintroducing
+ * stale "In Progress" entries when concurrent WUs complete on main.
+ *
+ * @param {string} backlogPath - Path to backlog.md (used to find state dir)
+ * @param {string} id - WU ID to mark complete
+ * @returns {Promise<string>} New status.md content
+ */
+export declare function computeStatusContentFromMergedState(backlogPath: any, id: any): Promise<string>;
 /**
  * Compute stamp file content
  *
@@ -82,6 +94,7 @@ export declare function computeStampContent(id: any, title: any): string;
 /**
  * Collect all metadata updates for a transaction
  * WU-1574: Made async for computeBacklogContent
+ * WU-1319: Made status.md generation use merged state
  *
  * Convenience function that computes all file contents at once.
  * Returns an object with all computed content.

package/dist/wu-transaction-collectors.js

@@ -30,12 +30,8 @@ import { getSectionHeadingsWithDefaults } from './section-headings.js';
 import { todayISO } from './date-utils.js';
 import { createError, ErrorCodes } from './error-handler.js';
 import { STRING_LITERALS } from './wu-constants.js';
-// WU-1574: BacklogManager removed - using state store + generator
-import { WUStateStore } from './wu-state-store.js';
-// WU-1734: Import proper path resolution utility
-import { getStateStoreDirFromBacklog } from './wu-paths.js';
-// WU-1145: Import concurrent merge utilities
-import { computeBacklogContentWithMainMerge, computeWUEventsContentWithMainMerge, } from './wu-done-concurrent-merge.js';
+// WU-1145, WU-1319: Import concurrent merge utilities
+import { computeBacklogContentWithMainMerge, computeStatusContentWithMainMerge, computeWUEventsContentWithMainMerge, } from './wu-done-concurrent-merge.js';
 /**
  * Compute WU YAML content for done state
  *
@@ -167,31 +163,6 @@ export function computeStatusContent(statusPath, id, title) {
     const frontmatterText = frontmatterMatch ? frontmatterMatch[0] : '';
     return frontmatterText + lines.join(STRING_LITERALS.NEWLINE);
 }
-function ensureTrailingNewline(content) {
-    if (content === '')
-        return content;
-    if (content.endsWith(STRING_LITERALS.NEWLINE))
-        return content;
-    return content + STRING_LITERALS.NEWLINE;
-}
-async function computeCompletionUpdatesFromStateStore(backlogPath, wuId) {
-    const stateDir = getStateStoreDirFromBacklog(backlogPath);
-    const store = new WUStateStore(stateDir);
-    await store.load();
-    const current = store.getWUState(wuId);
-    if (!current) {
-        throw new Error(`WU ${wuId} is not in_progress`);
-    }
-    if (current.status === 'done') {
-        return { store, stateDir, shouldAppendCompleteEvent: false, completeEvent: null };
-    }
-    if (current.status !== 'in_progress') {
-        throw new Error(`WU ${wuId} is not in_progress`);
-    }
-    const completeEvent = store.createCompleteEvent(wuId);
-    store.applyEvent(completeEvent);
-    return { store, stateDir, shouldAppendCompleteEvent: true, completeEvent };
-}
 /**
  * Compute wu-events.jsonl content after completing a WU.
  *
@@ -221,6 +192,21 @@ export async function computeBacklogContent(backlogPath, id, _title) {
     // WU-1145: Use merged state to preserve concurrent changes
     return computeBacklogContentWithMainMerge(backlogPath, id);
 }
+/**
+ * Compute updated status.md content from merged state store
+ *
+ * WU-1319: Generates status.md from merged state (origin/main + worktree events)
+ * instead of editing the local file snapshot. This prevents reintroducing
+ * stale "In Progress" entries when concurrent WUs complete on main.
+ *
+ * @param {string} backlogPath - Path to backlog.md (used to find state dir)
+ * @param {string} id - WU ID to mark complete
+ * @returns {Promise<string>} New status.md content
+ */
+export async function computeStatusContentFromMergedState(backlogPath, id) {
+    // WU-1319: Use merged state to preserve concurrent changes
+    return computeStatusContentWithMainMerge(backlogPath, id);
+}
 /**
  * Compute stamp file content
  *
@@ -235,6 +221,7 @@ export function computeStampContent(id, title) {
 /**
  * Collect all metadata updates for a transaction
  * WU-1574: Made async for computeBacklogContent
+ * WU-1319: Made status.md generation use merged state
  *
  * Convenience function that computes all file contents at once.
  * Returns an object with all computed content.
@@ -258,7 +245,8 @@ export async function collectMetadataUpdates({ doc, id, title, wuPath, statusPat
         },
         status: {
             path: statusPath,
-            content: computeStatusContent(statusPath, id, title),
+            // WU-1319: Use merged state to preserve concurrent changes
+            content: await computeStatusContentFromMergedState(backlogPath, id),
             description: 'status.md',
         },
         backlog: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/core",
-  "version": "2.4.0",
+  "version": "2.5.1",
   "description": "Core WU lifecycle tools for LumenFlow workflow framework",
   "keywords": [
     "lumenflow",
@@ -72,6 +72,7 @@
   "dependencies": {
     "chalk": "^5.6.2",
     "change-case": "^5.4.4",
+    "p-retry": "^6.2.1",
     "cli-progress": "^3.12.0",
     "cli-table3": "^0.6.5",
     "commander": "^14.0.2",
@@ -98,7 +99,7 @@
     "vitest": "^4.0.17"
   },
   "peerDependencies": {
-    "@lumenflow/memory": "2.4.0"
+    "@lumenflow/memory": "2.5.1"
   },
   "peerDependenciesMeta": {
     "@lumenflow/memory": {