cloud-cost-cli 0.2.0 → 0.3.0-beta.2

package/dist/src/commands/costs.js

@@ -0,0 +1,54 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.costsCommand = costsCommand;
+const cost_tracker_1 = require("../utils/cost-tracker");
+const logger_1 = require("../utils/logger");
+const chalk_1 = __importDefault(require("chalk"));
+async function costsCommand(options) {
+    const tracker = new cost_tracker_1.CostTracker();
+    if (options.clear) {
+        tracker.clear();
+        (0, logger_1.info)('Cost tracking data cleared');
+        return;
+    }
+    const days = parseInt(options.days || '30');
+    const summary = tracker.getSummary(days);
+    console.log(chalk_1.default.bold(`\n💰 AI Cost Summary (last ${days} days):\n`));
+    if (summary.totalOperations === 0) {
+        console.log(chalk_1.default.dim('No AI operations tracked yet.'));
+        console.log(chalk_1.default.dim('Use --explain or ask commands to generate AI insights.\n'));
+        return;
+    }
+    console.log(chalk_1.default.bold('Total:'));
+    console.log(`  Operations: ${summary.totalOperations}`);
+    console.log(`  Cost: $${summary.totalCost.toFixed(4)}`);
+    console.log();
+    console.log(chalk_1.default.bold('By Provider:'));
+    Object.entries(summary.byProvider).forEach(([provider, stats]) => {
+        const icon = provider === 'openai' ? '☁️ ' : '🏠';
+        console.log(`  ${icon} ${provider}:`);
+        console.log(`    Operations: ${stats.operations}`);
+        console.log(`    Cost: $${stats.cost.toFixed(4)}`);
+    });
+    console.log();
+    console.log(chalk_1.default.bold('By Model:'));
+    Object.entries(summary.byModel).forEach(([model, stats]) => {
+        console.log(`  ${model}:`);
+        console.log(`    Operations: ${stats.operations}`);
+        console.log(`    Cost: $${stats.cost.toFixed(4)}`);
+    });
+    console.log();
+    // Show average cost per operation
+    const avgCost = summary.totalCost / summary.totalOperations;
+    console.log(chalk_1.default.dim(`Average cost per operation: $${avgCost.toFixed(4)}`));
+    // Estimate monthly cost at current rate
+    const daysElapsed = days;
+    const monthlyEstimate = (summary.totalCost / daysElapsed) * 30;
+    if (daysElapsed >= 7) {
+        console.log(chalk_1.default.dim(`Estimated monthly cost: $${monthlyEstimate.toFixed(2)}`));
+    }
+    console.log();
+}

package/dist/src/commands/scan.d.ts

@@ -10,6 +10,9 @@ interface ScanCommandOptions {
     minSavings?: string;
     verbose?: boolean;
     accurate?: boolean;
+    explain?: boolean;
+    aiProvider?: string;
+    aiModel?: string;
 }
 export declare function scanCommand(options: ScanCommandOptions): Promise<void>;
 export {};

package/dist/src/commands/scan.js

@@ -17,6 +17,9 @@ const public_ips_1 = require("../providers/azure/public-ips");
 const table_1 = require("../reporters/table");
 const json_1 = require("../reporters/json");
 const logger_1 = require("../utils/logger");
+const ai_1 = require("../services/ai");
+const ask_1 = require("./ask");
+const config_1 = require("../utils/config");
 async function scanCommand(options) {
     try {
         if (options.provider === 'aws') {
@@ -110,11 +113,51 @@ async function scanAWS(options) {
     };
     // Render output
     const topN = parseInt(options.top || '5');
+    let aiService;
+    if (options.explain) {
+        // Load config file to get defaults
+        const fileConfig = config_1.ConfigLoader.load();
+        // CLI flags override config file
+        const provider = options.aiProvider || fileConfig.ai?.provider || 'openai';
+        const model = options.aiModel || fileConfig.ai?.model;
+        const maxExplanations = fileConfig.ai?.maxExplanations;
+        // Debug logging
+        if (process.env.DEBUG) {
+            console.error('options.aiProvider:', options.aiProvider, '(type:', typeof options.aiProvider, ')');
+            console.error('fileConfig.ai?.provider:', fileConfig.ai?.provider);
+            console.error('Provider detected:', provider);
+            console.error('Has API key in config:', !!fileConfig.ai?.apiKey);
+            console.error('Has env API key:', !!process.env.OPENAI_API_KEY);
+        }
+        if (provider === 'openai' && !process.env.OPENAI_API_KEY && !fileConfig.ai?.apiKey) {
+            (0, logger_1.error)('--explain with OpenAI requires OPENAI_API_KEY environment variable or config file');
+            (0, logger_1.info)('Set it with: export OPENAI_API_KEY="sk-..."');
+            (0, logger_1.info)('Or use --ai-provider ollama for local AI (requires Ollama installed)');
+            process.exit(1);
+        }
+        try {
+            aiService = new ai_1.AIService({
+                provider,
+                apiKey: provider === 'openai' ? (process.env.OPENAI_API_KEY || fileConfig.ai?.apiKey) : undefined,
+                model,
+                maxExplanations,
+            });
+            if (provider === 'ollama') {
+                (0, logger_1.info)('Using local Ollama for AI explanations (privacy-first, no API costs)');
+            }
+        }
+        catch (error) {
+            error(`Failed to initialize AI service: ${error.message}`);
+            process.exit(1);
+        }
+    }
+    // Save scan cache for natural language queries
+    (0, ask_1.saveScanCache)(options.provider, options.region, report);
     if (options.output === 'json') {
         (0, json_1.renderJSON)(report);
     }
     else {
-        (0, table_1.renderTable)(report, topN);
+        await (0, table_1.renderTable)(report, topN, aiService);
     }
 }
 async function scanAzure(options) {
@@ -129,6 +172,14 @@ async function scanAzure(options) {
     else {
         (0, logger_1.info)('Scanning all locations (no filter specified)');
     }
+    // Test Azure credentials before scanning
+    try {
+        await client.testConnection();
+    }
+    catch (err) {
+        (0, logger_1.error)(err.message);
+        process.exit(1);
+    }
     if (options.accurate) {
         (0, logger_1.info)('Note: --accurate flag is not yet implemented. Using estimated pricing.');
     }
@@ -189,10 +240,50 @@ async function scanAzure(options) {
     };
     // Render output
     const topN = parseInt(options.top || '5');
+    let aiService;
+    if (options.explain) {
+        // Load config file to get defaults
+        const fileConfig = config_1.ConfigLoader.load();
+        // CLI flags override config file
+        const provider = options.aiProvider || fileConfig.ai?.provider || 'openai';
+        const model = options.aiModel || fileConfig.ai?.model;
+        const maxExplanations = fileConfig.ai?.maxExplanations;
+        // Debug logging
+        if (process.env.DEBUG) {
+            console.error('options.aiProvider:', options.aiProvider, '(type:', typeof options.aiProvider, ')');
+            console.error('fileConfig.ai?.provider:', fileConfig.ai?.provider);
+            console.error('Provider detected:', provider);
+            console.error('Has API key in config:', !!fileConfig.ai?.apiKey);
+            console.error('Has env API key:', !!process.env.OPENAI_API_KEY);
+        }
+        if (provider === 'openai' && !process.env.OPENAI_API_KEY && !fileConfig.ai?.apiKey) {
+            (0, logger_1.error)('--explain with OpenAI requires OPENAI_API_KEY environment variable or config file');
+            (0, logger_1.info)('Set it with: export OPENAI_API_KEY="sk-..."');
+            (0, logger_1.info)('Or use --ai-provider ollama for local AI (requires Ollama installed)');
+            process.exit(1);
+        }
+        try {
+            aiService = new ai_1.AIService({
+                provider,
+                apiKey: provider === 'openai' ? (process.env.OPENAI_API_KEY || fileConfig.ai?.apiKey) : undefined,
+                model,
+                maxExplanations,
+            });
+            if (provider === 'ollama') {
+                (0, logger_1.info)('Using local Ollama for AI explanations (privacy-first, no API costs)');
+            }
+        }
+        catch (error) {
+            error(`Failed to initialize AI service: ${error.message}`);
+            process.exit(1);
+        }
+    }
+    // Save scan cache for natural language queries
+    (0, ask_1.saveScanCache)('azure', client.location, report);
     if (options.output === 'json') {
         (0, json_1.renderJSON)(report);
     }
     else {
-        (0, table_1.renderTable)(report, topN);
+        await (0, table_1.renderTable)(report, topN, aiService);
     }
 }

package/dist/src/commands/script.d.ts

@@ -0,0 +1,8 @@
+import { SavingsOpportunity } from '../types';
+interface ScriptCommandOptions {
+    opportunity: string;
+    output?: string;
+}
+export declare function scriptCommand(options: ScriptCommandOptions): Promise<void>;
+export declare function generateScriptForOpportunity(opportunity: SavingsOpportunity): string | null;
+export {};

package/dist/src/commands/script.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scriptCommand = scriptCommand;
+exports.generateScriptForOpportunity = generateScriptForOpportunity;
+const script_generator_1 = require("../services/script-generator");
+const logger_1 = require("../utils/logger");
+async function scriptCommand(options) {
+    (0, logger_1.info)('Script generation is currently only available after running a scan.');
+    (0, logger_1.info)('Usage: cloud-cost-cli scan --provider aws --region us-east-1');
+    (0, logger_1.info)('Then use the displayed resource IDs to generate scripts.');
+    // This is a placeholder - in a real implementation, we'd:
+    // 1. Load scan results from a cache/temp file
+    // 2. Find the opportunity by index or ID
+    // 3. Generate the script
+    // 4. Output to file or stdout
+    (0, logger_1.error)('Script generation requires a recent scan. Run "scan" first.');
+    process.exit(1);
+}
+// Helper function to generate script for a single opportunity
+function generateScriptForOpportunity(opportunity) {
+    const generator = new script_generator_1.ScriptGenerator();
+    const script = generator.generateRemediation(opportunity);
+    if (!script) {
+        return null;
+    }
+    return generator.renderScript(script);
+}

package/dist/src/providers/azure/client.d.ts

@@ -12,6 +12,7 @@ export declare class AzureClient {
     subscriptionId: string;
     location: string;
     constructor(config?: AzureClientConfig);
+    testConnection(): Promise<void>;
     getComputeClient(): ComputeManagementClient;
     getStorageClient(): StorageManagementClient;
     getSqlClient(): SqlManagementClient;

package/dist/src/providers/azure/client.js

@@ -22,6 +22,29 @@ class AzureClient {
         // Default to East US if no location specified
         this.location = config.location || '';
     }
+    // Test Azure credentials by making a lightweight API call
+    async testConnection() {
+        try {
+            const computeClient = this.getComputeClient();
+            // Try to list VMs (we'll just get an iterator, not actually iterate)
+            const vmsIterator = computeClient.virtualMachines.listAll();
+            // Get first page to test auth
+            await vmsIterator.next();
+        }
+        catch (error) {
+            const errorMsg = error.message || '';
+            if (errorMsg.includes('No subscriptions found') ||
+                errorMsg.includes('authentication') ||
+                errorMsg.includes('credentials') ||
+                errorMsg.includes('login') ||
+                error.statusCode === 401 ||
+                error.code === 'CredentialUnavailableError') {
+                throw new Error('Azure authentication failed. Please run "az login" first or set up service principal credentials.\n' +
+                    'See: https://learn.microsoft.com/en-us/cli/azure/authenticate-azure-cli');
+            }
+            throw error;
+        }
+    }
     getComputeClient() {
         return new arm_compute_1.ComputeManagementClient(this.credential, this.subscriptionId);
     }

package/dist/src/reporters/table.d.ts

@@ -1,2 +1,3 @@
 import { ScanReport } from '../types';
-export declare function renderTable(report: ScanReport, topN?: number): void;
+import { AIService } from '../services/ai';
+export declare function renderTable(report: ScanReport, topN?: number, aiService?: AIService): Promise<void>;

package/dist/src/reporters/table.js

@@ -7,7 +7,7 @@ exports.renderTable = renderTable;
 const cli_table3_1 = __importDefault(require("cli-table3"));
 const chalk_1 = __importDefault(require("chalk"));
 const utils_1 = require("../utils");
-function renderTable(report, topN = 5) {
+async function renderTable(report, topN = 5, aiService) {
     console.log(chalk_1.default.bold('\nCloud Cost Optimization Report'));
     console.log(`Provider: ${report.provider} | Region: ${report.region} | Account: ${report.accountId}`);
     console.log(`Analyzed: ${report.scanPeriod.start.toISOString().split('T')[0]} to ${report.scanPeriod.end.toISOString().split('T')[0]}\n`);
@@ -21,7 +21,8 @@ function renderTable(report, topN = 5) {
     console.log(chalk_1.default.bold(`Top ${opportunities.length} Savings Opportunities (est. ${(0, utils_1.formatCurrency)(report.totalPotentialSavings)}/month):\n`));
     const table = new cli_table3_1.default({
         head: ['#', 'Type', 'Resource ID', 'Recommendation', 'Savings/mo'],
-        colWidths: [5, 10, 25, 50, 15],
+        colWidths: [5, 12, 40, 60, 15],
+        wordWrap: true,
         style: {
             head: ['cyan'],
         },
@@ -36,8 +37,71 @@ function renderTable(report, topN = 5) {
         ]);
     });
     console.log(table.toString());
+    // Show AI explanations if enabled
+    if (aiService && aiService.isEnabled()) {
+        console.log(chalk_1.default.bold('\n🤖 AI-Powered Insights:\n'));
+        const maxExplanations = aiService.getMaxExplanations();
+        const opportunitiesToExplain = opportunities.slice(0, Math.min(maxExplanations, opportunities.length));
+        for (let i = 0; i < opportunitiesToExplain.length; i++) {
+            const opp = opportunitiesToExplain[i];
+            try {
+                console.log(chalk_1.default.cyan(`Analyzing opportunity #${i + 1}...`));
+                const explanation = await aiService.explainOpportunity(opp);
+                const cacheIndicator = explanation.cached ? chalk_1.default.dim(' (cached)') : '';
+                console.log(chalk_1.default.bold(`\n💡 Opportunity #${i + 1}: ${opp.resourceId}${cacheIndicator}`));
+                console.log(chalk_1.default.dim('─'.repeat(80)));
+                console.log(chalk_1.default.white(explanation.summary));
+                console.log();
+                console.log(chalk_1.default.bold('Why this is wasteful:'));
+                console.log(explanation.whyWasteful);
+                if (explanation.actionPlan.length > 0) {
+                    console.log();
+                    console.log(chalk_1.default.bold('Action plan:'));
+                    explanation.actionPlan.forEach((step) => {
+                        console.log(chalk_1.default.green(`  ${step}`));
+                    });
+                }
+                console.log();
+                console.log(`Risk: ${getRiskEmoji(explanation.riskLevel)} ${explanation.riskLevel.toUpperCase()}`);
+                console.log(`Time: ⏱️  ${explanation.estimatedTime}`);
+                // Try to generate remediation script
+                try {
+                    const script = await aiService.generateRemediationScript(opp);
+                    if (script) {
+                        console.log();
+                        console.log(chalk_1.default.bold('🔧 Remediation Script:'));
+                        console.log(chalk_1.default.dim('─'.repeat(80)));
+                        console.log(chalk_1.default.gray(script));
+                    }
+                }
+                catch (error) {
+                    // Script generation failed, skip silently
+                }
+                console.log();
+            }
+            catch (error) {
+                console.log(chalk_1.default.yellow(`⚠️  AI explanation failed: ${error.message}`));
+            }
+        }
+    }
+    // Show total count if there are more opportunities
+    if (report.opportunities.length > topN) {
+        console.log(chalk_1.default.dim(`\n... and ${report.opportunities.length - topN} more opportunities (use --top ${report.opportunities.length} to see all)`));
+    }
     console.log(chalk_1.default.bold(`\nTotal potential savings: ${chalk_1.default.green((0, utils_1.formatCurrency)(report.totalPotentialSavings))}/month (${chalk_1.default.green((0, utils_1.formatCurrency)(report.totalPotentialSavings * 12))}/year)`));
     console.log(`\nSummary: ${report.summary.totalResources} resources analyzed | ${report.summary.idleResources} idle | ${report.summary.oversizedResources} oversized | ${report.summary.unusedResources} unused`);
     console.log(chalk_1.default.dim(`\n💡 Note: Cost estimates based on us-east-1 pricing and may vary by region.`));
     console.log(chalk_1.default.dim(`   For more accurate estimates, actual costs depend on your usage and region.\n`));
 }
+function getRiskEmoji(risk) {
+    switch (risk) {
+        case 'low':
+            return '✅';
+        case 'medium':
+            return '⚠️';
+        case 'high':
+            return '🚨';
+        default:
+            return '❓';
+    }
+}

package/dist/src/services/ai.d.ts

@@ -0,0 +1,44 @@
+import { SavingsOpportunity } from '../types';
+export interface AIExplanation {
+    summary: string;
+    whyWasteful: string;
+    actionPlan: string[];
+    riskLevel: 'low' | 'medium' | 'high';
+    estimatedTime: string;
+    script?: string;
+    cached?: boolean;
+}
+export interface QueryAnswer {
+    response: string;
+    suggestions?: string[];
+    relatedOpportunities?: any[];
+}
+export type AIProvider = 'openai' | 'ollama';
+export interface AIConfig {
+    provider: AIProvider;
+    apiKey?: string;
+    model?: string;
+    maxExplanations?: number;
+}
+export declare class AIService {
+    private openaiClient;
+    private ollamaClient;
+    private provider;
+    private model;
+    private enabled;
+    private maxExplanations;
+    private cache;
+    private useCache;
+    private costTracker;
+    constructor(config?: AIConfig);
+    isEnabled(): boolean;
+    getMaxExplanations(): number;
+    explainOpportunity(opportunity: SavingsOpportunity): Promise<AIExplanation>;
+    generateRemediationScript(opportunity: SavingsOpportunity): Promise<string | null>;
+    private buildPrompt;
+    private parseExplanation;
+    answerQuery(query: string, scanReport: any): Promise<QueryAnswer>;
+    private buildQueryContext;
+    private buildQueryPrompt;
+    private parseQueryAnswer;
+}