stackharbinger 0.3.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0625ffb650537306abc4297407d0373c204c69412c7610254488c1006461bbcc
-  data.tar.gz: 65106dadaa487141d44e7772c57d9b0c59e18ab478517f0e94cad1440b8ab8b4
+  metadata.gz: 1d46315e9aab151406a3993d75a034eaf28f16d1ce92f44b6344438ba8b9c482
+  data.tar.gz: b4d3c35c6578600ed85d1a387b1cfe13ce5873c256dce6d20267c0366e329052
 SHA512:
-  metadata.gz: 3922e4f871e0782ebf821ef3e01f91aebba249c908f81a3b8f94e550d0d7d68a8525118d61f78b326b801aeecb801fbd89f975b48c2c95bbafd12c7703ebcf7a
-  data.tar.gz: c50866bca2f2b69d995d01735d62da1cb44f436aa546e5a069d7f8b50b8d25e63d95969f4df85ed008cd7d893a7e8d92959efe12e29e7834199f7322455a9cb9
+  metadata.gz: a6d586f4ccc611050bff15516e5ce10601b21b530c51a899742dd8fb8a167cb2d297d0d182fb3a4536b78d85db09b084c25c646fbf3249fd1120125a614aa50b
+  data.tar.gz: a1a0aa1900b07a3be28862e6ad4e3196e05735dc338c22ed592f6ad6d3af6d925764b0c2d957a96fa3d48b9f995e500edcfbb932897237a1a4c44e8bd1d16228

data/README.md

@@ -2,17 +2,19 @@
 
 **Track End-of-Life dates for your tech stack and stay ahead of deprecations.**
 
-Harbinger is a CLI tool that scans your Ruby, Rails, PostgreSQL, and MySQL versions, and warns you about upcoming EOL (End-of-Life) dates. Never get caught off-guard by unsupported dependencies again.
+Harbinger is a CLI tool that scans your Ruby, Rails, Python, Node.js, Rust, Go, PostgreSQL, MySQL, Redis, and MongoDB versions, and warns you about upcoming EOL (End-of-Life) dates. Never get caught off-guard by unsupported dependencies again.
 
 ## Features
 
-- 🔍 **Auto-detects versions** from `.ruby-version`, `Gemfile`, `Gemfile.lock`, and `config/database.yml`
-- 🐘 **Database detection** for PostgreSQL and MySQL (mysql2/trilogy adapters)
+- 🔍 **Auto-detects versions** from `.ruby-version`, `Gemfile`, `Gemfile.lock`, `.nvmrc`, `.python-version`, `pyproject.toml`, `package.json`, `rust-toolchain`, `Cargo.toml`, `go.mod`, `config/database.yml`, and `docker-compose.yml`
+- 🐘 **Database detection** for PostgreSQL, MySQL, Redis, and MongoDB
+- 🌐 **Multi-language support** - Ruby, Python, Node.js, Rust, Go
+- 📊 **Ecosystem-grouped dashboard** - Projects organized by language ecosystem with relevant components only
 - 📅 **Fetches EOL data** from [endoflife.date](https://endoflife.date)
 - 🎨 **Color-coded warnings** (red: already EOL, yellow: <6 months, green: safe)
 - ⚡ **Smart caching** (24-hour cache, works offline after first fetch)
-- 📊 **Track multiple projects** with `--save` and view dashboard with `harbinger show`
 - 🔄 **Bulk operations** with `--recursive` scan and `rescan` command
+- 📤 **Export to JSON/CSV** for reporting and automation
 - 🚀 **Zero configuration** - just run `harbinger scan`
 
 ## Installation
@@ -86,23 +88,72 @@ PostgreSQL 16.11:
 ```bash
 # Show dashboard of all tracked projects
 harbinger show
+
+# Filter to specific project(s) by name or path
+harbinger show budget
+harbinger show job
+
+# Show project paths with verbose mode
+harbinger show -v
+harbinger show job --verbose
+```
+
+### Export data
+
+```bash
+# Export to JSON (stdout)
+harbinger show --format json
+
+# Export to CSV (stdout)
+harbinger show --format csv
+
+# Save to file
+harbinger show --format json -o report.json
+harbinger show --format csv --output eol-report.csv
+
+# Export filtered projects
+harbinger show myproject --format json
 ```
 
 **Example output:**
 
 ```
-Tracked Projects (10)
+Tracked Projects (12)
+
+Ruby Ecosystem (7)
+================================================================================
+┌─────────────────┬───────┬──────────┬────────────┬───────┬─────────────────┐
+│ Project         │ Ruby  │ Rails    │ PostgreSQL │ Redis │ Status          │
+├─────────────────┼───────┼──────────┼────────────┼───────┼─────────────────┤
+│ shop-api        │ 3.2.0 │ 6.1.7    │ 15.0       │ -     │ ✗ Rails EOL     │
+│ blog-engine     │ 3.3.0 │ 7.0.8    │ 16.0       │ 7.0   │ ✗ Rails EOL     │
+│ analytics-app   │ 3.3.0 │ 8.0.1    │ 16.0       │ -     │ ✓ Current       │
+│ admin-portal    │ 3.3.0 │ 8.0.4    │ 16.11      │ 7.2   │ ✓ Current       │
+│ billing-service │ 3.4.1 │ 8.1.0    │ 17.0       │ -     │ ✓ Current       │
+└─────────────────┴───────┴──────────┴────────────┴───────┴─────────────────┘
+
+Python Ecosystem (3)
+================================================================================
+┌──────────────┬────────┬────────────┬─────────┐
+│ Project      │ Python │ PostgreSQL │ Status  │
+├──────────────┼────────┼────────────┼─────────┤
+│ ml-pipeline  │ 3.11   │ 16.0       │ ✓ Current │
+│ data-scraper │ 3.12   │ -          │ ✓ Current │
+│ ai-worker    │ 3.13   │ 15.0       │ ✓ Current │
+└──────────────┴────────┴────────────┴─────────┘
+
+Node.js Ecosystem (2)
 ================================================================================
-┌───────────────────┬───────┬──────────┬────────────┬───────┬─────────────┐
-│ Project           │ Ruby  │ Rails    │ PostgreSQL │ MySQL │ Status      │
-├───────────────────┼───────┼──────────┼────────────┼───────┼─────────────┤
-│ ledger            │ 3.3.0 │ 6.1.7.10 │ -          │ -     │ ✗ Rails EOL │
-│ option_tracker    │ 3.3.0 │ 7.0.8.7  │ -          │ -     │ ✗ Rails EOL │
-│ CarCal            │ -     │ 8.0.2    │ -          │ -     │ ✓ Current   │
-│ job_tracker       │ 3.3.0 │ 8.0.4    │ 16.11      │ -     │ ✓ Current   │
-└───────────────────┴───────┴──────────┴────────────┴───────┴─────────────┘
+┌───────────────┬─────────┬────────────┬──────────────────────┐
+│ Project       │ Node.js │ PostgreSQL │ Status               │
+├───────────────┼─────────┼────────────┼──────────────────────┤
+│ frontend-app  │ 18.0    │ -          │ ⚠ Node.js ending soon │
+│ realtime-api  │ 22.0    │ 16.0       │ ✓ Current            │
+└───────────────┴─────────┴────────────┴──────────────────────┘
 ```
 
+Projects are grouped by their primary programming language ecosystem. Each ecosystem only displays relevant components (e.g., Python projects don't show Ruby/Rails columns).
+
 ### Re-scan all tracked projects
 
 ```bash
@@ -113,6 +164,13 @@ harbinger rescan
 harbinger rescan --verbose
 ```
 
+### Remove a project
+
+```bash
+# Remove a project from tracking
+harbinger remove my-project
+```
+
 ### Update EOL data
 
 ```bash
@@ -131,8 +189,14 @@ harbinger version
 1. **Detection**: Harbinger looks for version info in your project:
    - Ruby: `.ruby-version`, `Gemfile` (`ruby "x.x.x"`), `Gemfile.lock` (RUBY VERSION)
    - Rails: `Gemfile.lock` (rails gem)
+   - Python: `.python-version`, `pyproject.toml`, `docker-compose.yml`, or `python --version`
+   - Node.js: `.nvmrc`, `.node-version`, `package.json` engines, `docker-compose.yml`, or `node --version`
+   - Rust: `rust-toolchain`, `rust-toolchain.toml`, `Cargo.toml` (rust-version), `docker-compose.yml`, or `rustc --version`
+   - Go: `go.mod`, `go.work`, `.go-version`, `docker-compose.yml`, or `go version`
    - PostgreSQL: `config/database.yml` (adapter check) + `psql --version` or `pg` gem
    - MySQL: `config/database.yml` (mysql2/trilogy adapter) + `mysql --version` or gem version
+   - Redis: `docker-compose.yml` + `redis-server --version` or `redis` gem
+   - MongoDB: `docker-compose.yml` + `mongod --version` or `mongoid`/`mongo` gem
 
 2. **EOL Data**: Fetches official EOL dates from [endoflife.date](https://endoflife.date) API
 
@@ -173,6 +237,53 @@ Parses `Gemfile.lock` for the rails gem version.
 
 **Supported adapters**: `mysql2` (traditional) and `trilogy` (Rails 7.1+)
 
+### Redis Detection
+
+1. Checks `docker-compose.yml` for redis image with version tag
+2. Tries `redis-server --version` for local installations
+3. Falls back to `redis` gem version from `Gemfile.lock`
+
+### MongoDB Detection
+
+1. Checks `docker-compose.yml` for mongo image with version tag
+2. Tries `mongod --version` for local installations
+3. Falls back to `mongoid` or `mongo` gem version from `Gemfile.lock`
+
+### Python Detection
+
+1. `.python-version` file (highest priority)
+2. `pyproject.toml` (`requires-python` field)
+3. Docker Compose `python:*` images
+4. `python --version` for system installation
+
+### Node.js Detection
+
+1. `.nvmrc` or `.node-version` files (highest priority - explicit version specification)
+2. `package.json` `engines.node` field (e.g., ">=18.0.0")
+3. Docker Compose `node:*` images
+4. `node --version` for system installation
+
+**Version Normalization**: Handles constraint operators (`>=`, `^`, `~`), LTS names (`lts/hydrogen`), and version ranges
+
+### Rust Detection
+
+1. `rust-toolchain` or `rust-toolchain.toml` files (highest priority - explicit toolchain specification)
+2. `Cargo.toml` `rust-version` field (MSRV - Minimum Supported Rust Version)
+3. Docker Compose `rust:*` images
+4. `rustc --version` for system installation (only when Rust project files exist)
+
+**Note:** Symbolic channels like "stable", "beta", "nightly" are skipped as they don't provide specific versions.
+
+### Go Detection
+
+1. `go.mod` file (highest priority - standard Go module version specification)
+2. `go.work` file (Go workspace format)
+3. `.go-version` file
+4. Docker Compose `golang:*` images
+5. `go version` for system installation (only when Go project files exist)
+
+**Note:** Shell fallback only executes when Go project files are detected, preventing unnecessary command execution.
+
 ## Requirements
 
 - Ruby >= 3.1.0
@@ -197,30 +308,27 @@ bundle exec exe/harbinger scan .
 
 ## Roadmap
 
-### V0.3.0 - Current
-- ✅ PostgreSQL version detection with local/remote database handling
-- ✅ MySQL version detection (mysql2 and trilogy adapters)
-- ✅ Rescan command to update all tracked projects
-- ✅ Enhanced dashboard with database columns
-- ✅ EOL tracking for PostgreSQL and MySQL
-
-### V0.4.0 - Planned
-- 📋 Export reports to JSON/CSV
-- 🐳 Docker Compose database version detection
-- 🔴 Redis version detection
-- 🍃 MongoDB version detection
-
-### V1.0 - Future
-- 🐍 Python support (pyproject.toml, requirements.txt)
-- 📦 Node.js support (package.json, .nvmrc)
-- 🦀 Rust support (Cargo.toml)
-- 🐘 Go support (go.mod)
+### V1.0 - Current (Ready for Release!)
+- ✅ Ruby, Rails, Python, Node.js, Rust, Go version detection
+- ✅ PostgreSQL, MySQL, Redis, MongoDB version detection
+- ✅ Ecosystem-grouped dashboard with smart component display
+- ✅ Export reports to JSON/CSV
+- ✅ Bulk scanning with `--recursive` and `rescan` commands
+- ✅ 24-hour smart caching for offline support
+- ✅ Color-coded EOL warnings
+
+### V1.1 - Next
+- 🔷 TypeScript version detection
+- 🎯 Framework detection (Django, Flask, Express, Gin)
+- 📦 Package manager detection (npm, yarn, pip, bundler, go modules versions)
+- 🔍 Dependency vulnerability scanning integration
 
 ### V2.0 - Vision
-- 🤖 AI-powered upgrade summaries
-- 📧 Email/Slack notifications
-- ☁️ Cloud platform detection (AWS, Heroku, etc.)
-- 👥 Team collaboration features
+- 🤖 AI-powered upgrade summaries and breaking change analysis
+- 📧 Email/Slack notifications for approaching EOL dates
+- ☁️ Cloud platform detection (AWS, Heroku, Render)
+- 👥 Team collaboration features (shared dashboards)
+- 📈 Historical tracking and trends
 
 ## Contributing
 

data/docs/index.html

@@ -4,7 +4,7 @@
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>Harbinger - Track EOL Dates for Your Tech Stack</title>
-    <meta name="description" content="Never get caught off-guard by unsupported dependencies. Harbinger tracks End-of-Life dates for Ruby, Rails, and more.">
+    <meta name="description" content="Never get caught off-guard by unsupported dependencies. Harbinger tracks End-of-Life dates for Ruby, Rails, PostgreSQL, MySQL, Redis, MongoDB, Python, Node.js, and Rust.">
     <script src="https://cdn.tailwindcss.com"></script>
     <style>
         @import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;600;700;900&display=swap');
@@ -17,7 +17,7 @@
         <div class="max-w-6xl mx-auto px-4 py-20">
             <h1 class="text-5xl md:text-7xl font-black mb-6">Harbinger</h1>
             <p class="text-2xl md:text-3xl mb-8 text-blue-100">Track End-of-Life dates for your tech stack</p>
-            <p class="text-xl mb-12 text-blue-100 max-w-2xl">Never get caught off-guard by unsupported dependencies. Harbinger scans your Ruby and Rails projects and warns you before support ends.</p>
+            <p class="text-xl mb-12 text-blue-100 max-w-2xl">Never get caught off-guard by unsupported dependencies. Harbinger scans your Ruby, Rails, Python, Node.js, Rust, Go, PostgreSQL, MySQL, Redis, and MongoDB versions and warns you before support ends.</p>
 
             <div class="flex flex-col sm:flex-row gap-4">
                 <div class="bg-gray-900 rounded-lg p-4 font-mono text-sm">
@@ -38,7 +38,7 @@
             <div class="bg-white p-6 rounded-lg shadow-sm">
                 <div class="text-4xl mb-4">🔍</div>
                 <h3 class="text-xl font-semibold mb-2">Auto-Detection</h3>
-                <p class="text-gray-600">Automatically detects Ruby and Rails versions from .ruby-version, Gemfile, and Gemfile.lock</p>
+                <p class="text-gray-600">Detects Ruby, Rails, Python, Node.js, Rust, Go, PostgreSQL, MySQL, Redis, and MongoDB versions from project files and Docker configs</p>
             </div>
             <div class="bg-white p-6 rounded-lg shadow-sm">
                 <div class="text-4xl mb-4">📅</div>
@@ -62,8 +62,8 @@
             </div>
             <div class="bg-white p-6 rounded-lg shadow-sm">
                 <div class="text-4xl mb-4">📊</div>
-                <h3 class="text-xl font-semibold mb-2">Dashboard View</h3>
-                <p class="text-gray-600">Track multiple projects and see EOL status at a glance with harbinger show</p>
+                <h3 class="text-xl font-semibold mb-2">Ecosystem Grouping</h3>
+                <p class="text-gray-600">Projects organized by language ecosystem (Ruby, Python, Node.js, Rust) with only relevant components displayed</p>
             </div>
             <div class="bg-white p-6 rounded-lg shadow-sm">
                 <div class="text-4xl mb-4">🔄</div>
@@ -73,7 +73,7 @@
             <div class="bg-white p-6 rounded-lg shadow-sm">
                 <div class="text-4xl mb-4">🧪</div>
                 <h3 class="text-xl font-semibold mb-2">Well Tested</h3>
-                <p class="text-gray-600">52 RSpec tests with 100% pass rate, built with TDD</p>
+                <p class="text-gray-600">146 RSpec tests with 100% pass rate, built with TDD</p>
             </div>
         </div>
     </div>
@@ -109,12 +109,58 @@
             </div>
 
             <div class="prose max-w-none">
-                <h3 class="text-2xl font-semibold mb-4">Commands</h3>
+                <h3 class="text-2xl font-semibold mb-4">Dashboard with Ecosystem Grouping</h3>
+                <p class="text-gray-600 mb-4">Projects are organized by their primary programming language ecosystem, showing only relevant components:</p>
+
+                <div class="bg-gray-900 rounded-lg p-6 font-mono text-xs overflow-x-auto mb-8">
+                    <div class="text-gray-400 mb-1">$ harbinger show</div>
+                    <div class="text-white mb-2">Tracked Projects (12)</div>
+
+                    <div class="text-cyan-400 mt-3 mb-1">Ruby Ecosystem (7)</div>
+                    <div class="text-gray-400">================================================================================</div>
+                    <div class="text-white">
+                        <div>┌─────────────────┬───────┬──────────┬────────────┬───────┬─────────────────┐</div>
+                        <div>│ Project         │ Ruby  │ Rails    │ PostgreSQL │ Redis │ Status          │</div>
+                        <div>├─────────────────┼───────┼──────────┼────────────┼───────┼─────────────────┤</div>
+                        <div>│ shop-api        │ 3.2.0 │ 6.1.7    │ 15.0       │ -     │ <span class="text-red-400">✗ Rails EOL</span>     │</div>
+                        <div>│ blog-engine     │ 3.3.0 │ 7.0.8    │ 16.0       │ 7.0   │ <span class="text-red-400">✗ Rails EOL</span>     │</div>
+                        <div>│ admin-portal    │ 3.3.0 │ 8.0.4    │ 16.11      │ 7.2   │ <span class="text-green-400">✓ Current</span>       │</div>
+                        <div>└─────────────────┴───────┴──────────┴────────────┴───────┴─────────────────┘</div>
+                    </div>
+
+                    <div class="text-cyan-400 mt-3 mb-1">Python Ecosystem (3)</div>
+                    <div class="text-gray-400">================================================================================</div>
+                    <div class="text-white">
+                        <div>┌──────────────┬────────┬────────────┬─────────┐</div>
+                        <div>│ Project      │ Python │ PostgreSQL │ Status  │</div>
+                        <div>├──────────────┼────────┼────────────┼─────────┤</div>
+                        <div>│ ml-pipeline  │ 3.11   │ 16.0       │ <span class="text-green-400">✓ Current</span> │</div>
+                        <div>│ data-scraper │ 3.12   │ -          │ <span class="text-green-400">✓ Current</span> │</div>
+                        <div>└──────────────┴────────┴────────────┴─────────┘</div>
+                    </div>
+
+                    <div class="text-cyan-400 mt-3 mb-1">Node.js Ecosystem (2)</div>
+                    <div class="text-gray-400">================================================================================</div>
+                    <div class="text-white">
+                        <div>┌──────────────┬─────────┬────────────┬─────────┐</div>
+                        <div>│ Project      │ Node.js │ PostgreSQL │ Status  │</div>
+                        <div>├──────────────┼─────────┼────────────┼─────────┤</div>
+                        <div>│ frontend-app │ 18.0    │ -          │ <span class="text-yellow-400">⚠ Node.js ending soon</span> │</div>
+                        <div>│ realtime-api │ 22.0    │ 16.0       │ <span class="text-green-400">✓ Current</span> │</div>
+                        <div>└──────────────┴─────────┴────────────┴─────────┘</div>
+                    </div>
+                </div>
+
+                <h3 class="text-2xl font-semibold mb-4 mt-8">Commands</h3>
                 <ul class="space-y-3 text-gray-700">
                     <li><code class="bg-gray-100 px-2 py-1 rounded">harbinger scan --path [PATH]</code> - Scan a project and show EOL status</li>
                     <li><code class="bg-gray-100 px-2 py-1 rounded">harbinger scan --save</code> - Save project for tracking</li>
                     <li><code class="bg-gray-100 px-2 py-1 rounded">harbinger scan --recursive</code> - Scan all projects in a directory</li>
-                    <li><code class="bg-gray-100 px-2 py-1 rounded">harbinger show</code> - View dashboard of all tracked projects</li>
+                    <li><code class="bg-gray-100 px-2 py-1 rounded">harbinger show [PROJECT] [-v]</code> - View dashboard (filter by name/path, -v shows paths)</li>
+                    <li><code class="bg-gray-100 px-2 py-1 rounded">harbinger show --format json|csv</code> - Export data to JSON or CSV</li>
+                    <li><code class="bg-gray-100 px-2 py-1 rounded">harbinger show --format json -o report.json</code> - Save export to file</li>
+                    <li><code class="bg-gray-100 px-2 py-1 rounded">harbinger rescan</code> - Re-scan all tracked projects and update versions</li>
+                    <li><code class="bg-gray-100 px-2 py-1 rounded">harbinger remove PROJECT</code> - Remove a project from tracking</li>
                     <li><code class="bg-gray-100 px-2 py-1 rounded">harbinger update</code> - Force refresh EOL data from API</li>
                     <li><code class="bg-gray-100 px-2 py-1 rounded">harbinger version</code> - Show harbinger version</li>
                 </ul>
@@ -127,30 +173,31 @@
         <h2 class="text-3xl font-bold mb-8 text-center">Roadmap</h2>
         <div class="grid md:grid-cols-3 gap-8">
             <div>
-                <h3 class="text-xl font-semibold mb-4 text-green-600">✅ V0.2.0 (Current)</h3>
+                <h3 class="text-xl font-semibold mb-4 text-green-600">✅ V1.0 (Current)</h3>
                 <ul class="space-y-2 text-gray-600">
-                    <li>• Dashboard view</li>
-                    <li>• Project tracking</li>
-                    <li>• Recursive scanning</li>
-                    <li>• Homebrew distribution</li>
+                    <li>• Ruby, Rails, Python, Node.js, Rust, Go</li>
+                    <li>• PostgreSQL, MySQL, Redis, MongoDB</li>
+                    <li>• Ecosystem-grouped dashboard</li>
+                    <li>• Export to JSON/CSV</li>
+                    <li>• Bulk scanning & rescan</li>
                 </ul>
             </div>
             <div>
-                <h3 class="text-xl font-semibold mb-4 text-blue-600">📋 V0.3.0 (Planned)</h3>
+                <h3 class="text-xl font-semibold mb-4 text-blue-600">📋 V1.1 (Next)</h3>
                 <ul class="space-y-2 text-gray-600">
-                    <li>• PostgreSQL detection</li>
-                    <li>• MySQL detection</li>
-                    <li>• Rescan command</li>
-                    <li>• Export to JSON/CSV</li>
+                    <li>• TypeScript detection</li>
+                    <li>• Framework detection (Django, Flask, Express, Gin)</li>
+                    <li>• Package manager versions</li>
+                    <li>• Vulnerability scanning integration</li>
                 </ul>
             </div>
             <div>
-                <h3 class="text-xl font-semibold mb-4 text-purple-600">🚀 V1.0 (Future)</h3>
+                <h3 class="text-xl font-semibold mb-4 text-purple-600">🚀 V2.0 (Vision)</h3>
                 <ul class="space-y-2 text-gray-600">
-                    <li>• Python support</li>
-                    <li>• Node.js support</li>
-                    <li>• Go support</li>
-                    <li>• Rust support</li>
+                    <li>• AI-powered upgrade summaries</li>
+                    <li>• Email/Slack notifications</li>
+                    <li>• Cloud platform detection</li>
+                    <li>• Team collaboration</li>
                 </ul>
             </div>
         </div>

data/lib/harbinger/analyzers/database_detector.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require "English"
 require "yaml"
 
 module Harbinger
@@ -17,7 +18,11 @@ module Harbinger
       def detect
         return nil unless database_detected?
 
-        # Try shell command first (actual database version)
+        # Try docker-compose.yml first (most accurate for Docker-based projects)
+        version = detect_from_docker_compose
+        return version if version
+
+        # Try shell command (actual database version for non-Docker setups)
         version = detect_from_shell
         return version if version
 
@@ -68,6 +73,11 @@ module Harbinger
         raise NotImplementedError, "Subclasses must implement detect_from_shell"
       end
 
+      # Optional method - subclasses can override to detect from docker-compose.yml
+      def detect_from_docker_compose
+        nil
+      end
+
       # Abstract method - must be implemented by subclasses
       # Detects version from Gemfile.lock gem version
       def detect_from_gemfile_lock
@@ -81,7 +91,7 @@ module Harbinger
 
         content = File.read(database_yml_path)
         YAML.safe_load(content, aliases: true)
-      rescue Psych::SyntaxError, StandardError
+      rescue StandardError
         nil
       end
 
@@ -112,7 +122,7 @@ module Harbinger
       # Execute shell command safely
       def execute_command(command)
         output = `#{command} 2>&1`.strip
-        return nil unless $?.success?
+        return nil unless $CHILD_STATUS.success?
 
         output
       rescue StandardError

data/lib/harbinger/analyzers/docker_compose_detector.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+require "yaml"
+
+module Harbinger
+  module Analyzers
+    # Detects versions from docker-compose.yml and Dockerfile
+    class DockerComposeDetector
+      attr_reader :project_path
+
+      def initialize(project_path)
+        @project_path = project_path
+      end
+
+      # Extract version from a Docker image in docker-compose.yml
+      # e.g., "postgres:16-alpine" => "16", "mysql:8.0" => "8.0"
+      def image_version(image_pattern)
+        compose = parse_docker_compose
+        return nil unless compose
+
+        services = compose["services"]
+        return nil unless services
+
+        services.each_value do |service|
+          image = service["image"]
+          next unless image
+
+          if image.match?(/^#{image_pattern}[:\d]/)
+            version = extract_version_from_image(image)
+            return version if version
+          end
+        end
+
+        nil
+      end
+
+      # Extract Ruby version from Dockerfile
+      # e.g., "FROM ruby:3.4.7-slim" => "3.4.7"
+      def ruby_version_from_dockerfile
+        dockerfile = read_dockerfile
+        return nil unless dockerfile
+
+        # Match patterns like:
+        # FROM ruby:3.4.7
+        # FROM ruby:3.4.7-slim
+        # FROM ruby:3.4.7-alpine
+        match = dockerfile.match(/^FROM\s+ruby:(\d+\.\d+(?:\.\d+)?)/i)
+        match[1] if match
+      end
+
+      # Extract Rails version from Dockerfile (rare, but possible)
+      def rails_version_from_dockerfile
+        dockerfile = read_dockerfile
+        return nil unless dockerfile
+
+        # Match patterns like:
+        # FROM rails:7.0
+        # ARG RAILS_VERSION=7.0.8
+        match = dockerfile.match(/^FROM\s+rails:(\d+\.\d+(?:\.\d+)?)/i)
+        return match[1] if match
+
+        match = dockerfile.match(/RAILS_VERSION[=:](\d+\.\d+(?:\.\d+)?)/i)
+        match[1] if match
+      end
+
+      # Check if docker-compose.yml exists
+      def docker_compose_exists?
+        docker_compose_path != nil
+      end
+
+      # Check if Dockerfile exists
+      def dockerfile_exists?
+        File.exist?(File.join(project_path, "Dockerfile"))
+      end
+
+      private
+
+      def docker_compose_path
+        paths = [
+          File.join(project_path, "docker-compose.yml"),
+          File.join(project_path, "docker-compose.yaml"),
+          File.join(project_path, "compose.yml"),
+          File.join(project_path, "compose.yaml")
+        ]
+        paths.find { |p| File.exist?(p) }
+      end
+
+      def parse_docker_compose
+        path = docker_compose_path
+        return nil unless path
+
+        YAML.safe_load(File.read(path), aliases: true)
+      rescue StandardError
+        nil
+      end
+
+      def read_dockerfile
+        path = File.join(project_path, "Dockerfile")
+        return nil unless File.exist?(path)
+
+        File.read(path)
+      rescue StandardError
+        nil
+      end
+
+      # Extract version number from Docker image tag
+      # "postgres:16-alpine" => "16"
+      # "postgres:16.2" => "16.2"
+      # "mysql:8.0.33" => "8.0.33"
+      # "redis:7-alpine" => "7"
+      def extract_version_from_image(image)
+        return nil unless image.include?(":")
+
+        tag = image.split(":").last
+        # Extract leading version number (digits and dots)
+        match = tag.match(/^(\d+(?:\.\d+)*)/)
+        match[1] if match
+      end
+    end
+  end
+end