@lumenflow/core 2.1.2 → 2.2.1

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

@@ -7,7 +7,7 @@
  * - string risks → array
  * - test_paths → tests
  * - ISO/Date created → YYYY-MM-DD
- * - Removes deprecated fields: owner, context, spec_refs
+ * - Removes deprecated fields: owner, context
  */
 /**
  * Normalize a WU schema object, converting legacy formats to current schema.

package/dist/wu-schema-normalization.js

@@ -7,7 +7,7 @@
  * - string risks → array
  * - test_paths → tests
  * - ISO/Date created → YYYY-MM-DD
- * - Removes deprecated fields: owner, context, spec_refs
+ * - Removes deprecated fields: owner, context
  */
 /**
  * Normalize a WU schema object, converting legacy formats to current schema.
@@ -77,6 +77,5 @@ export function normalizeWUSchema(wu) {
     }
     // 6. Remove deprecated fields
     delete result.owner;
-    delete result.spec_refs;
     return result;
 }

package/dist/wu-spawn-skills.d.ts

@@ -14,6 +14,14 @@ export declare function resolveSkillsPaths(config: any, clientName: any): {
     configuredAgentsMissing: boolean;
 };
 export declare function generateSkillsCatalogGuidance(config: any, clientName: any): string;
-export declare function generateClientSkillsGuidance(clientContext: ClientContext): string;
+/**
+ * WU-1142: Get byLane skills for a specific lane
+ *
+ * @param clientContext - Client context with config
+ * @param lane - Lane name (e.g., "Framework: Core")
+ * @returns Array of skill names for the lane, or empty array
+ */
+export declare function getByLaneSkills(clientContext: ClientContext | undefined, lane: string): string[];
+export declare function generateClientSkillsGuidance(clientContext: ClientContext | undefined, lane?: string): string;
 export declare function generateSkillsSelectionSection(doc: any, config: any, clientName: any): string;
 export {};

package/dist/wu-spawn-skills.js

@@ -107,17 +107,40 @@ export function generateSkillsCatalogGuidance(config, clientName) {
         : 'agents.clients.<client>.skillsDir';
     return `${SECTION.skillsCatalog}\n\n${configuredHint}No skills directories configured or found. Set \`directories.skillsDir\` or \`${clientHint}\` in .lumenflow.config.yaml.\n`;
 }
-export function generateClientSkillsGuidance(clientContext) {
+/**
+ * WU-1142: Get byLane skills for a specific lane
+ *
+ * @param clientContext - Client context with config
+ * @param lane - Lane name (e.g., "Framework: Core")
+ * @returns Array of skill names for the lane, or empty array
+ */
+export function getByLaneSkills(clientContext, lane) {
+    const byLane = clientContext?.config?.skills?.byLane;
+    if (!byLane || !lane)
+        return [];
+    return byLane[lane] || [];
+}
+export function generateClientSkillsGuidance(clientContext, lane) {
     const skills = clientContext?.config?.skills;
-    if (!skills ||
-        (!skills.instructions && (!skills.recommended || skills.recommended.length === 0))) {
+    if (!skills) {
+        return '';
+    }
+    // WU-1142: Check for byLane skills
+    const byLaneSkills = lane ? getByLaneSkills(clientContext, lane) : [];
+    const hasRecommended = skills.recommended && skills.recommended.length > 0;
+    const hasByLane = byLaneSkills.length > 0;
+    const hasInstructions = Boolean(skills.instructions);
+    if (!hasInstructions && !hasRecommended && !hasByLane) {
         return '';
     }
     const instructions = skills.instructions ? `${skills.instructions.trim()}\n\n` : '';
-    const recommended = skills.recommended && skills.recommended.length > 0
-        ? `Recommended skills:\n${skills.recommended.map((s) => `- \`${s}\``).join('\n')}\n`
+    const recommendedSection = hasRecommended || hasByLane
+        ? `Recommended skills:\n${[...(skills.recommended || []), ...byLaneSkills]
+            .filter((s, i, arr) => arr.indexOf(s) === i) // dedupe
+            .map((s) => `- \`${s}\``)
+            .join('\n')}\n`
         : '';
-    return `${SECTION.clientSkills} (${clientContext.name})\n\n${instructions}${recommended}`;
+    return `${SECTION.clientSkills} (${clientContext?.name})\n\n${instructions}${recommendedSection}`;
 }
 export function generateSkillsSelectionSection(doc, config, clientName) {
     const lane = doc.lane || '';

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

@@ -45,13 +45,25 @@ export declare function computeWUYAMLContent(doc: any): string;
  * @throws {Error} If file not found or section not found
  */
 export declare function computeStatusContent(statusPath: any, id: any, title: any): string;
+/**
+ * Compute wu-events.jsonl content after completing a WU.
+ *
+ * WU-1145: Now merges with origin/main to preserve concurrent changes.
+ * This prevents loss of WU entries when multiple WUs are completed concurrently.
+ *
+ * @param {string} backlogPath - Path to backlog.md
+ * @param {string} wuId - WU ID being completed
+ * @returns {Promise<{eventsPath: string, content: string} | null>}
+ */
 export declare function computeWUEventsContentAfterComplete(backlogPath: any, wuId: any): Promise<{
     eventsPath: string;
     content: string;
 }>;
 /**
  * Compute updated backlog.md content
+ *
  * WU-1574: Simplified to generate from state store
+ * WU-1145: Now merges with origin/main to preserve concurrent changes
  *
  * @param {string} backlogPath - Path to backlog.md
  * @param {string} id - WU ID to mark complete

package/dist/wu-transaction-collectors.js

@@ -24,7 +24,6 @@
  */
 /* eslint-disable security/detect-non-literal-fs-filename, security/detect-object-injection */
 import { existsSync, readFileSync } from 'node:fs';
-import path from 'node:path';
 import { stringifyYAML } from './wu-yaml.js';
 import { parseBacklogFrontmatter } from './backlog-parser.js';
 import { getSectionHeadingsWithDefaults } from './section-headings.js';
@@ -32,10 +31,11 @@ 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, WU_EVENTS_FILE_NAME } from './wu-state-store.js';
-import { generateBacklog } from './backlog-generator.js';
+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';
 /**
  * Compute WU YAML content for done state
  *
@@ -192,22 +192,25 @@ async function computeCompletionUpdatesFromStateStore(backlogPath, wuId) {
     store.applyEvent(completeEvent);
     return { store, stateDir, shouldAppendCompleteEvent: true, completeEvent };
 }
+/**
+ * Compute wu-events.jsonl content after completing a WU.
+ *
+ * WU-1145: Now merges with origin/main to preserve concurrent changes.
+ * This prevents loss of WU entries when multiple WUs are completed concurrently.
+ *
+ * @param {string} backlogPath - Path to backlog.md
+ * @param {string} wuId - WU ID being completed
+ * @returns {Promise<{eventsPath: string, content: string} | null>}
+ */
 export async function computeWUEventsContentAfterComplete(backlogPath, wuId) {
-    const { stateDir, shouldAppendCompleteEvent, completeEvent } = await computeCompletionUpdatesFromStateStore(backlogPath, wuId);
-    if (!shouldAppendCompleteEvent) {
-        return null;
-    }
-    const eventsPath = path.join(stateDir, WU_EVENTS_FILE_NAME);
-    const existing = existsSync(eventsPath) ? readFileSync(eventsPath, { encoding: 'utf-8' }) : '';
-    const withNewline = ensureTrailingNewline(existing);
-    return {
-        eventsPath,
-        content: withNewline + JSON.stringify(completeEvent) + STRING_LITERALS.NEWLINE,
-    };
+    // WU-1145: Use merged state to preserve concurrent changes
+    return computeWUEventsContentWithMainMerge(backlogPath, wuId);
 }
 /**
  * Compute updated backlog.md content
+ *
  * WU-1574: Simplified to generate from state store
+ * WU-1145: Now merges with origin/main to preserve concurrent changes
  *
  * @param {string} backlogPath - Path to backlog.md
  * @param {string} id - WU ID to mark complete
@@ -215,8 +218,8 @@ export async function computeWUEventsContentAfterComplete(backlogPath, wuId) {
  * @returns {Promise<string>} New backlog.md content
  */
 export async function computeBacklogContent(backlogPath, id, _title) {
-    const { store } = await computeCompletionUpdatesFromStateStore(backlogPath, id);
-    return generateBacklog(store);
+    // WU-1145: Use merged state to preserve concurrent changes
+    return computeBacklogContentWithMainMerge(backlogPath, id);
 }
 /**
  * Compute stamp file content

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/core",
-  "version": "2.1.2",
+  "version": "2.2.1",
   "description": "Core WU lifecycle tools for LumenFlow workflow framework",
   "keywords": [
     "lumenflow",
@@ -39,6 +39,7 @@
     "./spawn-recovery": "./dist/spawn-recovery.js",
     "./spawn-monitor": "./dist/spawn-monitor.js",
     "./spawn-escalation": "./dist/spawn-escalation.js",
+    "./spawn-prompt-schema": "./dist/spawn-prompt-schema.js",
     "./backlog-generator": "./dist/backlog-generator.js",
     "./backlog-parser": "./dist/backlog-parser.js",
     "./backlog-editor": "./dist/backlog-editor.js",
@@ -94,7 +95,7 @@
     "vitest": "^4.0.17"
   },
   "peerDependencies": {
-    "@lumenflow/memory": "2.1.2"
+    "@lumenflow/memory": "2.2.1"
   },
   "peerDependenciesMeta": {
     "@lumenflow/memory": {