@lumenflow/core 3.2.0 → 3.2.1

package/dist/adapters/mock-dashboard-renderer.adapter.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Mock Dashboard Renderer Adapter
+ *
+ * WU-1549: Extracted from production TerminalDashboardRenderer.
+ * Provides a test-friendly implementation of IDashboardRenderer that
+ * captures all calls for assertions instead of writing to stdout.
+ *
+ * Hexagonal Architecture - Infrastructure Layer (Test Double)
+ * Implements the DashboardRenderer port for unit testing.
+ *
+ * @module mock-dashboard-renderer.adapter
+ * @see {@link ../ports/dashboard-renderer.port.ts} - Port interface
+ * @see {@link ./terminal-renderer.adapter.ts} - Production implementation
+ */
+import type { IDashboardRenderer } from '../ports/dashboard-renderer.port.js';
+import type { DashboardData, Suggestion, ExecutionPlan, UserChoice } from '../domain/orchestration.types.js';
+/**
+ * Captured render call for test assertions
+ */
+export interface RenderCall {
+    method: 'render' | 'renderSuggestions' | 'renderPlan' | 'clear';
+    args: unknown[];
+    timestamp: number;
+}
+/**
+ * Mock Dashboard Renderer
+ *
+ * Captures all rendering calls for test verification.
+ * Does not produce UnsafeAny console output.
+ *
+ * @example
+ * const mock = new MockDashboardRenderer();
+ * mock.render(dashboardData);
+ * expect(mock.renderCalls).toHaveLength(1);
+ * expect(mock.renderCalls[0].method).toBe('render');
+ *
+ * @example
+ * // Configure plan approval response
+ * const mock = new MockDashboardRenderer({ planChoice: { choice: 'reject' } });
+ * const result = await mock.renderPlan(plan);
+ * expect(result.choice).toBe('reject');
+ */
+export declare class MockDashboardRenderer implements IDashboardRenderer {
+    /** All captured render calls in chronological order */
+    readonly renderCalls: RenderCall[];
+    /** Configurable response for renderPlan */
+    private readonly planChoice;
+    constructor(options?: {
+        planChoice?: UserChoice;
+    });
+    /**
+     * Capture render call without producing output.
+     *
+     * @param data - Complete dashboard data
+     */
+    render(data: DashboardData): void;
+    /**
+     * Capture renderSuggestions call without producing output.
+     *
+     * @param suggestions - Ordered suggestions
+     */
+    renderSuggestions(suggestions: Suggestion[]): void;
+    /**
+     * Capture renderPlan call and return configured choice.
+     *
+     * @param plan - Proposed execution plan
+     * @returns Configured user choice (default: approve)
+     */
+    renderPlan(plan: ExecutionPlan): Promise<UserChoice>;
+    /**
+     * Capture clear call without producing output.
+     */
+    clear(): void;
+    /**
+     * Reset all captured calls (useful between test cases).
+     */
+    reset(): void;
+    /**
+     * Get calls filtered by method name.
+     *
+     * @param method - Method name to filter
+     * @returns Filtered calls
+     */
+    getCallsByMethod(method: RenderCall['method']): RenderCall[];
+}
+//# sourceMappingURL=mock-dashboard-renderer.adapter.d.ts.map

package/dist/adapters/mock-dashboard-renderer.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-dashboard-renderer.adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/mock-dashboard-renderer.adapter.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,aAAa,EACb,UAAU,EACX,MAAM,kCAAkC,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,QAAQ,GAAG,mBAAmB,GAAG,YAAY,GAAG,OAAO,CAAC;IAChE,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,qBAAsB,YAAW,kBAAkB;IAC9D,uDAAuD;IACvD,QAAQ,CAAC,WAAW,EAAE,UAAU,EAAE,CAAM;IAExC,2CAA2C;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;gBAE5B,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,UAAU,CAAA;KAAE;IAIjD;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAQjC;;;;OAIG;IACH,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI;IAQlD;;;;;OAKG;IACG,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAS1D;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;OAKG;IACH,gBAAgB,CAAC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,UAAU,EAAE;CAG7D"}

package/dist/adapters/mock-dashboard-renderer.adapter.js

@@ -0,0 +1,93 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Mock Dashboard Renderer
+ *
+ * Captures all rendering calls for test verification.
+ * Does not produce UnsafeAny console output.
+ *
+ * @example
+ * const mock = new MockDashboardRenderer();
+ * mock.render(dashboardData);
+ * expect(mock.renderCalls).toHaveLength(1);
+ * expect(mock.renderCalls[0].method).toBe('render');
+ *
+ * @example
+ * // Configure plan approval response
+ * const mock = new MockDashboardRenderer({ planChoice: { choice: 'reject' } });
+ * const result = await mock.renderPlan(plan);
+ * expect(result.choice).toBe('reject');
+ */
+export class MockDashboardRenderer {
+    /** All captured render calls in chronological order */
+    renderCalls = [];
+    /** Configurable response for renderPlan */
+    planChoice;
+    constructor(options) {
+        this.planChoice = options?.planChoice ?? { choice: 'approve', modifications: undefined };
+    }
+    /**
+     * Capture render call without producing output.
+     *
+     * @param data - Complete dashboard data
+     */
+    render(data) {
+        this.renderCalls.push({
+            method: 'render',
+            args: [data],
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Capture renderSuggestions call without producing output.
+     *
+     * @param suggestions - Ordered suggestions
+     */
+    renderSuggestions(suggestions) {
+        this.renderCalls.push({
+            method: 'renderSuggestions',
+            args: [suggestions],
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Capture renderPlan call and return configured choice.
+     *
+     * @param plan - Proposed execution plan
+     * @returns Configured user choice (default: approve)
+     */
+    async renderPlan(plan) {
+        this.renderCalls.push({
+            method: 'renderPlan',
+            args: [plan],
+            timestamp: Date.now(),
+        });
+        return this.planChoice;
+    }
+    /**
+     * Capture clear call without producing output.
+     */
+    clear() {
+        this.renderCalls.push({
+            method: 'clear',
+            args: [],
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Reset all captured calls (useful between test cases).
+     */
+    reset() {
+        this.renderCalls.length = 0;
+    }
+    /**
+     * Get calls filtered by method name.
+     *
+     * @param method - Method name to filter
+     * @returns Filtered calls
+     */
+    getCallsByMethod(method) {
+        return this.renderCalls.filter((call) => call.method === method);
+    }
+}
+//# sourceMappingURL=mock-dashboard-renderer.adapter.js.map

package/dist/adapters/mock-dashboard-renderer.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-dashboard-renderer.adapter.js","sourceRoot":"","sources":["../../src/adapters/mock-dashboard-renderer.adapter.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAkCzC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,qBAAqB;IAChC,uDAAuD;IAC9C,WAAW,GAAiB,EAAE,CAAC;IAExC,2CAA2C;IAC1B,UAAU,CAAa;IAExC,YAAY,OAAqC;QAC/C,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3F,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAmB;QACxB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;YACpB,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,CAAC,IAAI,CAAC;YACZ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,WAAyB;QACzC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;YACpB,MAAM,EAAE,mBAAmB;YAC3B,IAAI,EAAE,CAAC,WAAW,CAAC;YACnB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,IAAmB;QAClC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;YACpB,MAAM,EAAE,YAAY;YACpB,IAAI,EAAE,CAAC,IAAI,CAAC;YACZ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;YACpB,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,EAAE;YACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACH,gBAAgB,CAAC,MAA4B;QAC3C,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IACnE,CAAC;CACF"}

package/dist/adapters/recovery-adapters.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Recovery Adapters
+ *
+ * WU-1094: INIT-002 Phase 2 - Implement adapters and dependency injection
+ *
+ * Concrete adapter implementations for recovery-related port interfaces.
+ * These adapters wrap the existing implementation functions to conform
+ * to the port interfaces, enabling dependency injection.
+ *
+ * Adapters:
+ * - RecoveryAnalyzerAdapter - Implements IRecoveryAnalyzer
+ *
+ * @module adapters/recovery-adapters
+ */
+import type { IRecoveryAnalyzer, WuContext, RecoveryAnalysis } from '../ports/recovery.ports.js';
+/**
+ * RecoveryAnalyzerAdapter
+ *
+ * Implements IRecoveryAnalyzer by delegating to the analyzeRecovery function.
+ * Analyzes WU context to detect state inconsistencies and suggests
+ * recovery actions.
+ *
+ * @example
+ * // Use default adapter
+ * const adapter = new RecoveryAnalyzerAdapter();
+ * const analysis = await adapter.analyzeRecovery(context);
+ *
+ * @example
+ * // Use as port interface
+ * const analyzer: IRecoveryAnalyzer = new RecoveryAnalyzerAdapter();
+ */
+export declare class RecoveryAnalyzerAdapter implements IRecoveryAnalyzer {
+    /**
+     * Analyze context for recovery issues.
+     *
+     * @param context - Current WU context
+     * @returns Promise<RecoveryAnalysis> - Recovery analysis with issues and suggested actions
+     */
+    analyzeRecovery(context: WuContext): Promise<RecoveryAnalysis>;
+}
+//# sourceMappingURL=recovery-adapters.d.ts.map

package/dist/adapters/recovery-adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-adapters.d.ts","sourceRoot":"","sources":["../../src/adapters/recovery-adapters.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAKjG;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D;;;;;OAKG;IACG,eAAe,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAGrE"}

package/dist/adapters/recovery-adapters.js

@@ -0,0 +1,32 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+// Import existing implementation
+import { analyzeRecovery } from '../recovery/recovery-analyzer.js';
+/**
+ * RecoveryAnalyzerAdapter
+ *
+ * Implements IRecoveryAnalyzer by delegating to the analyzeRecovery function.
+ * Analyzes WU context to detect state inconsistencies and suggests
+ * recovery actions.
+ *
+ * @example
+ * // Use default adapter
+ * const adapter = new RecoveryAnalyzerAdapter();
+ * const analysis = await adapter.analyzeRecovery(context);
+ *
+ * @example
+ * // Use as port interface
+ * const analyzer: IRecoveryAnalyzer = new RecoveryAnalyzerAdapter();
+ */
+export class RecoveryAnalyzerAdapter {
+    /**
+     * Analyze context for recovery issues.
+     *
+     * @param context - Current WU context
+     * @returns Promise<RecoveryAnalysis> - Recovery analysis with issues and suggested actions
+     */
+    async analyzeRecovery(context) {
+        return analyzeRecovery(context);
+    }
+}
+//# sourceMappingURL=recovery-adapters.js.map

package/dist/adapters/recovery-adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-adapters.js","sourceRoot":"","sources":["../../src/adapters/recovery-adapters.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAmBzC,iCAAiC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAEnE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,uBAAuB;IAClC;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,OAAkB;QACtC,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;CACF"}

package/dist/adapters/terminal-renderer.adapter.d.ts

@@ -0,0 +1,86 @@
+import type { IDashboardRenderer } from '../ports/dashboard-renderer.port.js';
+import type { DashboardData, Suggestion, ExecutionPlan, UserChoice } from '../domain/orchestration.types.js';
+/**
+ * Terminal Dashboard Renderer
+ *
+ * Renders orchestration dashboard data to terminal using ANSI colours and ASCII tables.
+ *
+ * @example
+ * const renderer = new TerminalDashboardRenderer();
+ * const data = await metricsCollector.collect();
+ * renderer.render(data);
+ */
+export declare class TerminalDashboardRenderer implements IDashboardRenderer {
+    /**
+     * Render the complete dashboard with all 5 sections.
+     *
+     * Sections:
+     * 1. Global Status - High-level metrics
+     * 2. Agent Small Multiples - Per-agent comparison table
+     * 3. WU Progress - DoD progress bars with headlines
+     * 4. Timeline - Recent events
+     * 5. Alerts - Items requiring attention
+     *
+     * @param data - Complete dashboard data
+     */
+    render(data: DashboardData): void;
+    /**
+     * Render prioritised suggestions.
+     *
+     * @param suggestions - Ordered suggestions (highest priority first)
+     */
+    renderSuggestions(suggestions: Suggestion[]): void;
+    /**
+     * Render execution plan and prompt for user approval.
+     *
+     * @param plan - Proposed execution plan
+     * @returns User's choice (approve/reject/edit)
+     */
+    renderPlan(plan: ExecutionPlan): Promise<UserChoice>;
+    /**
+     * Clear terminal output.
+     *
+     * Uses ANSI escape sequence to clear screen.
+     */
+    clear(): void;
+    /**
+     * Render global status section.
+     *
+     * @private
+     */
+    private renderGlobalStatus;
+    /**
+     * Render agent metrics as small multiples table.
+     *
+     * @private
+     */
+    private renderAgentMetrics;
+    /**
+     * Render WU progress with DoD bars and headlines.
+     *
+     * @private
+     */
+    private renderWUProgress;
+    /**
+     * Render timeline of recent events.
+     *
+     * @private
+     */
+    private renderTimeline;
+    /**
+     * Render alerts requiring attention.
+     *
+     * @private
+     */
+    private renderAlerts;
+    /**
+     * Prompt user for execution plan approval.
+     *
+     * This is a simplified implementation for testing.
+     * Production version would use @inquirer/prompts for interactive input.
+     *
+     * @private
+     */
+    private promptUser;
+}
+//# sourceMappingURL=terminal-renderer.adapter.d.ts.map

package/dist/adapters/terminal-renderer.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-renderer.adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/terminal-renderer.adapter.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,aAAa,EACb,UAAU,EAMX,MAAM,kCAAkC,CAAC;AA6C1C;;;;;;;;;GASG;AACH,qBAAa,yBAA0B,YAAW,kBAAkB;IAClE;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAuBjC;;;;OAIG;IACH,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI;IAqBlD;;;;;OAKG;IACG,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IA2B1D;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAKb;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IA6E1B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IA8C1B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAkDxB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAwBtB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAqBpB;;;;;;;OAOG;YACW,UAAU;CAQzB"}