@jterrats/smart-deployment 1.0.3

package/README.md

@@ -0,0 +1,193 @@
+# Smart Deployment
+
+[![CI](https://img.shields.io/github/actions/workflow/status/jterrats/smart-deployment/test.yml?branch=main&label=CI&logo=github)](https://github.com/jterrats/smart-deployment/actions/workflows/test.yml)
+[![License](https://img.shields.io/github/license/jterrats/smart-deployment)](https://github.com/jterrats/smart-deployment/blob/main/LICENSE)
+[![Latest Release](https://img.shields.io/github/v/release/jterrats/smart-deployment?display_name=tag&label=latest%20release)](https://github.com/jterrats/smart-deployment/releases)
+[![Node Version](https://img.shields.io/node/v/@jterrats/smart-deployment?logo=node.js)](https://www.npmjs.com/package/@jterrats/smart-deployment)
+[![npm](https://img.shields.io/npm/v/@jterrats/smart-deployment?logo=npm&label=npm)](https://www.npmjs.com/package/@jterrats/smart-deployment)
+
+Smart Deployment is a Salesforce CLI plugin that analyzes metadata, builds deployment waves, validates project state, and executes staged deployments with optional AI assistance.
+
+The current codebase supports:
+
+- metadata scanning and dependency graph generation
+- wave generation with circular dependency detection
+- conservative circular dependency remediation for supported `ApexClass` cycles
+- real CLI flows for `start`, `analyze`, `validate`, `status`, `resume`, and `config`
+- AI-assisted dependency inference, priority weighting, and validation
+- multiple LLM providers through a shared provider abstraction
+
+## Current Status
+
+This repository is in active development, but the command surface is now usable as a first working version.
+
+What is working today:
+
+- `sf smart-deployment analyze`
+- `sf smart-deployment start`
+- `sf smart-deployment validate`
+- `sf smart-deployment status`
+- `sf smart-deployment resume`
+- `sf smart-deployment config`
+- JSON and HTML analysis reports
+- repo-level AI configuration via `.smart-deployment.json`
+
+What is still partial:
+
+- full live deployment validation against real Salesforce orgs across all flows
+- broader automatic circular dependency remediation beyond simple supported cases
+- richer deployment resume/polling semantics against remote deployment backends
+- broader provider ecosystem beyond the currently implemented adapters
+
+## Installation
+
+```bash
+sf plugins install @jterrats/smart-deployment
+```
+
+For local development:
+
+```bash
+yarn install
+yarn build
+sf plugins link .
+```
+
+## Quick Start
+
+Analyze a project:
+
+```bash
+sf smart-deployment analyze --source-path force-app
+```
+
+Generate a saved plan and JSON report:
+
+```bash
+sf smart-deployment analyze \
+  --source-path force-app \
+  --use-ai \
+  --save-plan \
+  --output analysis.json \
+  --format json
+```
+
+Run a dry deployment:
+
+```bash
+sf smart-deployment start \
+  --source-path force-app \
+  --dry-run
+```
+
+Run with AI and allow conservative cycle remediation:
+
+```bash
+sf smart-deployment start \
+  --source-path force-app \
+  --target-org myorg \
+  --use-ai \
+  --allow-cycle-remediation
+```
+
+Validate without executing deployment:
+
+```bash
+sf smart-deployment validate \
+  --source-path force-app \
+  --use-ai
+```
+
+Show persisted deployment state:
+
+```bash
+sf smart-deployment status --source-path force-app
+```
+
+Resume a failed deployment from local state:
+
+```bash
+sf smart-deployment resume \
+  --source-path force-app \
+  --retry-strategy standard
+```
+
+Configure the default AI provider for a repo:
+
+```bash
+sf smart-deployment config \
+  --source-path . \
+  --set-llm-provider openai \
+  --set-llm-model gpt-4o-mini
+```
+
+## Commands
+
+See:
+
+- [CLI reference](docs/cli-reference.md)
+- [AI configuration](docs/ai-configuration.md)
+- [Known limitations](docs/known-limitations.md)
+- [Documentation index](docs/README.md)
+
+## AI Providers
+
+The AI layer is no longer Agentforce-only.
+
+Current provider model:
+
+- shared provider abstraction in `src/ai/llm-provider.ts`
+- provider factory in `src/ai/llm-provider-factory.ts`
+- concrete adapters currently implemented for:
+  - `agentforce`
+  - `openai`
+
+AI is optional. When unavailable, supported flows fall back to deterministic heuristics where possible.
+
+## Repo Configuration
+
+Repo-scoped configuration is stored in:
+
+```text
+.smart-deployment.json
+```
+
+Example:
+
+```json
+{
+  "llm": {
+    "provider": "openai",
+    "model": "gpt-4o-mini",
+    "endpoint": "https://api.openai.com/v1/chat/completions",
+    "timeout": 30000
+  },
+  "priorities": {
+    "ApexClass:CriticalService": 100
+  }
+}
+```
+
+Deployment runtime state is stored separately under `.smart-deployment/` and should not be committed.
+
+## Testing
+
+Main commands:
+
+```bash
+yarn test
+yarn test:compile
+yarn test:only
+yarn lint
+```
+
+The suite currently includes unit, integration-style, and NUT coverage for the main CLI flows.
+
+## Documentation Policy
+
+The repository contains both active documentation and historical design/planning material.
+
+- active docs live in `docs/`
+- archived historical docs live in `docs/archive/`
+
+If a document describes flags or workflows that do not exist in the current command layer, treat the archived version as historical only.

package/lib/ai/agentforce-error-handler.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Agentforce Error Handler - US-073
+ * Graceful AI failure handling with fallback
+ *
+ * @ac US-073-AC-1: Detect AI failures
+ * @ac US-073-AC-2: Fallback to static analysis
+ * @ac US-073-AC-3: Log AI errors
+ * @ac US-073-AC-4: Warn user about fallback
+ * @ac US-073-AC-5: Continue deployment
+ * @ac US-073-AC-6: Report AI usage statistics
+ * @issue #73
+ */
+export type AIUsageStats = {
+    totalCalls: number;
+    successfulCalls: number;
+    failedCalls: number;
+    fallbackCount: number;
+    averageResponseTime: number;
+    errorsByType: Record<string, number>;
+    lastFailure?: Date;
+    lastSuccess?: Date;
+};
+/**
+ * @ac US-073-AC-1: Detect AI failures
+ * @ac US-073-AC-2: Fallback to static analysis
+ */
+export declare class AgentforceErrorHandler {
+    private readonly stats;
+    private consecutiveFailures;
+    private readonly failureThreshold;
+    constructor();
+    /**
+     * @ac US-073-AC-2: Fallback to static analysis
+     * @ac US-073-AC-3: Log AI errors
+     * @ac US-073-AC-4: Warn user about fallback
+     * @ac US-073-AC-5: Continue deployment
+     * Execute AI call with error handling and fallback
+     */
+    executeWithFallback<T>(aiCall: () => Promise<T>, fallback: () => T | Promise<T>, context: string): Promise<{
+        result: T;
+        usedFallback: boolean;
+    }>;
+    /**
+     * @ac US-073-AC-1: Detect AI failures
+     * Record successful AI call
+     */
+    private recordSuccess;
+    /**
+     * @ac US-073-AC-1: Detect AI failures
+     * @ac US-073-AC-3: Log AI errors
+     * Record failed AI call
+     */
+    private recordFailure;
+    /**
+     * Categorize AI error
+     */
+    private categorizeError;
+    /**
+     * @ac US-073-AC-4: Warn user about fallback
+     * Warn user that AI is unavailable
+     */
+    private warnUserAboutFallback;
+    /**
+     * @ac US-073-AC-6: Report AI usage statistics
+     * Get usage statistics
+     */
+    getStats(): AIUsageStats;
+    /**
+     * Get failure rate
+     */
+    private getFailureRate;
+    /**
+     * @ac US-073-AC-6: Report AI usage statistics
+     * Format usage report
+     */
+    formatReport(): string;
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+}

package/lib/ai/agentforce-error-handler.js

@@ -0,0 +1,196 @@
+/**
+ * Agentforce Error Handler - US-073
+ * Graceful AI failure handling with fallback
+ *
+ * @ac US-073-AC-1: Detect AI failures
+ * @ac US-073-AC-2: Fallback to static analysis
+ * @ac US-073-AC-3: Log AI errors
+ * @ac US-073-AC-4: Warn user about fallback
+ * @ac US-073-AC-5: Continue deployment
+ * @ac US-073-AC-6: Report AI usage statistics
+ * @issue #73
+ */
+import { getLogger } from '../utils/logger.js';
+const logger = getLogger('AgentforceErrorHandler');
+/**
+ * @ac US-073-AC-1: Detect AI failures
+ * @ac US-073-AC-2: Fallback to static analysis
+ */
+export class AgentforceErrorHandler {
+    stats;
+    consecutiveFailures = 0;
+    failureThreshold = 5;
+    constructor() {
+        this.stats = {
+            totalCalls: 0,
+            successfulCalls: 0,
+            failedCalls: 0,
+            fallbackCount: 0,
+            averageResponseTime: 0,
+            errorsByType: {},
+        };
+        logger.info('Agentforce error handler initialized');
+    }
+    /**
+     * @ac US-073-AC-2: Fallback to static analysis
+     * @ac US-073-AC-3: Log AI errors
+     * @ac US-073-AC-4: Warn user about fallback
+     * @ac US-073-AC-5: Continue deployment
+     * Execute AI call with error handling and fallback
+     */
+    async executeWithFallback(aiCall, fallback, context) {
+        const startTime = Date.now();
+        this.stats.totalCalls++;
+        try {
+            const result = await aiCall();
+            this.recordSuccess(Date.now() - startTime);
+            return {
+                result,
+                usedFallback: false,
+            };
+        }
+        catch (error) {
+            this.recordFailure(error, context);
+            // Use fallback
+            logger.warn('AI call failed, using fallback', {
+                context,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            this.stats.fallbackCount++;
+            this.warnUserAboutFallback(context);
+            const fallbackResult = await fallback();
+            return {
+                result: fallbackResult,
+                usedFallback: true,
+            };
+        }
+    }
+    /**
+     * @ac US-073-AC-1: Detect AI failures
+     * Record successful AI call
+     */
+    recordSuccess(responseTime) {
+        this.stats.successfulCalls++;
+        this.stats.lastSuccess = new Date();
+        this.consecutiveFailures = 0; // Reset on success
+        // Update average response time
+        const total = this.stats.successfulCalls;
+        this.stats.averageResponseTime = (this.stats.averageResponseTime * (total - 1) + responseTime) / total;
+        logger.debug('AI call successful', {
+            responseTime,
+            averageResponseTime: this.stats.averageResponseTime,
+        });
+    }
+    /**
+     * @ac US-073-AC-1: Detect AI failures
+     * @ac US-073-AC-3: Log AI errors
+     * Record failed AI call
+     */
+    recordFailure(error, context) {
+        this.stats.failedCalls++;
+        this.stats.lastFailure = new Date();
+        this.consecutiveFailures++;
+        // Categorize error
+        const errorType = this.categorizeError(error);
+        this.stats.errorsByType[errorType] = (this.stats.errorsByType[errorType] ?? 0) + 1;
+        logger.error('AI call failed', {
+            context,
+            errorType,
+            error: error instanceof Error ? error.message : String(error),
+            totalFailures: this.stats.failedCalls,
+        });
+    }
+    /**
+     * Categorize AI error
+     */
+    categorizeError(error) {
+        if (error instanceof Error) {
+            if (error.message.includes('timeout'))
+                return 'timeout';
+            if (error.message.includes('rate limit'))
+                return 'rate-limit';
+            if (error.message.includes('unauthorized'))
+                return 'auth';
+            if (error.message.includes('network'))
+                return 'network';
+            if (error.message.includes('model'))
+                return 'model-error';
+        }
+        return 'unknown';
+    }
+    /**
+     * @ac US-073-AC-4: Warn user about fallback
+     * Warn user that AI is unavailable
+     */
+    warnUserAboutFallback(context) {
+        logger.warn('⚠️  AI service unavailable - using static analysis fallback', {
+            context,
+            consecutiveFailures: this.consecutiveFailures,
+            failureRate: this.getFailureRate(),
+        });
+        // Log warning (console.warn would be used in CLI context)
+        logger.warn(`AI unavailable for ${context} - using static analysis`);
+    }
+    /**
+     * @ac US-073-AC-6: Report AI usage statistics
+     * Get usage statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Get failure rate
+     */
+    getFailureRate() {
+        if (this.stats.totalCalls === 0)
+            return 0;
+        return this.stats.failedCalls / this.stats.totalCalls;
+    }
+    /**
+     * @ac US-073-AC-6: Report AI usage statistics
+     * Format usage report
+     */
+    formatReport() {
+        const lines = [];
+        const failureRate = (this.getFailureRate() * 100).toFixed(1);
+        const fallbackRate = this.stats.totalCalls > 0 ? ((this.stats.fallbackCount / this.stats.totalCalls) * 100).toFixed(1) : '0.0';
+        lines.push('🤖 AI Usage Statistics');
+        lines.push('═══════════════════════════════════════');
+        lines.push(`Total AI Calls: ${this.stats.totalCalls}`);
+        lines.push(`Successful: ${this.stats.successfulCalls}`);
+        lines.push(`Failed: ${this.stats.failedCalls}`);
+        lines.push(`Fallback Used: ${this.stats.fallbackCount} (${fallbackRate}%)`);
+        lines.push(`Failure Rate: ${failureRate}%`);
+        lines.push(`Avg Response Time: ${Math.round(this.stats.averageResponseTime)}ms`);
+        lines.push('');
+        if (Object.keys(this.stats.errorsByType).length > 0) {
+            lines.push('Errors by Type:');
+            for (const [type, count] of Object.entries(this.stats.errorsByType)) {
+                lines.push(`  ${type}: ${count}`);
+            }
+            lines.push('');
+        }
+        if (this.stats.lastFailure) {
+            const timeSince = Date.now() - this.stats.lastFailure.getTime();
+            lines.push(`Last Failure: ${Math.floor(timeSince / 1000)}s ago`);
+        }
+        lines.push('');
+        lines.push(`Consecutive Failures: ${this.consecutiveFailures}/${this.failureThreshold}`);
+        return lines.join('\n');
+    }
+    /**
+     * Reset statistics
+     */
+    resetStats() {
+        this.stats.totalCalls = 0;
+        this.stats.successfulCalls = 0;
+        this.stats.failedCalls = 0;
+        this.stats.fallbackCount = 0;
+        this.stats.averageResponseTime = 0;
+        this.stats.errorsByType = {};
+        this.stats.lastFailure = undefined;
+        this.stats.lastSuccess = undefined;
+        logger.info('AI usage stats reset');
+    }
+}
+//# sourceMappingURL=agentforce-error-handler.js.map

package/lib/ai/agentforce-error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentforce-error-handler.js","sourceRoot":"","sources":["../../src/ai/agentforce-error-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,MAAM,GAAG,SAAS,CAAC,wBAAwB,CAAC,CAAC;AAanD;;;GAGG;AACH,MAAM,OAAO,sBAAsB;IAChB,KAAK,CAAe;IAC7B,mBAAmB,GAAG,CAAC,CAAC;IACf,gBAAgB,GAAG,CAAC,CAAC;IAEtC;QACE,IAAI,CAAC,KAAK,GAAG;YACX,UAAU,EAAE,CAAC;YACb,eAAe,EAAE,CAAC;YAClB,WAAW,EAAE,CAAC;YACd,aAAa,EAAE,CAAC;YAChB,mBAAmB,EAAE,CAAC;YACtB,YAAY,EAAE,EAAE;SACjB,CAAC;QAEF,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,mBAAmB,CAC9B,MAAwB,EACxB,QAA8B,EAC9B,OAAe;QAEf,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QAExB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,EAAE,CAAC;YAC9B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;YAE3C,OAAO;gBACL,MAAM;gBACN,YAAY,EAAE,KAAK;aACpB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAEnC,eAAe;YACf,MAAM,CAAC,IAAI,CAAC,gCAAgC,EAAE;gBAC5C,OAAO;gBACP,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;YAEH,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;YAC3B,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;YAEpC,MAAM,cAAc,GAAG,MAAM,QAAQ,EAAE,CAAC;YAExC,OAAO;gBACL,MAAM,EAAE,cAAc;gBACtB,YAAY,EAAE,IAAI;aACnB,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,aAAa,CAAC,YAAoB;QACxC,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC,CAAC,mBAAmB;QAEjD,+BAA+B;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC;QACzC,IAAI,CAAC,KAAK,CAAC,mBAAmB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,mBAAmB,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,YAAY,CAAC,GAAG,KAAK,CAAC;QAEvG,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE;YACjC,YAAY;YACZ,mBAAmB,EAAE,IAAI,CAAC,KAAK,CAAC,mBAAmB;SACpD,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACK,aAAa,CAAC,KAAc,EAAE,OAAe;QACnD,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACzB,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAE3B,mBAAmB;QACnB,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAEnF,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE;YAC7B,OAAO;YACP,SAAS;YACT,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;YAC7D,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW;SACtC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,KAAc;QACpC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAAE,OAAO,SAAS,CAAC;YACxD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAAE,OAAO,YAAY,CAAC;YAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAAE,OAAO,MAAM,CAAC;YAC1D,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAAE,OAAO,SAAS,CAAC;YACxD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,OAAO,aAAa,CAAC;QAC5D,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;OAGG;IACK,qBAAqB,CAAC,OAAe;QAC3C,MAAM,CAAC,IAAI,CAAC,6DAA6D,EAAE;YACzE,OAAO;YACP,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;YAC7C,WAAW,EAAE,IAAI,CAAC,cAAc,EAAE;SACnC,CAAC,CAAC;QAEH,0DAA0D;QAC1D,MAAM,CAAC,IAAI,CAAC,sBAAsB,OAAO,0BAA0B,CAAC,CAAC;IACvE,CAAC;IAED;;;OAGG;IACI,QAAQ;QACb,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACK,cAAc;QACpB,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;IACxD,CAAC;IAED;;;OAGG;IACI,YAAY;QACjB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC7D,MAAM,YAAY,GAChB,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAE5G,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,KAAK,CAAC,aAAa,KAAK,YAAY,IAAI,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,iBAAiB,WAAW,GAAG,CAAC,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,sBAAsB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACjF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAC9B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;gBACpE,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;YACpC,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YAChE,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QACnE,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,yBAAyB,IAAI,CAAC,mBAAmB,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAEzF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACI,UAAU;QACf,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,mBAAmB,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC;QAEnC,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACtC,CAAC;CACF"}

package/lib/ai/agentforce-priority-service.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Agentforce Priority Service - US-057
+ * Uses Salesforce AI to suggest component deployment priorities
+ *
+ * @ac US-057-AC-1: Send component list to Agentforce
+ * @ac US-057-AC-2: Receive priority recommendations
+ * @ac US-057-AC-3: Consider business criticality
+ * @ac US-057-AC-4: Consider failure impact
+ * @ac US-057-AC-5: Merge with static priorities
+ * @ac US-057-AC-6: Report AI decisions
+ * @issue #57
+ */
+import type { MetadataComponent } from '../types/metadata.js';
+import type { AgentforceFetch } from './agentforce-service.js';
+import type { LLMProvider, LLMProviderName } from './llm-provider.js';
+export type PriorityRecommendation = {
+    componentName: string;
+    priority: number;
+    reason: string;
+    confidence: number;
+    businessCriticality: 'low' | 'medium' | 'high' | 'critical';
+    failureImpact: 'low' | 'medium' | 'high' | 'critical';
+};
+export type AgentforceConfig = {
+    baseDir?: string;
+    provider?: LLMProviderName;
+    endpoint?: string;
+    apiKey?: string;
+    model?: string;
+    timeout?: number;
+    enabled?: boolean;
+    maxRetries?: number;
+    rateLimit?: number;
+    fetchFn?: AgentforceFetch;
+    llmProvider?: LLMProvider;
+};
+export type PriorityAnalysisResult = {
+    recommendations: PriorityRecommendation[];
+    totalComponents: number;
+    aiAdjustments: number;
+    executionTime: number;
+    tokensUsed?: number;
+    usedFallback: boolean;
+};
+/**
+ * @ac US-057-AC-1: Send component list to Agentforce
+ * @ac US-057-AC-2: Receive priority recommendations
+ */
+export declare class AgentforcePriorityService {
+    private readonly llmProvider;
+    private readonly enabled;
+    constructor(config?: AgentforceConfig);
+    /**
+     * @ac US-057-AC-1: Send component list to Agentforce
+     * @ac US-057-AC-2: Receive priority recommendations
+     * @ac US-057-AC-3: Consider business criticality
+     * @ac US-057-AC-4: Consider failure impact
+     */
+    analyzePriorities(components: MetadataComponent[], context?: {
+        orgType?: string;
+        industry?: string;
+    }): Promise<PriorityAnalysisResult>;
+    /**
+     * @ac US-057-AC-3: Consider business criticality
+     * @ac US-057-AC-4: Consider failure impact
+     */
+    private buildPriorityPrompt;
+    /**
+     * @ac US-057-AC-1: Send component list to Agentforce
+     */
+    private parseResponse;
+    /**
+     * Mock response for testing and fallback
+     */
+    private getMockResponse;
+    private createFallbackResult;
+    /**
+     * @ac US-057-AC-6: Report AI decisions
+     */
+    formatDecisionReport(result: PriorityAnalysisResult): string;
+    getProviderConfig(): Readonly<ReturnType<LLMProvider['getConfig']>>;
+}