@lumenflow/core 2.18.3 → 2.20.0

package/dist/delegation-registry-store.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Delegation Registry Store (WU-1944)
+ *
+ * Event-sourced state store for tracking sub-agent delegations.
+ * Stores events in .lumenflow/state/delegation-registry.jsonl (append-only, git-friendly).
+ *
+ * Features:
+ * - Event sourcing with replay for current state
+ * - Atomic append operations
+ * - O(1) queries by parent WU, target WU, and status
+ *
+ * @see {@link packages/@lumenflow/cli/src/lib/__tests__/delegation-registry-store.test.ts} - Tests
+ * @see {@link packages/@lumenflow/cli/src/lib/delegation-registry-schema.ts} - Schema definitions
+ */
+import { type DelegationEvent, type DelegationIntentValue } from './delegation-registry-schema.js';
+/** Delegation registry file name constant */
+export declare const DELEGATION_REGISTRY_FILE_NAME = "delegation-registry.jsonl";
+/**
+ * Delegation Registry Store class
+ *
+ * Manages delegation registry state via event sourcing pattern.
+ * Events are appended to JSONL file, state is rebuilt by replaying events.
+ */
+export declare class DelegationRegistryStore {
+    private readonly baseDir;
+    private readonly registryFilePath;
+    private readonly delegations;
+    private readonly byParent;
+    private readonly byTarget;
+    /**
+     * @param {string} baseDir - Directory containing .lumenflow/state/
+     */
+    constructor(baseDir: string);
+    /**
+     * Loads and replays events from JSONL file into current state.
+     *
+     * Handles:
+     * - Missing file: returns empty state
+     * - Empty file: returns empty state
+     * - Empty lines: skipped gracefully
+     * - Malformed JSON: throws error with line info
+     * - Invalid events: throws validation error
+     *
+     * @returns {Promise<void>}
+     * @throws {Error} If file contains malformed JSON or invalid events
+     *
+     * @example
+     * const store = new DelegationRegistryStore('/path/to/project');
+     * await store.load();
+     * const pending = store.getPendingDelegations();
+     */
+    load(): Promise<void>;
+    /**
+     * Applies an event to the in-memory state.
+     * If event for same delegation ID exists, updates it (latest wins).
+     *
+     * @private
+     */
+    private _applyEvent;
+    /**
+     * Appends an event to the registry file.
+     *
+     * Uses append mode to avoid full file rewrite.
+     * Creates file and parent directories if they don't exist.
+     * Validates event before appending.
+     *
+     * @private
+     * @throws {Error} If event fails validation
+     */
+    private _appendEvent;
+    /**
+     * Records a new delegation event with pending status.
+     *
+     * @param {string} parentWuId - Parent WU ID (orchestrator)
+     * @param {string} targetWuId - Target WU ID (delegated work)
+     * @param {string} lane - Lane for the delegated work
+     * @param {DelegationIntentValue} [intent] - Optional intent source (e.g., delegation)
+     * @returns {Promise<string>} The generated delegation ID
+     * @throws {Error} If validation fails
+     *
+     * @example
+     * const delegationId = await store.record('WU-1000', 'WU-1001', 'Operations: Tooling');
+     */
+    record(parentWuId: string, targetWuId: string, lane: string, intent?: DelegationIntentValue): Promise<string>;
+    /**
+     * Updates the status of a delegation.
+     *
+     * @param {string} delegationId - Delegation ID to update
+     * @param {string} status - New status
+     * @returns {Promise<void>}
+     * @throws {Error} If delegation ID not found
+     *
+     * @example
+     * await store.updateStatus('dlg-a1b2', 'completed');
+     */
+    updateStatus(delegationId: string, status: string): Promise<void>;
+    /**
+     * Records claim-time pickup evidence for a delegation entry.
+     *
+     * WU-1605: This distinguishes intent-only delegation records from
+     * delegated work that was actually picked up via wu:claim.
+     *
+     * @param {string} delegationId - Delegation ID to update
+     * @param {string} pickedUpBy - Agent identity that claimed the target WU
+     * @param {string} [pickedUpAt] - Optional ISO timestamp (defaults to now)
+     * @returns {Promise<void>}
+     * @throws {Error} If delegation ID not found
+     */
+    recordPickup(delegationId: string, pickedUpBy: string, pickedUpAt?: string): Promise<void>;
+    /**
+     * Gets all delegations for a parent WU.
+     *
+     * @param {string} parentWuId - Parent WU ID
+     * @returns {DelegationEvent[]} Array of delegation events
+     *
+     * @example
+     * const delegations = store.getByParent('WU-1000');
+     */
+    getByParent(parentWuId: string): DelegationEvent[];
+    /**
+     * Gets delegation for a target WU.
+     *
+     * @param {string} targetWuId - Target WU ID
+     * @returns {DelegationEvent | null} Delegation event or null
+     *
+     * @example
+     * const delegation = store.getByTarget('WU-1001');
+     */
+    getByTarget(targetWuId: string): DelegationEvent | null;
+    /**
+     * Gets all pending delegations.
+     *
+     * @returns {DelegationEvent[]} Array of pending delegation events
+     *
+     * @example
+     * const pending = store.getPendingDelegations();
+     */
+    getPendingDelegations(): DelegationEvent[];
+    /**
+     * Gets all delegations as an array.
+     *
+     * @returns {DelegationEvent[]} Array of all delegation events
+     *
+     * @example
+     * const allDelegations = store.getAllDelegations();
+     */
+    getAllDelegations(): DelegationEvent[];
+    /**
+     * Gets delegation by ID.
+     *
+     * @param {string} delegationId - Delegation ID
+     * @returns {DelegationEvent | null} Delegation event or null
+     *
+     * @example
+     * const delegation = store.getById('dlg-a1b2');
+     */
+    getById(delegationId: string): DelegationEvent | null;
+}
+//# sourceMappingURL=delegation-registry-store.d.ts.map

package/dist/delegation-registry-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation-registry-store.d.ts","sourceRoot":"","sources":["../src/delegation-registry-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC3B,MAAM,iCAAiC,CAAC;AAEzC,6CAA6C;AAC7C,eAAO,MAAM,6BAA6B,8BAA8B,CAAC;AAEzE;;;;;GAKG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAE/C;;OAEG;gBACS,OAAO,EAAE,MAAM;IAc3B;;;;;;;;;;;;;;;;;OAiBG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoD3B;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAmBnB;;;;;;;;;OASG;YACW,YAAY;IAmB1B;;;;;;;;;;;;OAYG;IACG,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC,MAAM,CAAC;IAoBlB;;;;;;;;;;OAUG;IACG,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBvE;;;;;;;;;;;OAWG;IACG,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBhG;;;;;;;;OAQG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,EAAE;IAOlD;;;;;;;;OAQG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAQvD;;;;;;;OAOG;IACH,qBAAqB,IAAI,eAAe,EAAE;IAM1C;;;;;;;OAOG;IACH,iBAAiB,IAAI,eAAe,EAAE;IAItC;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;CAGtD"}

package/dist/delegation-registry-store.js

@@ -0,0 +1,299 @@
+/**
+ * Delegation Registry Store (WU-1944)
+ *
+ * Event-sourced state store for tracking sub-agent delegations.
+ * Stores events in .lumenflow/state/delegation-registry.jsonl (append-only, git-friendly).
+ *
+ * Features:
+ * - Event sourcing with replay for current state
+ * - Atomic append operations
+ * - O(1) queries by parent WU, target WU, and status
+ *
+ * @see {@link packages/@lumenflow/cli/src/lib/__tests__/delegation-registry-store.test.ts} - Tests
+ * @see {@link packages/@lumenflow/cli/src/lib/delegation-registry-schema.ts} - Schema definitions
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { validateDelegationEvent, generateDelegationId, DelegationStatus, } from './delegation-registry-schema.js';
+/** Delegation registry file name constant */
+export const DELEGATION_REGISTRY_FILE_NAME = 'delegation-registry.jsonl';
+/**
+ * Delegation Registry Store class
+ *
+ * Manages delegation registry state via event sourcing pattern.
+ * Events are appended to JSONL file, state is rebuilt by replaying events.
+ */
+export class DelegationRegistryStore {
+    baseDir;
+    registryFilePath;
+    delegations;
+    byParent;
+    byTarget;
+    /**
+     * @param {string} baseDir - Directory containing .lumenflow/state/
+     */
+    constructor(baseDir) {
+        this.baseDir = baseDir;
+        this.registryFilePath = path.join(baseDir, DELEGATION_REGISTRY_FILE_NAME);
+        // In-memory state (rebuilt from events)
+        this.delegations = new Map();
+        // Index: parentWuId -> delegationIds[]
+        this.byParent = new Map();
+        // Index: targetWuId -> delegationId
+        this.byTarget = new Map();
+    }
+    /**
+     * Loads and replays events from JSONL file into current state.
+     *
+     * Handles:
+     * - Missing file: returns empty state
+     * - Empty file: returns empty state
+     * - Empty lines: skipped gracefully
+     * - Malformed JSON: throws error with line info
+     * - Invalid events: throws validation error
+     *
+     * @returns {Promise<void>}
+     * @throws {Error} If file contains malformed JSON or invalid events
+     *
+     * @example
+     * const store = new DelegationRegistryStore('/path/to/project');
+     * await store.load();
+     * const pending = store.getPendingDelegations();
+     */
+    async load() {
+        // Reset state
+        this.delegations.clear();
+        this.byParent.clear();
+        this.byTarget.clear();
+        // Check if file exists
+        let content;
+        try {
+            content = await fs.readFile(this.registryFilePath, 'utf-8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                // File doesn't exist - return empty state
+                return;
+            }
+            throw error;
+        }
+        // Parse JSONL content
+        const lines = content.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            // Skip empty lines
+            if (!line) {
+                continue;
+            }
+            // Parse JSON line
+            let parsed;
+            try {
+                parsed = JSON.parse(line);
+            }
+            catch (error) {
+                throw new Error(`Malformed JSON on line ${i + 1}: ${error.message}`);
+            }
+            // Validate against schema
+            const validation = validateDelegationEvent(parsed);
+            if (!validation.success) {
+                const issues = validation.error.issues
+                    .map((issue) => `${issue.path.join('.')}: ${issue.message}`)
+                    .join(', ');
+                throw new Error(`Validation error on line ${i + 1}: ${issues}`);
+            }
+            const event = validation.data;
+            // Apply event to state (latest event for same ID wins)
+            this._applyEvent(event);
+        }
+    }
+    /**
+     * Applies an event to the in-memory state.
+     * If event for same delegation ID exists, updates it (latest wins).
+     *
+     * @private
+     */
+    _applyEvent(event) {
+        const { id, parentWuId, targetWuId } = event;
+        // Update main state map
+        this.delegations.set(id, event);
+        // Update parent index
+        if (!this.byParent.has(parentWuId)) {
+            this.byParent.set(parentWuId, []);
+        }
+        const parentDelegations = this.byParent.get(parentWuId);
+        if (!parentDelegations.includes(id)) {
+            parentDelegations.push(id);
+        }
+        // Update target index
+        this.byTarget.set(targetWuId, id);
+    }
+    /**
+     * Appends an event to the registry file.
+     *
+     * Uses append mode to avoid full file rewrite.
+     * Creates file and parent directories if they don't exist.
+     * Validates event before appending.
+     *
+     * @private
+     * @throws {Error} If event fails validation
+     */
+    async _appendEvent(event) {
+        // Validate event before appending
+        const validation = validateDelegationEvent(event);
+        if (!validation.success) {
+            const issues = validation.error.issues
+                .map((issue) => `${issue.path.join('.')}: ${issue.message}`)
+                .join(', ');
+            throw new Error(`Validation error: ${issues}`);
+        }
+        const line = JSON.stringify(event) + '\n';
+        // Ensure parent directory exists before appending
+        await fs.mkdir(this.baseDir, { recursive: true });
+        // Use append flag to avoid rewriting the file
+        await fs.appendFile(this.registryFilePath, line, 'utf-8');
+    }
+    /**
+     * Records a new delegation event with pending status.
+     *
+     * @param {string} parentWuId - Parent WU ID (orchestrator)
+     * @param {string} targetWuId - Target WU ID (delegated work)
+     * @param {string} lane - Lane for the delegated work
+     * @param {DelegationIntentValue} [intent] - Optional intent source (e.g., delegation)
+     * @returns {Promise<string>} The generated delegation ID
+     * @throws {Error} If validation fails
+     *
+     * @example
+     * const delegationId = await store.record('WU-1000', 'WU-1001', 'Operations: Tooling');
+     */
+    async record(parentWuId, targetWuId, lane, intent) {
+        const id = generateDelegationId(parentWuId, targetWuId);
+        const event = {
+            id,
+            parentWuId,
+            targetWuId,
+            lane,
+            ...(intent ? { intent } : {}),
+            delegatedAt: new Date().toISOString(),
+            status: DelegationStatus.PENDING,
+            completedAt: null,
+        };
+        await this._appendEvent(event);
+        this._applyEvent(event);
+        return id;
+    }
+    /**
+     * Updates the status of a delegation.
+     *
+     * @param {string} delegationId - Delegation ID to update
+     * @param {string} status - New status
+     * @returns {Promise<void>}
+     * @throws {Error} If delegation ID not found
+     *
+     * @example
+     * await store.updateStatus('dlg-a1b2', 'completed');
+     */
+    async updateStatus(delegationId, status) {
+        const existing = this.delegations.get(delegationId);
+        if (!existing) {
+            throw new Error(`Delegation ID ${delegationId} not found`);
+        }
+        const event = {
+            ...existing,
+            status: status,
+            completedAt: new Date().toISOString(),
+        };
+        await this._appendEvent(event);
+        this._applyEvent(event);
+    }
+    /**
+     * Records claim-time pickup evidence for a delegation entry.
+     *
+     * WU-1605: This distinguishes intent-only delegation records from
+     * delegated work that was actually picked up via wu:claim.
+     *
+     * @param {string} delegationId - Delegation ID to update
+     * @param {string} pickedUpBy - Agent identity that claimed the target WU
+     * @param {string} [pickedUpAt] - Optional ISO timestamp (defaults to now)
+     * @returns {Promise<void>}
+     * @throws {Error} If delegation ID not found
+     */
+    async recordPickup(delegationId, pickedUpBy, pickedUpAt) {
+        const existing = this.delegations.get(delegationId);
+        if (!existing) {
+            throw new Error(`Delegation ID ${delegationId} not found`);
+        }
+        const event = {
+            ...existing,
+            pickedUpBy,
+            pickedUpAt: pickedUpAt ?? new Date().toISOString(),
+        };
+        await this._appendEvent(event);
+        this._applyEvent(event);
+    }
+    /**
+     * Gets all delegations for a parent WU.
+     *
+     * @param {string} parentWuId - Parent WU ID
+     * @returns {DelegationEvent[]} Array of delegation events
+     *
+     * @example
+     * const delegations = store.getByParent('WU-1000');
+     */
+    getByParent(parentWuId) {
+        const delegationIds = this.byParent.get(parentWuId) ?? [];
+        return delegationIds
+            .map((id) => this.delegations.get(id))
+            .filter((event) => event !== undefined);
+    }
+    /**
+     * Gets delegation for a target WU.
+     *
+     * @param {string} targetWuId - Target WU ID
+     * @returns {DelegationEvent | null} Delegation event or null
+     *
+     * @example
+     * const delegation = store.getByTarget('WU-1001');
+     */
+    getByTarget(targetWuId) {
+        const delegationId = this.byTarget.get(targetWuId);
+        if (!delegationId) {
+            return null;
+        }
+        return this.delegations.get(delegationId) ?? null;
+    }
+    /**
+     * Gets all pending delegations.
+     *
+     * @returns {DelegationEvent[]} Array of pending delegation events
+     *
+     * @example
+     * const pending = store.getPendingDelegations();
+     */
+    getPendingDelegations() {
+        return Array.from(this.delegations.values()).filter((delegation) => delegation.status === DelegationStatus.PENDING);
+    }
+    /**
+     * Gets all delegations as an array.
+     *
+     * @returns {DelegationEvent[]} Array of all delegation events
+     *
+     * @example
+     * const allDelegations = store.getAllDelegations();
+     */
+    getAllDelegations() {
+        return Array.from(this.delegations.values());
+    }
+    /**
+     * Gets delegation by ID.
+     *
+     * @param {string} delegationId - Delegation ID
+     * @returns {DelegationEvent | null} Delegation event or null
+     *
+     * @example
+     * const delegation = store.getById('dlg-a1b2');
+     */
+    getById(delegationId) {
+        return this.delegations.get(delegationId) ?? null;
+    }
+}
+//# sourceMappingURL=delegation-registry-store.js.map

package/dist/delegation-registry-store.js.map

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

package/dist/delegation-tree.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Delegation Tree Builder (WU-1674)
+ *
+ * Builds and formats delegation trees for visualization.
+ */
+import { DelegationStatus } from './delegation-registry-schema.js';
+interface DelegationRecord {
+    id: string;
+    parentWuId: string;
+    targetWuId: string;
+    lane: string;
+    status: string;
+    delegatedAt: string;
+    completedAt: string | null;
+    pickedUpAt?: string;
+    pickedUpBy?: string;
+}
+interface DelegationTreeNode {
+    wuId: string;
+    delegationId: string | null;
+    status: string | null;
+    lane: string | null;
+    delegatedAt: string | null;
+    children: DelegationTreeNode[];
+}
+/**
+ * Status indicators for terminal output.
+ */
+export declare const STATUS_INDICATORS: Readonly<{
+    [DelegationStatus.COMPLETED]: "✓";
+    pending: "○";
+    timeout: "⏱";
+    crashed: "✗";
+    escalated: "!";
+}>;
+/**
+ * Builds a delegation tree from flat delegation events.
+ */
+export declare function buildDelegationTree(delegations: DelegationRecord[], rootWuId: string): DelegationTreeNode;
+/**
+ * Formats a delegation tree for terminal display.
+ */
+export declare function formatDelegationTree(tree: DelegationTreeNode): string;
+/**
+ * Gets all delegations for a WU (direct + descendants).
+ */
+export declare function getDelegationsByWU(wuId: string, baseDir: string): Promise<DelegationRecord[]>;
+/**
+ * Gets all delegations for an initiative.
+ */
+export declare function getDelegationsByInitiative(initiativeId: string, registryDir: string, wuDir: string): Promise<DelegationRecord[]>;
+/**
+ * Converts a delegation tree to JSON.
+ */
+export declare function treeToJSON(tree: DelegationTreeNode): any;
+export {};
+//# sourceMappingURL=delegation-tree.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delegation-tree.d.ts","sourceRoot":"","sources":["../src/delegation-tree.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAcnE,UAAU,gBAAgB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAE5B,CAAC,gBAAgB,CAAC,SAAS,CAAC,MAAU;;;;;EAItC,CAAC;AAuBH;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,gBAAgB,EAAE,EAC/B,QAAQ,EAAE,MAAM,GACf,kBAAkB,CAmCpB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CA4BrE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAwC7B;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAmB7B;AA+BD;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,kBAAkB,OASlD"}