clckernel 1.2.6 → 1.2.8

package/tools/check_symlinks.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+/**
+ * Symlink & AI IDE Interoperability Guard
+ * Verifies that AI agent rule mirrors (CLAUDE.md, GEMINI.md, .cursorrules, .windsurfrules)
+ * exist and resolve to valid files without broken symlinks.
+ * Self-contained: uses only Node.js built-ins.
+ *
+ * @param {string} targetDir - Directory to scan (defaults to cwd)
+ * @returns {{ exitCode: number, skipped: boolean, name: string, data: object }}
+ */
+const check = async function checkSymlinks(targetDir) {
+  const fs = require('fs');
+  const path = require('path');
+
+  const dir = targetDir || process.cwd();
+  const rules = ['CLAUDE.md', 'GEMINI.md', '.cursorrules', '.windsurfrules'];
+  const violations = [];
+
+  const agentsPath = path.join(dir, 'AGENTS.md');
+  const hasAgents = fs.existsSync(agentsPath);
+
+  if (!hasAgents) {
+    return {
+      exitCode: 0,
+      skipped: true,
+      name: 'check_symlinks',
+      data: { violations: [], message: 'No AGENTS.md present in project' }
+    };
+  }
+
+  for (const rule of rules) {
+    const filePath = path.join(dir, rule);
+    try {
+      const lstat = fs.lstatSync(filePath);
+      if (lstat.isSymbolicLink()) {
+        const target = fs.readlinkSync(filePath);
+        const resolved = path.isAbsolute(target) ? target : path.resolve(dir, target);
+        if (!fs.existsSync(resolved)) {
+          violations.push({
+            file: rule,
+            message: `Broken symlink: points to non-existent target "${target}"`
+          });
+        }
+      }
+    } catch (err) {
+      if (err.code !== 'ENOENT') {
+        violations.push({
+          file: rule,
+          message: `Error reading symlink: ${err.message}`
+        });
+      }
+    }
+  }
+
+  const exitCode = violations.length > 0 ? 1 : 0;
+  return {
+    exitCode,
+    skipped: false,
+    name: 'check_symlinks',
+    data: {
+      violations,
+      message: violations.length > 0
+        ? `${violations.length} broken or invalid symlink(s) detected`
+        : 'All AI IDE rule mirrors & symlinks verified'
+    }
+  };
+};
+
+module.exports = check;
+
+if (require.main === module) {
+  check(process.argv[2]).then(result => {
+    console.log(JSON.stringify(result, null, 2));
+    process.exit(result.exitCode);
+  });
+}

package/tools/scan_secrets.js

@@ -62,7 +62,18 @@ const check = async function scanSecrets(targetDir) {
 
     let content;
     try {
-      content = fs.readFileSync(filePath, 'utf-8');
+      const buffer = fs.readFileSync(filePath);
+      // Skip binary files (check for null byte in first 512 bytes)
+      let isBinary = false;
+      const checkLen = Math.min(buffer.length, 512);
+      for (let b = 0; b < checkLen; b++) {
+        if (buffer[b] === 0) {
+          isBinary = true;
+          break;
+        }
+      }
+      if (isBinary) continue;
+      content = buffer.toString('utf-8');
     } catch {
       continue;
     }

package/AGENTS.md

@@ -1,124 +0,0 @@
-# 🔨 CLC Kernel (Node.js / Polyglot Core) — AGENTS
-
-This document is the **authoritative law** for AI agents working in this repository.
-Forged by **CLC Kernel: The AI Agent Governance Engine**.
-
----
-
-## 🎯 Project Identity & Category
-**CLC Kernel (`clckernel`)** is the Universal Polyglot AI Agent Governance Engine & AIUP Orchestrator.
-It creates and owns a new category in software engineering: **Deterministic AI Agent Governance**.
-
-Unlike prompt-based rules (`.cursorrules`) or backend agent runtimes (LangGraph), CLC Kernel provides an **in-repo developer harness** that deterministically forces AI coding agents to follow strict engineering lifecycles (SDD, TDD, Clean Architecture AST Linters) across multiple tech stacks (Next.js, FastAPI, Rails, Go, Rust, Laravel, Django, Astro).
-
----
-
-> 🚨 **RULE #0: MANDATORY EXECUTION OVERRIDE RULE (UNBYPASSABLE)**
-> Even when the user issues a direct or urgent fix request ("fix this bug", "fix this error", "quick fix"):
-> YOU ARE STRICTLY FORBIDDEN from modifying source code directly without completing the full quality harness:
-> 1. **Research & Root Cause Analysis:** Investigate tracebacks and inspect affected files before editing.
-> 2. **TDD Verification (Red Phase):** Write a failing regression test first (`npm test`).
-> 3. **Clean Architecture Implementation (Green Phase):** Make the test pass maintaining layer isolation.
-> 4. **Mandatory Educational Audit Gate:** Execute `npm test` and verify zero lint/test regressions.
-> NEVER declare success or skip verification commands for quick fixes.
-
----
-
-## 1. The Engineering Loop (Every Task)
-1. **Research** — Inspect codebase / docs / existing AST linters before writing code.
-2. **Plan** — Write an SDD under `sdds/{change-name}/` when introducing features or architectural refactors.
-3. **Test (TDD)** — Write failing tests first in `test/`.
-4. **Implement** — Write modular, zero-external-dependency code in `src/` or `tools/`.
-5. **Verify & Audit** — Run `npm test` (all 236+ test cases across catalog, adapters, generator, and detector).
-6. **DoD (Definition of Done)** — Clean code, zero regressions, full test coverage, docs updated in English and Spanish.
-7. **Commit** — Pre-commit hook runs automated guards. Use Conventional Commits (`feat:`, `fix:`, `docs:`, `refactor:`, `test:`). Never add AI co-authorship.
-
----
-
-## 2. Core Repository Architecture & Layout
-
-```
-clckernel/
-├── bin/
-│   └── cli.js                  # Executable CLI entrypoint (clckernel, clc-kernel, clc-forge)
-├── src/
-│   ├── index.js                # CLI controller orchestration
-│   ├── catalog.js              # Central 26-guard registry (Single Source of Truth)
-│   ├── config.js               # .clckernel.yml loader & validator (ConfigError)
-│   ├── detector.js             # Stack auto-detection heuristics
-│   ├── doctor.js               # Repository health check engine (CLC KERNEL DOCTOR)
-│   ├── generator.js            # Universal harness, hook, and symlink provisioner
-│   ├── ui.js                   # Terminal UI, ASCII banner & ANSI renderer
-│   ├── yaml.js                 # Zero-dependency YAML parser & glob-to-regex engine
-│   ├── adapters/               # Polyglot stack adapters (Next.js, FastAPI, Rails, Go, Rust, Laravel, Django, Astro)
-│   └── technologies/           # Technology-specific detectors (Celery, Redis, Postgres, Docker)
-├── tools/                      # Deterministic AST linters & safeguard scripts (Node.js & Python stdlib)
-│   ├── audit.js / audit.py     # Multi-guard orchestrator gates
-│   ├── scan_secrets.js / .py   # Secret leak scanners
-│   ├── check_architecture.*    # Clean Architecture layer isolation checkers
-│   ├── check_custom.js / .py   # User-defined regex rules from .clckernel.yml
-│   ├── check_a11y.js           # ARIA & accessibility linter
-│   ├── check_ui_reuse.js       # UI primitive reuse enforcer
-│   ├── check_performance.js    # Next/Image & tree-shaking linter
-│   ├── check_responsive.js     # Mobile-first & touch target linter
-│   ├── check_seo.js            # OpenGraph, SEO & Core Web Vitals linter
-│   ├── check_storybook.js      # Storybook coverage guard
-│   ├── check_api_contracts.js  # Zod schema validation guard
-│   ├── check_migrations.py     # Alembic / Django migration idempotency guard
-│   ├── check_db_efficiency.py  # ORM N+1 & query efficiency guard
-│   ├── check_scope.py          # Git diff vs SDD authorized scope guard
-│   ├── verify_tdd.py           # Red-to-Green transition proof checker
-│   ├── celery_guard.py         # Celery broker & result backend safety guard
-│   ├── redis_guard.py          # Redis decode_responses & timeout guard
-│   ├── postgres_guard.py       # PostgreSQL raw query & injection guard
-│   └── docker_guard.py         # Docker non-root USER & healthcheck guard
-├── test/                       # Comprehensive node:test runner suites
-├── README.md                   # Primary documentation (English)
-├── README.es.md                # Primary documentation (Spanish)
-└── package.json                # Package manifest (@clckernel)
-```
-
----
-
-## 3. Active Safeguard Catalog & Deterministic Rules
-
-All AI agents operating in repositories provisioned by CLC Kernel are deterministically governed by the following safeguard layers:
-
-### 📱 Frontend & UX Quality Safeguards
-- **`check_responsive.js`**: Enforces mobile-first responsive design, warns against fixed-width pixel overflows (`width: >400px` without media queries), and requires minimum touch targets (44x44px or 48x48px) for buttons and interactive controls.
-- **`check_seo.js`**: Validates essential SEO title/description tags, OpenGraph (`og:title`, `og:image`), GEO tags (`geo.position`, `ICBM`), heading hierarchy (`<h1>` uniqueness), and LCP image `priority` / `fetchpriority="high"`.
-- **`check_a11y.js`**: Audits ARIA roles, missing `alt` attributes on images, and keyboard navigable interactive controls.
-- **`check_ui_reuse.js`**: Prevents duplicate UI classes and arbitrary styling by enforcing the reuse of design system primitives in `components/ui/`.
-- **`check_performance.js`**: Enforces framework-native image optimization (`next/image`, `astro:assets`) and prevents barrel-file imports that break tree-shaking.
-- **`check_api_contracts.js`**: Enforces runtime schema validation (Zod) on all external HTTP requests and API boundaries.
-- **`check_storybook.js`**: Audits Storybook `.stories.tsx` coverage for all new UI primitives.
-
-### 🏛️ Backend, Architecture & Data Safeguards
-- **`check_architecture.js / .py`**: Validates Clean Architecture layer boundaries (Domain -> Use Case -> Interface -> Infrastructure) and prevents presentation/route handlers from calling DB queries directly.
-- **`check_db_efficiency.py`**: Detects N+1 query patterns in loops and enforces eager loading (`select_related`, `prefetch_related` in Django; `joinedload` in SQLAlchemy).
-- **`check_migrations.py`**: Ensures database migrations (Alembic / Django) are idempotent, reversible, and do not drop tables/columns destructively without down-revisions.
-- **`scan_secrets.js / .py`**: Scans diffs for private keys, AWS/Stripe credentials, JWT secrets, and hardcoded connection strings.
-- **`check_scope.py`**: Compares modified files against the authorized scope defined in the local SDD specification.
-- **`verify_tdd.py`**: Validates the transition proof from a failing regression test (Red Phase) to a passing implementation (Green Phase).
-
-### 🐳 Infrastructure & Technology Guards
-- **`docker_guard.py`**: Checks Dockerfiles for non-root `USER` directives, prevents `ENV` secret exposures, and requires `HEALTHCHECK` definitions.
-- **`celery_guard.py`**: Enforces broker URL isolation via environment variables, `@shared_task(ignore_result=True)` defaults, and secure backend configs.
-- **`redis_guard.py`**: Enforces `decode_responses=True`, mandatory `socket_connect_timeout`, and prevents hardcoded Redis host strings.
-- **`postgres_guard.py`**: Blocks raw SQL string formatting / Python f-strings in queries to prevent SQL injection vulnerabilities.
-
----
-
-## 4. Recommended Ecosystem Companions
-CLC Kernel is strictly focused on **Governance, Process & Quality Guards**. It relies modularly on companion tools with graceful degradation:
-- 🧠 **Engram (MCP):** Long-term memory, session state, and architectural decision records (ADRs).
-- 🕸️ **Graphify:** Repository knowledge graphs and visual topology mapping.
-- 🛡️ **Gentle AI (RDD):** Review-Driven Development with adversarial dual-lens review gates.
-
----
-
-## 5. Coding & Design Principles
-- **CONCEPTS > CODE:** Never add boilerplate without understanding architectural layer boundaries.
-- **Zero-Dependency Core:** The CLI engine and tool scripts must use native Node.js / Python built-ins wherever possible (zero runtime npm dependencies for the parser and linters).
-- **Polyglot Fidelity:** Native guards must be written in the ecosystem's native idioms (Go AST for Go, Python AST for Python, JS/TS AST for Node).
-- **Graceful Fallbacks:** If optional companion tools or optional linters are missing from the host machine, guards must degrade gracefully with advisory warnings rather than hard crashes.

package/docs/Journal/001-adr-clckernel-governance.md

@@ -1,18 +0,0 @@
-# ADR 001: Deterministic AI Agent Governance Engine
-
-## Status
-Accepted
-
-## Context
-AI coding agents generate code rapidly but introduce technical debt, layer violations, and false-positive test transitions when operating without deterministic guardrails.
-
-## Decision
-Establish **CLC Kernel** (`clckernel`) as a polyglot AI Agent Governance harness implementing the AI Unified Process (AIUP):
-1. **Spec-Driven Development (SDD)** with Human-in-the-Loop gates.
-2. **Test-Driven Development (TDD)** requiring verified failing tests prior to implementation.
-3. **Deterministic AST Linters** tailored per tech stack (Go, Python, Rust, Ruby, JS/TS, PHP).
-4. **Universal IDE Symlinking** from `AGENTS.md` to all AI IDEs (Cursor, Claude, Gemini, Copilot, Antigravity).
-
-## Consequences
-- Guarantees architectural integrity and zero secret leaks.
-- Seamlessly integrates with Engram (memory) and Graphify (knowledge graph).

package/test/adapters/astro.test.js

@@ -1,102 +0,0 @@
-const { describe, it } = require('node:test');
-const assert = require('node:assert');
-const { createTmpProject, teardown } = require('../helpers');
-
-describe('AstroAdapter', () => {
-  const AstroAdapter = require('../../src/adapters/astro');
-
-  describe('constructor', () => {
-    it('creates adapter with correct name and projectType', () => {
-      const adapter = new AstroAdapter();
-      assert.strictEqual(adapter.name, 'Astro Framework');
-      assert.strictEqual(adapter.projectType, 'frontend');
-      assert.strictEqual(adapter.testRunner, 'Vitest / Playwright');
-    });
-  });
-
-  describe('detect()', () => {
-    it('returns true when package.json has astro dependency', () => {
-      const dir = createTmpProject({
-        'package.json': JSON.stringify({ dependencies: { astro: '4.0.0' } }),
-      });
-      try {
-        const adapter = new AstroAdapter();
-        assert.strictEqual(adapter.detect(dir), true);
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('returns true when astro.config.mjs exists', () => {
-      const dir = createTmpProject({
-        'astro.config.mjs': 'export default {}',
-        'package.json': JSON.stringify({ dependencies: {} }),
-      });
-      try {
-        const adapter = new AstroAdapter();
-        assert.strictEqual(adapter.detect(dir), true);
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('returns true when astro.config.js exists', () => {
-      const dir = createTmpProject({
-        'astro.config.js': 'module.exports = {}',
-        'package.json': JSON.stringify({ dependencies: {} }),
-      });
-      try {
-        const adapter = new AstroAdapter();
-        assert.strictEqual(adapter.detect(dir), true);
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('returns false when no package.json exists', () => {
-      const dir = createTmpProject({});
-      try {
-        const adapter = new AstroAdapter();
-        assert.strictEqual(adapter.detect(dir), false);
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('returns false when package.json has no astro and no config file', () => {
-      const dir = createTmpProject({
-        'package.json': JSON.stringify({ dependencies: { react: '18.0.0' } }),
-      });
-      try {
-        const adapter = new AstroAdapter();
-        assert.strictEqual(adapter.detect(dir), false);
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('getTools()', () => {
-    it('returns array of tool objects with required fields', () => {
-      const adapter = new AstroAdapter();
-      const tools = adapter.getTools();
-      assert.ok(Array.isArray(tools));
-      assert.ok(tools.length > 0);
-      for (const tool of tools) {
-        assert.ok(tool.name);
-        assert.ok(tool.language);
-        assert.ok(typeof tool.command === 'string');
-        assert.ok(tool.description);
-      }
-    });
-  });
-
-  describe('getSafeguards()', () => {
-    it('returns non-empty array of strings', () => {
-      const adapter = new AstroAdapter();
-      const guards = adapter.getSafeguards();
-      assert.ok(Array.isArray(guards));
-      assert.ok(guards.length >= 5);
-    });
-  });
-});

package/test/adapters/base.test.js

@@ -1,86 +0,0 @@
-const { describe, it } = require('node:test');
-const assert = require('node:assert');
-const { createTmpProject, teardown } = require('../helpers');
-
-describe('BaseAdapter', () => {
-  const BaseAdapter = require('../../src/adapters/base');
-
-  describe('constructor', () => {
-    it('stores name, projectType, and testRunner', () => {
-      const adapter = new BaseAdapter('Test', 'frontend', 'Jest');
-      assert.strictEqual(adapter.name, 'Test');
-      assert.strictEqual(adapter.projectType, 'frontend');
-      assert.strictEqual(adapter.testRunner, 'Jest');
-    });
-  });
-
-  describe('detect()', () => {
-    it('returns false by default', () => {
-      const adapter = new BaseAdapter('Test', 'frontend', 'Jest');
-      assert.strictEqual(adapter.detect('/tmp'), false);
-    });
-  });
-
-  describe('getSafeguards()', () => {
-    it('returns empty array by default', () => {
-      const adapter = new BaseAdapter('Test', 'frontend', 'Jest');
-      assert.deepStrictEqual(adapter.getSafeguards(), []);
-    });
-  });
-
-  describe('getTools()', () => {
-    it('returns empty array by default', () => {
-      const adapter = new BaseAdapter('Test', 'frontend', 'Jest');
-      assert.deepStrictEqual(adapter.getTools(), []);
-    });
-  });
-
-  describe('provision()', () => {
-    it('creates docs/, sdds/, tools/ directories', () => {
-      const adapter = new BaseAdapter('Test', 'frontend', 'Jest');
-      const dir = createTmpProject({});
-      try {
-        adapter.provision(dir, {});
-
-        assert.ok(require('fs').existsSync(require('path').join(dir, 'docs', 'Journal')));
-        assert.ok(require('fs').existsSync(require('path').join(dir, 'docs', 'Architecture')));
-        assert.ok(require('fs').existsSync(require('path').join(dir, 'docs', 'Development')));
-        assert.ok(require('fs').existsSync(require('path').join(dir, 'sdds')));
-        assert.ok(require('fs').existsSync(require('path').join(dir, 'tools')));
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('writes .gitignore with sdds/* entry', () => {
-      const adapter = new BaseAdapter('Test', 'frontend', 'Jest');
-      const dir = createTmpProject({});
-      try {
-        adapter.provision(dir, {});
-
-        const gitignore = require('fs').readFileSync(
-          require('path').join(dir, '.gitignore'), 'utf-8'
-        );
-        assert.ok(gitignore.includes('sdds/*'));
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('writes AGENTS.md with adapter name and safeguards', () => {
-      const adapter = new BaseAdapter('TestStack', 'backend', 'Pytest');
-      const dir = createTmpProject({});
-      try {
-        adapter.provision(dir, {});
-
-        const agents = require('fs').readFileSync(
-          require('path').join(dir, 'AGENTS.md'), 'utf-8'
-        );
-        assert.ok(agents.includes('TestStack'));
-        assert.ok(agents.includes('BACKEND'));
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-});

package/test/adapters/django.test.js

@@ -1,95 +0,0 @@
-const { describe, it } = require('node:test');
-const assert = require('node:assert');
-const { createTmpProject, teardown } = require('../helpers');
-
-describe('DjangoAdapter', () => {
-  const DjangoAdapter = require('../../src/adapters/django');
-
-  describe('constructor', () => {
-    it('creates adapter with correct name and projectType', () => {
-      const adapter = new DjangoAdapter();
-      assert.strictEqual(adapter.name, 'Django Framework');
-      assert.strictEqual(adapter.projectType, 'backend');
-    });
-  });
-
-  describe('detect()', () => {
-    it('returns true when manage.py exists', () => {
-      const dir = createTmpProject({ 'manage.py': '#!/usr/bin/env python' });
-      try {
-        const adapter = new DjangoAdapter();
-        assert.strictEqual(adapter.detect(dir), true);
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('returns true when requirements.txt contains django', () => {
-      const dir = createTmpProject({ 'requirements.txt': 'django>=4.0\npsycopg2' });
-      try {
-        const adapter = new DjangoAdapter();
-        assert.strictEqual(adapter.detect(dir), true);
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('returns true when pyproject.toml contains django', () => {
-      const dir = createTmpProject({
-        'pyproject.toml': '[project]\nname = "myapp"\ndependencies = ["django>=4.0"]',
-      });
-      try {
-        const adapter = new DjangoAdapter();
-        assert.strictEqual(adapter.detect(dir), true);
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('returns false when no django indicators present', () => {
-      const dir = createTmpProject({
-        'requirements.txt': 'flask>=2.0',
-      });
-      try {
-        const adapter = new DjangoAdapter();
-        assert.strictEqual(adapter.detect(dir), false);
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('returns false when directory is empty', () => {
-      const dir = createTmpProject({});
-      try {
-        const adapter = new DjangoAdapter();
-        assert.strictEqual(adapter.detect(dir), false);
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('getTools()', () => {
-    it('returns array of tool objects with required fields', () => {
-      const adapter = new DjangoAdapter();
-      const tools = adapter.getTools();
-      assert.ok(Array.isArray(tools));
-      assert.ok(tools.length > 0);
-      for (const tool of tools) {
-        assert.ok(tool.name);
-        assert.ok(tool.language);
-        assert.ok(typeof tool.command === 'string');
-        assert.ok(tool.description);
-      }
-    });
-  });
-
-  describe('getSafeguards()', () => {
-    it('returns non-empty array of strings', () => {
-      const adapter = new DjangoAdapter();
-      const guards = adapter.getSafeguards();
-      assert.ok(Array.isArray(guards));
-      assert.ok(guards.length >= 5);
-    });
-  });
-});

package/test/adapters/fastapi.test.js

@@ -1,88 +0,0 @@
-const { describe, it } = require('node:test');
-const assert = require('node:assert');
-const { createTmpProject, teardown } = require('../helpers');
-
-describe('FastApiAdapter', () => {
-  const FastApiAdapter = require('../../src/adapters/fastapi');
-
-  describe('constructor', () => {
-    it('creates adapter with correct name and projectType', () => {
-      const adapter = new FastApiAdapter();
-      assert.strictEqual(adapter.name, 'FastAPI Framework');
-      assert.strictEqual(adapter.projectType, 'backend');
-      assert.strictEqual(adapter.testRunner, 'Pytest');
-    });
-  });
-
-  describe('detect()', () => {
-    it('returns true when pyproject.toml contains fastapi', () => {
-      const dir = createTmpProject({
-        'pyproject.toml': '[project]\nname = "api"\ndependencies = ["fastapi>=0.100"]',
-      });
-      try {
-        const adapter = new FastApiAdapter();
-        assert.strictEqual(adapter.detect(dir), true);
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('returns true when requirements.txt contains fastapi', () => {
-      const dir = createTmpProject({
-        'requirements.txt': 'fastapi>=0.100\nuvicorn',
-      });
-      try {
-        const adapter = new FastApiAdapter();
-        assert.strictEqual(adapter.detect(dir), true);
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('returns false when no fastapi indicators present', () => {
-      const dir = createTmpProject({
-        'requirements.txt': 'flask>=2.0',
-      });
-      try {
-        const adapter = new FastApiAdapter();
-        assert.strictEqual(adapter.detect(dir), false);
-      } finally {
-        teardown(dir);
-      }
-    });
-
-    it('returns false when directory is empty', () => {
-      const dir = createTmpProject({});
-      try {
-        const adapter = new FastApiAdapter();
-        assert.strictEqual(adapter.detect(dir), false);
-      } finally {
-        teardown(dir);
-      }
-    });
-  });
-
-  describe('getTools()', () => {
-    it('returns array of tool objects with required fields', () => {
-      const adapter = new FastApiAdapter();
-      const tools = adapter.getTools();
-      assert.ok(Array.isArray(tools));
-      assert.ok(tools.length > 0);
-      for (const tool of tools) {
-        assert.ok(tool.name);
-        assert.ok(tool.language);
-        assert.ok(typeof tool.command === 'string');
-        assert.ok(tool.description);
-      }
-    });
-  });
-
-  describe('getSafeguards()', () => {
-    it('returns non-empty array of strings', () => {
-      const adapter = new FastApiAdapter();
-      const guards = adapter.getSafeguards();
-      assert.ok(Array.isArray(guards));
-      assert.ok(guards.length >= 5);
-    });
-  });
-});