Files
everything-claude-code/tests/lib/project-detect.test.js
justtrance-web 912df24f4a feat: automatic project type and framework detection (#293)
Add SessionStart hook integration that auto-detects project languages
and frameworks by inspecting marker files and dependency manifests.

Supports 12 languages (Python, TypeScript, Go, Rust, Ruby, Java, C#,
Swift, Kotlin, Elixir, PHP, JavaScript) and 25+ frameworks (Next.js,
React, Django, FastAPI, Rails, Laravel, Spring, etc.).

Detection output is injected into Claude's context as JSON, enabling
context-aware recommendations without loading irrelevant rules.

- New: scripts/lib/project-detect.js (cross-platform detection library)
- Modified: scripts/hooks/session-start.js (integration)
- New: tests/lib/project-detect.test.js (28 tests, all passing)

Co-authored-by: Claude <noreply@anthropic.com>
2026-03-02 22:07:10 -08:00

419 lines
13 KiB
JavaScript

/**
* Tests for scripts/lib/project-detect.js
*
* Run with: node tests/lib/project-detect.test.js
*/
const assert = require('assert');
const path = require('path');
const fs = require('fs');
const os = require('os');
const {
detectProjectType,
LANGUAGE_RULES,
FRAMEWORK_RULES,
getPackageJsonDeps,
getPythonDeps,
getGoDeps,
getRustDeps,
getComposerDeps,
getElixirDeps
} = require('../../scripts/lib/project-detect');
// Test helper
function test(name, fn) {
try {
fn();
console.log(` \u2713 ${name}`);
return true;
} catch (err) {
console.log(` \u2717 ${name}`);
console.log(` Error: ${err.message}`);
return false;
}
}
// Create a temporary directory for testing
function createTempDir() {
return fs.mkdtempSync(path.join(os.tmpdir(), 'ecc-test-'));
}
// Clean up temp directory
function cleanupDir(dir) {
try {
fs.rmSync(dir, { recursive: true, force: true });
} catch { /* ignore */ }
}
// Write a file in the temp directory
function writeTestFile(dir, filePath, content = '') {
const fullPath = path.join(dir, filePath);
const dirName = path.dirname(fullPath);
fs.mkdirSync(dirName, { recursive: true });
fs.writeFileSync(fullPath, content, 'utf8');
}
function runTests() {
console.log('\n=== Testing project-detect.js ===\n');
let passed = 0;
let failed = 0;
// Rule definitions tests
console.log('Rule Definitions:');
if (test('LANGUAGE_RULES is non-empty array', () => {
assert.ok(Array.isArray(LANGUAGE_RULES));
assert.ok(LANGUAGE_RULES.length > 0);
})) passed++; else failed++;
if (test('FRAMEWORK_RULES is non-empty array', () => {
assert.ok(Array.isArray(FRAMEWORK_RULES));
assert.ok(FRAMEWORK_RULES.length > 0);
})) passed++; else failed++;
if (test('each language rule has type, markers, and extensions', () => {
for (const rule of LANGUAGE_RULES) {
assert.ok(typeof rule.type === 'string', `Missing type`);
assert.ok(Array.isArray(rule.markers), `Missing markers for ${rule.type}`);
assert.ok(Array.isArray(rule.extensions), `Missing extensions for ${rule.type}`);
}
})) passed++; else failed++;
if (test('each framework rule has framework, language, markers, packageKeys', () => {
for (const rule of FRAMEWORK_RULES) {
assert.ok(typeof rule.framework === 'string', `Missing framework`);
assert.ok(typeof rule.language === 'string', `Missing language for ${rule.framework}`);
assert.ok(Array.isArray(rule.markers), `Missing markers for ${rule.framework}`);
assert.ok(Array.isArray(rule.packageKeys), `Missing packageKeys for ${rule.framework}`);
}
})) passed++; else failed++;
// Empty directory detection
console.log('\nEmpty Directory:');
if (test('empty directory returns unknown primary', () => {
const dir = createTempDir();
try {
const result = detectProjectType(dir);
assert.strictEqual(result.primary, 'unknown');
assert.deepStrictEqual(result.languages, []);
assert.deepStrictEqual(result.frameworks, []);
assert.strictEqual(result.projectDir, dir);
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
// Python detection
console.log('\nPython Detection:');
if (test('detects python from requirements.txt', () => {
const dir = createTempDir();
try {
writeTestFile(dir, 'requirements.txt', 'flask==3.0.0\nrequests>=2.31');
const result = detectProjectType(dir);
assert.ok(result.languages.includes('python'));
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
if (test('detects python from pyproject.toml', () => {
const dir = createTempDir();
try {
writeTestFile(dir, 'pyproject.toml', '[project]\nname = "test"');
const result = detectProjectType(dir);
assert.ok(result.languages.includes('python'));
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
if (test('detects flask framework from requirements.txt', () => {
const dir = createTempDir();
try {
writeTestFile(dir, 'requirements.txt', 'flask==3.0.0\nrequests>=2.31');
const result = detectProjectType(dir);
assert.ok(result.frameworks.includes('flask'));
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
if (test('detects django framework from manage.py', () => {
const dir = createTempDir();
try {
writeTestFile(dir, 'manage.py', '#!/usr/bin/env python');
writeTestFile(dir, 'requirements.txt', 'django>=4.2');
const result = detectProjectType(dir);
assert.ok(result.frameworks.includes('django'));
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
if (test('detects fastapi from pyproject.toml dependencies', () => {
const dir = createTempDir();
try {
writeTestFile(dir, 'pyproject.toml', '[project]\nname = "test"\ndependencies = [\n "fastapi>=0.100",\n "uvicorn"\n]');
const result = detectProjectType(dir);
assert.ok(result.frameworks.includes('fastapi'));
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
// TypeScript/JavaScript detection
console.log('\nTypeScript/JavaScript Detection:');
if (test('detects typescript from tsconfig.json', () => {
const dir = createTempDir();
try {
writeTestFile(dir, 'tsconfig.json', '{}');
writeTestFile(dir, 'package.json', '{"dependencies":{}}');
const result = detectProjectType(dir);
assert.ok(result.languages.includes('typescript'));
// Should NOT also include javascript when TS is detected
assert.ok(!result.languages.includes('javascript'));
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
if (test('detects nextjs from next.config.mjs', () => {
const dir = createTempDir();
try {
writeTestFile(dir, 'tsconfig.json', '{}');
writeTestFile(dir, 'next.config.mjs', 'export default {}');
writeTestFile(dir, 'package.json', '{"dependencies":{"next":"14.0.0","react":"18.0.0"}}');
const result = detectProjectType(dir);
assert.ok(result.frameworks.includes('nextjs'));
assert.ok(result.frameworks.includes('react'));
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
if (test('detects react from package.json', () => {
const dir = createTempDir();
try {
writeTestFile(dir, 'package.json', '{"dependencies":{"react":"18.0.0","react-dom":"18.0.0"}}');
const result = detectProjectType(dir);
assert.ok(result.frameworks.includes('react'));
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
if (test('detects angular from angular.json', () => {
const dir = createTempDir();
try {
writeTestFile(dir, 'angular.json', '{}');
writeTestFile(dir, 'tsconfig.json', '{}');
writeTestFile(dir, 'package.json', '{"dependencies":{"@angular/core":"17.0.0"}}');
const result = detectProjectType(dir);
assert.ok(result.frameworks.includes('angular'));
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
// Go detection
console.log('\nGo Detection:');
if (test('detects golang from go.mod', () => {
const dir = createTempDir();
try {
writeTestFile(dir, 'go.mod', 'module github.com/test/app\n\ngo 1.22\n\nrequire (\n\tgithub.com/gin-gonic/gin v1.9.1\n)');
const result = detectProjectType(dir);
assert.ok(result.languages.includes('golang'));
assert.ok(result.frameworks.includes('gin'));
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
// Rust detection
console.log('\nRust Detection:');
if (test('detects rust from Cargo.toml', () => {
const dir = createTempDir();
try {
writeTestFile(dir, 'Cargo.toml', '[package]\nname = "test"\n\n[dependencies]\naxum = "0.7"');
const result = detectProjectType(dir);
assert.ok(result.languages.includes('rust'));
assert.ok(result.frameworks.includes('axum'));
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
// Ruby detection
console.log('\nRuby Detection:');
if (test('detects ruby and rails', () => {
const dir = createTempDir();
try {
writeTestFile(dir, 'Gemfile', 'source "https://rubygems.org"\ngem "rails"');
writeTestFile(dir, 'config/routes.rb', 'Rails.application.routes.draw do\nend');
const result = detectProjectType(dir);
assert.ok(result.languages.includes('ruby'));
assert.ok(result.frameworks.includes('rails'));
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
// PHP detection
console.log('\nPHP Detection:');
if (test('detects php and laravel', () => {
const dir = createTempDir();
try {
writeTestFile(dir, 'composer.json', '{"require":{"laravel/framework":"^10.0"}}');
writeTestFile(dir, 'artisan', '#!/usr/bin/env php');
const result = detectProjectType(dir);
assert.ok(result.languages.includes('php'));
assert.ok(result.frameworks.includes('laravel'));
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
// Fullstack detection
console.log('\nFullstack Detection:');
if (test('detects fullstack when frontend + backend frameworks present', () => {
const dir = createTempDir();
try {
writeTestFile(dir, 'package.json', '{"dependencies":{"react":"18.0.0","express":"4.18.0"}}');
const result = detectProjectType(dir);
assert.ok(result.frameworks.includes('react'));
assert.ok(result.frameworks.includes('express'));
assert.strictEqual(result.primary, 'fullstack');
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
// Dependency reader tests
console.log('\nDependency Readers:');
if (test('getPackageJsonDeps reads deps and devDeps', () => {
const dir = createTempDir();
try {
writeTestFile(dir, 'package.json', '{"dependencies":{"react":"18.0.0"},"devDependencies":{"typescript":"5.0.0"}}');
const deps = getPackageJsonDeps(dir);
assert.ok(deps.includes('react'));
assert.ok(deps.includes('typescript'));
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
if (test('getPythonDeps reads requirements.txt', () => {
const dir = createTempDir();
try {
writeTestFile(dir, 'requirements.txt', 'flask>=3.0\n# comment\nrequests==2.31\n-r other.txt');
const deps = getPythonDeps(dir);
assert.ok(deps.includes('flask'));
assert.ok(deps.includes('requests'));
assert.ok(!deps.includes('-r'));
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
if (test('getGoDeps reads go.mod require block', () => {
const dir = createTempDir();
try {
writeTestFile(dir, 'go.mod', 'module test\n\ngo 1.22\n\nrequire (\n\tgithub.com/gin-gonic/gin v1.9.1\n\tgithub.com/lib/pq v1.10.9\n)');
const deps = getGoDeps(dir);
assert.ok(deps.some(d => d.includes('gin-gonic/gin')));
assert.ok(deps.some(d => d.includes('lib/pq')));
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
if (test('getRustDeps reads Cargo.toml', () => {
const dir = createTempDir();
try {
writeTestFile(dir, 'Cargo.toml', '[package]\nname = "test"\n\n[dependencies]\nserde = "1.0"\ntokio = { version = "1.0", features = ["full"] }');
const deps = getRustDeps(dir);
assert.ok(deps.includes('serde'));
assert.ok(deps.includes('tokio'));
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
if (test('returns empty arrays for missing files', () => {
const dir = createTempDir();
try {
assert.deepStrictEqual(getPackageJsonDeps(dir), []);
assert.deepStrictEqual(getPythonDeps(dir), []);
assert.deepStrictEqual(getGoDeps(dir), []);
assert.deepStrictEqual(getRustDeps(dir), []);
assert.deepStrictEqual(getComposerDeps(dir), []);
assert.deepStrictEqual(getElixirDeps(dir), []);
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
// Elixir detection
console.log('\nElixir Detection:');
if (test('detects elixir from mix.exs', () => {
const dir = createTempDir();
try {
writeTestFile(dir, 'mix.exs', 'defmodule Test.MixProject do\n defp deps do\n [{:phoenix, "~> 1.7"},\n {:ecto, "~> 3.0"}]\n end\nend');
const result = detectProjectType(dir);
assert.ok(result.languages.includes('elixir'));
assert.ok(result.frameworks.includes('phoenix'));
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
// Edge cases
console.log('\nEdge Cases:');
if (test('handles non-existent directory gracefully', () => {
const result = detectProjectType('/tmp/nonexistent-dir-' + Date.now());
assert.strictEqual(result.primary, 'unknown');
assert.deepStrictEqual(result.languages, []);
})) passed++; else failed++;
if (test('handles malformed package.json', () => {
const dir = createTempDir();
try {
writeTestFile(dir, 'package.json', 'not valid json{{{');
const deps = getPackageJsonDeps(dir);
assert.deepStrictEqual(deps, []);
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
if (test('handles malformed composer.json', () => {
const dir = createTempDir();
try {
writeTestFile(dir, 'composer.json', '{invalid');
const deps = getComposerDeps(dir);
assert.deepStrictEqual(deps, []);
} finally {
cleanupDir(dir);
}
})) passed++; else failed++;
// Summary
console.log(`\n=== Results: ${passed} passed, ${failed} failed ===\n`);
process.exit(failed > 0 ? 1 : 0);
}
runTests();