@jterrats/smart-deployment 1.0.3

package/lib/waves/priority-wave-generator-ai.d.ts

@@ -0,0 +1,85 @@
+/**
+ * AI-Enhanced Priority Wave Generator - US-042 + US-057
+ * Extends priority wave generation with Agentforce AI
+ *
+ * @ac US-042-AC-1: Use deployment order constants
+ * @ac US-042-AC-2: Objects before classes before triggers
+ * @ac US-042-AC-3: Break ties using priorities
+ * @ac US-042-AC-4: User-defined priority overrides
+ * @ac US-042-AC-5: Report priority decisions
+ * @ac US-042-AC-6: Validate no dependency violations
+ * @ac US-057-AC-5: Merge with static priorities
+ * @ac US-057-AC-6: Report AI decisions
+ *
+ * @issue #42, #57
+ */
+import type { AgentforcePriorityService } from '../ai/agentforce-priority-service.js';
+import type { NodeId } from '../types/dependency.js';
+import type { PriorityOverride } from '../types/deployment-plan.js';
+import type { MetadataComponent } from '../types/metadata.js';
+import { PriorityWaveGenerator, type PriorityOptions } from './priority-wave-generator.js';
+import type { Wave } from './wave-builder.js';
+export type AIEnhancedOptions = PriorityOptions & {
+    agentforceService?: AgentforcePriorityService;
+    orgType?: string;
+    industry?: string;
+    autoAIForUnknown?: boolean;
+};
+/**
+ * AI-Enhanced Priority Wave Generator
+ *
+ * Combines static priority rules with AI-powered recommendations
+ * for intelligent deployment ordering.
+ *
+ * @example
+ * const aiService = new AgentforcePriorityService({ apiKey: 'xxx' });
+ * const generator = new AIEnhancedPriorityWaveGenerator({
+ *   agentforceService: aiService,
+ *   orgType: 'Production',
+ *   industry: 'Fintech'
+ * });
+ *
+ * const waves = await generator.applyPriorityWavesAsync(baseWaves, components);
+ */
+export declare class AIEnhancedPriorityWaveGenerator extends PriorityWaveGenerator {
+    private agentforceService?;
+    private aiAnalysisResult?;
+    private orgType?;
+    private industry?;
+    private autoAIForUnknown;
+    private unknownTypesDetected;
+    constructor(options?: AIEnhancedOptions);
+    /**
+     * @ac US-057-AC-5: Merge with static priorities
+     * @ac US-042-AC-4: User-defined priority overrides
+     */
+    applyPriorityWavesAsync(waves: Wave[], components: Map<NodeId, MetadataComponent>): Promise<Wave[]>;
+    /**
+     * Detect components with unknown metadata types (priority 99 or not in DEPLOYMENT_ORDER)
+     */
+    private detectUnknownTypes;
+    /**
+     * @ac US-057-AC-5: Merge with static priorities
+     */
+    private mergeAIPriorities;
+    /**
+     * @ac US-057-AC-6: Report AI decisions
+     */
+    getAIReport(): string | undefined;
+    /**
+     * @ac US-057-AC-6: Report AI decisions
+     */
+    getAIStats(): {
+        aiAdjustments: number;
+        aiExecutionTime: number;
+        tokensUsed?: number;
+        unknownTypesDetected: number;
+        unknownTypes: string[];
+        usedFallback: boolean;
+    } | undefined;
+    getAIPriorityOverrides(components: Map<NodeId, MetadataComponent>): Record<string, PriorityOverride>;
+    /**
+     * Get warning message if unknown types were detected without AI
+     */
+    getUnknownTypesWarning(): string | undefined;
+}

package/lib/waves/priority-wave-generator-ai.js

@@ -0,0 +1,191 @@
+/**
+ * AI-Enhanced Priority Wave Generator - US-042 + US-057
+ * Extends priority wave generation with Agentforce AI
+ *
+ * @ac US-042-AC-1: Use deployment order constants
+ * @ac US-042-AC-2: Objects before classes before triggers
+ * @ac US-042-AC-3: Break ties using priorities
+ * @ac US-042-AC-4: User-defined priority overrides
+ * @ac US-042-AC-5: Report priority decisions
+ * @ac US-042-AC-6: Validate no dependency violations
+ * @ac US-057-AC-5: Merge with static priorities
+ * @ac US-057-AC-6: Report AI decisions
+ *
+ * @issue #42, #57
+ */
+import { DEPLOYMENT_ORDER } from '../constants/deployment-order.js';
+import { getLogger } from '../utils/logger.js';
+import { PriorityWaveGenerator } from './priority-wave-generator.js';
+const logger = getLogger('AIEnhancedPriorityWaveGenerator');
+/**
+ * AI-Enhanced Priority Wave Generator
+ *
+ * Combines static priority rules with AI-powered recommendations
+ * for intelligent deployment ordering.
+ *
+ * @example
+ * const aiService = new AgentforcePriorityService({ apiKey: 'xxx' });
+ * const generator = new AIEnhancedPriorityWaveGenerator({
+ *   agentforceService: aiService,
+ *   orgType: 'Production',
+ *   industry: 'Fintech'
+ * });
+ *
+ * const waves = await generator.applyPriorityWavesAsync(baseWaves, components);
+ */
+export class AIEnhancedPriorityWaveGenerator extends PriorityWaveGenerator {
+    agentforceService;
+    aiAnalysisResult;
+    orgType;
+    industry;
+    autoAIForUnknown;
+    unknownTypesDetected = new Set();
+    constructor(options = {}) {
+        super(options);
+        this.agentforceService = options.agentforceService;
+        this.orgType = options.orgType;
+        this.industry = options.industry;
+        this.autoAIForUnknown = options.autoAIForUnknown ?? true;
+    }
+    /**
+     * @ac US-057-AC-5: Merge with static priorities
+     * @ac US-042-AC-4: User-defined priority overrides
+     */
+    async applyPriorityWavesAsync(waves, components) {
+        // Detect unknown metadata types
+        const unknownComponents = this.detectUnknownTypes(components);
+        if (unknownComponents.length > 0) {
+            logger.warn('Unknown metadata types detected', {
+                count: unknownComponents.length,
+                types: Array.from(this.unknownTypesDetected),
+            });
+            // Auto-enable AI for unknown types if service available
+            if (this.agentforceService && this.autoAIForUnknown) {
+                logger.info('Auto-enabling AI analysis for unknown types');
+            }
+            else if (!this.agentforceService && unknownComponents.length > 0) {
+                logger.warn('Unknown types found but no AI service configured', {
+                    types: Array.from(this.unknownTypesDetected),
+                    suggestion: 'Use --use-ai flag for intelligent prioritization',
+                });
+            }
+        }
+        // Get AI recommendations if available
+        if (this.agentforceService) {
+            const componentList = Array.from(components.values());
+            // Prioritize unknown types in AI analysis
+            const componentsToAnalyze = this.autoAIForUnknown && unknownComponents.length > 0
+                ? unknownComponents // Focus on unknowns first
+                : componentList;
+            this.aiAnalysisResult = await this.agentforceService.analyzePriorities(componentsToAnalyze, {
+                orgType: this.orgType,
+                industry: this.industry,
+            });
+            logger.info('AI analysis complete', {
+                adjustments: this.aiAnalysisResult.aiAdjustments,
+                executionTime: this.aiAnalysisResult.executionTime,
+                unknownTypesAnalyzed: unknownComponents.length,
+            });
+            // Merge AI recommendations into user priorities
+            this.mergeAIPriorities(components);
+        }
+        // Use base class method with enhanced priorities
+        return this.applyPriorityWaves(waves, components);
+    }
+    /**
+     * Detect components with unknown metadata types (priority 99 or not in DEPLOYMENT_ORDER)
+     */
+    detectUnknownTypes(components) {
+        const unknownComponents = [];
+        for (const component of components.values()) {
+            const priority = DEPLOYMENT_ORDER[component.type];
+            // Unknown if priority is 99 or not defined
+            if (!priority || priority === 99) {
+                this.unknownTypesDetected.add(component.type);
+                unknownComponents.push(component);
+            }
+        }
+        return unknownComponents;
+    }
+    /**
+     * @ac US-057-AC-5: Merge with static priorities
+     */
+    mergeAIPriorities(components) {
+        if (!this.aiAnalysisResult)
+            return;
+        // Access protected options from base class
+        const baseOptions = this.options;
+        const userPriorities = baseOptions.userPriorities ?? new Map();
+        for (const rec of this.aiAnalysisResult.recommendations) {
+            // Find component by name
+            const nodeId = Array.from(components.keys()).find((id) => id.endsWith(`:${rec.componentName}`));
+            if (nodeId && rec.confidence > 0.8) {
+                // Only apply if no user override exists
+                if (!userPriorities.has(nodeId)) {
+                    userPriorities.set(nodeId, rec.priority);
+                    logger.debug('Applied AI priority', {
+                        component: nodeId,
+                        priority: rec.priority,
+                        reason: rec.reason,
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * @ac US-057-AC-6: Report AI decisions
+     */
+    getAIReport() {
+        if (!this.aiAnalysisResult || !this.agentforceService) {
+            return undefined;
+        }
+        return this.agentforceService.formatDecisionReport(this.aiAnalysisResult);
+    }
+    /**
+     * @ac US-057-AC-6: Report AI decisions
+     */
+    getAIStats() {
+        if (!this.aiAnalysisResult)
+            return undefined;
+        return {
+            aiAdjustments: this.aiAnalysisResult.aiAdjustments,
+            aiExecutionTime: this.aiAnalysisResult.executionTime,
+            tokensUsed: this.aiAnalysisResult.tokensUsed,
+            unknownTypesDetected: this.unknownTypesDetected.size,
+            unknownTypes: Array.from(this.unknownTypesDetected),
+            usedFallback: this.aiAnalysisResult.usedFallback,
+        };
+    }
+    getAIPriorityOverrides(components) {
+        if (!this.aiAnalysisResult) {
+            return {};
+        }
+        const overrides = {};
+        for (const recommendation of this.aiAnalysisResult.recommendations) {
+            const nodeId = Array.from(components.keys()).find((id) => id.endsWith(`:${recommendation.componentName}`));
+            if (nodeId && recommendation.confidence > 0.8) {
+                overrides[nodeId] = {
+                    priority: recommendation.priority,
+                    source: 'ai',
+                    confidence: recommendation.confidence,
+                    reason: recommendation.reason,
+                    appliedAt: new Date().toISOString(),
+                };
+            }
+        }
+        return overrides;
+    }
+    /**
+     * Get warning message if unknown types were detected without AI
+     */
+    getUnknownTypesWarning() {
+        if (this.unknownTypesDetected.size === 0) {
+            return undefined;
+        }
+        if (!this.agentforceService) {
+            return `⚠️  Found ${this.unknownTypesDetected.size} unknown metadata type(s): ${Array.from(this.unknownTypesDetected).join(', ')}\n💡 Tip: Use --use-ai for intelligent prioritization of unknown types`;
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=priority-wave-generator-ai.js.map

package/lib/waves/priority-wave-generator-ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"priority-wave-generator-ai.js","sourceRoot":"","sources":["../../src/waves/priority-wave-generator-ai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAwB,MAAM,8BAA8B,CAAC;AAG3F,MAAM,MAAM,GAAG,SAAS,CAAC,iCAAiC,CAAC,CAAC;AAS5D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,+BAAgC,SAAQ,qBAAqB;IAChE,iBAAiB,CAA6B;IAC9C,gBAAgB,CAA0B;IAC1C,OAAO,CAAU;IACjB,QAAQ,CAAU;IAClB,gBAAgB,CAAU;IAC1B,oBAAoB,GAAgB,IAAI,GAAG,EAAE,CAAC;IAEtD,YAAmB,UAA6B,EAAE;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;QACnD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC;IAC3D,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,uBAAuB,CAAC,KAAa,EAAE,UAA0C;QAC5F,gCAAgC;QAChC,MAAM,iBAAiB,GAAG,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAE9D,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE;gBAC7C,KAAK,EAAE,iBAAiB,CAAC,MAAM;gBAC/B,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC;aAC7C,CAAC,CAAC;YAEH,wDAAwD;YACxD,IAAI,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACpD,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;YAC7D,CAAC;iBAAM,IAAI,CAAC,IAAI,CAAC,iBAAiB,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnE,MAAM,CAAC,IAAI,CAAC,kDAAkD,EAAE;oBAC9D,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC;oBAC5C,UAAU,EAAE,kDAAkD;iBAC/D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,sCAAsC;QACtC,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YAEtD,0CAA0C;YAC1C,MAAM,mBAAmB,GACvB,IAAI,CAAC,gBAAgB,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC;gBACnD,CAAC,CAAC,iBAAiB,CAAC,0BAA0B;gBAC9C,CAAC,CAAC,aAAa,CAAC;YAEpB,IAAI,CAAC,gBAAgB,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,mBAAmB,EAAE;gBAC1F,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAC;YAEH,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE;gBAClC,WAAW,EAAE,IAAI,CAAC,gBAAgB,CAAC,aAAa;gBAChD,aAAa,EAAE,IAAI,CAAC,gBAAgB,CAAC,aAAa;gBAClD,oBAAoB,EAAE,iBAAiB,CAAC,MAAM;aAC/C,CAAC,CAAC;YAEH,gDAAgD;YAChD,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC;QAED,iDAAiD;QACjD,OAAO,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,UAA0C;QACnE,MAAM,iBAAiB,GAAwB,EAAE,CAAC;QAElD,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;YAC5C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAElD,2CAA2C;YAC3C,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;gBACjC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC9C,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QAED,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,UAA0C;QAClE,IAAI,CAAC,IAAI,CAAC,gBAAgB;YAAE,OAAO;QAEnC,2CAA2C;QAC3C,MAAM,WAAW,GAAI,IAAgD,CAAC,OAAO,CAAC;QAC9E,MAAM,cAAc,GAAG,WAAW,CAAC,cAAc,IAAI,IAAI,GAAG,EAAE,CAAC;QAE/D,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,gBAAgB,CAAC,eAAe,EAAE,CAAC;YACxD,yBAAyB;YACzB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;YAEhG,IAAI,MAAM,IAAI,GAAG,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;gBACnC,wCAAwC;gBACxC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;oBAChC,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;oBACzC,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE;wBAClC,SAAS,EAAE,MAAM;wBACjB,QAAQ,EAAE,GAAG,CAAC,QAAQ;wBACtB,MAAM,EAAE,GAAG,CAAC,MAAM;qBACnB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACI,WAAW;QAChB,IAAI,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACtD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC5E,CAAC;IAED;;OAEG;IACI,UAAU;QAUf,IAAI,CAAC,IAAI,CAAC,gBAAgB;YAAE,OAAO,SAAS,CAAC;QAE7C,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,gBAAgB,CAAC,aAAa;YAClD,eAAe,EAAE,IAAI,CAAC,gBAAgB,CAAC,aAAa;YACpD,UAAU,EAAE,IAAI,CAAC,gBAAgB,CAAC,UAAU;YAC5C,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,CAAC,IAAI;YACpD,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC;YACnD,YAAY,EAAE,IAAI,CAAC,gBAAgB,CAAC,YAAY;SACjD,CAAC;IACJ,CAAC;IAEM,sBAAsB,CAAC,UAA0C;QACtE,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,SAAS,GAAqC,EAAE,CAAC;QAEvD,KAAK,MAAM,cAAc,IAAI,IAAI,CAAC,gBAAgB,CAAC,eAAe,EAAE,CAAC;YACnE,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,cAAc,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;YAE3G,IAAI,MAAM,IAAI,cAAc,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;gBAC9C,SAAS,CAAC,MAAM,CAAC,GAAG;oBAClB,QAAQ,EAAE,cAAc,CAAC,QAAQ;oBACjC,MAAM,EAAE,IAAI;oBACZ,UAAU,EAAE,cAAc,CAAC,UAAU;oBACrC,MAAM,EAAE,cAAc,CAAC,MAAM;oBAC7B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACI,sBAAsB;QAC3B,IAAI,IAAI,CAAC,oBAAoB,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACzC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC5B,OAAO,aAAa,IAAI,CAAC,oBAAoB,CAAC,IAAI,8BAA8B,KAAK,CAAC,IAAI,CACxF,IAAI,CAAC,oBAAoB,CAC1B,CAAC,IAAI,CAAC,IAAI,CAAC,wEAAwE,CAAC;QACvF,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/lib/waves/priority-wave-generator.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Priority-Based Wave Generator
+ * Prioritizes components by importance for wave generation
+ *
+ * @ac US-042-AC-1: Use deployment order constants
+ * @ac US-042-AC-2: Objects before classes before triggers
+ * @ac US-042-AC-3: Break ties using priorities
+ * @ac US-042-AC-4: User-defined priority overrides
+ * @ac US-042-AC-5: Report priority decisions
+ * @ac US-042-AC-6: Validate no dependency violations
+ *
+ * @issue #42
+ */
+import type { NodeId } from '../types/dependency.js';
+import type { MetadataComponent } from '../types/metadata.js';
+import type { Wave } from './wave-builder.js';
+export type PriorityOptions = {
+    userPriorities?: Map<NodeId, number>;
+    respectDependencyOrder?: boolean;
+};
+/**
+ * Priority-Based Wave Generator
+ *
+ * Generates waves with component prioritization:
+ * 1. Metadata type priority (Objects → Classes → Triggers)
+ * 2. User-defined priorities
+ * 3. Dependency order
+ *
+ * @example
+ * const generator = new PriorityWaveGenerator({
+ *   userPriorities: new Map([['ApexClass:Critical', 100]])
+ * });
+ */
+export declare class PriorityWaveGenerator {
+    private options;
+    constructor(options?: PriorityOptions);
+    /**
+     * @ac US-042-AC-2: Objects before classes before triggers
+     * @ac US-042-AC-3: Break ties using priorities
+     */
+    sortComponentsByPriority(components: NodeId[], componentMap: Map<NodeId, MetadataComponent>): NodeId[];
+    private calculatePriority;
+    /**
+     * @ac US-042-AC-4: User-defined priority overrides
+     */
+    applyPriorityWaves(waves: Wave[], components: Map<NodeId, MetadataComponent>): Wave[];
+}

package/lib/waves/priority-wave-generator.js

@@ -0,0 +1,88 @@
+/**
+ * Priority-Based Wave Generator
+ * Prioritizes components by importance for wave generation
+ *
+ * @ac US-042-AC-1: Use deployment order constants
+ * @ac US-042-AC-2: Objects before classes before triggers
+ * @ac US-042-AC-3: Break ties using priorities
+ * @ac US-042-AC-4: User-defined priority overrides
+ * @ac US-042-AC-5: Report priority decisions
+ * @ac US-042-AC-6: Validate no dependency violations
+ *
+ * @issue #42
+ */
+/**
+ * @ac US-042-AC-1: Use deployment order constants
+ */
+const DEPLOYMENT_PRIORITY_ORDER = [
+    'CustomObject',
+    'CustomField',
+    'RecordType',
+    'BusinessProcess',
+    'CompactLayout',
+    'Layout',
+    'Profile',
+    'PermissionSet',
+    'CustomMetadata',
+    'ApexClass',
+    'ApexTrigger',
+    'Flow',
+    'ValidationRule',
+    'WorkflowRule',
+    'EmailTemplate',
+];
+/**
+ * Priority-Based Wave Generator
+ *
+ * Generates waves with component prioritization:
+ * 1. Metadata type priority (Objects → Classes → Triggers)
+ * 2. User-defined priorities
+ * 3. Dependency order
+ *
+ * @example
+ * const generator = new PriorityWaveGenerator({
+ *   userPriorities: new Map([['ApexClass:Critical', 100]])
+ * });
+ */
+export class PriorityWaveGenerator {
+    options;
+    constructor(options = {}) {
+        this.options = {
+            userPriorities: options.userPriorities ?? new Map(),
+            respectDependencyOrder: options.respectDependencyOrder ?? true,
+        };
+    }
+    /**
+     * @ac US-042-AC-2: Objects before classes before triggers
+     * @ac US-042-AC-3: Break ties using priorities
+     */
+    sortComponentsByPriority(components, componentMap) {
+        return components.sort((a, b) => {
+            const priorityA = this.calculatePriority(a, componentMap);
+            const priorityB = this.calculatePriority(b, componentMap);
+            return priorityB - priorityA; // Higher priority first
+        });
+    }
+    calculatePriority(nodeId, componentMap) {
+        const component = componentMap.get(nodeId);
+        const type = nodeId.split(':')[0];
+        // Type priority (higher = deploy earlier)
+        const typeIndex = DEPLOYMENT_PRIORITY_ORDER.indexOf(type);
+        const typePriority = typeIndex === -1 ? 0 : (DEPLOYMENT_PRIORITY_ORDER.length - typeIndex) * 100;
+        // User priority override
+        const userPriority = this.options.userPriorities.get(nodeId) ?? 0;
+        // Component boost
+        const componentBoost = component?.priorityBoost ?? 0;
+        return typePriority + userPriority + componentBoost;
+    }
+    /**
+     * @ac US-042-AC-4: User-defined priority overrides
+     */
+    applyPriorityWaves(waves, components) {
+        return waves.map((wave) => ({
+            ...wave,
+            components: this.sortComponentsByPriority(wave.components, components),
+        }));
+    }
+}
+//# sourceMappingURL=priority-wave-generator.js.map

package/lib/waves/priority-wave-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"priority-wave-generator.js","sourceRoot":"","sources":["../../src/waves/priority-wave-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH;;GAEG;AACH,MAAM,yBAAyB,GAAmB;IAChD,cAAc;IACd,aAAa;IACb,YAAY;IACZ,iBAAiB;IACjB,eAAe;IACf,QAAQ;IACR,SAAS;IACT,eAAe;IACf,gBAAgB;IAChB,WAAW;IACX,aAAa;IACb,MAAM;IACN,gBAAgB;IAChB,cAAc;IACd,eAAe;CAChB,CAAC;AAOF;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,qBAAqB;IACxB,OAAO,CAA4B;IAE3C,YAAmB,UAA2B,EAAE;QAC9C,IAAI,CAAC,OAAO,GAAG;YACb,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI,GAAG,EAAkB;YACnE,sBAAsB,EAAE,OAAO,CAAC,sBAAsB,IAAI,IAAI;SAC/D,CAAC;IACJ,CAAC;IAED;;;OAGG;IACI,wBAAwB,CAAC,UAAoB,EAAE,YAA4C;QAChG,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;YAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;YAC1D,OAAO,SAAS,GAAG,SAAS,CAAC,CAAC,wBAAwB;QACxD,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,iBAAiB,CAAC,MAAc,EAAE,YAA4C;QACpF,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAiB,CAAC;QAElD,0CAA0C;QAC1C,MAAM,SAAS,GAAG,yBAAyB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,YAAY,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,yBAAyB,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC;QAEjG,yBAAyB;QACzB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAElE,kBAAkB;QAClB,MAAM,cAAc,GAAG,SAAS,EAAE,aAAa,IAAI,CAAC,CAAC;QAErD,OAAO,YAAY,GAAG,YAAY,GAAG,cAAc,CAAC;IACtD,CAAC;IAED;;OAEG;IACI,kBAAkB,CAAC,KAAa,EAAE,UAA0C;QACjF,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1B,GAAG,IAAI;YACP,UAAU,EAAE,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC;SACvE,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

package/lib/waves/test-optimizer.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Test Optimizer
+ * Optimizes test execution per wave to reduce deployment time
+ *
+ * @ac US-040-AC-1: Identify waves with Apex/Trigger changes
+ * @ac US-040-AC-2: Include tests only in waves with code
+ * @ac US-040-AC-3: Sync test classes with production classes
+ * @ac US-040-AC-4: Ensure trigger tests are included
+ * @ac US-040-AC-5: Calculate test coverage per wave
+ * @ac US-040-AC-6: Report test optimization savings
+ *
+ * @issue #40
+ */
+import type { NodeId } from '../types/dependency.js';
+import type { Wave } from './wave-builder.js';
+/**
+ * Test optimization result
+ */
+export type TestOptimizationResult = {
+    /** Original waves */
+    originalWaves: Wave[];
+    /** Optimized waves with test classes */
+    optimizedWaves: OptimizedWave[];
+    /** Optimization decisions */
+    decisions: OptimizationDecision[];
+    /** Statistics */
+    stats: OptimizationStats;
+};
+/**
+ * Optimized wave with test information
+ */
+export type OptimizedWave = Wave & {
+    /** Test classes included in this wave */
+    testClasses: NodeId[];
+    /** Code classes in this wave */
+    codeClasses: NodeId[];
+    /** Triggers in this wave */
+    triggers: NodeId[];
+    /** Needs test execution */
+    needsTests: boolean;
+    /** Estimated test coverage % */
+    estimatedCoverage: number;
+};
+/**
+ * Optimization decision
+ */
+export type OptimizationDecision = {
+    /** Wave number */
+    waveNumber: number;
+    /** Decision type */
+    type: 'include-tests' | 'skip-tests' | 'sync-tests';
+    /** Reason for decision */
+    reason: string;
+    /** Tests affected */
+    testsAffected: number;
+};
+/**
+ * Optimization statistics
+ */
+export type OptimizationStats = {
+    /** Total waves */
+    totalWaves: number;
+    /** Waves with tests */
+    wavesWithTests: number;
+    /** Waves without tests */
+    wavesWithoutTests: number;
+    /** Total test classes added */
+    totalTestsAdded: number;
+    /** Estimated time saved (seconds) */
+    timeSaved: number;
+};
+/**
+ * Optimizer options
+ */
+export type OptimizerOptions = {
+    /** Always run all tests (disable optimization) */
+    alwaysRunAllTests?: boolean;
+    /** Minimum test coverage required (0-100) */
+    minCoverageRequired?: number;
+    /** Include related tests (not just direct) */
+    includeRelatedTests?: boolean;
+};
+/**
+ * Test Optimizer
+ *
+ * Optimizes test execution by only including tests in waves
+ * that contain Apex classes or triggers.
+ *
+ * Strategy:
+ * 1. Identify waves with code changes (ApexClass, ApexTrigger)
+ * 2. Match test classes to production classes
+ * 3. Include only relevant tests per wave
+ * 4. Skip tests for metadata-only waves
+ *
+ * Performance: O(V)
+ *
+ * @example
+ * const optimizer = new TestOptimizer({
+ *   minCoverageRequired: 75,
+ *   includeRelatedTests: true
+ * });
+ *
+ * const result = optimizer.optimizeTests(waves);
+ * console.log(`Time saved: ${result.stats.timeSaved}s`);
+ */
+export declare class TestOptimizer {
+    private options;
+    constructor(options?: OptimizerOptions);
+    /**
+     * @ac US-040-AC-1: Identify waves with Apex/Trigger changes
+     * @ac US-040-AC-2: Include tests only in waves with code
+     * @ac US-040-AC-3: Sync test classes with production classes
+     */
+    optimizeTests(waves: Wave[]): TestOptimizationResult;
+    /**
+     * Collect all test classes from all waves
+     */
+    private collectAllTestClasses;
+    /**
+     * Get code classes (non-test Apex classes)
+     */
+    private getCodeClasses;
+    /**
+     * @ac US-040-AC-4: Ensure trigger tests are included
+     */
+    private getTriggers;
+    /**
+     * Check if component is a test class
+     */
+    private isTestClass;
+    /**
+     * Sync test classes with production classes
+     */
+    private syncTestClasses;
+    /**
+     * @ac US-040-AC-5: Calculate test coverage per wave
+     */
+    private estimateCoverage;
+    /**
+     * Calculate optimization statistics
+     */
+    private calculateStats;
+    /**
+     * @ac US-040-AC-6: Report test optimization savings
+     */
+    generateReport(result: TestOptimizationResult): string;
+    /**
+     * Get waves that need test execution
+     */
+    getWavesNeedingTests(result: TestOptimizationResult): OptimizedWave[];
+    /**
+     * Get total test count across all waves
+     */
+    getTotalTestCount(result: TestOptimizationResult): number;
+}