@jterrats/smart-deployment 1.0.3

package/lib/ai/dependency-inference-service.js

@@ -0,0 +1,220 @@
+/**
+ * AI Dependency Inference Service - US-055
+ * Uses Agentforce to infer non-obvious dependencies
+ *
+ * @ac US-055-AC-1: Send component context to Agentforce
+ * @ac US-055-AC-2: Receive dependency inferences
+ * @ac US-055-AC-3: Parse AI responses
+ * @ac US-055-AC-4: Confidence scoring
+ * @ac US-055-AC-5: Fallback to static analysis if AI fails
+ * @ac US-055-AC-6: Cache AI results
+ * @issue #55
+ */
+import { getLogger } from '../utils/logger.js';
+import { createLLMProvider } from './llm-provider-factory.js';
+const logger = getLogger('DependencyInferenceService');
+/**
+ * @ac US-055-AC-1: Send component context to Agentforce
+ * @ac US-055-AC-2: Receive dependency inferences
+ */
+export class DependencyInferenceService {
+    llmProvider;
+    cache = new Map();
+    confidenceThreshold;
+    constructor(llmProviderOrOptions, confidenceThreshold = 0.7) {
+        this.llmProvider = this.resolveProvider(llmProviderOrOptions);
+        this.confidenceThreshold = confidenceThreshold;
+        logger.info('Dependency inference service initialized', {
+            confidenceThreshold,
+            agentforceEnabled: this.llmProvider.isEnabled(),
+        });
+    }
+    resolveProvider(llmProviderOrOptions) {
+        if (llmProviderOrOptions && 'sendRequest' in llmProviderOrOptions) {
+            return llmProviderOrOptions;
+        }
+        return createLLMProvider({
+            baseDir: llmProviderOrOptions?.baseDir,
+        });
+    }
+    /**
+     * @ac US-055-AC-1: Send component context to Agentforce
+     * Infer dependencies for components
+     */
+    async inferDependencies(components, existingGraph) {
+        const startTime = Date.now();
+        const result = {
+            dependencies: [],
+            totalInferred: 0,
+            highConfidenceCount: 0,
+            executionTime: 0,
+            usedCache: false,
+            fallbackToStatic: false,
+        };
+        try {
+            // Check if Agentforce is enabled
+            if (!this.llmProvider.isEnabled()) {
+                logger.info('Agentforce disabled, skipping inference');
+                result.fallbackToStatic = true;
+                return result;
+            }
+            // Build prompt with component context
+            const prompt = this.buildInferencePrompt(components, existingGraph);
+            // Check cache first
+            const cacheKey = this.getCacheKey(components);
+            if (this.cache.has(cacheKey)) {
+                logger.debug('Using cached inference result');
+                result.dependencies = this.cache.get(cacheKey);
+                result.usedCache = true;
+                result.totalInferred = result.dependencies.length;
+                result.highConfidenceCount = result.dependencies.filter((d) => d.confidence >= this.confidenceThreshold).length;
+                result.executionTime = Date.now() - startTime;
+                return result;
+            }
+            // Send to Agentforce
+            const response = await this.llmProvider.sendRequest({
+                model: this.llmProvider.getConfig().model,
+                prompt,
+                temperature: 0.2, // Lower temperature for more consistent results
+                maxTokens: 2000,
+            });
+            // Parse response
+            const inferredDeps = this.parseInferenceResponse(response.content);
+            // Filter by confidence
+            const highConfidenceDeps = inferredDeps.filter((d) => d.confidence >= this.confidenceThreshold);
+            result.dependencies = highConfidenceDeps;
+            result.totalInferred = inferredDeps.length;
+            result.highConfidenceCount = highConfidenceDeps.length;
+            result.executionTime = Date.now() - startTime;
+            // Cache result
+            this.cache.set(cacheKey, highConfidenceDeps);
+            logger.info('Dependency inference completed', {
+                total: result.totalInferred,
+                highConfidence: result.highConfidenceCount,
+                executionTime: result.executionTime,
+            });
+            return result;
+        }
+        catch (error) {
+            logger.error('Dependency inference failed, falling back to static analysis', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            result.fallbackToStatic = true;
+            result.executionTime = Date.now() - startTime;
+            return result;
+        }
+    }
+    /**
+     * Build prompt for dependency inference
+     */
+    buildInferencePrompt(components, existingGraph) {
+        const componentSummaries = components.slice(0, 20).map((c) => ({
+            name: c.name,
+            type: c.type,
+            dependencies: Array.from(c.dependencies),
+        }));
+        const prompt = `You are an expert Salesforce metadata analyzer. Analyze the following components and infer any non-obvious dependencies that are not captured by static analysis.
+
+Look for:
+1. Dynamic references (e.g., Type.forName(), Schema.getGlobalDescribe())
+2. Implicit dependencies (e.g., sharing rules, field dependencies)
+3. Runtime dependencies (e.g., custom settings, platform events)
+4. Business logic dependencies (e.g., workflows triggering other workflows)
+
+Components:
+${JSON.stringify(componentSummaries, null, 2)}
+
+${existingGraph ? `\nExisting dependencies:\n${JSON.stringify(existingGraph, null, 2)}` : ''}
+
+Return ONLY a JSON array of inferred dependencies in this format:
+[
+  {
+    "from": "ComponentA",
+    "to": "ComponentB",
+    "type": "implicit|dynamic|runtime|business-logic",
+    "confidence": 0.0-1.0,
+    "reason": "Brief explanation",
+    "lineNumber": 123
+  }
+]
+
+Only include dependencies with confidence > 0.5. Be conservative - it's better to miss a dependency than to create a false positive.`;
+        return prompt;
+    }
+    /**
+     * @ac US-055-AC-3: Parse AI responses
+     * Parse Agentforce response into structured data
+     */
+    parseInferenceResponse(content) {
+        try {
+            // Extract JSON from response (may have surrounding text)
+            const jsonMatch = /\[[\s\S]*?\]/.exec(content);
+            if (!jsonMatch) {
+                logger.warn('No JSON array found in response');
+                return [];
+            }
+            const parsed = JSON.parse(jsonMatch[0]);
+            // Validate and map to InferredDependency
+            const dependencies = [];
+            for (const item of parsed) {
+                if (typeof item === 'object' &&
+                    item !== null &&
+                    'from' in item &&
+                    'to' in item &&
+                    'type' in item &&
+                    'confidence' in item &&
+                    'reason' in item) {
+                    const dep = item;
+                    dependencies.push({
+                        from: String(dep.from),
+                        to: String(dep.to),
+                        type: String(dep.type),
+                        confidence: Number(dep.confidence),
+                        reason: String(dep.reason),
+                        lineNumber: dep.lineNumber ? Number(dep.lineNumber) : undefined,
+                    });
+                }
+            }
+            return dependencies;
+        }
+        catch (error) {
+            logger.error('Failed to parse inference response', {
+                error: error instanceof Error ? error.message : String(error),
+                content: content.slice(0, 200),
+            });
+            return [];
+        }
+    }
+    /**
+     * @ac US-055-AC-6: Cache AI results
+     * Generate cache key for components
+     */
+    getCacheKey(components) {
+        // Create deterministic key from component names and types
+        const sortedComponents = components
+            .map((c) => `${c.type}:${c.name}`)
+            .sort()
+            .join('|');
+        return `inference:${sortedComponents}`;
+    }
+    /**
+     * Clear cache
+     */
+    clearCache() {
+        this.cache.clear();
+        logger.debug('Inference cache cleared');
+    }
+    /**
+     * Get cache size
+     */
+    getCacheSize() {
+        return this.cache.size;
+    }
+    /**
+     * Get confidence threshold
+     */
+    getConfidenceThreshold() {
+        return this.confidenceThreshold;
+    }
+}
+//# sourceMappingURL=dependency-inference-service.js.map

package/lib/ai/dependency-inference-service.js.map

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

package/lib/ai/llm-provider-factory.d.ts

@@ -0,0 +1,15 @@
+import { type AgentforceFetch } from './agentforce-service.js';
+import type { LLMProvider, LLMProviderName } from './llm-provider.js';
+export type LLMProviderFactoryConfig = {
+    baseDir?: string;
+    provider?: LLMProviderName;
+    endpoint?: string;
+    apiKey?: string;
+    model?: string;
+    timeout?: number;
+    enabled?: boolean;
+    rateLimit?: number;
+    maxRetries?: number;
+    fetchFn?: AgentforceFetch;
+};
+export declare function createLLMProvider(config?: LLMProviderFactoryConfig): LLMProvider;

package/lib/ai/llm-provider-factory.js

@@ -0,0 +1,36 @@
+import { loadRepoConfigSync } from '../config/repo-config.js';
+import { AgentforceService } from './agentforce-service.js';
+import { OpenAIService } from './openai-service.js';
+export function createLLMProvider(config = {}) {
+    const repoConfig = loadRepoConfigSync(config.baseDir).llm ?? {};
+    const resolvedConfig = {
+        ...config,
+        provider: config.provider ?? repoConfig.provider ?? 'agentforce',
+        endpoint: config.endpoint ?? repoConfig.endpoint,
+        model: config.model ?? repoConfig.model,
+        timeout: config.timeout ?? repoConfig.timeout,
+        rateLimit: config.rateLimit ?? repoConfig.rateLimit,
+    };
+    const provider = resolvedConfig.provider ?? 'agentforce';
+    switch (provider) {
+        case 'agentforce': {
+            return new AgentforceService({
+                ...resolvedConfig,
+                provider: 'agentforce',
+            });
+        }
+        case 'openai': {
+            return new OpenAIService({
+                ...resolvedConfig,
+                provider: 'openai',
+            });
+        }
+        default: {
+            return new AgentforceService({
+                ...resolvedConfig,
+                provider: 'agentforce',
+            });
+        }
+    }
+}
+//# sourceMappingURL=llm-provider-factory.js.map

package/lib/ai/llm-provider-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider-factory.js","sourceRoot":"","sources":["../../src/ai/llm-provider-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAwB,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAgBpD,MAAM,UAAU,iBAAiB,CAAC,SAAmC,EAAE;IACrE,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC;IAChE,MAAM,cAAc,GAA6B;QAC/C,GAAG,MAAM;QACT,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ,IAAI,YAAY;QAChE,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ;QAChD,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK;QACvC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,UAAU,CAAC,OAAO;QAC7C,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,UAAU,CAAC,SAAS;KACpD,CAAC;IACF,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,IAAI,YAAY,CAAC;IAEzD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,OAAO,IAAI,iBAAiB,CAAC;gBAC3B,GAAG,cAAc;gBACjB,QAAQ,EAAE,YAAY;aACvB,CAAC,CAAC;QACL,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,OAAO,IAAI,aAAa,CAAC;gBACvB,GAAG,cAAc;gBACjB,QAAQ,EAAE,QAAQ;aACnB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,OAAO,IAAI,iBAAiB,CAAC;gBAC3B,GAAG,cAAc;gBACjB,QAAQ,EAAE,YAAY;aACvB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC"}

package/lib/ai/llm-provider.d.ts

@@ -0,0 +1,27 @@
+export type LLMProviderName = 'agentforce' | 'openai';
+export type LLMRequest = {
+    model: string;
+    prompt: string;
+    context?: Record<string, unknown>;
+    temperature?: number;
+    maxTokens?: number;
+};
+export type LLMResponse = {
+    content: string;
+    tokensUsed: number;
+    model: string;
+    executionTime: number;
+};
+export type LLMProviderConfig = {
+    provider: LLMProviderName;
+    endpoint: string;
+    model: string;
+    timeout: number;
+    enabled: boolean;
+    rateLimit?: number;
+};
+export type LLMProvider = {
+    sendRequest(request: LLMRequest): Promise<LLMResponse>;
+    getConfig(): Readonly<LLMProviderConfig>;
+    isEnabled(): boolean;
+};

package/lib/ai/llm-provider.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=llm-provider.js.map

package/lib/ai/llm-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider.js","sourceRoot":"","sources":["../../src/ai/llm-provider.ts"],"names":[],"mappings":""}

package/lib/ai/openai-service.d.ts

@@ -0,0 +1,20 @@
+import type { LLMProvider, LLMProviderConfig, LLMRequest, LLMResponse } from './llm-provider.js';
+export type OpenAIFetch = typeof fetch;
+export type OpenAIConfig = LLMProviderConfig & {
+    provider: 'openai';
+    endpoint: string;
+    apiKey?: string;
+    model: string;
+    timeout: number;
+    enabled: boolean;
+    rateLimit: number;
+    fetchFn?: OpenAIFetch;
+};
+export declare class OpenAIService implements LLMProvider {
+    private readonly config;
+    private readonly fetchFn?;
+    constructor(config?: Partial<OpenAIConfig>);
+    sendRequest(request: LLMRequest): Promise<LLMResponse>;
+    getConfig(): Readonly<OpenAIConfig>;
+    isEnabled(): boolean;
+}

package/lib/ai/openai-service.js

@@ -0,0 +1,89 @@
+import { getLogger } from '../utils/logger.js';
+const logger = getLogger('OpenAIService');
+export class OpenAIService {
+    config;
+    fetchFn;
+    constructor(config = {}) {
+        this.config = {
+            provider: 'openai',
+            endpoint: config.endpoint ?? process.env.OPENAI_ENDPOINT ?? 'https://api.openai.com/v1/chat/completions',
+            apiKey: config.apiKey ?? process.env.OPENAI_API_KEY,
+            model: config.model ?? 'gpt-4o-mini',
+            timeout: config.timeout ?? 30_000,
+            enabled: config.enabled ?? true,
+            rateLimit: config.rateLimit ?? 60,
+            fetchFn: config.fetchFn ?? globalThis.fetch,
+        };
+        this.fetchFn = this.config.fetchFn;
+        logger.info('OpenAI service initialized', {
+            endpoint: this.config.endpoint,
+            model: this.config.model,
+            enabled: this.config.enabled,
+        });
+    }
+    async sendRequest(request) {
+        if (!this.config.enabled) {
+            throw new Error('OpenAI service is disabled');
+        }
+        if (!this.config.apiKey) {
+            throw new Error('OpenAI API key not configured');
+        }
+        if (!this.fetchFn) {
+            throw new Error('Fetch API is not available in this runtime');
+        }
+        const startTime = Date.now();
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        try {
+            const response = await this.fetchFn(this.config.endpoint, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${this.config.apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    model: request.model,
+                    messages: [
+                        {
+                            role: 'user',
+                            content: request.prompt,
+                        },
+                    ],
+                    temperature: request.temperature ?? 0.2,
+                    ['max_tokens']: request.maxTokens ?? 2000,
+                }),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`OpenAI API error: ${response.status} ${response.statusText}`);
+            }
+            const payload = (await response.json());
+            const content = payload.choices?.[0]?.message?.content;
+            if (!content) {
+                throw new Error('OpenAI response did not contain content');
+            }
+            return {
+                content,
+                tokensUsed: payload.usage?.['total_tokens'] ?? Math.max(1, Math.ceil(request.prompt.length / 4)),
+                model: payload.model ?? request.model,
+                executionTime: Date.now() - startTime,
+            };
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new Error('OpenAI request timed out');
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    isEnabled() {
+        return this.config.enabled;
+    }
+}
+//# sourceMappingURL=openai-service.js.map

package/lib/ai/openai-service.js.map

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

package/lib/ai/prompt-builder.d.ts

@@ -0,0 +1,79 @@
+/**
+ * AI Prompt Builder - US-058
+ * Build effective AI prompts with context and token optimization
+ *
+ * @ac US-058-AC-1: Context-aware prompt generation
+ * @ac US-058-AC-2: Include relevant metadata snippets
+ * @ac US-058-AC-3: Optimize token usage
+ * @ac US-058-AC-4: Template-based prompts
+ * @ac US-058-AC-5: Version prompts
+ * @ac US-058-AC-6: A/B test prompts
+ * @issue #58
+ */
+export type PromptTemplate = {
+    name: string;
+    version: string;
+    systemPrompt: string;
+    userPromptTemplate: string;
+    maxTokens: number;
+    temperature: number;
+};
+export type PromptContext = {
+    components?: unknown[];
+    waves?: unknown[];
+    dependencies?: unknown[];
+    metadata?: Record<string, unknown>;
+    limits?: {
+        maxComponents?: number;
+        maxSnippetLength?: number;
+    };
+};
+export type BuildPromptOptions = {
+    template: string;
+    context: PromptContext;
+    variant?: 'A' | 'B';
+};
+/**
+ * @ac US-058-AC-1: Context-aware prompt generation
+ * @ac US-058-AC-2: Include relevant metadata snippets
+ */
+export declare class PromptBuilder {
+    constructor(maxTokenEstimate?: number);
+    /**
+     * @ac US-058-AC-1: Context-aware prompt generation
+     * Build prompt from template and context
+     */
+    buildPrompt(options: BuildPromptOptions): {
+        systemPrompt: string;
+        userPrompt: string;
+        estimatedTokens: number;
+    };
+    /**
+     * @ac US-058-AC-6: A/B test prompts
+     * Get template variant for A/B testing
+     */
+    private getTemplateVariant;
+    /**
+     * @ac US-058-AC-3: Optimize token usage
+     * Optimize context to reduce token count
+     */
+    private optimizeContext;
+    /**
+     * @ac US-058-AC-3: Optimize token usage
+     * Estimate token count (rough approximation)
+     */
+    private estimateTokens;
+    /**
+     * Get available templates
+     */
+    getTemplates(): string[];
+    /**
+     * Get template details
+     */
+    getTemplate(name: string): PromptTemplate | undefined;
+    /**
+     * @ac US-058-AC-5: Version prompts
+     * Get template version
+     */
+    getTemplateVersion(name: string): string | undefined;
+}