infra-cost 0.3.0 → 0.3.2

package/README.md

@@ -4,7 +4,7 @@
 
 **Multi-cloud FinOps CLI tool for comprehensive cost analysis and infrastructure optimization**
 
-[![npm version](https://badge.fury.io/js/infra-cost.svg)](https://badge.fury.io/js/infra-cost)
+[![npm version](https://badge.fury.io/js/infra-cost.svg)](https://badge.fury.io/js/infra-cost.svg)
 [![Downloads](https://img.shields.io/npm/dm/infra-cost.svg)](https://npmjs.org/package/infra-cost)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![GitHub issues](https://img.shields.io/github/issues/codecollab-co/infra-cost)](https://github.com/codecollab-co/infra-cost/issues)
@@ -85,6 +85,15 @@ npx infra-cost
 docker run --rm codecollab-co/infra-cost --help
 ```
 
+### GitHub Action
+```yaml
+- uses: codecollab-co/infra-cost@v0.3.0
+  with:
+    provider: aws
+    aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
+    aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
+```
+
 ## 🎯 Quick Start
 
 ### 1. Basic AWS Cost Analysis
@@ -230,6 +239,99 @@ jobs:
             --smart-alerts --trends 7
 ```
 
+## 🤖 GitHub Actions Integration
+
+**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.
+
+### Basic Usage
+```yaml
+name: Cost Analysis
+on: [push, pull_request]
+
+jobs:
+  analyze:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: codecollab-co/infra-cost@v0.3.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
+```
+
+### PR Cost Check with Comments
+```yaml
+name: PR Cost Check
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  cost-check:
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
+    steps:
+      - uses: codecollab-co/infra-cost@v0.3.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'
+```
+
+### Daily Cost Report to Slack
+```yaml
+name: Daily Cost Report
+on:
+  schedule:
+    - cron: '0 9 * * *'
+
+jobs:
+  report:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: codecollab-co/infra-cost@v0.3.0
+        with:
+          provider: aws
+          aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
+          aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
+          analysis-type: finops
+          slack-webhook: ${{ secrets.SLACK_WEBHOOK }}
+```
+
+### Action Inputs
+
+| Input | Description | Default |
+|-------|-------------|---------|
+| `provider` | Cloud provider (aws, gcp, azure, alicloud, oracle) | `aws` |
+| `profile` | Cloud provider profile | `default` |
+| `region` | Cloud provider region | `us-east-1` |
+| `aws-access-key-id` | AWS Access Key ID | - |
+| `aws-secret-access-key` | AWS Secret Access Key | - |
+| `analysis-type` | Type of analysis (summary, detailed, delta, forecast, anomaly, finops, audit) | `summary` |
+| `forecast-days` | Days for forecast | `30` |
+| `delta-threshold` | Alert threshold for cost changes (%) | `10` |
+| `output-format` | Output format (text, json) | `text` |
+| `slack-webhook` | Slack webhook URL | - |
+| `comment-on-pr` | Post analysis as PR comment | `false` |
+| `fail-on-threshold` | Fail if costs exceed threshold | `false` |
+
+### Action Outputs
+
+| Output | Description |
+|--------|-------------|
+| `total-cost` | Total cost for the analysis period |
+| `cost-change` | Cost change percentage |
+| `forecast-cost` | Forecasted cost |
+| `anomalies-detected` | Number of anomalies detected |
+| `report-json` | Full report in JSON format |
+
+See [example workflows](.github/workflows/examples/) for more use cases.
+
 ## 🔧 Advanced Usage
 
 ### Cost Forecasting & Analytics
@@ -340,7 +442,7 @@ src/
 ```
 
 ### System Requirements
-- Node.js 16+ (recommended: 18+)
+- Node.js 20+ (required)
 - Memory: 512MB+ available
 - Network: Internet access for cloud provider APIs
 - Optional: Docker for containerized deployments
@@ -457,7 +559,14 @@ MIT © [Code Collab](https://github.com/codecollab-co)
 
 ## 🔄 Changelog
 
-### v0.2.4 - Latest Release
+### v0.3.0 - Latest Release
+- ✅ **GitHub Marketplace Action** - Integrate cost analysis into CI/CD workflows
+- ✅ **Node.js 20+ support** - Updated runtime requirements
+- ✅ **Sprint 6 UX improvements** - Enhanced user experience
+- ✅ **Configuration improvements** - Better config resolution and file permissions
+- ✅ **Date normalization** - Consistent UTC date handling
+
+### v0.2.4
 - ✅ **Fixed CommonJS compatibility** - Homebrew installation now works perfectly
 - ✅ **Enhanced error handling** and user experience improvements
 - ✅ **Optimized build process** for better performance
@@ -483,4 +592,4 @@ This tool evolved from `aws-cost-cli` with full backward compatibility. Both `in
 
 [⭐ Star us on GitHub](https://github.com/codecollab-co/infra-cost) • [🐦 Follow on Twitter](https://twitter.com/codecollabco) • [💼 LinkedIn](https://linkedin.com/company/codecollab-co)
 
-</div>
+</div>