@build-astron-co/nimbus 0.2.0 → 0.4.0

package/dist/src/commands/cost/cloud-cost-estimator.js

@@ -0,0 +1,211 @@
+/**
+ * Cloud Cost Estimator
+ *
+ * Provides cost estimates for live cloud operations (EC2 start, RDS create,
+ * EKS create, etc.) so users see a cost warning before committing to
+ * billable actions.
+ *
+ * Pricing data is a simple static lookup table based on on-demand, us-east-1
+ * list prices.  Monthly = hourly * 730.  The goal is user awareness, not
+ * exact billing.
+ */
+// Hours in a standard AWS billing month
+const HOURS_PER_MONTH = 730;
+// ------------------------------------------------------------------
+// EC2 instance hourly pricing (on-demand, us-east-1, Linux)
+// ------------------------------------------------------------------
+const EC2_HOURLY = {
+    // T3 burstable
+    't3.nano': 0.0052,
+    't3.micro': 0.0104,
+    't3.small': 0.0208,
+    't3.medium': 0.0416,
+    't3.large': 0.0832,
+    't3.xlarge': 0.1664,
+    't3.2xlarge': 0.3328,
+    // T3a (AMD)
+    't3a.nano': 0.0047,
+    't3a.micro': 0.0094,
+    't3a.small': 0.0188,
+    't3a.medium': 0.0376,
+    't3a.large': 0.0752,
+    't3a.xlarge': 0.1504,
+    // T2 burstable
+    't2.nano': 0.0058,
+    't2.micro': 0.0116,
+    't2.small': 0.023,
+    't2.medium': 0.0464,
+    't2.large': 0.0928,
+    't2.xlarge': 0.1856,
+    't2.2xlarge': 0.3712,
+    // M5 general purpose
+    'm5.large': 0.096,
+    'm5.xlarge': 0.192,
+    'm5.2xlarge': 0.384,
+    'm5.4xlarge': 0.768,
+    // M6i general purpose
+    'm6i.large': 0.096,
+    'm6i.xlarge': 0.192,
+    'm6i.2xlarge': 0.384,
+    // C5 compute optimized
+    'c5.large': 0.085,
+    'c5.xlarge': 0.17,
+    'c5.2xlarge': 0.34,
+    'c5.4xlarge': 0.68,
+    // R5 memory optimized
+    'r5.large': 0.126,
+    'r5.xlarge': 0.252,
+    'r5.2xlarge': 0.504,
+    // GPU
+    'p3.2xlarge': 3.06,
+    'g4dn.xlarge': 0.526,
+    'g4dn.2xlarge': 0.752,
+};
+// ------------------------------------------------------------------
+// RDS instance hourly pricing (on-demand, us-east-1, Single-AZ)
+// ------------------------------------------------------------------
+const RDS_HOURLY = {
+    'db.t3.micro': 0.017,
+    'db.t3.small': 0.034,
+    'db.t3.medium': 0.068,
+    'db.t3.large': 0.136,
+    'db.t3.xlarge': 0.272,
+    'db.t4g.micro': 0.016,
+    'db.t4g.small': 0.032,
+    'db.t4g.medium': 0.065,
+    'db.m5.large': 0.171,
+    'db.m5.xlarge': 0.342,
+    'db.m5.2xlarge': 0.684,
+    'db.m6i.large': 0.171,
+    'db.m6i.xlarge': 0.342,
+    'db.r5.large': 0.24,
+    'db.r5.xlarge': 0.48,
+    'db.r5.2xlarge': 0.96,
+    'db.r6i.large': 0.24,
+    'db.r6i.xlarge': 0.48,
+};
+// ------------------------------------------------------------------
+// Fixed hourly rates for managed services
+// ------------------------------------------------------------------
+const MANAGED_SERVICE_HOURLY = {
+    'eks-cluster': 0.1,
+    'nat-gateway': 0.045,
+    alb: 0.0225,
+    nlb: 0.0225,
+    'vpn-gateway': 0.05,
+    'elasticache-t3-medium': 0.068,
+    'redshift-dc2-large': 0.25,
+};
+// ------------------------------------------------------------------
+// Main estimation function
+// ------------------------------------------------------------------
+/**
+ * Estimate the cost of a cloud operation.
+ *
+ * Returns null if the operation or resource type is not recognized.
+ */
+export function estimateCloudCost(operation, params = {}) {
+    const count = params.count ?? 1;
+    switch (operation) {
+        case 'ec2:StartInstances':
+        case 'ec2:RunInstances': {
+            const type = params.instanceType || 't3.medium';
+            const hourlyPerUnit = EC2_HOURLY[type];
+            if (hourlyPerUnit === undefined) {
+                // Unknown type -- provide a generic estimate with a caveat
+                return {
+                    hourly: 0.0416 * count,
+                    monthly: 0.0416 * HOURS_PER_MONTH * count,
+                    description: `EC2 ${type} x${count} (pricing unavailable, using t3.medium estimate)`,
+                };
+            }
+            const hourly = hourlyPerUnit * count;
+            return {
+                hourly,
+                monthly: hourly * HOURS_PER_MONTH,
+                description: `EC2 ${type}${count > 1 ? ` x${count}` : ''} on-demand`,
+            };
+        }
+        case 'rds:StartDBInstance':
+        case 'rds:CreateDBInstance': {
+            const cls = params.instanceClass || 'db.t3.medium';
+            const hourlyPerUnit = RDS_HOURLY[cls];
+            const multiAzMultiplier = params.multiAz ? 2 : 1;
+            if (hourlyPerUnit === undefined) {
+                const fallback = 0.068; // db.t3.medium default
+                const hourly = fallback * multiAzMultiplier * count;
+                return {
+                    hourly,
+                    monthly: hourly * HOURS_PER_MONTH,
+                    description: `RDS ${cls}${params.multiAz ? ' Multi-AZ' : ''}${count > 1 ? ` x${count}` : ''} (pricing unavailable, using db.t3.medium estimate)`,
+                };
+            }
+            const hourly = hourlyPerUnit * multiAzMultiplier * count;
+            return {
+                hourly,
+                monthly: hourly * HOURS_PER_MONTH,
+                description: `RDS ${cls}${params.multiAz ? ' Multi-AZ' : ''}${count > 1 ? ` x${count}` : ''} on-demand`,
+            };
+        }
+        case 'eks:CreateCluster': {
+            const hourly = MANAGED_SERVICE_HOURLY['eks-cluster'] * count;
+            return {
+                hourly,
+                monthly: hourly * HOURS_PER_MONTH,
+                description: `EKS cluster control plane${count > 1 ? ` x${count}` : ''} ($0.10/hr fixed)`,
+            };
+        }
+        case 'natgateway:Create': {
+            const hourly = MANAGED_SERVICE_HOURLY['nat-gateway'] * count;
+            return {
+                hourly,
+                monthly: hourly * HOURS_PER_MONTH,
+                description: `NAT Gateway${count > 1 ? ` x${count}` : ''} ($0.045/hr + data processing charges)`,
+            };
+        }
+        case 'alb:Create': {
+            const hourly = MANAGED_SERVICE_HOURLY['alb'] * count;
+            return {
+                hourly,
+                monthly: hourly * HOURS_PER_MONTH,
+                description: `Application Load Balancer${count > 1 ? ` x${count}` : ''} ($0.0225/hr + LCU charges)`,
+            };
+        }
+        case 'nlb:Create': {
+            const hourly = MANAGED_SERVICE_HOURLY['nlb'] * count;
+            return {
+                hourly,
+                monthly: hourly * HOURS_PER_MONTH,
+                description: `Network Load Balancer${count > 1 ? ` x${count}` : ''} ($0.0225/hr + LCU charges)`,
+            };
+        }
+        default:
+            return null;
+    }
+}
+// ------------------------------------------------------------------
+// Display helpers
+// ------------------------------------------------------------------
+/**
+ * Format a cost estimate into a human-readable warning string.
+ *
+ * Example output:
+ *   "Estimated cost: ~$0.04/hour ($30.37/month) - EC2 t3.medium on-demand"
+ */
+export function formatCostWarning(estimate) {
+    const hourly = estimate.hourly < 0.01 ? `$${estimate.hourly.toFixed(4)}` : `$${estimate.hourly.toFixed(2)}`;
+    const monthly = `$${estimate.monthly.toFixed(2)}`;
+    return `Estimated cost: ~${hourly}/hour (${monthly}/month) - ${estimate.description}`;
+}
+/**
+ * Resolve an EC2 instance type to its hourly cost, or undefined if unknown.
+ */
+export function getEC2HourlyCost(instanceType) {
+    return EC2_HOURLY[instanceType];
+}
+/**
+ * Resolve an RDS instance class to its hourly cost, or undefined if unknown.
+ */
+export function getRDSHourlyCost(instanceClass) {
+    return RDS_HOURLY[instanceClass];
+}

package/dist/src/commands/cost/estimator.js

@@ -0,0 +1,73 @@
+/**
+ * Built-in Cost Estimator
+ *
+ * Parses Terraform .tf files and estimates costs using a static pricing
+ * lookup table. This provides quick, offline cost estimates without
+ * requiring external tools like Infracost.
+ *
+ * For more accurate, real-time pricing, install Infracost.
+ */
+import { TerraformParser } from './parsers/terraform';
+import { getResourcePrice } from './pricing';
+export class CostEstimator {
+    /**
+     * Estimate costs for a directory containing Terraform files.
+     *
+     * Reads all .tf files in the given directory, parses resource blocks,
+     * and looks up estimated pricing for each recognized resource type.
+     */
+    static async estimateDirectory(directory) {
+        const parser = new TerraformParser();
+        const resources = await parser.parseDirectory(directory);
+        const costResources = [];
+        const unsupportedTypes = {};
+        for (const resource of resources) {
+            const pricing = getResourcePrice(resource);
+            if (pricing) {
+                costResources.push({
+                    name: `${resource.type}.${resource.name}`,
+                    resourceType: resource.type,
+                    monthlyCost: pricing.monthlyCost,
+                    hourlyCost: pricing.hourlyCost,
+                    monthlyQuantity: pricing.quantity,
+                    unit: pricing.unit,
+                });
+            }
+            else {
+                unsupportedTypes[resource.type] = (unsupportedTypes[resource.type] || 0) + 1;
+            }
+        }
+        const totalMonthlyCost = costResources.reduce((sum, r) => sum + r.monthlyCost, 0);
+        const totalHourlyCost = costResources.reduce((sum, r) => sum + (r.hourlyCost || 0), 0);
+        return {
+            version: '0.2',
+            currency: 'USD',
+            projects: [
+                {
+                    name: directory.split('/').pop() || 'project',
+                    metadata: { source: 'nimbus-builtin' },
+                    pastTotalMonthlyCost: 0,
+                    pastTotalHourlyCost: 0,
+                    diffTotalMonthlyCost: 0,
+                    diffTotalHourlyCost: 0,
+                    totalMonthlyCost,
+                    totalHourlyCost,
+                    resources: costResources,
+                },
+            ],
+            totalMonthlyCost,
+            totalHourlyCost,
+            diffTotalMonthlyCost: 0,
+            timeGenerated: new Date().toISOString(),
+            summary: {
+                totalDetectedResources: resources.length,
+                totalSupportedResources: costResources.length,
+                totalUnsupportedResources: Object.values(unsupportedTypes).reduce((s, c) => s + c, 0),
+                totalUsageBasedResources: 0,
+                totalNoPriceResources: 0,
+                unsupportedResourceCounts: unsupportedTypes,
+                noPriceResourceCounts: {},
+            },
+        };
+    }
+}