@lumenflow/core 3.1.2 → 3.1.3

package/dist/usecases/compute-context.usecase.js

@@ -1,91 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-import { WU_STATUS } from '../wu-constants.js';
-/**
- * ComputeContextUseCase
- *
- * Orchestrates the computation of WU context by calling multiple adapters
- * and assembling the unified context model.
- *
- * @example
- * // Using default adapters via DI factory
- * const useCase = createComputeContextUseCase();
- * const context = await useCase.execute({ wuId: 'WU-1094' });
- *
- * @example
- * // Using custom adapters for testing
- * const useCase = new ComputeContextUseCase(
- *   mockLocationResolver,
- *   mockGitStateReader,
- *   mockWuStateReader,
- * );
- * const context = await useCase.execute({});
- */
-export class ComputeContextUseCase {
-    locationResolver;
-    gitStateReader;
-    wuStateReader;
-    constructor(locationResolver, gitStateReader, wuStateReader) {
-        this.locationResolver = locationResolver;
-        this.gitStateReader = gitStateReader;
-        this.wuStateReader = wuStateReader;
-    }
-    /**
-     * Execute the use case to compute WU context.
-     *
-     * @param options - Options including optional wuId and cwd
-     * @returns Promise<WuContext> - Computed WU context
-     */
-    async execute(options = {}) {
-        const { wuId, cwd } = options;
-        // Step 1: Resolve location context
-        const location = await this.locationResolver.resolveLocation(cwd);
-        // Step 2: Read git state for current directory
-        const git = await this.gitStateReader.readGitState(cwd);
-        // Step 3: Determine WU ID (explicit or from worktree)
-        const effectiveWuId = wuId ?? location.worktreeWuId;
-        // Step 4: Read WU state if we have a WU ID
-        let wu = null;
-        let worktreeGit;
-        if (effectiveWuId) {
-            const wuStateResult = await this.wuStateReader.readWuState(effectiveWuId, location.mainCheckout);
-            if (wuStateResult) {
-                wu = {
-                    id: wuStateResult.id,
-                    status: wuStateResult.status,
-                    lane: wuStateResult.lane,
-                    title: wuStateResult.title,
-                    yamlPath: wuStateResult.yamlPath,
-                    isConsistent: wuStateResult.isConsistent,
-                    inconsistencyReason: wuStateResult.inconsistencyReason,
-                };
-                // Step 5: If running from main and WU is in_progress, read worktree git state
-                if (location.type === 'main' && wu.status === WU_STATUS.IN_PROGRESS) {
-                    const worktreePath = this.getWorktreePath(location.mainCheckout, wu.lane, wu.id);
-                    worktreeGit = await this.gitStateReader.readGitState(worktreePath);
-                }
-            }
-        }
-        // Step 6: Create session state (inactive by default)
-        const session = {
-            isActive: false,
-            sessionId: null,
-        };
-        return {
-            location,
-            git,
-            wu,
-            session,
-            worktreeGit,
-        };
-    }
-    /**
-     * Get expected worktree path for a WU.
-     */
-    getWorktreePath(mainCheckout, lane, wuId) {
-        const laneKebab = lane.toLowerCase().replace(/[: ]+/g, '-');
-        const wuIdLower = wuId.toLowerCase();
-        return `${mainCheckout}/worktrees/${laneKebab}-${wuIdLower}`;
-    }
-}
-//# sourceMappingURL=compute-context.usecase.js.map

package/dist/usecases/compute-context.usecase.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"compute-context.usecase.js","sourceRoot":"","sources":["../../src/usecases/compute-context.usecase.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAwBzC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAY/C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,qBAAqB;IAEb;IACA;IACA;IAHnB,YACmB,gBAAmC,EACnC,cAA+B,EAC/B,aAA6B;QAF7B,qBAAgB,GAAhB,gBAAgB,CAAmB;QACnC,mBAAc,GAAd,cAAc,CAAiB;QAC/B,kBAAa,GAAb,aAAa,CAAgB;IAC7C,CAAC;IAEJ;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,UAAiC,EAAE;QAC/C,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;QAE9B,mCAAmC;QACnC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QAElE,+CAA+C;QAC/C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QAExD,sDAAsD;QACtD,MAAM,aAAa,GAAG,IAAI,IAAI,QAAQ,CAAC,YAAY,CAAC;QAEpD,2CAA2C;QAC3C,IAAI,EAAE,GAAmB,IAAI,CAAC;QAC9B,IAAI,WAAiC,CAAC;QAEtC,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,WAAW,CACxD,aAAa,EACb,QAAQ,CAAC,YAAY,CACtB,CAAC;YAEF,IAAI,aAAa,EAAE,CAAC;gBAClB,EAAE,GAAG;oBACH,EAAE,EAAE,aAAa,CAAC,EAAE;oBACpB,MAAM,EAAE,aAAa,CAAC,MAAM;oBAC5B,IAAI,EAAE,aAAa,CAAC,IAAI;oBACxB,KAAK,EAAE,aAAa,CAAC,KAAK;oBAC1B,QAAQ,EAAE,aAAa,CAAC,QAAQ;oBAChC,YAAY,EAAE,aAAa,CAAC,YAAY;oBACxC,mBAAmB,EAAE,aAAa,CAAC,mBAAmB;iBACvD,CAAC;gBAEF,8EAA8E;gBAC9E,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,IAAI,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,WAAW,EAAE,CAAC;oBACpE,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;oBACjF,WAAW,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;gBACrE,CAAC;YACH,CAAC;QACH,CAAC;QAED,qDAAqD;QACrD,MAAM,OAAO,GAAiB;YAC5B,QAAQ,EAAE,KAAK;YACf,SAAS,EAAE,IAAI;SAChB,CAAC;QAEF,OAAO;YACL,QAAQ;YACR,GAAG;YACH,EAAE;YACF,OAAO;YACP,WAAW;SACZ,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,YAAoB,EAAE,IAAY,EAAE,IAAY;QACtE,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACrC,OAAO,GAAG,YAAY,cAAc,SAAS,IAAI,SAAS,EAAE,CAAC;IAC/D,CAAC;CACF"}

package/dist/usecases/get-dashboard-data.usecase.d.ts

@@ -1,53 +0,0 @@
-/**
- * GetDashboardData Use Case
- *
- * Orchestrates the collection of all dashboard metrics from the metrics collector.
- * Follows hexagonal architecture - depends on port interface, not concrete implementation.
- *
- * @module get-dashboard-data.usecase
- * @see {@link ../ports/metrics-collector.port.ts} - Port interface
- * @see {@link ../domain/orchestration.types.ts} - Domain types
- */
-import type { IMetricsCollector } from '../ports/metrics-collector.port.js';
-import type { DashboardData } from '../domain/orchestration.types.js';
-/**
- * Options for the GetDashboardData use case.
- */
-export interface GetDashboardDataOptions {
-    /**
-     * Number of hours to include in the timeline.
-     * @default TIMELINE_WINDOW_HOURS (24)
-     */
-    timelineHours?: number;
-}
-/**
- * Use case for collecting all dashboard data.
- *
- * Orchestrates parallel calls to the metrics collector to gather:
- * - Global status (active WUs, completed, blocked, etc.)
- * - Agent metrics (invocation counts, pass rates, timing)
- * - WU progress (DoD progress, agent statuses)
- * - Timeline events (recent activity)
- * - Alerts (items requiring attention)
- *
- * @example
- * const collector = new FileSystemMetricsCollector(basePath);
- * const useCase = new GetDashboardDataUseCase(collector);
- * const data = await useCase.execute();
- * console.log(data.globalStatus.activeWUs);
- */
-export declare class GetDashboardDataUseCase {
-    private readonly metricsCollector;
-    constructor(metricsCollector: IMetricsCollector);
-    /**
-     * Execute the use case to collect all dashboard data.
-     *
-     * Calls all collector methods in parallel for optimal performance.
-     *
-     * @param options - Optional configuration
-     * @returns Promise resolving to complete dashboard data
-     * @throws Error if UnsafeAny collector method fails
-     */
-    execute(options?: GetDashboardDataOptions): Promise<DashboardData>;
-}
-//# sourceMappingURL=get-dashboard-data.usecase.d.ts.map

package/dist/usecases/get-dashboard-data.usecase.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"get-dashboard-data.usecase.d.ts","sourceRoot":"","sources":["../../src/usecases/get-dashboard-data.usecase.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAGtE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,uBAAuB;IACtB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,iBAAiB;IAEhE;;;;;;;;OAQG;IACG,OAAO,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,aAAa,CAAC;CAsB7E"}

package/dist/usecases/get-dashboard-data.usecase.js

@@ -1,54 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-import { TIMELINE_WINDOW_HOURS } from '../domain/orchestration.constants.js';
-/**
- * Use case for collecting all dashboard data.
- *
- * Orchestrates parallel calls to the metrics collector to gather:
- * - Global status (active WUs, completed, blocked, etc.)
- * - Agent metrics (invocation counts, pass rates, timing)
- * - WU progress (DoD progress, agent statuses)
- * - Timeline events (recent activity)
- * - Alerts (items requiring attention)
- *
- * @example
- * const collector = new FileSystemMetricsCollector(basePath);
- * const useCase = new GetDashboardDataUseCase(collector);
- * const data = await useCase.execute();
- * console.log(data.globalStatus.activeWUs);
- */
-export class GetDashboardDataUseCase {
-    metricsCollector;
-    constructor(metricsCollector) {
-        this.metricsCollector = metricsCollector;
-    }
-    /**
-     * Execute the use case to collect all dashboard data.
-     *
-     * Calls all collector methods in parallel for optimal performance.
-     *
-     * @param options - Optional configuration
-     * @returns Promise resolving to complete dashboard data
-     * @throws Error if UnsafeAny collector method fails
-     */
-    async execute(options = {}) {
-        const { timelineHours = TIMELINE_WINDOW_HOURS } = options;
-        const timelineSince = new Date();
-        timelineSince.setHours(timelineSince.getHours() - timelineHours);
-        const [globalStatus, agentMetrics, wuProgress, timeline, alerts] = await Promise.all([
-            this.metricsCollector.getGlobalStatus(),
-            this.metricsCollector.getAgentMetrics(),
-            this.metricsCollector.getWUProgress(),
-            this.metricsCollector.getTimeline(timelineSince),
-            this.metricsCollector.getAlerts(),
-        ]);
-        return {
-            globalStatus,
-            agentMetrics,
-            wuProgress,
-            timeline,
-            alerts,
-        };
-    }
-}
-//# sourceMappingURL=get-dashboard-data.usecase.js.map

package/dist/usecases/get-dashboard-data.usecase.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"get-dashboard-data.usecase.js","sourceRoot":"","sources":["../../src/usecases/get-dashboard-data.usecase.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAezC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAa7E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,uBAAuB;IACL;IAA7B,YAA6B,gBAAmC;QAAnC,qBAAgB,GAAhB,gBAAgB,CAAmB;IAAG,CAAC;IAEpE;;;;;;;;OAQG;IACH,KAAK,CAAC,OAAO,CAAC,UAAmC,EAAE;QACjD,MAAM,EAAE,aAAa,GAAG,qBAAqB,EAAE,GAAG,OAAO,CAAC;QAE1D,MAAM,aAAa,GAAG,IAAI,IAAI,EAAE,CAAC;QACjC,aAAa,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,EAAE,GAAG,aAAa,CAAC,CAAC;QAEjE,MAAM,CAAC,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACnF,IAAI,CAAC,gBAAgB,CAAC,eAAe,EAAE;YACvC,IAAI,CAAC,gBAAgB,CAAC,eAAe,EAAE;YACvC,IAAI,CAAC,gBAAgB,CAAC,aAAa,EAAE;YACrC,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,aAAa,CAAC;YAChD,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE;SAClC,CAAC,CAAC;QAEH,OAAO;YACL,YAAY;YACZ,YAAY;YACZ,UAAU;YACV,QAAQ;YACR,MAAM;SACP,CAAC;IACJ,CAAC;CACF"}

package/dist/usecases/get-suggestions.usecase.d.ts

@@ -1,101 +0,0 @@
-/**
- * GetSuggestions Use Case
- *
- * Applies orchestration rules to generate recommendations for next actions.
- * Combines WU progress analysis with code path detection.
- *
- * @module get-suggestions.usecase
- * @see {@link ../orchestration-rules.ts} - Rule functions
- * @see {@link ../ports/metrics-collector.port.ts} - Port interface
- */
-import type { IMetricsCollector } from '../ports/metrics-collector.port.js';
-import type { Suggestion } from '../domain/orchestration.types.js';
-/**
- * Bottleneck scores mapping WU IDs to their impact scores.
- * Impact score = number of downstream WUs blocked by this WU.
- */
-export type BottleneckScores = Record<string, number>;
-/**
- * Options for the GetSuggestions use case.
- */
-export interface GetSuggestionsOptions {
-    /**
-     * Code paths to analyse for mandatory agent triggers.
-     * When provided, detects which agents should be invoked.
-     */
-    codePaths?: string[];
-    /**
-     * Bottleneck impact scores from flow:bottlenecks analysis.
-     * When provided, suggestions for high-impact WUs are ranked higher
-     * within the same priority level.
-     *
-     * @see flow-bottlenecks.ts for score calculation
-     */
-    bottleneckScores?: BottleneckScores;
-}
-/**
- * Use case for generating orchestration suggestions.
- *
- * Combines two sources of suggestions:
- * 1. WU progress analysis - suggests agents based on current state
- * 2. Code path analysis - detects mandatory agents from file patterns
- *
- * @example
- * const collector = new FileSystemMetricsCollector(basePath);
- * const useCase = new GetSuggestionsUseCase(collector);
- *
- * // Get suggestions based on current WU state
- * const suggestions = await useCase.execute();
- *
- * // Get suggestions including code path analysis
- * const suggestionsWithPaths = await useCase.execute({
- *   codePaths: ['supabase/migrations/001.sql', 'src/prompts/system.ts']
- * });
- */
-export declare class GetSuggestionsUseCase {
-    private readonly metricsCollector;
-    constructor(metricsCollector: IMetricsCollector);
-    /**
-     * Execute the use case to generate suggestions.
-     *
-     * @param options - Optional configuration including code paths and bottleneck scores
-     * @returns Promise resolving to prioritised suggestions
-     * @throws Error if collector methods fail
-     */
-    execute(options?: GetSuggestionsOptions): Promise<Suggestion[]>;
-    /**
-     * Enrich suggestions with impact score information in reason field.
-     *
-     * @param suggestions - Suggestions to enrich
-     * @param bottleneckScores - WU ID to impact score mapping
-     * @returns Enriched suggestions
-     */
-    private enrichWithImpactScores;
-    /**
-     * Extract WU ID from a suggestion command.
-     *
-     * @param command - Command string containing WU ID
-     * @returns WU ID or null if not found
-     */
-    private extractWuIdFromCommand;
-    /**
-     * Sort suggestions by priority, then by impact score within same priority.
-     *
-     * @param suggestions - Suggestions to sort
-     * @param bottleneckScores - WU ID to impact score mapping
-     * @returns Sorted suggestions
-     */
-    private sortSuggestions;
-    /**
-     * Generate suggestions for mandatory agents detected from code paths.
-     *
-     * Avoids duplicating suggestions that already exist from WU progress analysis.
-     *
-     * @param mandatoryAgents - Agents detected from code paths
-     * @param existingSuggestions - Suggestions already generated
-     * @param wuId - WU ID for the suggestion
-     * @returns Additional suggestions for mandatory agents
-     */
-    private generateMandatoryAgentSuggestions;
-}
-//# sourceMappingURL=get-suggestions.usecase.d.ts.map

package/dist/usecases/get-suggestions.usecase.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"get-suggestions.usecase.d.ts","sourceRoot":"","sources":["../../src/usecases/get-suggestions.usecase.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAsB,MAAM,kCAAkC,CAAC;AAGvF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,iBAAiB;IAEhE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA+BzE;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IA2B9B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAS9B;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IA0BvB;;;;;;;;;OASG;IACH,OAAO,CAAC,iCAAiC;CA2B1C"}

package/dist/usecases/get-suggestions.usecase.js

@@ -1,148 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-import { detectMandatoryAgents, generateSuggestions } from '../orchestration-rules.js';
-/**
- * Use case for generating orchestration suggestions.
- *
- * Combines two sources of suggestions:
- * 1. WU progress analysis - suggests agents based on current state
- * 2. Code path analysis - detects mandatory agents from file patterns
- *
- * @example
- * const collector = new FileSystemMetricsCollector(basePath);
- * const useCase = new GetSuggestionsUseCase(collector);
- *
- * // Get suggestions based on current WU state
- * const suggestions = await useCase.execute();
- *
- * // Get suggestions including code path analysis
- * const suggestionsWithPaths = await useCase.execute({
- *   codePaths: ['supabase/migrations/001.sql', 'src/prompts/system.ts']
- * });
- */
-export class GetSuggestionsUseCase {
-    metricsCollector;
-    constructor(metricsCollector) {
-        this.metricsCollector = metricsCollector;
-    }
-    /**
-     * Execute the use case to generate suggestions.
-     *
-     * @param options - Optional configuration including code paths and bottleneck scores
-     * @returns Promise resolving to prioritised suggestions
-     * @throws Error if collector methods fail
-     */
-    async execute(options = {}) {
-        const { codePaths = [], bottleneckScores = {} } = options;
-        const [wuProgress, agentMetrics] = await Promise.all([
-            this.metricsCollector.getWUProgress(),
-            this.metricsCollector.getAgentMetrics(),
-        ]);
-        // Generate suggestions from WU progress
-        let progressSuggestions = generateSuggestions(wuProgress, agentMetrics);
-        // Enrich suggestions with impact scores if available (WU-1596)
-        progressSuggestions = this.enrichWithImpactScores(progressSuggestions, bottleneckScores);
-        // Detect mandatory agents from code paths
-        const mandatoryAgents = detectMandatoryAgents(codePaths);
-        // Generate additional suggestions for detected mandatory agents
-        const pathSuggestions = this.generateMandatoryAgentSuggestions(mandatoryAgents, progressSuggestions, wuProgress[0]?.wuId ?? 'current');
-        // Combine and deduplicate suggestions
-        const allSuggestions = [...progressSuggestions, ...pathSuggestions];
-        // Sort by priority (high > medium > low), then by impact score (descending)
-        return this.sortSuggestions(allSuggestions, bottleneckScores);
-    }
-    /**
-     * Enrich suggestions with impact score information in reason field.
-     *
-     * @param suggestions - Suggestions to enrich
-     * @param bottleneckScores - WU ID to impact score mapping
-     * @returns Enriched suggestions
-     */
-    enrichWithImpactScores(suggestions, bottleneckScores) {
-        if (Object.keys(bottleneckScores).length === 0) {
-            return suggestions;
-        }
-        return suggestions.map((suggestion) => {
-            const wuId = this.extractWuIdFromCommand(suggestion.command);
-            if (!wuId) {
-                return suggestion;
-            }
-            const impactScore = bottleneckScores[wuId];
-            if (impactScore === undefined || impactScore === 0) {
-                return suggestion;
-            }
-            // Enrich reason with impact score
-            return {
-                ...suggestion,
-                reason: `${suggestion.reason} (blocks ${impactScore} downstream WU${impactScore === 1 ? '' : 's'})`,
-            };
-        });
-    }
-    /**
-     * Extract WU ID from a suggestion command.
-     *
-     * @param command - Command string containing WU ID
-     * @returns WU ID or null if not found
-     */
-    extractWuIdFromCommand(command) {
-        if (!command) {
-            return null;
-        }
-        const match = command.match(/WU-\d+/);
-        return match ? match[0] : null;
-    }
-    /**
-     * Sort suggestions by priority, then by impact score within same priority.
-     *
-     * @param suggestions - Suggestions to sort
-     * @param bottleneckScores - WU ID to impact score mapping
-     * @returns Sorted suggestions
-     */
-    sortSuggestions(suggestions, bottleneckScores) {
-        const priorityOrder = { high: 0, medium: 1, low: 2 };
-        return suggestions.sort((a, b) => {
-            // First sort by priority
-            const aPriority = priorityOrder[a.priority] ?? Number.MAX_SAFE_INTEGER;
-            const bPriority = priorityOrder[b.priority] ?? Number.MAX_SAFE_INTEGER;
-            const priorityDiff = aPriority - bPriority;
-            if (priorityDiff !== 0) {
-                return priorityDiff;
-            }
-            // Within same priority, sort by impact score (higher score first)
-            const aWuId = this.extractWuIdFromCommand(a.command);
-            const bWuId = this.extractWuIdFromCommand(b.command);
-            const aScore = aWuId ? (bottleneckScores[aWuId] ?? 0) : 0;
-            const bScore = bWuId ? (bottleneckScores[bWuId] ?? 0) : 0;
-            return bScore - aScore; // Descending order (higher score first)
-        });
-    }
-    /**
-     * Generate suggestions for mandatory agents detected from code paths.
-     *
-     * Avoids duplicating suggestions that already exist from WU progress analysis.
-     *
-     * @param mandatoryAgents - Agents detected from code paths
-     * @param existingSuggestions - Suggestions already generated
-     * @param wuId - WU ID for the suggestion
-     * @returns Additional suggestions for mandatory agents
-     */
-    generateMandatoryAgentSuggestions(mandatoryAgents, existingSuggestions, wuId) {
-        const suggestions = [];
-        let nextId = existingSuggestions.length + 1;
-        for (const agentName of mandatoryAgents) {
-            // Check if suggestion already exists for this agent
-            const alreadyExists = existingSuggestions.some((s) => s.action.toLowerCase().includes(agentName));
-            if (!alreadyExists) {
-                suggestions.push({
-                    id: `sug-${(nextId++).toString().padStart(3, '0')}`,
-                    priority: 'high',
-                    action: `Run ${agentName}`,
-                    reason: `Code paths indicate ${agentName} is required`,
-                    command: `pnpm orchestrate:run ${agentName} --wu ${wuId}`,
-                });
-            }
-        }
-        return suggestions;
-    }
-}
-//# sourceMappingURL=get-suggestions.usecase.js.map

package/dist/usecases/get-suggestions.usecase.js.map

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

package/dist/usecases/index.d.ts

@@ -1,15 +0,0 @@
-/**
- * Use Cases Index
- *
- * WU-1094: INIT-002 Phase 2 - Implement adapters and dependency injection
- *
- * Re-exports all use case classes.
- *
- * @module usecases
- */
-export { ComputeContextUseCase, type ComputeContextOptions } from './compute-context.usecase.js';
-export { ValidateCommandUseCase } from './validate-command.usecase.js';
-export { AnalyzeRecoveryUseCase } from './analyze-recovery.usecase.js';
-export { GetDashboardDataUseCase, type GetDashboardDataOptions, } from './get-dashboard-data.usecase.js';
-export { GetSuggestionsUseCase, type GetSuggestionsOptions } from './get-suggestions.usecase.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/usecases/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/usecases/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAGH,OAAO,EAAE,qBAAqB,EAAE,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAGjG,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAGvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAGvE,OAAO,EACL,uBAAuB,EACvB,KAAK,uBAAuB,GAC7B,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,qBAAqB,EAAE,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/usecases/index.js

@@ -1,21 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * Use Cases Index
- *
- * WU-1094: INIT-002 Phase 2 - Implement adapters and dependency injection
- *
- * Re-exports all use case classes.
- *
- * @module usecases
- */
-// Context use cases
-export { ComputeContextUseCase } from './compute-context.usecase.js';
-// Validation use cases
-export { ValidateCommandUseCase } from './validate-command.usecase.js';
-// Recovery use cases
-export { AnalyzeRecoveryUseCase } from './analyze-recovery.usecase.js';
-// Existing use cases (pre-WU-1094)
-export { GetDashboardDataUseCase, } from './get-dashboard-data.usecase.js';
-export { GetSuggestionsUseCase } from './get-suggestions.usecase.js';
-//# sourceMappingURL=index.js.map

package/dist/usecases/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/usecases/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;GAQG;AAEH,oBAAoB;AACpB,OAAO,EAAE,qBAAqB,EAA8B,MAAM,8BAA8B,CAAC;AAEjG,uBAAuB;AACvB,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,qBAAqB;AACrB,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,mCAAmC;AACnC,OAAO,EACL,uBAAuB,GAExB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,qBAAqB,EAA8B,MAAM,8BAA8B,CAAC"}

package/dist/usecases/validate-command.usecase.d.ts

@@ -1,56 +0,0 @@
-/**
- * ValidateCommandUseCase
- *
- * WU-1094: INIT-002 Phase 2 - Implement adapters and dependency injection
- *
- * Use case for validating commands against WU context.
- * Uses constructor injection for command registry dependency.
- *
- * Hexagonal Architecture - Application Layer
- * - Depends on port interface (ICommandRegistry)
- * - Does NOT import from infrastructure layer
- *
- * @module usecases/validate-command.usecase
- */
-import type { ICommandRegistry, CommandDefinition, WuContext } from '../ports/validation.ports.js';
-import type { ValidationResult } from '../validation/types.js';
-/**
- * ValidateCommandUseCase
- *
- * Validates a command against the current WU context, returning
- * validation errors and warnings with fix suggestions.
- *
- * @example
- * // Using default registry via DI factory
- * const useCase = createValidateCommandUseCase();
- * const result = await useCase.execute('wu:done', context);
- *
- * @example
- * // Using custom registry for testing
- * const useCase = new ValidateCommandUseCase(mockRegistry);
- * const result = await useCase.execute('wu:claim', context);
- */
-export declare class ValidateCommandUseCase {
-    private readonly commandRegistry;
-    constructor(commandRegistry: ICommandRegistry);
-    /**
-     * Execute the use case to validate a command.
-     *
-     * @param command - Command name (e.g., 'wu:done')
-     * @param context - Current WU context
-     * @returns Promise<ValidationResult> - Validation result with errors/warnings
-     */
-    execute(command: string, context: WuContext): Promise<ValidationResult>;
-    /**
-     * Get valid commands for the current context.
-     *
-     * @param context - Current WU context
-     * @returns Promise<CommandDefinition[]> - Array of valid commands
-     */
-    getValidCommands(context: WuContext): Promise<CommandDefinition[]>;
-    /**
-     * Generate fix command for location errors.
-     */
-    private getLocationFixCommand;
-}
-//# sourceMappingURL=validate-command.usecase.d.ts.map

package/dist/usecases/validate-command.usecase.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate-command.usecase.d.ts","sourceRoot":"","sources":["../../src/usecases/validate-command.usecase.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACnG,OAAO,KAAK,EAAE,gBAAgB,EAAsC,MAAM,wBAAwB,CAAC;AAKnG;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAAf,eAAe,EAAE,gBAAgB;IAE9D;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkG7E;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIxE;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAkB9B"}