infra-cost 1.2.0 → 1.3.0

package/README.md

@@ -181,6 +181,134 @@ 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
+
+---
+
 ### Command Migration Table
 
 | Command Usage | Old Command (v0.x) | New Command (v1.0) |
@@ -511,15 +639,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
@@ -878,6 +1040,29 @@ 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
+
 ### Q3 2026 (Planned)
 
 **Priority: Enterprise Features**