project-scan 1.0.0

package/lib/test-runner.js

@@ -0,0 +1,447 @@
+'use strict';
+/**
+ * test-runner.js — Universal test runner
+ * Detects and executes test frameworks across all major languages.
+ * Returns structured results: suite name, status, passed/failed/skipped counts, output.
+ */
+
+const { execSync, spawnSync } = require('child_process');
+const fs   = require('fs');
+const path = require('path');
+
+// ─── Per-language runner configs ─────────────────────────────────────────────
+
+/**
+ * Each runner: { name, detect(rootDir), run(rootDir) → RunResult }
+ * RunResult: { suite, passed, failed, skipped, duration, status, output, error? }
+ */
+const RUNNERS = [
+
+  // ── Node.js: Jest ──────────────────────────────────────────────────────────
+  {
+    name: 'Jest',
+    detect(root) {
+      const pkg = tryReadJSON(path.join(root, 'package.json'));
+      if (pkg && (allDeps(pkg).includes('jest') || pkg.jest)) return true;
+      // subdirectory package.jsons
+      return findSubPackages(root).some(p => {
+        const sp = tryReadJSON(p);
+        return sp && (allDeps(sp).includes('jest') || sp.jest || sp.scripts?.test?.includes('jest'));
+      });
+    },
+    run(root) {
+      const targets = [root, ...findSubDirs(root)].filter(dir => {
+        const pkg = tryReadJSON(path.join(dir, 'package.json'));
+        return pkg && (allDeps(pkg).includes('jest') || pkg.jest || pkg.scripts?.test?.includes('jest'));
+      });
+      const results = [];
+      for (const dir of targets) {
+        const label = dir === root ? '(root)' : path.relative(root, dir);
+        results.push(runJest(dir, label));
+      }
+      return results;
+    }
+  },
+
+  // ── Node.js: Vitest ────────────────────────────────────────────────────────
+  {
+    name: 'Vitest',
+    detect(root) {
+      const pkg = tryReadJSON(path.join(root, 'package.json'));
+      if (pkg && allDeps(pkg).includes('vitest')) return true;
+      return findSubPackages(root).some(p => {
+        const sp = tryReadJSON(p);
+        return sp && allDeps(sp).includes('vitest');
+      });
+    },
+    run(root) {
+      const targets = [root, ...findSubDirs(root)].filter(dir => {
+        const pkg = tryReadJSON(path.join(dir, 'package.json'));
+        return pkg && allDeps(pkg).includes('vitest');
+      });
+      return targets.map(dir => runCommand({
+        dir, label: dir === root ? '(root)' : path.relative(root, dir),
+        cmd: hasBin(dir, 'vitest') ? 'npx vitest run --reporter=verbose' : null,
+        suite: 'Vitest',
+        parseOutput: parseVitestOutput,
+      }));
+    }
+  },
+
+  // ── Node.js: Mocha ─────────────────────────────────────────────────────────
+  {
+    name: 'Mocha',
+    detect(root) {
+      const pkg = tryReadJSON(path.join(root, 'package.json'));
+      if (pkg && allDeps(pkg).includes('mocha')) return true;
+      return findSubPackages(root).some(p => {
+        const sp = tryReadJSON(p);
+        return sp && allDeps(sp).includes('mocha');
+      });
+    },
+    run(root) {
+      return [runCommand({
+        dir: root, label: '(root)',
+        cmd: 'npx mocha --reporter spec',
+        suite: 'Mocha',
+        parseOutput: parseMochaOutput,
+      })];
+    }
+  },
+
+  // ── Python: pytest ─────────────────────────────────────────────────────────
+  {
+    name: 'pytest',
+    detect(root) {
+      return fs.existsSync(path.join(root, 'requirements.txt')) ||
+             fs.existsSync(path.join(root, 'pyproject.toml'))  ||
+             fs.existsSync(path.join(root, 'pytest.ini'))       ||
+             fs.existsSync(path.join(root, 'setup.py'))         ||
+             hasSourceExt(root, '.py');
+    },
+    run(root) {
+      const cmd = commandExists('pytest') ? 'pytest -v --tb=short 2>&1'
+               : commandExists('python3') ? 'python3 -m pytest -v --tb=short 2>&1'
+               : commandExists('python')  ? 'python -m pytest -v --tb=short 2>&1'
+               : null;
+      return [runCommand({ dir: root, label: '(root)', cmd, suite: 'pytest', parseOutput: parsePytestOutput })];
+    }
+  },
+
+  // ── Go: go test ────────────────────────────────────────────────────────────
+  {
+    name: 'Go test',
+    detect(root) { return fs.existsSync(path.join(root, 'go.mod')); },
+    run(root) {
+      return [runCommand({
+        dir: root, label: '(root)',
+        cmd: commandExists('go') ? 'go test ./... -v 2>&1' : null,
+        suite: 'Go test',
+        parseOutput: parseGoTestOutput,
+      })];
+    }
+  },
+
+  // ── Rust: cargo test ───────────────────────────────────────────────────────
+  {
+    name: 'Cargo test',
+    detect(root) { return fs.existsSync(path.join(root, 'Cargo.toml')); },
+    run(root) {
+      return [runCommand({
+        dir: root, label: '(root)',
+        cmd: commandExists('cargo') ? 'cargo test 2>&1' : null,
+        suite: 'Cargo test',
+        parseOutput: parseCargoOutput,
+      })];
+    }
+  },
+
+  // ── Java/Kotlin: Maven ─────────────────────────────────────────────────────
+  {
+    name: 'Maven',
+    detect(root) { return fs.existsSync(path.join(root, 'pom.xml')); },
+    run(root) {
+      const cmd = commandExists('mvn') ? 'mvn test -B 2>&1' : null;
+      return [runCommand({ dir: root, label: '(root)', cmd, suite: 'Maven', parseOutput: parseMavenOutput })];
+    }
+  },
+
+  // ── Java/Kotlin: Gradle ────────────────────────────────────────────────────
+  {
+    name: 'Gradle',
+    detect(root) {
+      return fs.existsSync(path.join(root, 'build.gradle')) ||
+             fs.existsSync(path.join(root, 'build.gradle.kts'));
+    },
+    run(root) {
+      const gradleCmd = fs.existsSync(path.join(root, 'gradlew')) ? './gradlew' : (commandExists('gradle') ? 'gradle' : null);
+      return [runCommand({ dir: root, label: '(root)', cmd: gradleCmd ? `${gradleCmd} test 2>&1` : null, suite: 'Gradle', parseOutput: parseGradleOutput })];
+    }
+  },
+
+  // ── PHP: PHPUnit ───────────────────────────────────────────────────────────
+  {
+    name: 'PHPUnit',
+    detect(root) {
+      return fs.existsSync(path.join(root, 'phpunit.xml'))       ||
+             fs.existsSync(path.join(root, 'phpunit.xml.dist'))  ||
+             fs.existsSync(path.join(root, 'vendor/bin/phpunit')) ||
+             hasSourceExt(root, '.php');
+    },
+    run(root) {
+      const cmd = fs.existsSync(path.join(root, 'vendor/bin/phpunit')) ? './vendor/bin/phpunit --testdox 2>&1'
+               : commandExists('phpunit') ? 'phpunit --testdox 2>&1' : null;
+      return [runCommand({ dir: root, label: '(root)', cmd, suite: 'PHPUnit', parseOutput: parsePHPUnitOutput })];
+    }
+  },
+
+  // ── Ruby: RSpec ────────────────────────────────────────────────────────────
+  {
+    name: 'RSpec',
+    detect(root) {
+      return fs.existsSync(path.join(root, 'Gemfile'))   ||
+             fs.existsSync(path.join(root, '.rspec'))    ||
+             fs.existsSync(path.join(root, 'spec'));
+    },
+    run(root) {
+      const cmd = commandExists('rspec') ? 'rspec --format progress 2>&1' : (commandExists('bundle') ? 'bundle exec rspec --format progress 2>&1' : null);
+      return [runCommand({ dir: root, label: '(root)', cmd, suite: 'RSpec', parseOutput: parseRSpecOutput })];
+    }
+  },
+
+  // ── Dart/Flutter ───────────────────────────────────────────────────────────
+  {
+    name: 'Flutter/Dart test',
+    detect(root) { return fs.existsSync(path.join(root, 'pubspec.yaml')); },
+    run(root) {
+      const cmd = commandExists('flutter') ? 'flutter test 2>&1' : (commandExists('dart') ? 'dart test 2>&1' : null);
+      return [runCommand({ dir: root, label: '(root)', cmd, suite: 'Flutter/Dart', parseOutput: parseDartOutput })];
+    }
+  },
+
+  // ── .NET: dotnet test ──────────────────────────────────────────────────────
+  {
+    name: 'dotnet test',
+    detect(root) {
+      try {
+        return fs.readdirSync(root).some(f => f.endsWith('.csproj') || f.endsWith('.sln'));
+      } catch { return false; }
+    },
+    run(root) {
+      const cmd = commandExists('dotnet') ? 'dotnet test --logger "console;verbosity=normal" 2>&1' : null;
+      return [runCommand({ dir: root, label: '(root)', cmd, suite: 'dotnet test', parseOutput: parseDotnetOutput })];
+    }
+  },
+];
+
+// ─── Core runner ─────────────────────────────────────────────────────────────
+
+function runAllTests(rootDir) {
+  const results = [];
+  const activeRunners = RUNNERS.filter(r => r.detect(rootDir));
+
+  if (activeRunners.length === 0) {
+    return [{
+      suite: 'No test framework detected',
+      status: 'skipped',
+      passed: 0, failed: 0, skipped: 0,
+      output: 'No recognized test framework was found in this project.',
+      duration: 0,
+    }];
+  }
+
+  for (const runner of activeRunners) {
+    try {
+      const suiteResults = runner.run(rootDir);
+      results.push(...suiteResults);
+    } catch (err) {
+      results.push({
+        suite: runner.name,
+        status: 'error',
+        passed: 0, failed: 0, skipped: 0,
+        output: '',
+        error: err.message,
+        duration: 0,
+      });
+    }
+  }
+  return results;
+}
+
+// ─── Jest runner (special: uses JSON reporter) ────────────────────────────────
+
+function runJest(dir, label) {
+  const start = Date.now();
+  if (!fs.existsSync(path.join(dir, 'node_modules', '.bin', 'jest')) &&
+      !fs.existsSync(path.join(dir, 'node_modules', 'jest'))) {
+    // Try npm test fallback
+    const pkg = tryReadJSON(path.join(dir, 'package.json'));
+    if (!pkg?.scripts?.test) {
+      return { suite: `Jest (${label})`, status: 'skipped', passed: 0, failed: 0, skipped: 0, output: 'Jest not installed. Run npm install first.', duration: 0 };
+    }
+  }
+
+  const result = spawnSync('npx', ['jest', '--no-coverage', '--json', '--forceExit'], {
+    cwd: dir, encoding: 'utf8', timeout: 120000,
+    env: { ...process.env, FORCE_COLOR: '0' }
+  });
+
+  const duration = Date.now() - start;
+  const rawOutput = (result.stdout || '') + (result.stderr || '');
+
+  // Try to parse JSON output
+  const jsonStart = rawOutput.indexOf('{');
+  const jsonEnd   = rawOutput.lastIndexOf('}');
+  if (jsonStart !== -1 && jsonEnd !== -1) {
+    try {
+      const jResult = JSON.parse(rawOutput.slice(jsonStart, jsonEnd + 1));
+      const passed  = jResult.numPassedTests  || 0;
+      const failed  = jResult.numFailedTests  || 0;
+      const skipped = jResult.numPendingTests || 0;
+      const status  = failed > 0 ? 'failed' : (passed > 0 ? 'passed' : 'skipped');
+
+      // Build readable test breakdown
+      const lines = [];
+      for (const suite of (jResult.testResults || [])) {
+        const relPath = path.relative(dir, suite.testFilePath);
+        lines.push(`\n  📄 ${relPath}`);
+        for (const t of (suite.testResults || [])) {
+          const icon = t.status === 'passed' ? '  ✔' : t.status === 'failed' ? '  ✖' : '  ○';
+          lines.push(`${icon} ${t.fullName}`);
+          if (t.status === 'failed' && t.failureMessages?.length) {
+            lines.push(`       ${t.failureMessages[0].split('\n').slice(0, 3).join('\n       ')}`);
+          }
+        }
+      }
+
+      return {
+        suite: `Jest (${label})`,
+        status,
+        passed, failed, skipped,
+        duration,
+        output: lines.join('\n'),
+        suites: jResult.numPassedTestSuites + '/' + jResult.numTotalTestSuites + ' suites passed',
+      };
+    } catch { /* fall through to text parse */ }
+  }
+
+  return parseJestTextOutput(rawOutput, label, duration);
+}
+
+// ─── Generic command runner ───────────────────────────────────────────────────
+
+function runCommand({ dir, label, cmd, suite, parseOutput }) {
+  if (!cmd) {
+    return { suite: `${suite} (${label})`, status: 'skipped', passed: 0, failed: 0, skipped: 0, output: `${suite} not installed or not found in PATH.`, duration: 0 };
+  }
+  const start = Date.now();
+  try {
+    const output = execSync(cmd, { cwd: dir, encoding: 'utf8', timeout: 120000, env: { ...process.env, FORCE_COLOR: '0' }, stdio: 'pipe' });
+    const duration = Date.now() - start;
+    return { suite: `${suite} (${label})`, duration, ...parseOutput(output, true) };
+  } catch (err) {
+    const duration = Date.now() - start;
+    const output = (err.stdout || '') + (err.stderr || '') + (err.message || '');
+    return { suite: `${suite} (${label})`, duration, ...parseOutput(output, false) };
+  }
+}
+
+// ─── Output parsers ───────────────────────────────────────────────────────────
+
+function parseJestTextOutput(output, label, duration) {
+  const passMatch = output.match(/(\d+)\s+passed/);
+  const failMatch = output.match(/(\d+)\s+failed/);
+  const skipMatch = output.match(/(\d+)\s+(?:skipped|pending)/);
+  const passed  = passMatch ? parseInt(passMatch[1]) : 0;
+  const failed  = failMatch ? parseInt(failMatch[1]) : 0;
+  const skipped = skipMatch ? parseInt(skipMatch[1]) : 0;
+  return { suite: `Jest (${label})`, status: failed > 0 ? 'failed' : (passed > 0 ? 'passed' : 'unknown'), passed, failed, skipped, duration, output: output.slice(-3000) };
+}
+
+function parsePytestOutput(output, exitOk) {
+  const m = output.match(/(\d+)\s+passed(?:,\s*(\d+)\s+failed)?(?:,\s*(\d+)\s+(?:warning|skipped))?/);
+  const failed  = output.match(/(\d+)\s+failed/)?.[1];
+  const passed  = m?.[1] || '0';
+  const skipped = output.match(/(\d+)\s+(?:skipped|deselected)/)?.[1] || '0';
+  const status  = parseInt(failed || '0') > 0 ? 'failed' : (exitOk ? 'passed' : 'failed');
+  return { status, passed: parseInt(passed), failed: parseInt(failed || '0'), skipped: parseInt(skipped), output: output.slice(-3000) };
+}
+
+function parseGoTestOutput(output, exitOk) {
+  const passLines = (output.match(/--- PASS:/g) || []).length;
+  const failLines = (output.match(/--- FAIL:/g) || []).length;
+  const skipLines = (output.match(/--- SKIP:/g) || []).length;
+  return { status: failLines > 0 ? 'failed' : (exitOk ? 'passed' : 'failed'), passed: passLines, failed: failLines, skipped: skipLines, output: output.slice(-3000) };
+}
+
+function parseCargoOutput(output, exitOk) {
+  const m = output.match(/test result:.*?(\d+)\s+passed;\s*(\d+)\s+failed;\s*(\d+)\s+ignored/);
+  return { status: m && parseInt(m[2]) > 0 ? 'failed' : (exitOk ? 'passed' : 'failed'), passed: parseInt(m?.[1] || '0'), failed: parseInt(m?.[2] || '0'), skipped: parseInt(m?.[3] || '0'), output: output.slice(-3000) };
+}
+
+function parseMavenOutput(output, exitOk) {
+  const m = output.match(/Tests run:\s*(\d+),\s*Failures:\s*(\d+),\s*Errors:\s*(\d+),\s*Skipped:\s*(\d+)/);
+  const failed  = m ? parseInt(m[2]) + parseInt(m[3]) : 0;
+  const passed  = m ? parseInt(m[1]) - failed - parseInt(m[4]) : 0;
+  const skipped = m ? parseInt(m[4]) : 0;
+  return { status: failed > 0 ? 'failed' : (exitOk ? 'passed' : 'failed'), passed, failed, skipped, output: output.slice(-3000) };
+}
+
+function parseGradleOutput(output, exitOk) {
+  const m = output.match(/(\d+)\s+tests?\s+completed(?:,\s*(\d+)\s+failed)?/);
+  const failed  = m?.[2] ? parseInt(m[2]) : 0;
+  const total   = m ? parseInt(m[1]) : 0;
+  return { status: failed > 0 ? 'failed' : (exitOk ? 'passed' : 'failed'), passed: total - failed, failed, skipped: 0, output: output.slice(-3000) };
+}
+
+function parseMochaOutput(output, exitOk) {
+  const passMatch = output.match(/(\d+)\s+passing/);
+  const failMatch = output.match(/(\d+)\s+failing/);
+  const pending   = output.match(/(\d+)\s+pending/);
+  const passed  = passMatch ? parseInt(passMatch[1]) : 0;
+  const failed  = failMatch ? parseInt(failMatch[1]) : 0;
+  const skipped = pending   ? parseInt(pending[1])   : 0;
+  return { status: failed > 0 ? 'failed' : (exitOk ? 'passed' : 'failed'), passed, failed, skipped, output: output.slice(-3000) };
+}
+
+function parseVitestOutput(output, exitOk) {
+  const passMatch = output.match(/(\d+)\s+(?:test[s]?\s+)?passed/i);
+  const failMatch = output.match(/(\d+)\s+(?:test[s]?\s+)?failed/i);
+  const passed  = passMatch ? parseInt(passMatch[1]) : 0;
+  const failed  = failMatch ? parseInt(failMatch[1]) : 0;
+  return { status: failed > 0 ? 'failed' : (exitOk ? 'passed' : 'failed'), passed, failed, skipped: 0, output: output.slice(-3000) };
+}
+
+function parsePHPUnitOutput(output, exitOk) {
+  const m = output.match(/OK\s+\((\d+)\s+tests?/);
+  const f = output.match(/FAILURES!\s*\nTests:\s*(\d+),.*?Failures:\s*(\d+)/s);
+  if (f) return { status: 'failed', passed: parseInt(f[1]) - parseInt(f[2]), failed: parseInt(f[2]), skipped: 0, output: output.slice(-3000) };
+  return { status: exitOk ? 'passed' : 'failed', passed: m ? parseInt(m[1]) : 0, failed: 0, skipped: 0, output: output.slice(-3000) };
+}
+
+function parseRSpecOutput(output, exitOk) {
+  const m = output.match(/(\d+)\s+examples?,\s*(\d+)\s+failures?/);
+  return { status: m && parseInt(m[2]) > 0 ? 'failed' : (exitOk ? 'passed' : 'failed'), passed: m ? parseInt(m[1]) - parseInt(m[2]) : 0, failed: m ? parseInt(m[2]) : 0, skipped: 0, output: output.slice(-3000) };
+}
+
+function parseDartOutput(output, exitOk) {
+  const passMatch = output.match(/(\d+) tests? passed/);
+  const failMatch = output.match(/(\d+) tests? failed/);
+  const passed  = passMatch ? parseInt(passMatch[1]) : 0;
+  const failed  = failMatch ? parseInt(failMatch[1]) : 0;
+  return { status: failed > 0 ? 'failed' : (exitOk ? 'passed' : 'failed'), passed, failed, skipped: 0, output: output.slice(-3000) };
+}
+
+function parseDotnetOutput(output, exitOk) {
+  const m = output.match(/Passed!\s+-\s+Failed:\s*(\d+),\s*Passed:\s*(\d+),\s*Skipped:\s*(\d+)/);
+  if (m) return { status: parseInt(m[1]) > 0 ? 'failed' : 'passed', passed: parseInt(m[2]), failed: parseInt(m[1]), skipped: parseInt(m[3]), output: output.slice(-3000) };
+  const f = output.match(/Failed:\s*(\d+)/); const p = output.match(/Passed:\s*(\d+)/);
+  return { status: exitOk ? 'passed' : 'failed', passed: p ? parseInt(p[1]) : 0, failed: f ? parseInt(f[1]) : 0, skipped: 0, output: output.slice(-3000) };
+}
+
+// ─── Utility helpers ──────────────────────────────────────────────────────────
+
+function tryReadJSON(p) { try { return JSON.parse(fs.readFileSync(p, 'utf8')); } catch { return null; } }
+function allDeps(pkg) { return [...Object.keys(pkg.dependencies || {}), ...Object.keys(pkg.devDependencies || {}), ...Object.keys(pkg.peerDependencies || {})]; }
+function commandExists(cmd) { try { execSync(`which ${cmd} 2>/dev/null || command -v ${cmd} 2>/dev/null`, { encoding: 'utf8' }).trim(); return true; } catch { return false; } }
+function hasBin(dir, bin) { return fs.existsSync(path.join(dir, 'node_modules', '.bin', bin)); }
+function hasSourceExt(root, ext) {
+  try { return fs.readdirSync(root).some(f => f.endsWith(ext)); } catch { return false; }
+}
+function findSubPackages(root) {
+  try {
+    return fs.readdirSync(root, { withFileTypes: true })
+      .filter(e => e.isDirectory() && !['node_modules', '.git', 'dist', 'build'].includes(e.name))
+      .map(e => path.join(root, e.name, 'package.json'))
+      .filter(p => fs.existsSync(p));
+  } catch { return []; }
+}
+function findSubDirs(root) {
+  try {
+    return fs.readdirSync(root, { withFileTypes: true })
+      .filter(e => e.isDirectory() && !['node_modules', '.git', 'dist', 'build', '.next', '__pycache__', 'venv', '.venv'].includes(e.name))
+      .map(e => path.join(root, e.name));
+  } catch { return []; }
+}
+
+module.exports = { runAllTests };

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "project-scan",
+  "version": "1.0.0",
+  "description": "Universal project summarizer & test runner — scans any project for languages, frameworks, databases, cloud services, CI/CD pipelines and runs tests. Works with JavaScript, TypeScript, Python, Go, Rust, Java, Kotlin, PHP, Ruby, Dart, C#, and more.",
+  "main": "lib/scanner.js",
+  "bin": {
+    "project-scan": "bin/project-scan.js"
+  },
+  "scripts": {
+    "scan": "node bin/project-scan.js",
+    "start": "node bin/project-scan.js",
+    "test": "node bin/project-scan.js --tests-only"
+  },
+  "keywords": [
+    "project-scan",
+    "project-summarizer",
+    "test-runner",
+    "documentation",
+    "code-analysis",
+    "devtools",
+    "cli",
+    "universal"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "preferGlobal": true,
+  "files": [
+    "bin/",
+    "lib/",
+    "README.md"
+  ]
+}