stackharbinger 0.4.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 663f135c9d728ba59e2f33d33ddd73e3be1b37143c7533db0534db995301aa8e
-  data.tar.gz: de00d8ba69996d960b57bc96d49c79da0f9221a90ac870805fd9f5aad16b506f
+  metadata.gz: 1d46315e9aab151406a3993d75a034eaf28f16d1ce92f44b6344438ba8b9c482
+  data.tar.gz: b4d3c35c6578600ed85d1a387b1cfe13ce5873c256dce6d20267c0366e329052
 SHA512:
-  metadata.gz: 2505777f55661fe67224a94351e8eb00d56cb2ef834c19a86f00e9be6fd45cf4aea5abb872242750c5f4dc3608e4707e0ecb8899538407d348ff7fdec7254a3c
-  data.tar.gz: 1ee3dcbca6a3cd75ede6a720fdb50bc8969a070c4bbb0c8a17cb4abacc0b9cb4536dd78fe0b78cb7609d56e15fc5affdcebac1ec5a906911cd3e323341b882bf
+  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
@@ -116,18 +118,42 @@ 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
@@ -163,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
 
@@ -205,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
@@ -229,30 +308,27 @@ bundle exec exe/harbinger scan .
 
 ## Roadmap
 
-### V0.4.0 - Current
+### 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
-- ✅ Docker Compose database version detection
-- ✅ Redis version detection
-- ✅ MongoDB version detection
-
-### V0.3.0
-- ✅ 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
-
-### V1.0 - Future
-- 🐍 Python support (pyproject.toml, requirements.txt)
-- 📦 Node.js support (package.json, .nvmrc)
-- 🦀 Rust support (Cargo.toml)
-- 🐘 Go support (go.mod)
+- ✅ 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, Rails, PostgreSQL, and MySQL versions 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">Detects Ruby, Rails, PostgreSQL, and MySQL versions from project files and database configs</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">Smart Dashboard</h3>
-                <p class="text-gray-600">Dynamic columns show only relevant data - columns and projects without matches are hidden automatically</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">116 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,7 +109,49 @@
             </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>
@@ -131,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.4.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>• 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>• Docker Compose detection</li>
-                    <li>• Redis detection</li>
-                    <li>• MongoDB detection</li>
+                    <li>• Bulk scanning & rescan</li>
                 </ul>
             </div>
             <div>
-                <h3 class="text-xl font-semibold mb-4 text-blue-600">📋 V0.3.0</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>• Smart dashboard filtering</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/go_detector.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module Harbinger
+  module Analyzers
+    class GoDetector
+      def initialize(project_path)
+        @project_path = project_path
+      end
+
+      def detect
+        version = detect_from_go_mod ||
+                  detect_from_go_work ||
+                  detect_from_go_version_file ||
+                  detect_from_docker_compose ||
+                  detect_from_shell
+
+        normalize_version(version) if version
+      end
+
+      def go_detected?
+        File.exist?(File.join(@project_path, "go.mod")) ||
+          File.exist?(File.join(@project_path, "go.work")) ||
+          File.exist?(File.join(@project_path, ".go-version"))
+      end
+
+      private
+
+      def detect_from_go_mod
+        go_mod_path = File.join(@project_path, "go.mod")
+        return nil unless File.exist?(go_mod_path)
+
+        content = File.read(go_mod_path)
+        # Match "go 1.21" or "go 1.21.0" format
+        match = content.match(/^go\s+([\d.]+)/m)
+        match[1] if match
+      end
+
+      def detect_from_go_work
+        go_work_path = File.join(@project_path, "go.work")
+        return nil unless File.exist?(go_work_path)
+
+        content = File.read(go_work_path)
+        # Match "go 1.21" or "go 1.21.0" format
+        match = content.match(/^go\s+([\d.]+)/m)
+        match[1] if match
+      end
+
+      def detect_from_go_version_file
+        go_version_path = File.join(@project_path, ".go-version")
+        return nil unless File.exist?(go_version_path)
+
+        version = File.read(go_version_path).strip
+        version unless version.empty?
+      end
+
+      def detect_from_docker_compose
+        docker_compose_path = File.join(@project_path, "docker-compose.yml")
+        return nil unless File.exist?(docker_compose_path)
+
+        content = File.read(docker_compose_path)
+        # Match golang:1.21, golang:1.21.0, golang:1.21-alpine, etc.
+        match = content.match(/golang:([\d.]+)/)
+        match[1] if match
+      end
+
+      def detect_from_shell
+        # Only try shell detection if Go project files exist
+        return nil unless go_detected?
+
+        version_output = `go version 2>/dev/null`.strip
+        return nil if version_output.empty?
+
+        # Parse "go version go1.21.0 darwin/amd64" format
+        match = version_output.match(/go version go([\d.]+)/)
+        match[1] if match
+      rescue StandardError
+        nil
+      end
+
+      def normalize_version(version)
+        # Remove any trailing qualifiers like -alpine, -rc1, etc.
+        version.gsub(/-(alpine|rc\d+|beta\d*).*/, "")
+      end
+    end
+  end
+end

data/lib/harbinger/analyzers/node_detector.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+require_relative "docker_compose_detector"
+require "json"
+
+module Harbinger
+  module Analyzers
+    class NodeDetector
+      def initialize(project_path)
+        @project_path = project_path
+      end
+
+      def detect
+        detect_from_version_files ||
+          detect_from_package_json ||
+          detect_from_docker_compose ||
+          (nodejs_detected? ? detect_from_shell : nil)
+      end
+
+      def nodejs_detected?
+        File.exist?(File.join(project_path, "package.json")) ||
+          File.exist?(File.join(project_path, "package-lock.json")) ||
+          File.exist?(File.join(project_path, ".nvmrc")) ||
+          File.exist?(File.join(project_path, ".node-version")) ||
+          File.exist?(File.join(project_path, "node_modules"))
+      rescue StandardError
+        false
+      end
+
+      private
+
+      attr_reader :project_path
+
+      def detect_from_version_files
+        [".nvmrc", ".node-version"].each do |filename|
+          file_path = File.join(project_path, filename)
+          next unless File.exist?(file_path)
+
+          content = File.read(file_path).strip
+          next if content.empty?
+
+          return extract_version(content)
+        end
+
+        nil
+      rescue StandardError
+        nil
+      end
+
+      def detect_from_package_json
+        file_path = File.join(project_path, "package.json")
+        return nil unless File.exist?(file_path)
+
+        content = File.read(file_path)
+        package = JSON.parse(content)
+
+        engines = package.dig("engines", "node")
+        return nil unless engines
+
+        extract_version(engines)
+      rescue StandardError
+        nil
+      end
+
+      def detect_from_docker_compose
+        docker = DockerComposeDetector.new(project_path)
+        docker.image_version("node")
+      end
+
+      def detect_from_shell
+        output = `node --version 2>&1`.strip
+        return nil unless $CHILD_STATUS.success?
+
+        # Parse: "v18.16.0" (note the 'v' prefix)
+        match = output.match(/^v?(\d+\.\d+(?:\.\d+)?)/)
+        match[1] if match
+      rescue StandardError
+        nil
+      end
+
+      def extract_version(version_string)
+        # Remove 'v' prefix (Node.js convention)
+        version = version_string.sub(/^v/, "")
+
+        # Strip constraint operators: >=18.0.0, ^18.0.0, ~18.0.0
+        version = version.gsub(/^[><=~^!\s]+/, "")
+
+        # Handle ranges like ">=14.0.0 <20.0.0" - extract first version
+        version = version.split(/\s+/).first if version.include?(" ")
+
+        # Handle .x suffix (e.g., "18.x" => "18")
+        version = version.sub(/\.x$/, "")
+
+        # Handle LTS names like "lts/hydrogen" (hydrogen=18, gallium=16, fermium=14)
+        if version =~ /lts\/(hydrogen|gallium|fermium)/i
+          lts_name = $1.downcase
+          return case lts_name
+                 when "hydrogen" then "18"
+                 when "gallium" then "16"
+                 when "fermium" then "14"
+                 else nil
+                 end
+        end
+
+        version
+      end
+    end
+  end
+end

data/lib/harbinger/analyzers/python_detector.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+module Harbinger
+  module Analyzers
+    class PythonDetector
+      def initialize(project_path)
+        @project_path = project_path
+      end
+
+      def detect
+        detect_from_pyproject_toml ||
+          detect_from_python_version ||
+          detect_from_pyvenv_cfg ||
+          (python_detected? ? detect_from_shell : nil)
+      end
+
+      def python_detected?
+        File.exist?(File.join(project_path, "pyproject.toml")) ||
+          File.exist?(File.join(project_path, "requirements.txt")) ||
+          File.exist?(File.join(project_path, ".python-version")) ||
+          File.exist?(File.join(project_path, "setup.py")) ||
+          File.exist?(File.join(project_path, "setup.cfg")) ||
+          venv_exists?
+      end
+
+      private
+
+      attr_reader :project_path
+
+      def detect_from_pyproject_toml
+        file_path = File.join(project_path, "pyproject.toml")
+        return nil unless File.exist?(file_path)
+
+        content = File.read(file_path)
+
+        # Try [project] requires-python = ">=3.11"
+        match = content.match(/requires-python\s*=\s*["']([^"']+)["']/)
+        return extract_version(match[1]) if match
+
+        # Try [tool.poetry.dependencies] python = "^3.11"
+        match = content.match(/\[tool\.poetry\.dependencies\].*?python\s*=\s*["']([^"']+)["']/m)
+        return extract_version(match[1]) if match
+
+        nil
+      rescue StandardError
+        nil
+      end
+
+      def detect_from_python_version
+        file_path = File.join(project_path, ".python-version")
+        return nil unless File.exist?(file_path)
+
+        content = File.read(file_path).strip
+        extract_version(content)
+      rescue StandardError
+        nil
+      end
+
+      def detect_from_pyvenv_cfg
+        ["venv/pyvenv.cfg", ".venv/pyvenv.cfg"].each do |cfg_path|
+          file_path = File.join(project_path, cfg_path)
+          next unless File.exist?(file_path)
+
+          content = File.read(file_path)
+          # Parse: "version = 3.11.5"
+          match = content.match(/version\s*=\s*(\d+\.\d+(?:\.\d+)?)/)
+          return match[1] if match
+        end
+
+        nil
+      rescue StandardError
+        nil
+      end
+
+      def detect_from_shell
+        # Try python3 first (more reliable on multi-Python systems)
+        output = `python3 --version 2>&1`.strip
+        if $CHILD_STATUS.success?
+          match = output.match(/Python\s+(\d+\.\d+(?:\.\d+)?)/)
+          return match[1] if match
+        end
+
+        # Fall back to python
+        output = `python --version 2>&1`.strip
+        return nil unless $CHILD_STATUS.success?
+
+        match = output.match(/Python\s+(\d+\.\d+(?:\.\d+)?)/)
+        match[1] if match
+      rescue StandardError
+        nil
+      end
+
+      def extract_version(version_string)
+        # Strip constraint operators: >=3.11, ^3.11, ~3.11, >3.11, <4.0
+        version = version_string.gsub(/^[><=~^!\s]+/, "")
+
+        # Handle ranges like ">=3.9,<4.0" - extract first version
+        version = version.split(",").first.strip if version.include?(",")
+
+        # Remove "python-" prefix if present (from .python-version)
+        version.sub(/^python-/, "")
+      end
+
+      def venv_exists?
+        File.exist?(File.join(project_path, "venv/pyvenv.cfg")) ||
+          File.exist?(File.join(project_path, ".venv/pyvenv.cfg"))
+      end
+    end
+  end
+end