clckernel 1.2.6 → 1.2.8

package/test/detector.test.js

@@ -1,345 +0,0 @@
-const { describe, it } = require('node:test');
-const assert = require('node:assert');
-const path = require('path');
-const fs = require('fs');
-const { createTmpProject, teardown } = require('./helpers');
-
-describe('autoDetectStack', () => {
-  const { autoDetectStack } = require('../src/detector');
-
-  describe('Next.js detection', () => {
-    it('detects package.json with "next" in dependencies', () => {
-      const dir = createTmpProject({
-        'package.json': JSON.stringify({ dependencies: { next: '14.0.0' } }),
-      });
-      try {
-        const config = autoDetectStack(dir);
-        assert.strictEqual(config.projectType, 'frontend');
-        assert.strictEqual(config.framework, 'Next.js (App Router)');
-        assert.strictEqual(config.testRunner, 'Vitest / Jest');
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('detects package.json with "next" in devDependencies', () => {
-      const dir = createTmpProject({
-        'package.json': JSON.stringify({ devDependencies: { next: '15.0.0' } }),
-      });
-      try {
-        const config = autoDetectStack(dir);
-        assert.strictEqual(config.projectType, 'frontend');
-        assert.strictEqual(config.framework, 'Next.js (App Router)');
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('Django detection', () => {
-    it('detects manage.py presence', () => {
-      const dir = createTmpProject({ 'manage.py': '' });
-      try {
-        const config = autoDetectStack(dir);
-        assert.strictEqual(config.projectType, 'backend');
-        assert.strictEqual(config.framework, 'Django Framework');
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('detects requirements.txt with django', () => {
-      const dir = createTmpProject({
-        'requirements.txt': 'django>=4.0\ndjangorestframework\n',
-      });
-      try {
-        const config = autoDetectStack(dir);
-        assert.strictEqual(config.projectType, 'backend');
-        assert.strictEqual(config.framework, 'Django Framework');
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('detects pyproject.toml with django', () => {
-      const dir = createTmpProject({
-        'pyproject.toml': '[project]\nname = "myapp"\ndependencies = ["django>=4.0"]\n',
-      });
-      try {
-        const config = autoDetectStack(dir);
-        assert.strictEqual(config.projectType, 'backend');
-        assert.strictEqual(config.framework, 'Django Framework');
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('Go detection', () => {
-    it('detects go.mod presence', () => {
-      const dir = createTmpProject({
-        'go.mod': 'module example.com/myapp\n\ngo 1.21\n',
-      });
-      try {
-        const config = autoDetectStack(dir);
-        assert.strictEqual(config.projectType, 'backend');
-        assert.strictEqual(config.framework, 'Go (Golang)');
-        assert.strictEqual(config.testRunner, 'go test');
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('FastAPI detection', () => {
-    it('detects pyproject.toml with fastapi', () => {
-      const dir = createTmpProject({
-        'pyproject.toml': '[project]\nname = "myapi"\ndependencies = ["fastapi"]\n',
-      });
-      try {
-        const config = autoDetectStack(dir);
-        assert.strictEqual(config.projectType, 'backend');
-        assert.strictEqual(config.framework, 'FastAPI Framework');
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('Astro detection', () => {
-    it('detects package.json with astro', () => {
-      const dir = createTmpProject({
-        'package.json': JSON.stringify({ dependencies: { astro: '3.0.0' } }),
-      });
-      try {
-        const config = autoDetectStack(dir);
-        assert.strictEqual(config.projectType, 'frontend');
-        assert.strictEqual(config.framework, 'Astro Framework');
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('Rails detection', () => {
-    it('detects Gemfile with rails and config/routes.rb', () => {
-      const dir = createTmpProject({
-        'Gemfile': "source 'https://rubygems.org'\ngem 'rails', '~> 7.0'\n",
-        'config/routes.rb': "Rails.application.routes.draw do\nend\n",
-      });
-      try {
-        const config = autoDetectStack(dir);
-        assert.strictEqual(config.projectType, 'backend');
-        assert.strictEqual(config.framework, 'Ruby on Rails');
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('Rust detection', () => {
-    it('detects Cargo.toml with [package]', () => {
-      const dir = createTmpProject({
-        'Cargo.toml': '[package]\nname = "myapp"\nversion = "0.1.0"\nedition = "2021"\n',
-      });
-      try {
-        const config = autoDetectStack(dir);
-        assert.strictEqual(config.projectType, 'backend');
-        assert.strictEqual(config.framework, 'Rust Engine');
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('Laravel detection', () => {
-    it('detects artisan and composer.json', () => {
-      const dir = createTmpProject({
-        artisan: '',
-        'composer.json': JSON.stringify({ require: { 'laravel/framework': '^10.0' } }),
-      });
-      try {
-        const config = autoDetectStack(dir);
-        assert.strictEqual(config.projectType, 'backend');
-        assert.strictEqual(config.framework, 'PHP / Laravel');
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('Fallback detection', () => {
-    it('returns frontend/Next.js fallback when src/app exists but no adapter matches', () => {
-      const dir = createTmpProject({
-        'src/app/page.tsx': '',
-      });
-      try {
-        const config = autoDetectStack(dir);
-        assert.strictEqual(config.projectType, 'frontend');
-        assert.strictEqual(config.framework, 'Next.js');
-        assert.strictEqual(config.testRunner, 'Vitest');
-        assert.strictEqual(config.adapter, null);
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('returns frontend/Next.js fallback when src/pages exists but no adapter matches', () => {
-      const dir = createTmpProject({
-        'src/pages/index.tsx': '',
-      });
-      try {
-        const config = autoDetectStack(dir);
-        assert.strictEqual(config.projectType, 'frontend');
-        assert.strictEqual(config.framework, 'Next.js');
-        assert.strictEqual(config.adapter, null);
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('returns backend/FastAPI fallback for empty directory', () => {
-      const dir = createTmpProject({});
-      try {
-        const config = autoDetectStack(dir);
-        assert.strictEqual(config.projectType, 'backend');
-        assert.strictEqual(config.framework, 'FastAPI');
-        assert.strictEqual(config.testRunner, 'Pytest');
-        assert.strictEqual(config.adapter, null);
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('returns fallback backend config when package.json has unknown dependencies', () => {
-      const dir = createTmpProject({
-        'package.json': JSON.stringify({ dependencies: { lodash: '4.17.21' } }),
-      });
-      try {
-        const config = autoDetectStack(dir);
-        assert.strictEqual(config.adapter, null);
-        assert.strictEqual(config.projectType, 'backend');
-        assert.strictEqual(config.framework, 'FastAPI');
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('Husky detection', () => {
-    it('returns gitHooks=husky when .husky directory exists', () => {
-      const dir = createTmpProject({
-        'package.json': JSON.stringify({ dependencies: { next: '14.0.0' } }),
-        '.husky/pre-commit': '#!/bin/sh\nnpm test\n',
-      });
-      try {
-        const config = autoDetectStack(dir);
-        assert.strictEqual(config.gitHooks, 'husky');
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('returns gitHooks=githooks when .husky directory is absent', () => {
-      const dir = createTmpProject({
-        'package.json': JSON.stringify({ dependencies: { next: '14.0.0' } }),
-      });
-      try {
-        const config = autoDetectStack(dir);
-        assert.strictEqual(config.gitHooks, 'githooks');
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('returns gitHooks=husky in fallback when .husky exists', () => {
-      const dir = createTmpProject({
-        '.husky/pre-commit': '',
-      });
-      try {
-        const config = autoDetectStack(dir);
-        assert.strictEqual(config.gitHooks, 'husky');
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('config object shape', () => {
-    it('returns all required fields for a matched adapter', () => {
-      const dir = createTmpProject({
-        'package.json': JSON.stringify({ dependencies: { next: '14.0.0' } }),
-      });
-      try {
-        const config = autoDetectStack(dir);
-        assert.ok('projectType' in config, 'missing projectType');
-        assert.ok('framework' in config, 'missing framework');
-        assert.ok('styling' in config, 'missing styling');
-        assert.ok('uiLibrary' in config, 'missing uiLibrary');
-        assert.ok('testRunner' in config, 'missing testRunner');
-        assert.ok('gitHooks' in config, 'missing gitHooks');
-        assert.ok('orm' in config, 'missing orm');
-        assert.ok('adapter' in config, 'missing adapter');
-        assert.ok(config.adapter !== null, 'adapter should be set');
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('sets styling and uiLibrary for frontend adapters', () => {
-      const dir = createTmpProject({
-        'package.json': JSON.stringify({ dependencies: { next: '14.0.0' } }),
-      });
-      try {
-        const config = autoDetectStack(dir);
-        assert.strictEqual(config.styling, 'Tailwind CSS v4');
-        assert.strictEqual(config.uiLibrary, 'Component Primitives');
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('sets N/A for styling and uiLibrary on backend adapters', () => {
-      const dir = createTmpProject({ 'go.mod': 'module example.com\n' });
-      try {
-        const config = autoDetectStack(dir);
-        assert.strictEqual(config.styling, 'N/A');
-        assert.strictEqual(config.uiLibrary, 'N/A');
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('returns all required fields for fallback config', () => {
-      const dir = createTmpProject({});
-      try {
-        const config = autoDetectStack(dir);
-        assert.ok('projectType' in config);
-        assert.ok('framework' in config);
-        assert.ok('styling' in config);
-        assert.ok('uiLibrary' in config);
-        assert.ok('testRunner' in config);
-        assert.ok('gitHooks' in config);
-        assert.ok('orm' in config);
-        assert.strictEqual(config.adapter, null);
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('adapter priority', () => {
-    it('Next.js matches before Django when both signals exist', () => {
-      const dir = createTmpProject({
-        'package.json': JSON.stringify({ dependencies: { next: '14.0.0' } }),
-        'manage.py': '',
-      });
-      try {
-        const config = autoDetectStack(dir);
-        assert.strictEqual(config.framework, 'Next.js (App Router)');
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-});

package/test/doctor.test.js

@@ -1,302 +0,0 @@
-const { describe, it, beforeEach, afterEach } = require('node:test');
-const assert = require('node:assert');
-const path = require('path');
-const fs = require('fs');
-const { createTmpProject, teardown } = require('./helpers');
-
-describe('runDoctor', () => {
-  const { runDoctor } = require('../src/doctor');
-
-  /**
-   * Helper: create a fully healthy project with all required structures.
-   */
-  function createHealthyProject() {
-    return createTmpProject({
-      'AGENTS.md': '# AGENTS.md\nProject governance rules.\n',
-      'sdds/.gitkeep': '',
-      'docs/Journal/001-adr.md': '# ADR 001\n',
-      'tools/audit.js': "const scan = require('./check_scan');\nmodule.exports = { scan };\n",
-      'tools/check_scan.js': 'module.exports = function check() { return true; };\n',
-      'tools/check_lint.py': 'def check():\n    return True\n',
-      '.husky/pre-commit': '#!/usr/bin/env sh\nnpm test\n',
-    });
-  }
-
-  let capturedOutput;
-  let originalLog;
-
-  beforeEach(() => {
-    capturedOutput = [];
-    originalLog = console.log;
-    console.log = (...args) => capturedOutput.push(args.join(' '));
-  });
-
-  afterEach(() => {
-    console.log = originalLog;
-  });
-
-  describe('healthy project (all checks pass)', () => {
-    it('reports HEALTHY when all files and tools are present', () => {
-      const dir = createHealthyProject();
-      try {
-        runDoctor(dir);
-        const output = capturedOutput.join('\n');
-        assert.ok(output.includes('HEALTHY'), 'output should contain HEALTHY');
-        assert.ok(output.includes('[PASS]'), 'output should contain PASS markers');
-        assert.ok(!output.includes('[FAIL]'), 'should have no FAIL markers');
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('has PASS status for AGENTS.md check', () => {
-      const dir = createHealthyProject();
-      try {
-        runDoctor(dir);
-        const output = capturedOutput.join('\n');
-        assert.ok(output.includes('AGENTS.md law document'), 'should check AGENTS.md');
-        // The PASS line for AGENTS.md
-        assert.ok(output.includes('[PASS]') && output.includes('AGENTS.md'), 'AGENTS.md should be PASS');
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('has PASS status for tools/ check', () => {
-      const dir = createHealthyProject();
-      try {
-        runDoctor(dir);
-        const output = capturedOutput.join('\n');
-        assert.ok(output.includes('tools/ safeguard suite'), 'should check tools/');
-        assert.ok(output.includes('[PASS]') && output.includes('tools/ safeguard suite'), 'tools/ should be PASS');
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('validates JS tool loads successfully', () => {
-      const dir = createHealthyProject();
-      try {
-        runDoctor(dir);
-        const output = capturedOutput.join('\n');
-        assert.ok(output.includes('tool/check_scan.js loads'), 'should validate check_scan.js');
-        assert.ok(output.includes('[PASS]') && output.includes('check_scan.js loads'), 'check_scan.js should PASS');
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('validates Python tool parses successfully', () => {
-      const dir = createHealthyProject();
-      try {
-        runDoctor(dir);
-        const output = capturedOutput.join('\n');
-        assert.ok(output.includes('tool/check_lint.py parses'), 'should validate check_lint.py');
-        assert.ok(output.includes('[PASS]') && output.includes('check_lint.py parses'), 'check_lint.py should PASS');
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('validates audit.js import alignment', () => {
-      const dir = createHealthyProject();
-      try {
-        runDoctor(dir);
-        const output = capturedOutput.join('\n');
-        assert.ok(output.includes('audit.js import ./check_scan'), 'should check audit.js import');
-        assert.ok(output.includes('[PASS]') && output.includes('audit.js import ./check_scan'), 'audit.js import should PASS');
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('missing AGENTS.md', () => {
-    it('marks AGENTS.md check as FAIL', () => {
-      const dir = createTmpProject({
-        'sdds/.gitkeep': '',
-        'docs/Journal/001-adr.md': '# ADR\n',
-        'tools/check_scan.js': 'module.exports = function() {};\n',
-        '.husky/pre-commit': '#!/usr/bin/env sh\necho test\n',
-      });
-      try {
-        runDoctor(dir);
-        const output = capturedOutput.join('\n');
-        assert.ok(output.includes('[FAIL]') && output.includes('AGENTS.md law document'), 'AGENTS.md should be FAIL');
-        assert.ok(!output.includes('HEALTHY'), 'should not be HEALTHY');
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('missing sdds/ directory', () => {
-    it('marks sdds/ check as FAIL', () => {
-      const dir = createTmpProject({
-        'AGENTS.md': '# AGENTS\n',
-        'docs/Journal/001-adr.md': '# ADR\n',
-        'tools/check_scan.js': 'module.exports = function() {};\n',
-        '.husky/pre-commit': '#!/usr/bin/env sh\necho test\n',
-      });
-      try {
-        runDoctor(dir);
-        const output = capturedOutput.join('\n');
-        assert.ok(output.includes('[FAIL]') && output.includes('sdds/'), 'sdds/ should be FAIL');
-        assert.ok(!output.includes('HEALTHY'), 'should not be HEALTHY');
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('missing tools/ directory', () => {
-    it('marks tools/ safeguard suite as FAIL', () => {
-      const dir = createTmpProject({
-        'AGENTS.md': '# AGENTS\n',
-        'sdds/.gitkeep': '',
-        'docs/Journal/001-adr.md': '# ADR\n',
-        '.husky/pre-commit': '#!/usr/bin/env sh\necho test\n',
-      });
-      try {
-        runDoctor(dir);
-        const output = capturedOutput.join('\n');
-        assert.ok(output.includes('[FAIL]') && output.includes('tools/ safeguard suite'), 'tools/ should be FAIL');
-        assert.ok(!output.includes('HEALTHY'), 'should not be HEALTHY');
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('missing pre-commit hooks', () => {
-    it('marks pre-commit git hooks as FAIL when neither .husky nor .githooks exist', () => {
-      const dir = createTmpProject({
-        'AGENTS.md': '# AGENTS\n',
-        'sdds/.gitkeep': '',
-        'docs/Journal/001-adr.md': '# ADR\n',
-        'tools/check_scan.js': 'module.exports = function() {};\n',
-      });
-      try {
-        runDoctor(dir);
-        const output = capturedOutput.join('\n');
-        assert.ok(output.includes('[FAIL]') && output.includes('pre-commit git hooks'), 'pre-commit hooks should be FAIL');
-        assert.ok(!output.includes('HEALTHY'), 'should not be HEALTHY');
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('marks pre-commit git hooks as PASS when .githooks/pre-commit exists', () => {
-      const dir = createTmpProject({
-        'AGENTS.md': '# AGENTS\n',
-        'sdds/.gitkeep': '',
-        'docs/Journal/001-adr.md': '# ADR\n',
-        'tools/check_scan.js': 'module.exports = function() {};\n',
-        '.githooks/pre-commit': '#!/usr/bin/env bash\necho test\n',
-      });
-      try {
-        runDoctor(dir);
-        const output = capturedOutput.join('\n');
-        assert.ok(output.includes('[PASS]') && output.includes('pre-commit git hooks'), '.githooks should be PASS');
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('broken JS tool (require fails)', () => {
-    it('marks tool/check_broken.js loads as FAIL when require fails', () => {
-      const dir = createTmpProject({
-        'AGENTS.md': '# AGENTS\n',
-        'sdds/.gitkeep': '',
-        'docs/Journal/001-adr.md': '# ADR\n',
-        'tools/check_broken.js': "const missing = require('./nonexistent');\nmodule.exports = {};\n",
-        '.husky/pre-commit': '#!/usr/bin/env sh\necho test\n',
-      });
-      try {
-        runDoctor(dir);
-        const output = capturedOutput.join('\n');
-        assert.ok(output.includes('[FAIL]') && output.includes('tool/check_broken.js loads'), 'broken JS tool should FAIL');
-        assert.ok(!output.includes('HEALTHY'), 'should not be HEALTHY');
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('broken Python tool (ast.parse fails)', () => {
-    it('marks tool/check_bad.py parses as FAIL when syntax is invalid', () => {
-      const dir = createTmpProject({
-        'AGENTS.md': '# AGENTS\n',
-        'sdds/.gitkeep': '',
-        'docs/Journal/001-adr.md': '# ADR\n',
-        'tools/check_bad.py': 'def broken(\n    return True\n',  // Missing closing paren
-        '.husky/pre-commit': '#!/usr/bin/env sh\necho test\n',
-      });
-      try {
-        runDoctor(dir);
-        const output = capturedOutput.join('\n');
-        assert.ok(output.includes('[FAIL]') && output.includes('tool/check_bad.py parses'), 'broken Python tool should FAIL');
-        assert.ok(!output.includes('HEALTHY'), 'should not be HEALTHY');
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('English output', () => {
-    it('outputs all messages in English (no Spanish)', () => {
-      const dir = createHealthyProject();
-      try {
-        runDoctor(dir);
-        const output = capturedOutput.join('\n');
-        // Key English phrases that should be present
-        assert.ok(output.includes('HEALTHY'), 'should output HEALTHY');
-        assert.ok(output.includes('CLC KERNEL DOCTOR') || output.includes('CLC FORGE DOCTOR'), 'should output doctor header');
-        assert.ok(output.includes('PASS'), 'should output PASS');
-        // Spanish phrases that should NOT be present
-        const spanishWords = ['éxito', 'éxito', 'falló', 'problema', 'instalado', 'salvaguardas', 'leyes'];
-        for (const word of spanishWords) {
-          assert.ok(!output.toLowerCase().includes(word), `should not contain Spanish word: ${word}`);
-        }
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('audit.js import alignment failure', () => {
-    it('marks audit.js import as FAIL when required module is missing', () => {
-      const dir = createTmpProject({
-        'AGENTS.md': '# AGENTS\n',
-        'sdds/.gitkeep': '',
-        'docs/Journal/001-adr.md': '# ADR\n',
-        'tools/audit.js': "const checker = require('./check_nonexistent');\nmodule.exports = {};\n",
-        '.husky/pre-commit': '#!/usr/bin/env sh\necho test\n',
-      });
-      try {
-        runDoctor(dir);
-        const output = capturedOutput.join('\n');
-        assert.ok(output.includes('[FAIL]') && output.includes('audit.js import ./check_nonexistent'), 'audit.js import should FAIL');
-        assert.ok(output.includes('Module not found in tools/'), 'should show detail message');
-        assert.ok(!output.includes('HEALTHY'), 'should not be HEALTHY');
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('multiple issues detected', () => {
-    it('reports correct count of issues', () => {
-      const dir = createTmpProject({}); // Empty project — many checks fail
-      try {
-        runDoctor(dir);
-        const output = capturedOutput.join('\n');
-        assert.ok(output.includes('issue(s) detected'), 'should report issues detected');
-        assert.ok(!output.includes('HEALTHY'), 'should not be HEALTHY');
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-});