cloud-cost-cli 0.1.0 → 0.2.0

package/README.md

@@ -1,8 +1,11 @@
 # cloud-cost-cli
 
+[![npm version](https://badge.fury.io/js/cloud-cost-cli.svg)](https://www.npmjs.com/package/cloud-cost-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 **Optimize your cloud spend in seconds.**
 
-A command-line tool that analyzes your AWS, GCP, and Azure bills to identify cost-saving opportunities — idle resources, oversized instances, unattached volumes, and more.
+A command-line tool that analyzes your AWS and Azure resources to identify cost-saving opportunities — idle resources, oversized instances, unattached volumes, and more.
 
 ---
 
@@ -15,157 +18,140 @@ Cloud bills are growing faster than revenue. Engineering teams overprovision, fo
 `cloud-cost-cli` connects to your cloud accounts, analyzes resource usage and billing data, and outputs a ranked list of actionable savings opportunities — all in your terminal, in under 60 seconds.
 
 **What it finds:**
-- Idle EC2/Compute instances (low CPU, stopped but still billed)
-- Unattached EBS volumes and snapshots
-- Oversized RDS/database instances
+- Idle VMs/EC2 instances (low CPU, stopped but still billed)
+- Unattached volumes, disks, and snapshots
+- Oversized database instances (RDS, Azure SQL)
 - Old load balancers with no traffic
-- Unused Elastic IPs
-- Underutilized reserved instances or savings plan mismatches
-- Redundant S3 storage (lifecycle policies missing)
+- Unused public IP addresses
+- Underutilized resources that can be downsized
+- Storage without lifecycle policies
 
 ---
 
-## Features (MVP - Week 1–2)
-
-- ✅ AWS support (EC2, EBS, RDS, S3, ELB, Elastic IP)
-- ✅ Connect via AWS credentials (IAM read-only recommended)
-- ✅ Analyze last 30 days of usage
-- ✅ Output top 5 savings opportunities with estimated monthly savings
-- ✅ Export report as JSON, Markdown, or terminal table
-- ✅ Zero third-party API dependencies (uses AWS SDK directly)
-
-**Coming soon:**
-- GCP and Azure support
-- Slack/email alerts for new cost spikes
-- Scheduled reports (cron-friendly)
-- Team dashboard (web UI, SaaS)
-- Custom rules and thresholds
-- Terraform/IaC integration (flag risky configs before apply)
+## Features
+
+**Current capabilities:**
+- ✅ **Multi-cloud support** - AWS and Azure
+- ✅ **AWS analyzers** - EC2, EBS, RDS, S3, ELB, Elastic IP
+- ✅ **Azure analyzers** - VMs, Managed Disks, Storage, SQL, Public IPs
+- ✅ Connect via cloud credentials (read-only recommended)
+- ✅ Analyze last 7-30 days of usage
+- ✅ Output top savings opportunities with estimated monthly savings
+- ✅ Export report as JSON or terminal table
+- ✅ Filter by minimum savings amount
+- ✅ Comprehensive test suite (84 tests)
+
+**Potential future additions:**
+- GCP support (Compute Engine, Cloud Storage, Cloud SQL)
+- Real-time pricing API integration
+- Configuration file support
+- Additional AWS services (Lambda, DynamoDB, CloudFront, etc.)
+- Additional Azure services (App Services, CosmosDB, etc.)
+- Multi-region analysis
+- Historical cost tracking
+- Scheduled scans and notifications
+- CI/CD integration examples
+- Custom analyzer rules
+
+No commitment on timeline - contributions welcome!
 
 ---
 
 ## Installation
 
 **Requirements:**
-- Node.js >= 18 (or use the standalone binary)
-- AWS credentials configured (see [AWS CLI setup](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html))
+- Node.js >= 18
+- Cloud credentials:
+  - **AWS**: [AWS CLI configured](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) or environment variables
+  - **Azure**: [Azure CLI logged in](https://learn.microsoft.com/en-us/cli/azure/authenticate-azure-cli) or environment variables
 
 **Install via npm:**
 ```bash
 npm install -g cloud-cost-cli
 ```
 
-**Or download standalone binary:**
-```bash
-# macOS/Linux
-curl -L https://github.com/vuhp/cloud-cost-cli/releases/latest/download/cloud-cost-cli-$(uname -s)-$(uname -m) -o /usr/local/bin/cloud-cost-cli
-chmod +x /usr/local/bin/cloud-cost-cli
+---
 
-# Windows (PowerShell)
-Invoke-WebRequest -Uri "https://github.com/vuhp/cloud-cost-cli/releases/latest/download/cloud-cost-cli-windows-x64.exe" -OutFile "$env:USERPROFILE\bin\cloud-cost-cli.exe"
+## Usage
+
+**AWS scan:**
+```bash
+cloud-cost-cli scan --provider aws --profile default --region us-east-1
 ```
 
----
+**Azure scan:**
+```bash
+# Set Azure subscription ID (or use --subscription-id flag)
+export AZURE_SUBSCRIPTION_ID="your-subscription-id"
 
-## Usage
+cloud-cost-cli scan --provider azure --location eastus
+```
 
-**Basic scan (AWS):**
+**Show more opportunities:**
 ```bash
-cloud-cost-cli scan --provider aws --profile default
+cloud-cost-cli scan --provider aws --top 20  # Show top 20 instead of default 5
 ```
 
-**Specify region and output format:**
+**Filter by minimum savings:**
 ```bash
-cloud-cost-cli scan --provider aws --region us-east-1 --output json > report.json
+cloud-cost-cli scan --provider azure --min-savings 50  # Only show opportunities > $50/month
 ```
 
-**Top N opportunities:**
+**Specify output format:**
 ```bash
-cloud-cost-cli scan --provider aws --top 10
+cloud-cost-cli scan --provider aws --output json > report.json
 ```
 
 **Example output:**
 ```
 Cloud Cost Optimization Report
-Provider: AWS | Region: us-east-1 | Account: 123456789012
+Provider: AWS | Region: us-east-1 | Account: N/A
 Analyzed: 2026-01-01 to 2026-01-31
 
 Top 5 Savings Opportunities (est. $1,245/month):
 
-1. Idle EC2 instance: i-0abc123def456
-   Type: m5.large | Running 720h | Avg CPU: 2%
-   → Recommendation: Stop or downsize to t3.small
-   → Est. savings: $65/month
-
-2. Unattached EBS volume: vol-0xyz789abc
-   Size: 500 GB (gp3) | Age: 45 days
-   → Recommendation: Delete or snapshot + delete
-   → Est. savings: $40/month
-
-3. Oversized RDS instance: mydb-production
-   Type: db.r5.xlarge | Avg connections: 5 | Avg CPU: 15%
-   → Recommendation: Downsize to db.t3.large
-   → Est. savings: $180/month
+┌───┬──────────┬────────────────────────────────────────┬──────────────────────────────────────────────────────────┬─────────────┐
+│ # │ Type     │ Resource ID                            │ Recommendation                                           │ Savings/mo  │
+├───┼──────────┼────────────────────────────────────────┼──────────────────────────────────────────────────────────┼─────────────┤
+│ 1 │ EC2      │ i-0abc123def456                        │ Stop idle instance (CPU: 2%)                             │ $65.00      │
+├───┼──────────┼────────────────────────────────────────┼──────────────────────────────────────────────────────────┼─────────────┤
+│ 2 │ EBS      │ vol-0xyz789abc                         │ Delete unattached volume (500 GB)                        │ $40.00      │
+├───┼──────────┼────────────────────────────────────────┼──────────────────────────────────────────────────────────┼─────────────┤
+│ 3 │ RDS      │ mydb-production                        │ Downsize from db.r5.xlarge to db.t3.large (CPU: 15%)    │ $180.00     │
+├───┼──────────┼────────────────────────────────────────┼──────────────────────────────────────────────────────────┼─────────────┤
+│ 4 │ ELB      │ my-old-alb                             │ Delete unused load balancer                              │ $22.00      │
+├───┼──────────┼────────────────────────────────────────┼──────────────────────────────────────────────────────────┼─────────────┤
+│ 5 │ S3       │ logs-bucket-2023                       │ Add lifecycle policy to transition to Glacier            │ $938.00     │
+└───┴──────────┴────────────────────────────────────────┴──────────────────────────────────────────────────────────┴─────────────┘
 
-4. Unused Elastic Load Balancer: my-old-alb
-   Active targets: 0 | Requests/day: 0
-   → Recommendation: Delete
-   → Est. savings: $22/month
+Total potential savings: $1,245/month ($14,940/year)
 
-5. S3 bucket with no lifecycle policy: logs-bucket-2023
-   Size: 12 TB | Age: 18 months
-   → Recommendation: Enable Intelligent-Tiering or Glacier transition
-   → Est. savings: $938/month
+Summary: 47 resources analyzed | 12 idle | 8 oversized | 5 unused
 
-Total potential savings: $1,245/month ($14,940/year)
+💡 Note: Cost estimates based on us-east-1 pricing and may vary by region.
+   For more accurate estimates, actual costs depend on your usage and region.
 ```
 
 ---
 
-## Configuration
-
-Create a config file at `~/.cloud-cost-cli/config.json` (optional):
-
-```json
-{
-  "aws": {
-    "profile": "default",
-    "regions": ["us-east-1", "us-west-2"],
-    "excludeResources": ["i-0abc123", "vol-xyz"],
-    "thresholds": {
-      "idleCpuPercent": 5,
-      "minAgeDays": 7
-    }
-  },
-  "output": {
-    "format": "table",
-    "includeRecommendations": true
-  }
-}
-```
+## Pricing Estimates
 
----
+**How cost estimates work:**
 
-## Roadmap
+Cost savings are estimated using AWS on-demand pricing for **us-east-1** (January 2026). These are approximations to help you prioritize optimization efforts.
 
-**Phase 1 (Week 1–2): MVP**
-- AWS support (EC2, EBS, RDS, S3, ELB, EIP)
-- CLI with basic scan and reporting
-- GitHub Sponsors setup
-- Launch on Hacker News, Product Hunt, Reddit
+**Important notes:**
+- 💵 Actual costs vary by region (e.g., ap-southeast-1 may be 10-15% higher)
+- 📊 Estimates don't include Reserved Instances, Savings Plans, or spot discounts
+- 🔄 AWS pricing changes periodically
+- ⚙️ Additional costs like data transfer and storage operations not included
 
-**Phase 2 (Month 2):**
-- GCP support
-- Azure support
-- Scheduled reports (cron mode)
-- Slack webhook integration
-- GitHub Sponsors perks (early access, priority support)
+**For the most accurate estimates:**
+- Cross-reference with your AWS Cost Explorer or Azure Cost Management
+- Consider estimates as directional guidance, not exact amounts
+- Real-time pricing API integration coming in a future release
 
-**Phase 3 (Month 3+):**
-- SaaS version: connect account, weekly email reports, team dashboard
-- Paid tiers: $29/mo (alerts + history), $99/mo (multi-account + API)
-- Enterprise: on-prem, SSO, audit logs, custom rules
-- Terraform provider (flag cost risks before apply)
+The goal is to help you find waste quickly — even if estimates are ±20%, you'll still identify significant savings opportunities.
 
 ---
 
@@ -178,25 +164,33 @@ Contributions welcome! Please open an issue before submitting large PRs.
 git clone https://github.com/vuhp/cloud-cost-cli.git
 cd cloud-cost-cli
 npm install
-npm run dev
+npm run build
 ```
 
 **Run tests:**
 ```bash
-npm test
+npm test              # Run all tests
+npm run test:coverage # Run with coverage report
+npm run test:ui       # Interactive UI
+```
+
+**Development workflow:**
+```bash
+npm run dev -- scan --provider aws --profile your-profile  # Test locally
+npm run build                                              # Compile TypeScript
 ```
 
 ---
 
-## Sponsorship
+## Support This Project
 
-If this tool saves you money, consider sponsoring development via [GitHub Sponsors](https://github.com/sponsors/vuhp).
+If cloud-cost-cli helps you save money, consider [sponsoring on GitHub](https://github.com/sponsors/vuhp).
 
-**Sponsor tiers:**
-- ☕ $5/mo: Thank you!
-- 🚀 $25/mo: Early access to new features + priority support
-- 💼 $100/mo: Logo on README + monthly 1:1 consultation (30 min)
-- 🏢 $500/mo: Custom rule development + dedicated Slack channel
+Your support helps fund:
+- 🚀 New cloud provider integrations
+- 🐛 Bug fixes and maintenance
+- 📚 Better documentation
+- ✨ Community feature requests
 
 ---
 
@@ -208,27 +202,30 @@ MIT License - see [LICENSE](LICENSE)
 
 ## Credits
 
-**Powered by:**
-- AWS SDK for JavaScript
-- Commander.js
-- Chalk (terminal colors)
-- Table (terminal tables)
+**Built with:**
+- [AWS SDK for JavaScript v3](https://aws.amazon.com/sdk-for-javascript/) - AWS cloud APIs
+- [Azure SDK for JavaScript](https://azure.github.io/azure-sdk-for-js/) - Azure cloud APIs
+- [Commander.js](https://github.com/tj/commander.js) - CLI framework
+- [cli-table3](https://github.com/cli-table/cli-table3) - Terminal tables
+- [Chalk](https://github.com/chalk/chalk) - Terminal styling
 
 ---
 
 ## FAQ
 
 **Q: Does this tool make changes to my infrastructure?**  
-A: No. It only reads billing and usage data. It never modifies or deletes resources.
+A: No. It only reads resource metadata and usage metrics. It never modifies or deletes resources.
 
-**Q: What IAM permissions are required?**  
-A: Read-only permissions for Cost Explorer, EC2, EBS, RDS, S3, ELB. See [IAM policy template](docs/iam-policy.json).
+**Q: What permissions are required?**  
+A: Read-only permissions for each cloud provider:
+- **AWS**: EC2, EBS, RDS, S3, ELB, CloudWatch (see [AWS permissions](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html))
+- **Azure**: Reader role on subscription or resource groups
 
 **Q: How accurate are the savings estimates?**  
-A: Estimates are based on current pricing and usage patterns. Actual savings may vary.
+A: Estimates are based on current pricing and usage patterns. Actual savings may vary by region and your specific pricing agreements (Reserved Instances, Savings Plans, etc.).
 
 **Q: Can I run this in CI/CD?**  
-A: Yes. Use `--output json` and fail the build if savings exceed a threshold.
+A: Yes. Use `--output json` and parse the results to fail builds if savings exceed a threshold.
 
 ---
 

package/dist/bin/cloud-cost-cli.js

@@ -11,13 +11,16 @@ program
 program
     .command('scan')
     .description('Scan cloud account for cost savings')
-    .option('--provider <aws|gcp|azure>', 'Cloud provider', 'aws')
-    .option('--region <region>', 'Cloud region (e.g., us-east-1)')
+    .option('--provider <aws|azure>', 'Cloud provider', 'aws')
+    .option('--region <region>', 'AWS region (e.g., us-east-1)')
     .option('--profile <profile>', 'AWS profile name', 'default')
+    .option('--subscription-id <id>', 'Azure subscription ID')
+    .option('--location <location>', 'Azure location filter (e.g., eastus, westus2) - optional, scans all if omitted')
     .option('--top <N>', 'Show top N opportunities', '5')
     .option('--output <table|json|markdown>', 'Output format', 'table')
     .option('--days <N>', 'Analysis period in days', '30')
     .option('--min-savings <amount>', 'Filter by minimum savings ($/month)')
+    .option('--accurate', 'Use real-time pricing from AWS (slower but more accurate)')
     .option('--verbose', 'Verbose logging')
     .action(scan_js_1.scanCommand);
 program.parse();

package/dist/src/analyzers/cost-estimator.d.ts

@@ -13,6 +13,20 @@ export declare const ELB_PRICING: {
     clb: number;
 };
 export declare const EIP_PRICING_HOURLY = 0.005;
+/**
+ * Cost estimator with support for both estimate and accurate modes
+ */
+export declare class CostEstimator {
+    private pricingService?;
+    private useAccuratePricing;
+    constructor(region: string, accurate?: boolean);
+    getEC2MonthlyCost(instanceType: string): Promise<number>;
+    getEBSMonthlyCost(sizeGB: number, volumeType: string): Promise<number>;
+    getRDSMonthlyCost(instanceClass: string, engine?: string): Promise<number>;
+    getS3MonthlyCost(sizeGB: number, storageClass?: string): number;
+    getELBMonthlyCost(type?: 'alb' | 'nlb' | 'clb'): number;
+    getEIPMonthlyCost(): number;
+}
 export declare function getEC2MonthlyCost(instanceType: string): number;
 export declare function getEBSMonthlyCost(sizeGB: number, volumeType: string): number;
 export declare function getRDSMonthlyCost(instanceClass: string): number;

package/dist/src/analyzers/cost-estimator.js

@@ -1,14 +1,15 @@
 "use strict";
-// EC2 instance pricing (us-east-1, Linux, on-demand, monthly estimate)
-// Source: AWS pricing as of 2026-01, monthly = hourly × 730
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EIP_PRICING_HOURLY = exports.ELB_PRICING = exports.S3_PRICING = exports.RDS_PRICING = exports.EBS_PRICING = exports.EC2_PRICING = void 0;
+exports.CostEstimator = exports.EIP_PRICING_HOURLY = exports.ELB_PRICING = exports.S3_PRICING = exports.RDS_PRICING = exports.EBS_PRICING = exports.EC2_PRICING = void 0;
 exports.getEC2MonthlyCost = getEC2MonthlyCost;
 exports.getEBSMonthlyCost = getEBSMonthlyCost;
 exports.getRDSMonthlyCost = getRDSMonthlyCost;
 exports.getS3MonthlyCost = getS3MonthlyCost;
 exports.getELBMonthlyCost = getELBMonthlyCost;
 exports.getEIPMonthlyCost = getEIPMonthlyCost;
+const pricing_service_1 = require("./pricing-service");
+// Fallback pricing estimates (based on us-east-1, Jan 2026)
+// Used when --accurate flag is not set or Pricing API fails
 exports.EC2_PRICING = {
     't2.micro': 8.47,
     't2.small': 16.79,
@@ -28,7 +29,6 @@ exports.EC2_PRICING = {
     'r5.large': 91.25,
     'r5.xlarge': 182.50,
 };
-// EBS pricing (us-east-1, per GB/month)
 exports.EBS_PRICING = {
     gp3: 0.08,
     gp2: 0.10,
@@ -37,7 +37,6 @@ exports.EBS_PRICING = {
     st1: 0.045,
     sc1: 0.015,
 };
-// RDS pricing (us-east-1, per month)
 exports.RDS_PRICING = {
     'db.t3.micro': 11.01,
     'db.t3.small': 22.63,
@@ -49,30 +48,89 @@ exports.RDS_PRICING = {
     'db.r5.xlarge': 350.40,
     'db.r5.2xlarge': 700.80,
 };
-// S3 pricing (per GB/month)
 exports.S3_PRICING = {
     standard: 0.023,
-    intelligentTiering: 0.023, // same base, but auto-transitions
+    intelligentTiering: 0.023,
     glacier: 0.004,
     glacierDeepArchive: 0.00099,
 };
-// ELB pricing (per month, excluding LCU charges)
 exports.ELB_PRICING = {
-    alb: 16.43, // Application Load Balancer
-    nlb: 16.43, // Network Load Balancer
-    clb: 18.25, // Classic Load Balancer
+    alb: 16.43,
+    nlb: 16.43,
+    clb: 18.25,
 };
-// Elastic IP pricing (per hour when not associated)
-exports.EIP_PRICING_HOURLY = 0.005; // ~$3.65/month
+exports.EIP_PRICING_HOURLY = 0.005;
+/**
+ * Cost estimator with support for both estimate and accurate modes
+ */
+class CostEstimator {
+    pricingService;
+    useAccuratePricing;
+    constructor(region, accurate = false) {
+        this.useAccuratePricing = accurate;
+        if (accurate) {
+            this.pricingService = new pricing_service_1.PricingService(region);
+        }
+    }
+    async getEC2MonthlyCost(instanceType) {
+        if (this.useAccuratePricing && this.pricingService) {
+            try {
+                return await this.pricingService.getEC2Price(instanceType);
+            }
+            catch (error) {
+                // Fallback to estimate if API fails
+            }
+        }
+        return exports.EC2_PRICING[instanceType] || 50; // Generic estimate if type unknown
+    }
+    async getEBSMonthlyCost(sizeGB, volumeType) {
+        let pricePerGB;
+        if (this.useAccuratePricing && this.pricingService) {
+            try {
+                pricePerGB = await this.pricingService.getEBSPrice(volumeType);
+            }
+            catch (error) {
+                pricePerGB = exports.EBS_PRICING[volumeType] || 0.08;
+            }
+        }
+        else {
+            pricePerGB = exports.EBS_PRICING[volumeType] || 0.08;
+        }
+        return sizeGB * pricePerGB;
+    }
+    async getRDSMonthlyCost(instanceClass, engine) {
+        if (this.useAccuratePricing && this.pricingService && engine) {
+            try {
+                return await this.pricingService.getRDSPrice(instanceClass, engine);
+            }
+            catch (error) {
+                // Fallback to estimate
+            }
+        }
+        return exports.RDS_PRICING[instanceClass] || 100;
+    }
+    getS3MonthlyCost(sizeGB, storageClass = 'standard') {
+        const pricePerGB = exports.S3_PRICING[storageClass] || exports.S3_PRICING.standard;
+        return sizeGB * pricePerGB;
+    }
+    getELBMonthlyCost(type = 'alb') {
+        return exports.ELB_PRICING[type];
+    }
+    getEIPMonthlyCost() {
+        return exports.EIP_PRICING_HOURLY * 730; // ~$3.65
+    }
+}
+exports.CostEstimator = CostEstimator;
+// Legacy exports for backwards compatibility
 function getEC2MonthlyCost(instanceType) {
-    return exports.EC2_PRICING[instanceType] || 0;
+    return exports.EC2_PRICING[instanceType] || 50;
 }
 function getEBSMonthlyCost(sizeGB, volumeType) {
     const pricePerGB = exports.EBS_PRICING[volumeType] || 0.08;
     return sizeGB * pricePerGB;
 }
 function getRDSMonthlyCost(instanceClass) {
-    return exports.RDS_PRICING[instanceClass] || 0;
+    return exports.RDS_PRICING[instanceClass] || 100;
 }
 function getS3MonthlyCost(sizeGB, storageClass = 'standard') {
     const pricePerGB = exports.S3_PRICING[storageClass] || exports.S3_PRICING.standard;
@@ -82,5 +140,5 @@ function getELBMonthlyCost(type = 'alb') {
     return exports.ELB_PRICING[type];
 }
 function getEIPMonthlyCost() {
-    return exports.EIP_PRICING_HOURLY * 730; // ~$3.65
+    return exports.EIP_PRICING_HOURLY * 730;
 }

package/dist/src/analyzers/pricing-service.d.ts

@@ -0,0 +1,38 @@
+export declare class PricingService {
+    private pricingClient;
+    private region;
+    constructor(region?: string);
+    /**
+     * Get EC2 instance on-demand pricing for the configured region
+     */
+    getEC2Price(instanceType: string): Promise<number>;
+    /**
+     * Get EBS volume pricing per GB
+     */
+    getEBSPrice(volumeType: string): Promise<number>;
+    /**
+     * Get RDS instance pricing
+     */
+    getRDSPrice(instanceClass: string, engine?: string): Promise<number>;
+    /**
+     * Extract price from AWS Pricing API response
+     */
+    private extractPriceFromResponse;
+    /**
+     * Convert AWS region code to location name used in Pricing API
+     */
+    private getLocationName;
+    /**
+     * Normalize RDS engine name for Pricing API
+     */
+    private normalizeEngine;
+    /**
+     * Fallback estimates when API calls fail (based on us-east-1)
+     */
+    private getFallbackEC2Price;
+    private getFallbackEBSPrice;
+    private getFallbackRDSPrice;
+}
+export declare function getS3MonthlyCost(sizeGB: number, storageClass?: string): number;
+export declare function getELBMonthlyCost(type?: 'alb' | 'nlb' | 'clb'): number;
+export declare function getEIPMonthlyCost(): number;