@lumenflow/core 3.1.3 → 3.2.1

package/dist/cycle-detector.js

@@ -0,0 +1,84 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Detects circular dependencies in WU dependency graph using DFS
+ *
+ * Uses standard cycle detection: tracks visited nodes and nodes in current
+ * recursion stack. If we encounter a node already in the recursion stack,
+ * we've found a cycle.
+ *
+ * Note: This function treats both `blocks` and `blocked_by` as edges for
+ * traversal. This means if WU-A blocks WU-B, and WU-B's blocked_by includes
+ * WU-A, following both directions will find a path back to WU-A.
+ *
+ * @param wuMap - Map of WU ID to WU object
+ * @returns Cycle detection result with hasCycle boolean and cycles array
+ *
+ * @example
+ * const wuMap = new Map([
+ *   ['WU-001', { id: 'WU-001', blocks: ['WU-002'] }],
+ *   ['WU-002', { id: 'WU-002', blocks: ['WU-001'] }],
+ * ]);
+ * const result = detectCycles(wuMap);
+ * // result.hasCycle === true
+ * // result.cycles contains the cycle path
+ */
+export function detectCycles(wuMap) {
+    const visited = new Set();
+    const recursionStack = new Set();
+    const cycles = [];
+    /**
+     * DFS traversal to detect cycles
+     * @param wuId - Current WU ID
+     * @param path - Current path from root
+     * @returns True if cycle found
+     */
+    function dfs(wuId, path) {
+        // If node is in recursion stack, we found a cycle
+        if (recursionStack.has(wuId)) {
+            const cycleStart = path.indexOf(wuId);
+            if (cycleStart !== -1) {
+                cycles.push([...path.slice(cycleStart), wuId]);
+            }
+            else {
+                // Self-reference case
+                cycles.push([wuId, wuId]);
+            }
+            return true;
+        }
+        // If already fully visited, skip
+        if (visited.has(wuId)) {
+            return false;
+        }
+        // Mark as being processed
+        visited.add(wuId);
+        recursionStack.add(wuId);
+        // Get dependencies (both blocks and blocked_by create edges)
+        // Only use arrays - ignore legacy string format for backward compatibility
+        const wu = wuMap.get(wuId);
+        const blocks = Array.isArray(wu?.blocks) ? wu.blocks : [];
+        const blockedBy = Array.isArray(wu?.blocked_by) ? wu.blocked_by : [];
+        const deps = [...blocks, ...blockedBy];
+        // Visit all dependencies
+        for (const dep of deps) {
+            // Only traverse if the dependency exists in our map
+            if (wuMap.has(dep)) {
+                dfs(dep, [...path, wuId]);
+            }
+        }
+        // Remove from recursion stack (done processing)
+        recursionStack.delete(wuId);
+        return false;
+    }
+    // Run DFS from each node to find all cycles
+    for (const wuId of wuMap.keys()) {
+        if (!visited.has(wuId)) {
+            dfs(wuId, []);
+        }
+    }
+    return {
+        hasCycle: cycles.length > 0,
+        cycles,
+    };
+}
+//# sourceMappingURL=cycle-detector.js.map

package/dist/cycle-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycle-detector.js","sourceRoot":"","sources":["../src/cycle-detector.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAgCzC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,YAAY,CAAC,KAA4B;IACvD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,MAAM,MAAM,GAAe,EAAE,CAAC;IAE9B;;;;;OAKG;IACH,SAAS,GAAG,CAAC,IAAY,EAAE,IAAc;QACvC,kDAAkD;QAClD,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;YACjD,CAAC;iBAAM,CAAC;gBACN,sBAAsB;gBACtB,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YAC5B,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,iCAAiC;QACjC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,0BAA0B;QAC1B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEzB,6DAA6D;QAC7D,2EAA2E;QAC3E,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;QAEvC,yBAAyB;QACzB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,oDAAoD;YACpD,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnB,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,gDAAgD;QAChD,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,4CAA4C;IAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC;QAC3B,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/date-utils.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Get current date in ISO format (YYYY-MM-DD)
+ * @returns {string} Current date in YYYY-MM-DD format
+ * @example
+ * todayISO(); // "2025-11-12"
+ */
+export declare function todayISO(): string;
+/**
+ * Format a date with a custom format string
+ * @param {Date|string|number} date - Date to format
+ * @param {string} formatString - date-fns format string
+ * @returns {string} Formatted date string
+ * @example
+ * formatDate(new Date(), 'yyyy-MM-dd HH:mm:ss');
+ * formatDate('2025-11-12', 'MMMM d, yyyy'); // "November 12, 2025"
+ */
+export declare function formatDate(date: UnsafeAny, formatString: UnsafeAny): string;
+/**
+ * Normalize a Date object or ISO timestamp string to YYYY-MM-DD format
+ *
+ * WU-1442: Fix date corruption when js-yaml parses YYYY-MM-DD as Date objects
+ * Library-First: Uses date-fns for date formatting (no manual parsing)
+ *
+ * Use case: js-yaml parses `created: 2025-12-04` (unquoted) as a Date object.
+ * When yaml.dump() serializes it back, it outputs `2025-12-04T00:00:00.000Z`.
+ * This function normalizes Date objects back to YYYY-MM-DD string format.
+ *
+ * Handles:
+ * - Date objects → YYYY-MM-DD string
+ * - ISO timestamp strings → YYYY-MM-DD string (date portion)
+ * - YYYY-MM-DD strings → preserved as-is
+ * - undefined/null → preserved as undefined
+ *
+ * @param {Date|string|undefined|null} value - Date value to normalize
+ * @returns {string|undefined} Date in YYYY-MM-DD format or undefined
+ *
+ * @example
+ * normalizeToDateString(new Date('2025-12-04')); // '2025-12-04'
+ * normalizeToDateString('2025-12-04T00:00:00.000Z'); // '2025-12-04'
+ * normalizeToDateString('2025-12-04'); // '2025-12-04'
+ * normalizeToDateString(undefined); // undefined
+ */
+export declare function normalizeToDateString(value: UnsafeAny): string | undefined;
+/**
+ * Normalize various date formats to ISO 8601 datetime (YYYY-MM-DDTHH:mm:ss.sssZ)
+ *
+ * WU-1337: Auto-repair date fields in WU YAML to consistent format
+ * Library-First: Uses date-fns for date handling (no manual parsing)
+ *
+ * Handles:
+ * - ISO date strings (YYYY-MM-DD) → midnight UTC
+ * - ISO datetime strings (already valid) → preserved
+ * - Unix timestamps (milliseconds) → converted
+ * - undefined/null → preserved as undefined
+ *
+ * @param {string|number|undefined|null} value - Date value to normalize
+ * @returns {string|undefined} ISO datetime string or undefined
+ *
+ * @example
+ * normalizeISODateTime('2025-11-29'); // '2025-11-29T00:00:00.000Z'
+ * normalizeISODateTime('2025-11-29T14:30:00.000Z'); // '2025-11-29T14:30:00.000Z'
+ * normalizeISODateTime(1732896000000); // '2024-11-29T16:00:00.000Z'
+ * normalizeISODateTime(undefined); // undefined
+ */
+export declare function normalizeISODateTime(value: UnsafeAny): string | undefined;
+//# sourceMappingURL=date-utils.d.ts.map

package/dist/date-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-utils.d.ts","sourceRoot":"","sources":["../src/date-utils.ts"],"names":[],"mappings":"AAgBA;;;;;GAKG;AACH,wBAAgB,QAAQ,WAEvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,UAElE;AAQD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,sBAgCrD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,sBAgCpD"}

package/dist/date-utils.js

@@ -0,0 +1,143 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file date-utils.ts
+ * @description Date formatting utilities using date-fns library
+ * WU-1082: Extract shared utilities (eliminate date formatting duplication)
+ *
+ * Replaces manual date formatting in:
+ * - tools/wu-block.ts (todayISO)
+ * - tools/wu-unblock.ts (todayISO)
+ * - tools/wu-done.ts (todayISO - already uses date-fns)
+ */
+import { format } from 'date-fns';
+/**
+ * Get current date in ISO format (YYYY-MM-DD)
+ * @returns {string} Current date in YYYY-MM-DD format
+ * @example
+ * todayISO(); // "2025-11-12"
+ */
+export function todayISO() {
+    return format(new Date(), 'yyyy-MM-dd');
+}
+/**
+ * Format a date with a custom format string
+ * @param {Date|string|number} date - Date to format
+ * @param {string} formatString - date-fns format string
+ * @returns {string} Formatted date string
+ * @example
+ * formatDate(new Date(), 'yyyy-MM-dd HH:mm:ss');
+ * formatDate('2025-11-12', 'MMMM d, yyyy'); // "November 12, 2025"
+ */
+export function formatDate(date, formatString) {
+    return format(new Date(date), formatString);
+}
+/**
+ * Date format constant for YYYY-MM-DD
+ * @constant {string}
+ */
+const DATE_FORMAT_ISO = 'yyyy-MM-dd';
+/**
+ * Normalize a Date object or ISO timestamp string to YYYY-MM-DD format
+ *
+ * WU-1442: Fix date corruption when js-yaml parses YYYY-MM-DD as Date objects
+ * Library-First: Uses date-fns for date formatting (no manual parsing)
+ *
+ * Use case: js-yaml parses `created: 2025-12-04` (unquoted) as a Date object.
+ * When yaml.dump() serializes it back, it outputs `2025-12-04T00:00:00.000Z`.
+ * This function normalizes Date objects back to YYYY-MM-DD string format.
+ *
+ * Handles:
+ * - Date objects → YYYY-MM-DD string
+ * - ISO timestamp strings → YYYY-MM-DD string (date portion)
+ * - YYYY-MM-DD strings → preserved as-is
+ * - undefined/null → preserved as undefined
+ *
+ * @param {Date|string|undefined|null} value - Date value to normalize
+ * @returns {string|undefined} Date in YYYY-MM-DD format or undefined
+ *
+ * @example
+ * normalizeToDateString(new Date('2025-12-04')); // '2025-12-04'
+ * normalizeToDateString('2025-12-04T00:00:00.000Z'); // '2025-12-04'
+ * normalizeToDateString('2025-12-04'); // '2025-12-04'
+ * normalizeToDateString(undefined); // undefined
+ */
+export function normalizeToDateString(value) {
+    // Preserve undefined/null
+    if (value == null) {
+        return undefined;
+    }
+    // If already a YYYY-MM-DD string, return as-is
+    if (typeof value === 'string' && /^\d{4}-\d{2}-\d{2}$/.test(value)) {
+        return value;
+    }
+    // Convert Date objects or timestamp strings to YYYY-MM-DD
+    if (value instanceof Date) {
+        return format(value, DATE_FORMAT_ISO);
+    }
+    // Handle ISO timestamp strings (e.g., '2025-12-04T00:00:00.000Z')
+    if (typeof value === 'string' && /^\d{4}-\d{2}-\d{2}T/.test(value)) {
+        return format(new Date(value), DATE_FORMAT_ISO);
+    }
+    // Fallback: try to parse and format
+    try {
+        const date = new Date(value);
+        if (!isNaN(date.getTime())) {
+            return format(date, DATE_FORMAT_ISO);
+        }
+    }
+    catch {
+        // Invalid date - return undefined
+    }
+    return undefined;
+}
+/**
+ * Normalize various date formats to ISO 8601 datetime (YYYY-MM-DDTHH:mm:ss.sssZ)
+ *
+ * WU-1337: Auto-repair date fields in WU YAML to consistent format
+ * Library-First: Uses date-fns for date handling (no manual parsing)
+ *
+ * Handles:
+ * - ISO date strings (YYYY-MM-DD) → midnight UTC
+ * - ISO datetime strings (already valid) → preserved
+ * - Unix timestamps (milliseconds) → converted
+ * - undefined/null → preserved as undefined
+ *
+ * @param {string|number|undefined|null} value - Date value to normalize
+ * @returns {string|undefined} ISO datetime string or undefined
+ *
+ * @example
+ * normalizeISODateTime('2025-11-29'); // '2025-11-29T00:00:00.000Z'
+ * normalizeISODateTime('2025-11-29T14:30:00.000Z'); // '2025-11-29T14:30:00.000Z'
+ * normalizeISODateTime(1732896000000); // '2024-11-29T16:00:00.000Z'
+ * normalizeISODateTime(undefined); // undefined
+ */
+export function normalizeISODateTime(value) {
+    // Preserve undefined/null (optional fields)
+    if (value == null) {
+        return undefined;
+    }
+    // If already a valid ISO datetime format, preserve it
+    // Pattern: YYYY-MM-DDTHH:mm:ss.sssZ
+    if (typeof value === 'string' && /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/.test(value)) {
+        return value;
+    }
+    // Handle Unix timestamps as strings (convert to number first)
+    let dateInput = value;
+    if (typeof value === 'string' && /^\d+$/.test(value)) {
+        // Numeric string - treat as Unix timestamp in milliseconds
+        dateInput = Number(value);
+    }
+    // Parse and convert to ISO datetime
+    // date-fns/Date handles: ISO dates, ISO datetimes, Unix timestamps
+    const date = new Date(dateInput);
+    // Check for invalid date
+    if (isNaN(date.getTime())) {
+        // Fallback: return undefined for unparseable dates
+        // Zod schema will catch invalid dates separately
+        return undefined;
+    }
+    // Convert to ISO 8601 datetime format
+    return date.toISOString();
+}
+//# sourceMappingURL=date-utils.js.map

package/dist/date-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-utils.js","sourceRoot":"","sources":["../src/date-utils.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;;;;GAKG;AACH,MAAM,UAAU,QAAQ;IACtB,OAAO,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,YAAY,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,IAAe,EAAE,YAAuB;IACjE,OAAO,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,eAAe,GAAG,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAgB;IACpD,0BAA0B;IAC1B,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,+CAA+C;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACnE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,0DAA0D;IAC1D,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IACxC,CAAC;IAED,kEAAkE;IAClE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACnE,OAAO,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC,CAAC;IAClD,CAAC;IAED,oCAAoC;IACpC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC3B,OAAO,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAgB;IACnD,4CAA4C;IAC5C,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,sDAAsD;IACtD,oCAAoC;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,+CAA+C,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7F,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8DAA8D;IAC9D,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,2DAA2D;QAC3D,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,oCAAoC;IACpC,mEAAmE;IACnE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;IAEjC,yBAAyB;IACzB,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC1B,mDAAmD;QACnD,iDAAiD;QACjD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,sCAAsC;IACtC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;AAC5B,CAAC"}

package/dist/delegation-escalation.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Signal type for delegation failures.
+ */
+export declare const DELEGATION_FAILURE_SIGNAL_TYPE = "delegation_failure";
+/**
+ * Severity levels for delegation failure signals
+ */
+export declare const SignalSeverity: Readonly<{
+    WARNING: "warning";
+    ERROR: "error";
+    CRITICAL: "critical";
+}>;
+/**
+ * Suggested actions for delegation failure signals
+ */
+export declare const SuggestedAction: Readonly<{
+    RETRY: "retry";
+    BLOCK: "block";
+    HUMAN_ESCALATE: "human_escalate";
+}>;
+/**
+ * Escalates a stuck delegation by signalling the orchestrator.
+ *
+ * WU-1967: Replaced Bug WU creation with memory bus signalling.
+ * Called when recoverStuckDelegation() returns ESCALATED_STUCK.
+ * Signals orchestrator inbox with delegation failure context.
+ *
+ * Escalation levels based on recovery attempts:
+ * - 1st attempt: severity=warning, suggested_action=retry
+ * - 2nd attempt: severity=error, suggested_action=block
+ * - 3rd+ attempt: severity=critical, suggested_action=human_escalate
+ *
+ * @param {string} delegationId - ID of the stuck delegation
+ * @param {Object} options - Options
+ * @param {string} options.baseDir - Base directory for .lumenflow/
+ * @param {boolean} [options.dryRun=false] - If true, returns signal without sending
+ * @returns {Promise<EscalationResult>} Escalation result with signal details
+ *
+ * @throws {Error} If delegation not found
+ * @throws {Error} If delegation already escalated (duplicate prevention)
+ * @throws {Error} If no escalation audit log exists
+ *
+ * @example
+ * // After recoverStuckDelegation returns ESCALATED_STUCK
+ * const result = await escalateStuckDelegation('delegation-1234', { baseDir: '/path/to/project' });
+ * console.log(`Signal sent: ${result.signalId}, action: ${result.signal.suggested_action}`);
+ */
+export interface EscalateStuckDelegationOptions {
+    /** Base directory for .lumenflow/ */
+    baseDir?: string;
+    /** If true, return spec only without sending signal */
+    dryRun?: boolean;
+}
+export declare function escalateStuckDelegation(delegationId: UnsafeAny, options?: EscalateStuckDelegationOptions): Promise<{
+    signalId: string;
+    signal: {
+        type: string;
+        severity: "error" | "warning" | "critical";
+        delegation_id: any;
+        target_wu_id: any;
+        parent_wu_id: any;
+        lane: any;
+        recovery_action: any;
+        recovery_attempts: any;
+        last_checkpoint: any;
+        suggested_action: "block" | "retry" | "human_escalate";
+        message: string;
+    };
+    delegationStatus: "escalated";
+}>;
+//# sourceMappingURL=delegation-escalation.d.ts.map

package/dist/delegation-escalation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation-escalation.d.ts","sourceRoot":"","sources":["../src/delegation-escalation.ts"],"names":[],"mappings":"AAkDA;;GAEG;AACH,eAAO,MAAM,8BAA8B,uBAAuB,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,cAAc;;;;EAIzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;EAI1B,CAAC;AAyJH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,8BAA8B;IAC7C,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,SAAS,EACvB,OAAO,GAAE,8BAAmC;;;;;;;;;;;;;;;;GAiF7C"}

package/dist/delegation-escalation.js

@@ -0,0 +1,264 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Delegation Escalation Module (WU-1952, WU-1967)
+ *
+ * WU-1967: Replaced Bug WU creation with memory bus signalling.
+ * Signals orchestrator inbox instead of creating human-in-loop Bug WUs.
+ *
+ * Escalation Flow:
+ * 1. recoverStuckDelegation() returns { recovered: false, action: ESCALATED_STUCK }
+ * 2. escalateStuckDelegation() signals orchestrator via memory bus
+ * 3. Delegation status updated to ESCALATED (prevents duplicate signals)
+ * 4. Orchestrator decides: retry (1st), block (2nd), human escalate (3rd+)
+ *
+ * Library-First Note: This is project-specific delegation escalation code for
+ * ExampleApp's custom delegation-registry.jsonl and memory bus patterns.
+ * No external library exists for this domain-specific agent lifecycle management.
+ *
+ * @see {@link packages/@lumenflow/cli/src/lib/__tests__/delegation-escalation.test.ts} - Tests
+ * @see {@link packages/@lumenflow/cli/src/lib/delegation-recovery.ts} - Recovery logic
+ * @see {@link packages/@lumenflow/cli/src/lib/mem-signal-core.ts} - Signal creation
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { DelegationRegistryStore } from './delegation-registry-store.js';
+import { DelegationStatus } from './delegation-registry-schema.js';
+import { RECOVERY_DIR_NAME } from './delegation-recovery.js';
+import { LUMENFLOW_PATHS } from './wu-constants.js';
+let createSignal = null;
+try {
+    const mod = await import('@lumenflow/memory/signal');
+    createSignal = mod.createSignal;
+}
+catch {
+    // @lumenflow/memory not available - signal features disabled
+}
+/**
+ * Log prefix for delegation-escalation messages
+ */
+const LOG_PREFIX = '[delegation-escalation]';
+/**
+ * Signal type for delegation failures.
+ */
+export const DELEGATION_FAILURE_SIGNAL_TYPE = 'delegation_failure';
+/**
+ * Severity levels for delegation failure signals
+ */
+export const SignalSeverity = Object.freeze({
+    WARNING: 'warning',
+    ERROR: 'error',
+    CRITICAL: 'critical',
+});
+/**
+ * Suggested actions for delegation failure signals
+ */
+export const SuggestedAction = Object.freeze({
+    RETRY: 'retry',
+    BLOCK: 'block',
+    HUMAN_ESCALATE: 'human_escalate',
+});
+/**
+ * @typedef {Object} DelegationFailureSignal
+ * @property {string} type - Always 'delegation_failure'
+ * @property {string} severity - 'warning' | 'error' | 'critical'
+ * @property {string} delegation_id - Delegation ID
+ * @property {string} target_wu_id - Target WU ID
+ * @property {string} parent_wu_id - Parent WU ID (orchestrator)
+ * @property {string} lane - Lane name
+ * @property {string} recovery_action - Recovery action that triggered escalation
+ * @property {number} recovery_attempts - Number of recovery attempts
+ * @property {string|null} last_checkpoint - Last checkpoint timestamp
+ * @property {string} suggested_action - 'retry' | 'block' | 'human_escalate'
+ * @property {string} message - Human-readable message
+ */
+/**
+ * @typedef {Object} EscalationResult
+ * @property {string} signalId - Signal ID (e.g., 'sig-abc12345')
+ * @property {DelegationFailureSignal} signal - The signal payload
+ * @property {string} delegationStatus - Updated delegation status (ESCALATED)
+ */
+/**
+ * @typedef {Object} AuditLogEntry
+ * @property {string} timestamp - ISO timestamp of recovery action
+ * @property {string} delegationId - ID of the delegation being recovered
+ * @property {string} action - Recovery action taken
+ * @property {string} reason - Explanation of why action was taken
+ * @property {Object} context - Additional context
+ */
+/**
+ * Counts existing escalation attempts for a delegation by reading audit logs.
+ *
+ * @param {string} baseDir - Base directory
+ * @param {string} delegationId - Delegation ID to count attempts for
+ * @returns {Promise<number>} Number of previous escalation attempts
+ */
+async function countEscalationAttempts(baseDir, delegationId) {
+    // WU-1421: Use LUMENFLOW_PATHS.BASE for consistency
+    const recoveryDir = path.join(baseDir, LUMENFLOW_PATHS.BASE, RECOVERY_DIR_NAME);
+    try {
+        const files = await fs.readdir(recoveryDir);
+        const delegationFiles = files.filter((f) => f.startsWith(`${delegationId}-`) && f.endsWith('.json'));
+        return delegationFiles.length;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return 0;
+        }
+        throw error;
+    }
+}
+/**
+ * Determines severity and suggested action based on recovery attempts.
+ *
+ * @param {number} attempts - Number of recovery attempts
+ * @returns {{ severity: string, suggestedAction: string }}
+ */
+function determineEscalationLevel(attempts) {
+    if (attempts <= 1) {
+        return {
+            severity: SignalSeverity.WARNING,
+            suggestedAction: SuggestedAction.RETRY,
+        };
+    }
+    else if (attempts === 2) {
+        return {
+            severity: SignalSeverity.ERROR,
+            suggestedAction: SuggestedAction.BLOCK,
+        };
+    }
+    else {
+        return {
+            severity: SignalSeverity.CRITICAL,
+            suggestedAction: SuggestedAction.HUMAN_ESCALATE,
+        };
+    }
+}
+/**
+ * Find the most recent escalation audit log for a delegation.
+ *
+ * @param {string} baseDir - Base directory
+ * @param {string} delegationId - Delegation ID to find audit log for
+ * @returns {Promise<AuditLogEntry|null>} Audit log entry or null if not found
+ */
+async function findEscalationAuditLog(baseDir, delegationId) {
+    // WU-1421: Use LUMENFLOW_PATHS.BASE for consistency
+    const recoveryDir = path.join(baseDir, LUMENFLOW_PATHS.BASE, RECOVERY_DIR_NAME);
+    try {
+        const files = await fs.readdir(recoveryDir);
+        // Filter files for this delegation ID, sorted by name (timestamp-based)
+        const delegationFiles = files
+            .filter((f) => f.startsWith(`${delegationId}-`) && f.endsWith('.json'))
+            .sort()
+            .reverse(); // Most recent first
+        if (delegationFiles.length === 0) {
+            return null;
+        }
+        // Read the most recent audit log
+        const latestFile = delegationFiles[0];
+        if (!latestFile) {
+            return null;
+        }
+        const auditPath = path.join(recoveryDir, latestFile);
+        const content = await fs.readFile(auditPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+}
+/**
+ * Builds a delegation failure signal payload.
+ *
+ * @param {Object} delegation - Delegation event data
+ * @param {AuditLogEntry} auditLog - Escalation audit log
+ * @param {number} attempts - Number of recovery attempts
+ * @returns {DelegationFailureSignal} Signal payload
+ */
+function buildDelegationFailureSignal(delegation, auditLog, attempts) {
+    const { severity, suggestedAction } = determineEscalationLevel(attempts);
+    const lastCheckpoint = auditLog.context.lastCheckpoint || null;
+    return {
+        type: DELEGATION_FAILURE_SIGNAL_TYPE,
+        severity,
+        delegation_id: delegation.id,
+        target_wu_id: delegation.targetWuId,
+        parent_wu_id: delegation.parentWuId,
+        lane: delegation.lane,
+        recovery_action: auditLog.action,
+        recovery_attempts: attempts,
+        last_checkpoint: lastCheckpoint,
+        suggested_action: suggestedAction,
+        message: `Delegation ${delegation.id} for ${delegation.targetWuId} stuck: ${auditLog.reason}`,
+    };
+}
+export async function escalateStuckDelegation(delegationId, options = {}) {
+    const { baseDir = process.cwd(), dryRun = false } = options;
+    // WU-1421: Use LUMENFLOW_PATHS.STATE_DIR for consistency
+    const registryDir = path.join(baseDir, LUMENFLOW_PATHS.STATE_DIR);
+    // Load delegation registry
+    const store = new DelegationRegistryStore(registryDir);
+    try {
+        await store.load();
+    }
+    catch {
+        throw new Error(`Delegation ${delegationId} not found: registry unavailable`);
+    }
+    // Find the delegation
+    const delegation = store.getById(delegationId);
+    if (!delegation) {
+        throw new Error(`Delegation ${delegationId} not found in registry`);
+    }
+    // Check if signal module is available
+    if (!createSignal) {
+        throw new Error('Signal module (@lumenflow/memory) not available - cannot escalate');
+    }
+    // WU-1967: Check if already escalated (prevents duplicate signals)
+    if (delegation.status === DelegationStatus.ESCALATED) {
+        throw new Error(`Delegation ${delegationId} already escalated`);
+    }
+    // Find escalation audit log
+    const auditLog = await findEscalationAuditLog(baseDir, delegationId);
+    if (!auditLog) {
+        throw new Error(`No escalation audit log found for delegation ${delegationId}`);
+    }
+    // Count previous escalation attempts
+    const attempts = await countEscalationAttempts(baseDir, delegationId);
+    // Build signal payload
+    const signalPayload = buildDelegationFailureSignal(delegation, auditLog, attempts);
+    if (dryRun) {
+        console.log(`${LOG_PREFIX} [dry-run] Would signal orchestrator`);
+        console.log(`${LOG_PREFIX} [dry-run] Severity: ${signalPayload.severity}`);
+        console.log(`${LOG_PREFIX} [dry-run] Suggested action: ${signalPayload.suggested_action}`);
+        console.log(`${LOG_PREFIX} [dry-run] Message: ${signalPayload.message}`);
+        return {
+            signalId: 'sig-dry-run',
+            signal: signalPayload,
+            delegationStatus: DelegationStatus.ESCALATED,
+        };
+    }
+    // WU-1967: Send signal to orchestrator inbox
+    console.log(`${LOG_PREFIX} Signalling orchestrator for delegation ${delegationId}`);
+    console.log(`${LOG_PREFIX} Target WU: ${delegation.targetWuId}`);
+    console.log(`${LOG_PREFIX} Severity: ${signalPayload.severity}`);
+    console.log(`${LOG_PREFIX} Suggested action: ${signalPayload.suggested_action}`);
+    // Create signal with structured message (JSON payload in message field)
+    const signalResult = await createSignal(baseDir, {
+        message: JSON.stringify(signalPayload),
+        wuId: delegation.parentWuId, // Signal targets the orchestrator (parent WU)
+        lane: delegation.lane,
+    });
+    // Update delegation status to ESCALATED (prevents duplicate signals)
+    await store.updateStatus(delegationId, DelegationStatus.ESCALATED);
+    console.log(`${LOG_PREFIX} Signal sent: ${signalResult.signal.id}`);
+    console.log(`${LOG_PREFIX} Delegation ${delegationId} status updated to ESCALATED`);
+    return {
+        signalId: signalResult.signal.id,
+        signal: signalPayload,
+        delegationStatus: DelegationStatus.ESCALATED,
+    };
+}
+//# sourceMappingURL=delegation-escalation.js.map

package/dist/delegation-escalation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation-escalation.js","sourceRoot":"","sources":["../src/delegation-escalation.ts"],"names":[],"mappings":"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"}