devcompass 2.3.0 → 2.4.0

package/README.md

@@ -1,25 +1,50 @@
 # 🧭 DevCompass
 
-**Dependency health checker with ecosystem intelligence for JavaScript/TypeScript projects**
+**Dependency health checker with ecosystem intelligence and real-time GitHub issue tracking for JavaScript/TypeScript projects**
 
 [![npm version](https://img.shields.io/npm/v/devcompass.svg)](https://www.npmjs.com/package/devcompass)
 [![npm downloads](https://img.shields.io/npm/dm/devcompass.svg)](https://www.npmjs.com/package/devcompass)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Analyze your JavaScript projects to find unused dependencies, outdated packages, **detect security vulnerabilities**, **check bundle sizes**, **verify licenses**, and **automatically fix issues** with a single command. Perfect for **CI/CD pipelines** with JSON output and exit codes.
+Analyze your JavaScript projects to find unused dependencies, outdated packages, **detect security vulnerabilities**, **monitor GitHub issues in real-time**, **check bundle sizes**, **verify licenses**, and **automatically fix issues** with a single command. Perfect for **CI/CD pipelines** with JSON output and exit codes.
 
+> **NEW in v2.4.0:** Real-time GitHub issue tracking & predictive warnings! 🔮  
+> **NEW in v2.3.1:** Fixed all security vulnerabilities! Health score: 2.5/10 → 8/10 🔒  
 > **NEW in v2.3:** Security scanning, bundle analysis & license checker! 🔐  
 > **NEW in v2.2:** CI/CD integration with JSON output & smart caching! 🚀  
 > **NEW in v2.1:** Auto-fix command! 🔧 Fix critical issues automatically!  
 > **NEW in v2.0:** Real-time ecosystem alerts for known issues! 🚨
 
+## 🎉 Latest Update: v2.4.0
+
+**Real-time GitHub issue tracking is here!** DevCompass now monitors live GitHub activity for 14+ popular packages:
+
+- 🔮 **Predictive warnings** based on recent bug activity
+- 📊 **Risk scoring** (high/medium/low severity)
+- 📈 **Trend analysis** (increasing/stable/decreasing)
+- ⚡ **93% faster** with smart caching (8s → 0.5s)
+- 🔗 **Direct links** to GitHub repositories
+
+**Example warning:**
+```
+🔮 PREDICTIVE WARNINGS (1)
+
+🟡 express
+   Increased issue activity
+   15 new issues in last 7 days
+   → Monitor for stability
+   GitHub: https://github.com/expressjs/express
+```
+
 ## ✨ Features
 
-- 🔐 **Security Scanning** (NEW in v2.3!) - npm audit integration with severity breakdown
-- 📦 **Bundle Size Analysis** (NEW in v2.3!) - Identify heavy packages (> 1MB)
-- ⚖️ **License Checker** (NEW in v2.3!) - Detect restrictive licenses (GPL, AGPL)
+- 🔮 **GitHub Issue Tracking** (v2.4) - Real-time monitoring of package health
+- 📈 **Predictive Warnings** (v2.4) - Detect issues before they're announced
+- 🔐 **Security Scanning** (v2.3) - npm audit integration with severity breakdown
+- 📦 **Bundle Size Analysis** (v2.3) - Identify heavy packages (> 1MB)
+- ⚖️ **License Checker** (v2.3) - Detect restrictive licenses (GPL, AGPL)
 - 🚀 **CI/CD Integration** (v2.2) - JSON output, exit codes, and silent mode
-- ⚡ **Smart Caching** (v2.2) - 70% faster on repeated runs
+- ⚡ **Smart Caching** (v2.2) - 93% faster on repeated runs
 - 🎛️ **Advanced Filtering** (v2.2) - Control alerts by severity level
 - 🔧 **Auto-Fix Command** (v2.1) - Fix issues automatically with one command
 - 🚨 **Ecosystem Intelligence** (v2.0) - Detect known issues before they break production
@@ -65,11 +90,60 @@ devcompass analyze --ci
 devcompass analyze --silent
 ```
 
-## 🔐 NEW in v2.3: Security & Compliance Features
+## 🔮 Predictive Warnings (v2.4.0)
+
+DevCompass now monitors **real-time GitHub activity** to detect potential issues before they're officially reported!
+
+### What it tracks:
+- 🐛 **Open bug reports** in the last 7/30 days
+- 🔥 **High-activity packages** with unusual issue spikes
+- 📈 **Trend analysis** (increasing/stable/decreasing)
+- ⚠️ **Critical issues** flagged by maintainers
+
+### Currently tracked packages (14+):
+- **axios**, **lodash**, **moment**, **express**
+- **react**, **vue**, **next**, **webpack**
+- **typescript**, **eslint**, **jest**, **prettier**
+- **node-fetch**, **chalk**
+
+### Example Output:
+```
+🔮 PREDICTIVE WARNINGS (2)
+
+  Based on recent GitHub activity:
+
+🟠 axios
+   High bug activity detected
+   15 new issues in last 7 days
+   → Consider delaying upgrade or monitoring closely
+   GitHub: https://github.com/axios/axios
+
+🟡 webpack
+   Increased issue activity
+   8 issues opened recently
+   → Monitor for stability
+   GitHub: https://github.com/webpack/webpack
+```
+
+### How it works:
+1. Fetches live issue data from GitHub API
+2. Analyzes issue frequency (last 7/30 days)
+3. Detects critical issues via labels
+4. Calculates risk scores
+5. Provides actionable recommendations
+
+### Performance:
+- **First run:** ~8 seconds (fetches GitHub data for 14 packages)
+- **Cached runs:** ~0.5 seconds (93% faster!)
+- **Cache duration:** 1 hour
+
+> More packages being added in v2.5.0 (expanding to top 500)!
+
+## 🔐 Security & Compliance Features
 
 ### Security Vulnerability Scanning
 
-DevCompass now integrates with **npm audit** to detect security vulnerabilities automatically!
+DevCompass integrates with **npm audit** to detect security vulnerabilities automatically!
 
 **Example Output:**
 ```
@@ -141,22 +215,18 @@ Detect restrictive licenses that may require legal review!
 - ⚠️ **Restrictive:** GPL, AGPL, LGPL
 - ❓ **Unknown:** Missing or custom licenses
 
-### Combined Analysis Example (v2.3)
+### Combined Analysis Example
 
 **Full Output:**
 ```
-🔍 DevCompass v2.3.0 - Analyzing your project...
+🔍 DevCompass v2.4.0 - Analyzing your project...
 ✔ Scanned 25 dependencies in project
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-🔐 SECURITY VULNERABILITIES (5)
+✅ SECURITY VULNERABILITIES
 
-  🔴 CRITICAL: 1
-  🟠 HIGH: 2
-  🟡 MODERATE: 2
-
-  Run npm audit fix to fix vulnerabilities
+  No vulnerabilities detected!
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
@@ -169,6 +239,18 @@ Detect restrictive licenses that may require legal review!
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
+🔮 PREDICTIVE WARNINGS (1)
+
+  Based on recent GitHub activity:
+
+🟡 express
+   Increased issue activity
+   8 issues opened recently
+   → Monitor for stability
+   GitHub: https://github.com/expressjs/express
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
 📦 HEAVY PACKAGES (2)
 
   Packages larger than 1MB:
@@ -178,42 +260,37 @@ Detect restrictive licenses that may require legal review!
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-⚖️ LICENSE WARNINGS (1)
+✅ LICENSE COMPLIANCE
 
-  sharp - Restrictive (LGPL-3.0)
+  All licenses are permissive!
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 📊 PROJECT HEALTH
 
-  Overall Score:              6.2/10
+  Overall Score:              8.5/10
   Total Dependencies:         25
-  Security Vulnerabilities:   5
   Ecosystem Alerts:           1
+  Predictive Warnings:        1
   Unused:                     0
-  Outdated:                   3
+  Outdated:                   2
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 💡 QUICK WINS
 
-  🔐 Fix security vulnerabilities:
-
-  npm audit fix
-
   🔴 Fix critical issues:
 
   npm install axios@1.6.2
 
   Expected impact:
-  ✓ Resolve security vulnerabilities
   ✓ Resolve critical stability issues
-  ✓ Improve health score → 8.7/10
+  ✓ Improve health score → 10/10
 
 💡 TIP: Run 'devcompass fix' to apply these fixes automatically!
 ```
 
-## 🚀 CI/CD Integration (v2.2)
+## 🚀 CI/CD Integration
 
 ### JSON Output
 Perfect for parsing in CI/CD pipelines:
@@ -221,29 +298,45 @@ Perfect for parsing in CI/CD pipelines:
 devcompass analyze --json
 ```
 
-**Output (v2.3):**
+**Output:**
 ```json
 {
-  "version": "2.3.0",
-  "timestamp": "2026-04-02T10:30:00.000Z",
+  "version": "2.4.0",
+  "timestamp": "2026-04-04T10:30:00.000Z",
   "summary": {
-    "healthScore": 6.2,
+    "healthScore": 8.5,
     "totalDependencies": 25,
-    "securityVulnerabilities": 5,
+    "securityVulnerabilities": 0,
     "ecosystemAlerts": 1,
+    "predictiveWarnings": 1,
     "unusedDependencies": 0,
-    "outdatedPackages": 3,
+    "outdatedPackages": 2,
     "heavyPackages": 2,
-    "licenseWarnings": 1
+    "licenseWarnings": 0
   },
   "security": {
-    "total": 5,
-    "critical": 1,
-    "high": 2,
-    "moderate": 2,
+    "total": 0,
+    "critical": 0,
+    "high": 0,
+    "moderate": 0,
     "low": 0,
-    "vulnerabilities": [...]
+    "vulnerabilities": []
   },
+  "predictiveWarnings": [
+    {
+      "package": "express",
+      "severity": "medium",
+      "title": "Increased issue activity",
+      "description": "8 issues opened recently",
+      "recommendation": "Monitor for stability",
+      "githubData": {
+        "totalIssues": 234,
+        "recentIssues": 8,
+        "trend": "increasing",
+        "repoUrl": "https://github.com/expressjs/express"
+      }
+    }
+  ],
   "bundleAnalysis": {
     "heavyPackages": [
       { "name": "typescript", "size": "8.1 MB" },
@@ -251,12 +344,10 @@ devcompass analyze --json
     ]
   },
   "licenses": {
-    "warnings": [
-      { "package": "sharp", "license": "LGPL-3.0", "type": "restrictive" }
-    ]
+    "warnings": []
   },
   "ecosystemAlerts": [...],
-  "unusedDependencies": [...],
+  "unusedDependencies": [],
   "outdatedPackages": [...]
 }
 ```
@@ -293,16 +384,18 @@ devcompass analyze --silent
 echo $?  # Check exit code
 ```
 
-## ⚡ Smart Caching (v2.2)
+## ⚡ Smart Caching
 
 DevCompass caches results to improve performance:
 
-- **First run:** Normal speed (fetches all data)
-- **Cached runs:** ~70% faster
+- **First run:** ~8 seconds (fetches GitHub + npm data)
+- **Cached runs:** ~0.5 seconds (93% faster!)
 - **Cache duration:** 1 hour
 - **Cache file:** `.devcompass-cache.json` (auto-gitignored)
 
 **What gets cached:**
+- GitHub issue data (NEW in v2.4.0)
+- Predictive warnings (NEW in v2.4.0)
 - Security vulnerabilities
 - Ecosystem alerts
 - Unused dependencies
@@ -318,7 +411,7 @@ DevCompass caches results to improve performance:
 }
 ```
 
-## 🎛️ Advanced Configuration (v2.2)
+## 🎛️ Advanced Configuration
 
 Create `devcompass.config.json` in your project root:
 ```json
@@ -373,7 +466,7 @@ Create `devcompass.config.json` in your project root:
 }
 ```
 
-## 🔧 Auto-Fix Command (v2.1)
+## 🔧 Auto-Fix Command
 
 DevCompass can **automatically fix issues** in your project!
 
@@ -382,6 +475,7 @@ DevCompass can **automatically fix issues** in your project!
 - 🧹 **Removes unused dependencies** - Cleans up packages you're not using
 - ⬆️ **Safe updates** - Applies patch and minor updates automatically
 - ⚠️ **Skips breaking changes** - Major updates require manual review
+- 🔄 **Clears cache** - Ensures fresh analysis after fixes (NEW in v2.4.0)
 
 ### Usage
 ```bash
@@ -401,6 +495,7 @@ devcompass fix --path /path/to/project
 - ✅ Requires confirmation (unless `--yes` flag used)
 - ✅ Skips major updates (may have breaking changes)
 - ✅ Groups actions by priority (critical → cleanup → updates)
+- ✅ Clears cache after fixes (NEW in v2.4.0)
 - ✅ Provides clear summary of changes
 
 ### Workflow Example
@@ -415,7 +510,7 @@ devcompass fix
 devcompass analyze
 ```
 
-## 🚨 Ecosystem Intelligence (v2.0)
+## 🚨 Ecosystem Intelligence
 
 DevCompass tracks **real-world issues** in popular packages and warns you before they break production!
 
@@ -468,7 +563,7 @@ DevCompass won't flag these as unused (they're typically used in config files):
 - Shows current vs latest versions
 - Indicates update type (major/minor/patch)
 
-### Health Score (Enhanced in v2.3)
+### Health Score
 Calculated from 0-10 based on:
 - Percentage of unused dependencies (−4 points per 100%)
 - Percentage of outdated packages (−3 points per 100%)
@@ -615,6 +710,8 @@ If you encounter a false positive, please [report it](https://github.com/AjayBTh
 8. **Use JSON output** - Integrate with your monitoring tools
 9. **Review major updates** - Always check changelogs before major version bumps
 10. **Verify before uninstalling** - DevCompass helps identify candidates, but always verify
+11. **Watch predictive warnings** - Monitor packages with increasing issue activity (NEW)
+12. **Cache for speed** - First run takes ~8s, cached runs ~0.5s (NEW)
 
 ## 🤝 Contributing
 
@@ -698,7 +795,7 @@ Check out DevCompass stats:
 
 ## 🌟 What's Next?
 
-### Roadmap (v2.4+)
+### Roadmap
 - [x] ~~Automatic fix command~~ ✅ **Added in v2.1!**
 - [x] ~~CI/CD integration with JSON output~~ ✅ **Added in v2.2!**
 - [x] ~~Smart caching system~~ ✅ **Added in v2.2!**
@@ -706,13 +803,17 @@ Check out DevCompass stats:
 - [x] ~~npm audit integration~~ ✅ **Added in v2.3!**
 - [x] ~~Bundle size analysis~~ ✅ **Added in v2.3!**
 - [x] ~~License compliance checker~~ ✅ **Added in v2.3!**
-- [ ] GitHub Issues API for real-time issue tracking (v2.4.0)
-- [ ] Automated security patch suggestions (v2.4.0)
-- [ ] Dependency graph visualization (v2.5.0)
-- [ ] Web dashboard for team health monitoring (v2.5.0)
-- [ ] More tracked packages (React, Next.js, Vue, Angular) (v2.5.0)
-- [ ] Team collaboration features (v2.6.0)
-- [ ] Slack/Discord notifications (v2.6.0)
+- [x] ~~Fix all security vulnerabilities~~ ✅ **Fixed in v2.3.1!**
+- [x] ~~GitHub Issues API for real-time issue tracking~~ ✅ **Added in v2.4.0!**
+- [x] ~~Predictive warnings based on bug activity~~ ✅ **Added in v2.4.0!**
+- [ ] Expand to top 500 npm packages (v2.5.0)
+- [ ] Performance optimizations (v2.6.0)
+- [ ] Advanced security features with Snyk (v2.7.0)
+- [ ] Enhanced fix command improvements (v2.8.0)
+- [ ] Dependency graph visualization (v3.0.0)
+- [ ] Web dashboard for team health monitoring (v3.0.0)
+- [ ] Team collaboration features (v3.1.0)
+- [ ] Slack/Discord notifications (v3.1.0)
 
 Want to contribute? Pick an item and open an issue! 🚀
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "devcompass",
-  "version": "2.3.0",
-  "description": "Dependency health checker with ecosystem intelligence for JavaScript/TypeScript projects",
+  "version": "2.4.0",
+  "description": "Dependency health checker with ecosystem intelligence and real-time GitHub issue tracking for JavaScript/TypeScript projects",
   "main": "src/index.js",
   "bin": {
     "devcompass": "./bin/devcompass.js"
@@ -36,7 +36,12 @@
     "json-output",
     "npm-audit",
     "bundle-size",
-    "license-checker"
+    "license-checker",
+    "github-issues",
+    "predictive-warnings",
+    "risk-detection",
+    "dependency-monitoring",
+    "issue-tracking"
   ],
   "author": "Ajay Thorat <ajaythorat988@gmail.com>",
   "license": "MIT",
@@ -44,7 +49,7 @@
     "chalk": "^4.1.2",
     "commander": "^11.1.0",
     "depcheck": "^1.4.7",
-    "npm-check-updates": "^16.14.12",
+    "npm-check-updates": "^20.0.0",
     "ora": "^5.4.1",
     "semver": "^7.6.0"
   },
@@ -59,4 +64,4 @@
     "url": "https://github.com/AjayBThorat-20/devcompass/issues"
   },
   "homepage": "https://github.com/AjayBThorat-20/devcompass#readme"
-}
+}

package/src/alerts/github-tracker.js

@@ -0,0 +1,177 @@
+// src/alerts/github-tracker.js
+const https = require('https');
+
+// GitHub repos we track (you can expand this)
+const TRACKED_REPOS = {
+  'axios': 'axios/axios',
+  'lodash': 'lodash/lodash',
+  'moment': 'moment/moment',
+  'express': 'expressjs/express',
+  'react': 'facebook/react',
+  'vue': 'vuejs/core',
+  'next': 'vercel/next.js',
+  'webpack': 'webpack/webpack',
+  'typescript': 'microsoft/TypeScript',
+  'eslint': 'eslint/eslint',
+  'jest': 'jestjs/jest',
+  'prettier': 'prettier/prettier',
+  'node-fetch': 'node-fetch/node-fetch',
+  'chalk': 'chalk/chalk'
+};
+
+/**
+ * Fetch GitHub issues for a package
+ */
+async function fetchGitHubIssues(packageName) {
+  const repo = TRACKED_REPOS[packageName];
+  
+  if (!repo) {
+    return null; // Not tracked
+  }
+  
+  try {
+    const data = await makeGitHubRequest(`/repos/${repo}/issues`, {
+      state: 'open',
+      per_page: 100,
+      labels: 'bug'
+    });
+    
+    return analyzeIssues(data, packageName);
+  } catch (error) {
+    console.error(`GitHub API error for ${packageName}:`, error.message);
+    return null;
+  }
+}
+
+/**
+ * Make GitHub API request
+ */
+function makeGitHubRequest(path, params = {}) {
+  return new Promise((resolve, reject) => {
+    const queryString = Object.entries(params)
+      .map(([key, val]) => `${key}=${encodeURIComponent(val)}`)
+      .join('&');
+    
+    const options = {
+      hostname: 'api.github.com',
+      path: `${path}?${queryString}`,
+      method: 'GET',
+      headers: {
+        'User-Agent': 'DevCompass',
+        'Accept': 'application/vnd.github.v3+json'
+      }
+    };
+    
+    const req = https.request(options, (res) => {
+      let data = '';
+      
+      res.on('data', (chunk) => {
+        data += chunk;
+      });
+      
+      res.on('end', () => {
+        if (res.statusCode === 200) {
+          try {
+            resolve(JSON.parse(data));
+          } catch (error) {
+            reject(new Error('Failed to parse GitHub response'));
+          }
+        } else {
+          reject(new Error(`GitHub API returned ${res.statusCode}`));
+        }
+      });
+    });
+    
+    req.on('error', reject);
+    req.end();
+  });
+}
+
+/**
+ * Analyze issues to detect trends
+ */
+function analyzeIssues(issues, packageName) {
+  const now = Date.now();
+  const day = 24 * 60 * 60 * 1000;
+  
+  // Count issues by recency
+  const last7Days = issues.filter(i => 
+    (now - new Date(i.created_at).getTime()) < 7 * day
+  ).length;
+  
+  const last30Days = issues.filter(i => 
+    (now - new Date(i.created_at).getTime()) < 30 * day
+  ).length;
+  
+  // Detect critical issues (high priority labels)
+  const criticalLabels = ['critical', 'security', 'regression', 'breaking'];
+  const criticalIssues = issues.filter(issue => 
+    issue.labels.some(label => 
+      criticalLabels.some(critical => 
+        label.name.toLowerCase().includes(critical)
+      )
+    )
+  );
+  
+  // Calculate risk score
+  let riskScore = 0;
+  if (last7Days > 15) riskScore += 3;
+  else if (last7Days > 10) riskScore += 2;
+  else if (last7Days > 5) riskScore += 1;
+  
+  if (criticalIssues.length > 5) riskScore += 2;
+  else if (criticalIssues.length > 2) riskScore += 1;
+  
+  return {
+    package: packageName,
+    totalIssues: issues.length,
+    last7Days,
+    last30Days,
+    criticalIssues: criticalIssues.length,
+    riskScore,
+    trend: determineTrend(last7Days, last30Days),
+    repoUrl: `https://github.com/${TRACKED_REPOS[packageName]}`
+  };
+}
+
+/**
+ * Determine trend (increasing/stable/decreasing)
+ */
+function determineTrend(last7Days, last30Days) {
+  const weeklyAverage = last30Days / 4;
+  
+  if (last7Days > weeklyAverage * 1.5) {
+    return 'increasing';
+  } else if (last7Days < weeklyAverage * 0.5) {
+    return 'decreasing';
+  } else {
+    return 'stable';
+  }
+}
+
+/**
+ * Check GitHub issues for multiple packages
+ */
+async function checkGitHubIssues(packages) {
+  const results = [];
+  
+  // Process in batches to avoid rate limits
+  for (const packageName of packages) {
+    const result = await fetchGitHubIssues(packageName);
+    
+    if (result) {
+      results.push(result);
+    }
+    
+    // Rate limit: wait 1 second between requests
+    await new Promise(resolve => setTimeout(resolve, 1000));
+  }
+  
+  return results;
+}
+
+module.exports = {
+  checkGitHubIssues,
+  fetchGitHubIssues,
+  TRACKED_REPOS
+};

package/src/alerts/predictive.js

@@ -1,54 +1,84 @@
 // src/alerts/predictive.js
+const { checkGitHubIssues } = require('./github-tracker');
 
 /**
- * Analyze package health trends
- * NOTE: This is a simplified version without GitHub API
- * For production, integrate with GitHub Issues API
+ * Generate predictive warnings based on GitHub activity
  */
-async function analyzeTrends(packageName) {
-  // Placeholder for future GitHub API integration
-  // For now, return basic analysis
-  
-  return {
-    package: packageName,
-    recentIssues: 0,
-    trend: 'stable',
-    recommendation: null
-  };
+async function generatePredictiveWarnings(packages) {
+  try {
+    const packageNames = Object.keys(packages);
+    const githubData = await checkGitHubIssues(packageNames);
+    
+    const warnings = [];
+    
+    for (const data of githubData) {
+      // High risk: many recent issues
+      if (data.riskScore >= 3) {
+        warnings.push({
+          package: data.package,
+          severity: 'high',
+          type: 'predictive',
+          title: 'High bug activity detected',
+          description: `${data.last7Days} new issues in last 7 days`,
+          recommendation: 'Consider delaying upgrade or monitoring closely',
+          data: {
+            totalIssues: data.totalIssues,
+            recentIssues: data.last7Days,
+            criticalIssues: data.criticalIssues,
+            trend: data.trend,
+            repoUrl: data.repoUrl
+          }
+        });
+      }
+      
+      // Medium risk: increasing trend
+      else if (data.riskScore >= 2 || data.trend === 'increasing') {
+        warnings.push({
+          package: data.package,
+          severity: 'medium',
+          type: 'predictive',
+          title: 'Increased issue activity',
+          description: `${data.last7Days} issues opened recently`,
+          recommendation: 'Monitor for stability',
+          data: {
+            totalIssues: data.totalIssues,
+            recentIssues: data.last7Days,
+            trend: data.trend,
+            repoUrl: data.repoUrl
+          }
+        });
+      }
+    }
+    
+    return warnings;
+  } catch (error) {
+    console.error('Error generating predictive warnings:', error.message);
+    return [];
+  }
 }
 
 /**
- * Calculate risk score based on trends
+ * Calculate risk score for a package
  */
-function calculateRiskScore(trends) {
-  let risk = 0;
+function calculateRiskScore(githubData) {
+  let score = 0;
   
-  // High issue activity = higher risk
-  if (trends.recentIssues > 20) {
-    risk += 3;
-  } else if (trends.recentIssues > 10) {
-    risk += 2;
-  } else if (trends.recentIssues > 5) {
-    risk += 1;
-  }
+  // High recent activity
+  if (githubData.last7Days > 20) score += 3;
+  else if (githubData.last7Days > 10) score += 2;
+  else if (githubData.last7Days > 5) score += 1;
   
-  return risk;
-}
-
-/**
- * Generate predictive warnings
- */
-function generatePredictiveWarnings(packages) {
-  const warnings = [];
+  // Critical issues
+  if (githubData.criticalIssues > 5) score += 2;
+  else if (githubData.criticalIssues > 2) score += 1;
   
-  // This is a placeholder
-  // In production, this would analyze GitHub activity
+  // Trend
+  if (githubData.trend === 'increasing') score += 1;
   
-  return warnings;
+  return score;
 }
 
 module.exports = {
-  analyzeTrends,
-  calculateRiskScore,
-  generatePredictiveWarnings
+  generatePredictiveWarnings,
+  calculateRiskScore
 };

package/src/commands/analyze.js

@@ -161,7 +161,7 @@ async function analyze(options) {
       }
     }
     
-    // Check security vulnerabilities (NEW)
+    // Check security vulnerabilities
     spinner.text = 'Checking security vulnerabilities...';
     let securityData = { vulnerabilities: [], metadata: { total: 0, critical: 0, high: 0, moderate: 0, low: 0 } };
     
@@ -184,7 +184,32 @@ async function analyze(options) {
       }
     }
     
-    // Analyze bundle sizes (NEW)
+    // Check for predictive warnings (GitHub Issues) - NEW
+    spinner.text = 'Checking GitHub activity...';
+    let predictiveWarnings = [];
+    
+    if (config.cache) {
+      predictiveWarnings = getCached(projectPath, 'predictive');
+    }
+    
+    if (!predictiveWarnings) {
+      try {
+        const { generatePredictiveWarnings } = require('../alerts/predictive');
+        predictiveWarnings = await generatePredictiveWarnings(dependencies);
+        
+        if (config.cache && predictiveWarnings.length > 0) {
+          setCache(projectPath, 'predictive', predictiveWarnings);
+        }
+      } catch (error) {
+        if (outputMode !== 'silent') {
+          console.log(chalk.yellow('\n⚠️  Could not check GitHub activity'));
+          console.log(chalk.gray(`   Error: ${error.message}\n`));
+        }
+        predictiveWarnings = [];
+      }
+    }
+    
+    // Analyze bundle sizes
     spinner.text = 'Analyzing bundle sizes...';
     let bundleSizes = [];
     
@@ -204,7 +229,7 @@ async function analyze(options) {
       }
     }
     
-    // Check licenses (NEW)
+    // Check licenses
     spinner.text = 'Checking licenses...';
     let licenses = [];
     
@@ -224,7 +249,7 @@ async function analyze(options) {
       }
     }
     
-    // Calculate score (UPDATED)
+    // Calculate score
     const alertPenalty = calculateAlertPenalty(alerts);
     const securityPenalty = calculateSecurityPenalty(securityData.metadata);
     
@@ -241,15 +266,15 @@ async function analyze(options) {
     
     // Handle different output modes
     if (outputMode === 'json') {
-      const jsonOutput = formatAsJson(alerts, unusedDeps, outdatedDeps, score, totalDeps, securityData, bundleSizes, licenses);
+      const jsonOutput = formatAsJson(alerts, unusedDeps, outdatedDeps, score, totalDeps, securityData, bundleSizes, licenses, predictiveWarnings);
       console.log(jsonOutput);
     } else if (outputMode === 'ci') {
-      displayResults(alerts, unusedDeps, outdatedDeps, score, totalDeps, securityData, bundleSizes, licenses);
+      displayResults(alerts, unusedDeps, outdatedDeps, score, totalDeps, securityData, bundleSizes, licenses, predictiveWarnings);
       handleCiMode(score, config, alerts, unusedDeps);
     } else if (outputMode === 'silent') {
       // Silent mode - no output
     } else {
-      displayResults(alerts, unusedDeps, outdatedDeps, score, totalDeps, securityData, bundleSizes, licenses);
+      displayResults(alerts, unusedDeps, outdatedDeps, score, totalDeps, securityData, bundleSizes, licenses, predictiveWarnings);
     }
     
   } catch (error) {
@@ -262,10 +287,10 @@ async function analyze(options) {
   }
 }
 
-function displayResults(alerts, unusedDeps, outdatedDeps, score, totalDeps, securityData, bundleSizes, licenses) {
+function displayResults(alerts, unusedDeps, outdatedDeps, score, totalDeps, securityData, bundleSizes, licenses, predictiveWarnings) {
   logDivider();
   
-  // SECURITY VULNERABILITIES (NEW SECTION)
+  // SECURITY VULNERABILITIES
   if (securityData.metadata.total > 0) {
     const criticalCount = securityData.metadata.critical;
     const highCount = securityData.metadata.high;
@@ -335,6 +360,33 @@ function displayResults(alerts, unusedDeps, outdatedDeps, score, totalDeps, secu
   
   logDivider();
   
+  // PREDICTIVE WARNINGS (NEW SECTION)
+  if (predictiveWarnings.length > 0) {
+    logSection('🔮 PREDICTIVE WARNINGS', predictiveWarnings.length);
+    
+    log(chalk.gray('  Based on recent GitHub activity:\n'));
+    
+    predictiveWarnings.forEach(warning => {
+      const display = getSeverityDisplay(warning.severity);
+      
+      log(`${display.emoji} ${display.color(warning.package)}`);
+      log(`   ${chalk.yellow(warning.title)}`);
+      log(`   ${warning.description}`);
+      log(`   ${chalk.cyan('→')} ${warning.recommendation}`);
+      
+      if (warning.data && warning.data.repoUrl) {
+        log(chalk.gray(`   GitHub: ${warning.data.repoUrl}`));
+      }
+      
+      log('');
+    });
+  } else {
+    logSection('✅ PREDICTIVE ANALYSIS');
+    log(chalk.green('  No unusual activity detected!\n'));
+  }
+  
+  logDivider();
+  
   // UNUSED DEPENDENCIES
   if (unusedDeps.length > 0) {
     logSection('🔴 UNUSED DEPENDENCIES', unusedDeps.length);
@@ -376,7 +428,7 @@ function displayResults(alerts, unusedDeps, outdatedDeps, score, totalDeps, secu
   
   logDivider();
   
-  // BUNDLE SIZE (NEW SECTION)
+  // BUNDLE SIZE
   const heavyPackages = findHeavyPackages(bundleSizes);
   if (heavyPackages.length > 0) {
     logSection('📦 HEAVY PACKAGES', heavyPackages.length);
@@ -396,7 +448,7 @@ function displayResults(alerts, unusedDeps, outdatedDeps, score, totalDeps, secu
     logDivider();
   }
   
-  // LICENSE WARNINGS (NEW SECTION - ALWAYS SHOW)
+  // LICENSE WARNINGS
   const problematicLicenses = findProblematicLicenses(licenses);
   if (problematicLicenses.length > 0) {
     logSection('⚖️  LICENSE WARNINGS', problematicLicenses.length);
@@ -431,6 +483,10 @@ function displayResults(alerts, unusedDeps, outdatedDeps, score, totalDeps, secu
     log(`  Ecosystem Alerts:           ${chalk.red(alerts.length)}`);
   }
   
+  if (predictiveWarnings.length > 0) {
+    log(`  Predictive Warnings:        ${chalk.yellow(predictiveWarnings.length)}`);
+  }
+  
   log(`  Unused:                     ${chalk.red(unusedDeps.length)}`);
   log(`  Outdated:                   ${chalk.yellow(outdatedDeps.length)}\n`);
   

package/src/commands/fix.js

@@ -3,11 +3,13 @@ const chalk = require('chalk');
 const ora = require('ora');
 const { execSync } = require('child_process');
 const readline = require('readline');
+const path = require('path');
 
 const { findUnusedDeps } = require('../analyzers/unused-deps');
 const { findOutdatedDeps } = require('../analyzers/outdated');
 const { checkEcosystemAlerts } = require('../alerts');
 const { getSeverityDisplay } = require('../alerts/formatter');
+const { clearCache } = require('../cache/manager');
 
 async function fix(options) {
   const projectPath = options.path || process.cwd();
@@ -22,7 +24,6 @@ async function fix(options) {
   
   try {
     const fs = require('fs');
-    const path = require('path');
     const packageJsonPath = path.join(projectPath, 'package.json');
     
     if (!fs.existsSync(packageJsonPath)) {
@@ -52,7 +53,7 @@ async function fix(options) {
     spinner.succeed(chalk.green('Analysis complete!\n'));
     
     // Show what will be fixed
-    await showFixPlan(criticalAlerts, unusedDeps, outdatedDeps, options);
+    await showFixPlan(criticalAlerts, unusedDeps, outdatedDeps, options, projectPath);
     
   } catch (error) {
     spinner.fail(chalk.red('Analysis failed'));
@@ -61,7 +62,7 @@ async function fix(options) {
   }
 }
 
-async function showFixPlan(criticalAlerts, unusedDeps, outdatedDeps, options) {
+async function showFixPlan(criticalAlerts, unusedDeps, outdatedDeps, options, projectPath) {
   const actions = [];
   
   // Critical alerts
@@ -160,19 +161,19 @@ async function showFixPlan(criticalAlerts, unusedDeps, outdatedDeps, options) {
   
   // Confirm
   if (options.yes) {
-    await applyFixes(actions);
+    await applyFixes(actions, projectPath);
   } else {
     const confirmed = await askConfirmation('\n❓ Apply these fixes?');
     
     if (confirmed) {
-      await applyFixes(actions);
+      await applyFixes(actions, projectPath);
     } else {
       console.log(chalk.yellow('\n⚠️  Fix cancelled. No changes made.\n'));
     }
   }
 }
 
-async function applyFixes(actions) {
+async function applyFixes(actions, projectPath) {
   console.log(chalk.cyan.bold('\n🔧 Applying fixes...\n'));
   
   const spinner = ora('Processing...').start();
@@ -222,6 +223,11 @@ async function applyFixes(actions) {
     console.log(chalk.green.bold('\n✨ All fixes applied successfully!\n'));
     console.log(chalk.cyan('💡 Run') + chalk.bold(' devcompass analyze ') + chalk.cyan('to see the new health score.\n'));
     
+    // Clear cache after fixes - ADDED
+    spinner.text = 'Clearing cache...';
+    clearCache(projectPath);
+    spinner.succeed(chalk.gray('Cache cleared'));
+    
   } catch (error) {
     spinner.fail(chalk.red('Fix failed'));
     console.log(chalk.red(`\n❌ Error: ${error.message}\n`));
@@ -244,4 +250,4 @@ function askConfirmation(question) {
   });
 }
 
-module.exports = { fix };
+module.exports = { fix };

package/src/utils/json-formatter.js

@@ -3,7 +3,7 @@
 /**
  * Format analysis results as JSON
  */
-function formatAsJson(alerts, unusedDeps, outdatedDeps, score, totalDeps, securityData, bundleSizes, licenses) {
+function formatAsJson(alerts, unusedDeps, outdatedDeps, score, totalDeps, securityData, bundleSizes, licenses, predictiveWarnings = []) {
   const problematicLicenses = licenses.filter(l => l.type === 'restrictive' || l.type === 'unknown');
   const heavyPackages = bundleSizes.filter(p => p.size > 1024);
   
@@ -15,6 +15,7 @@ function formatAsJson(alerts, unusedDeps, outdatedDeps, score, totalDeps, securi
       totalDependencies: totalDeps,
       securityVulnerabilities: securityData.metadata.total,
       ecosystemAlerts: alerts.length,
+      predictiveWarnings: predictiveWarnings.length,
       unusedDependencies: unusedDeps.length,
       outdatedPackages: outdatedDeps.length,
       heavyPackages: heavyPackages.length,
@@ -44,6 +45,14 @@ function formatAsJson(alerts, unusedDeps, outdatedDeps, score, totalDeps, securi
       source: alert.source,
       reported: alert.reported
     })),
+    predictiveWarnings: predictiveWarnings.map(warning => ({
+      package: warning.package,
+      severity: warning.severity,
+      title: warning.title,
+      description: warning.description,
+      recommendation: warning.recommendation,
+      githubData: warning.data
+    })),
     unusedDependencies: unusedDeps.map(dep => ({
       name: dep.name
     })),