infra-cost 1.2.0 → 1.4.0

package/README.md

@@ -181,6 +181,211 @@ infra-cost free-tier --json                # JSON output
 
 ---
 
+#### `infra-cost annotate` - Cost Annotations for IaC Files (NEW in v1.3.0)
+
+Add cost estimates directly in your Infrastructure as Code files - see costs during code review!
+
+```bash
+# Annotate Terraform files
+infra-cost annotate --path ./terraform/
+
+# Before:
+resource "aws_instance" "web" {
+  instance_type = "t3.xlarge"
+  ami           = "ami-12345678"
+}
+
+# After:
+# 💰 infra-cost: $121.47/month | aws_instance @ us-east-1
+# 💡 Consider t3.large for 50% savings if CPU < 40% (saves $60.74/month)
+# 📊 Last updated: 2026-01-30
+resource "aws_instance" "web" {
+  instance_type = "t3.xlarge"
+  ami           = "ami-12345678"
+}
+```
+
+**Features:**
+- 📝 **Terraform & CloudFormation support** - HCL and YAML annotations
+- 💰 **Monthly cost estimates** - see the cost of each resource
+- 💡 **Optimization suggestions** - inline recommendations for savings
+- 📊 **Auto-update** - keep annotations fresh with --update flag
+- 🧹 **Clean removal** - remove all annotations with --remove
+- 🔍 **Dry run** - preview changes before applying
+
+**Commands:**
+```bash
+# Annotate all Terraform files in a directory
+infra-cost annotate --path ./terraform/
+
+# CloudFormation templates
+infra-cost annotate --path ./cloudformation/ --format cloudformation
+
+# Preview without modifying files
+infra-cost annotate --path ./terraform/ --dry-run
+
+# Update existing annotations
+infra-cost annotate --path ./terraform/ --update
+
+# Remove all cost annotations
+infra-cost annotate --path ./terraform/ --remove
+```
+
+**Perfect for:**
+- Code reviews with cost visibility
+- DevOps engineers writing IaC
+- Cost-aware development culture
+- Pre-commit cost checks
+- Documentation of infrastructure costs
+
+---
+
+#### `infra-cost history` - Git Cost History (NEW in v1.3.0)
+
+Correlate cost changes with git commits - see which code changes impact costs!
+
+```bash
+# Show cost history with git correlation
+infra-cost history --git
+
+# Output:
+# 📊 Cost History with Git Correlation
+# ═══════════════════════════════════════════════════════════
+# Date          Cost        Change      Commit
+# ─────────────────────────────────────────────────────────
+# 2026-01-28    $142.30     +$12.40     abc1234 Add GPU instances
+# 2026-01-27    $129.90     +$45.20     def5678 Deploy new RDS
+# 2026-01-26    $84.70      -$8.30      ghi9012 Cleanup unused EBS
+# 2026-01-25    $93.00      +$3.10      jkl3456 Update Lambda memory
+# ═══════════════════════════════════════════════════════════
+#
+# 🔍 Significant cost changes:
+# • +$45.20 on 2026-01-27: def5678 "Deploy new RDS for analytics"
+# • +$12.40 on 2026-01-28: abc1234 "Add GPU instances for ML"
+
+# Analyze specific commit
+infra-cost history --commit abc1234
+
+# Who caused the most cost changes this month?
+infra-cost blame --period month
+```
+
+**Features:**
+- 📊 **Cost-commit correlation** - see which commits changed costs
+- 👤 **Author attribution** - track cost impact by developer
+- 📈 **Trend analysis** - understand cost evolution over time
+- 🔍 **Commit details** - deep dive into specific commits
+- 📝 **Multiple formats** - text, JSON, markdown output
+- ⚠️ **Significant change alerts** - highlight big cost impacts
+
+**Commands:**
+```bash
+# Show cost history for the past week (default)
+infra-cost history --git
+
+# Show history for different periods
+infra-cost history --period month
+infra-cost history --period quarter
+
+# Filter by author
+infra-cost history --author john@example.com
+
+# Analyze specific commit
+infra-cost history --commit abc1234
+
+# Blame analysis - who impacted costs most?
+infra-cost blame --period month
+
+# Export to JSON for analysis
+infra-cost history --format json > cost-history.json
+```
+
+**Perfect for:**
+- Engineering teams tracking cost accountability
+- Understanding which features drive costs
+- Cost-aware code reviews
+- FinOps culture and awareness
+- Retrospectives on cost trends
+
+---
+
+#### `infra-cost terraform` - Terraform Cost Preview (NEW in v1.4.0)
+
+**Estimate infrastructure costs BEFORE deploying - shift-left cost management!**
+
+```bash
+# Generate terraform plan and estimate costs
+terraform plan -out=tfplan
+infra-cost terraform --plan tfplan
+
+# Output:
+# ╭─────────────────────────────────────────────────────────────╮
+# │             Terraform Cost Estimate                         │
+# ├─────────────────────────────────────────────────────────────┤
+# │ Resources to CREATE:                                        │
+# │ ───────────────────────────────────────────────────────────│
+# │ + aws_instance.web_server (t3.xlarge)                       │
+# │   └── Monthly: $121.47 | Hourly: $0.1664                   │
+# │ + aws_db_instance.primary (db.r5.large, 100GB gp2)          │
+# │   └── Monthly: $182.80 | Hourly: $0.25                     │
+# ├─────────────────────────────────────────────────────────────┤
+# │ Resources to MODIFY:                                        │
+# │ ───────────────────────────────────────────────────────────│
+# │ ~ aws_instance.api_server                                   │
+# │   └── t3.medium → t3.large: +$30.37/month                  │
+# ├─────────────────────────────────────────────────────────────┤
+# │ Resources to DESTROY:                                       │
+# │ ───────────────────────────────────────────────────────────│
+# │ - aws_instance.old_server                                   │
+# │   └── Savings: -$60.74/month                               │
+# ├─────────────────────────────────────────────────────────────┤
+# │ SUMMARY                                                     │
+# │ ───────────────────────────────────────────────────────────│
+# │ Current Monthly Cost:     $1,240.50                         │
+# │ Estimated New Cost:       $1,520.83                         │
+# │ Difference:               +$280.33/month (+22.6%)          │
+# │                                                             │
+# │ ⚠️  Cost increase exceeds 20% threshold!                    │
+# ╰─────────────────────────────────────────────────────────────╯
+```
+
+**Usage Examples:**
+
+```bash
+# Basic cost estimate
+terraform plan -out=tfplan
+infra-cost terraform --plan tfplan
+
+# With cost threshold (fail if > 20% change)
+infra-cost terraform --plan tfplan --threshold 20
+
+# JSON format for automation
+infra-cost terraform --plan tfplan --output json
+
+# From JSON plan
+terraform show -json tfplan > tfplan.json
+infra-cost terraform --plan tfplan.json
+```
+
+**Supported Resources:**
+- ✅ EC2 instances (all types)
+- ✅ RDS instances with storage
+- ✅ EBS volumes (gp2, gp3, io1, io2, st1, sc1)
+- ✅ Load Balancers (ALB, NLB, CLB)
+- ✅ NAT Gateways
+- ✅ ElastiCache clusters
+- ✅ S3 buckets (estimated)
+- ✅ Lambda functions (estimated)
+
+**Perfect for:**
+- CI/CD cost gates
+- Preventing expensive deployments
+- Cost-aware infrastructure changes
+- Shift-left FinOps culture
+- Pre-deployment cost reviews
+
+---
+
 ### Command Migration Table
 
 | Command Usage | Old Command (v0.x) | New Command (v1.0) |
@@ -511,15 +716,49 @@ infra-cost export inventory pdf
 infra-cost cost analyze --output json
 ```
 
-### Interactive Dashboard
+### Interactive TUI Dashboard
+
+**Real-time cost monitoring with keyboard navigation**
+
 ```bash
-# Launch interactive terminal dashboard
+# Launch interactive TUI dashboard (shortcut)
+infra-cost dashboard
+
+# Or explicitly
 infra-cost dashboard interactive
 
+# Custom refresh interval (default: 60 seconds)
+infra-cost dashboard --refresh 30
+
 # Multi-cloud dashboard
 infra-cost dashboard multicloud
 ```
 
+**Features:**
+- 🎨 Beautiful terminal UI with real-time updates
+- ⌨️ Full keyboard navigation (vim-style supported)
+- 📊 Multiple views: Services, Resources, Trends, Alerts
+- 📈 Live trend indicators (↗ up, ↘ down, → stable)
+- 🔔 Real-time alert notifications
+- 🔄 Auto-refresh with configurable intervals
+- 🎯 Drill-down into services and resources
+
+**Keyboard Shortcuts:**
+```
+q       - Quit
+r       - Refresh data
+↑↓/jk   - Navigate rows
+←→/hl   - Switch tabs
+1-4     - Quick tab switch
+?       - Help
+```
+
+**Perfect for:**
+- DevOps engineers monitoring costs in terminal
+- SREs with terminal-based workflows
+- Real-time cost exploration
+- Server environments without GUI
+
 ## 💬 Slack Integration
 
 ### Enhanced Team Collaboration
@@ -557,48 +796,71 @@ jobs:
             --slack-channel ${{ secrets.SLACK_CHANNEL }}
 ```
 
-## 🤖 GitHub Actions Integration
+## 🤖 GitHub Actions Integration (v1.4.0+)
 
-**infra-cost** is available as a GitHub Action on the [GitHub Marketplace](https://github.com/marketplace/actions/infra-cost-multi-cloud-finops-analysis), making it easy to integrate cost analysis into your CI/CD workflows.
+**infra-cost** is available as a GitHub Action, making it easy to integrate cost analysis into your CI/CD workflows with cost gates and automated PR comments.
 
-### Basic Usage
+### Quick Cost Check
 ```yaml
 name: Cost Analysis
-on: [push, pull_request]
+on: [pull_request]
 
 jobs:
-  analyze:
+  cost-check:
     runs-on: ubuntu-latest
     steps:
-      - uses: codecollab-co/infra-cost@v0.3.0
+      - uses: actions/checkout@v4
+      - uses: codecollab-co/infra-cost@v1.4.0
         with:
           provider: aws
-          aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
-          aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
-          analysis-type: summary
+          command: now
+          comment-on-pr: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 ```
 
-### PR Cost Check with Comments
+### Cost Gate - Fail on Increase
 ```yaml
-name: PR Cost Check
-on:
-  pull_request:
-    branches: [main]
+name: Cost Gate
+on: pull_request
 
 jobs:
-  cost-check:
+  cost-gate:
     runs-on: ubuntu-latest
-    permissions:
-      pull-requests: write
     steps:
-      - uses: codecollab-co/infra-cost@v0.3.0
+      - uses: actions/checkout@v4
+      - uses: codecollab-co/infra-cost@v1.4.0
         with:
           provider: aws
-          aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
-          aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
-          analysis-type: delta
-          delta-threshold: '10'
-          comment-on-pr: 'true'
+          command: now
+          fail-on-increase: true  # Fail if ANY cost increase
+          cost-threshold: 1000     # Fail if monthly cost exceeds $1000
+          comment-on-pr: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+
+### Terraform Cost Preview (Shift-Left)
+```yaml
+name: Terraform Cost Check
+on: pull_request
+
+jobs:
+  terraform-cost:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Terraform Plan
+        run: terraform plan -out=tfplan
+
+      - name: Cost Estimate
+        uses: codecollab-co/infra-cost@v1.4.0
+        with:
+          command: terraform
+          additional-args: '--plan tfplan --threshold 20'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 ```
 
 ### Daily Cost Report to Slack
@@ -878,6 +1140,47 @@ src/
   - Approval workflows
   - Related: Issue #42 (Scheduled Reports), Issue #49 (API Server)
 
+### Q2 2026 (v1.3.0 - Phase 2 Complete)
+
+**Priority: Developer Experience & IDE Integration**
+- ✅ **Interactive TUI Dashboard** (Issue #43)
+  - React Ink-based terminal UI
+  - Real-time cost monitoring with keyboard navigation
+  - Multiple views: Services, Resources, Trends, Alerts
+- ✅ **Cost Annotations for IaC Files** (Issue #54)
+  - Terraform and CloudFormation cost comments
+  - Inline optimization suggestions
+  - Update/remove annotations
+- ✅ **Git Cost History** (Issue #56)
+  - Cost-commit correlation
+  - Blame analysis by author
+  - Historical trend analysis
+- 🔮 **VS Code Extension** (Issue #55 - Planned)
+  - Inline cost display for Terraform/CloudFormation
+  - Sidebar panel with cost summaries
+  - CodeLens integration
+  - Hover information with alternatives
+  - **Note:** VS Code extension will be a separate repository
+  - Integration points with CLI for cost data
+
+### Q2 2026 (v1.4.0 - Phase 3: CI/CD & Shift-Left)
+
+**Priority: CI/CD Integration & Shift-Left Cost Management**
+- ✅ **GitHub Actions Integration** (Issue #46)
+  - Native GitHub Action for cost analysis in PRs
+  - Cost gates with fail-on-increase and threshold checks
+  - Enhanced PR comments with cost breakdown
+  - Multiple output variables for downstream jobs
+  - Slack notification support
+- ✅ **Terraform Cost Preview** (Issue #47)
+  - Parse terraform plan files (binary and JSON)
+  - Estimate costs before deployment
+  - Show create/modify/destroy breakdown
+  - Cost threshold gates for CI/CD
+  - Support for EC2, RDS, EBS, Load Balancers, and more
+  - Monthly and hourly cost estimates
+  - Shift-left cost management
+
 ### Q3 2026 (Planned)
 
 **Priority: Enterprise Features**