clckernel 1.2.6

package/src/adapters/base.js

@@ -0,0 +1,109 @@
+/**
+ * CLC Kernel — Base Stack Adapter Interface
+ * All framework-specific adapters (Rails, Astro, Next.js, FastAPI, Go, Rust, Laravel)
+ * inherit from this interface to ensure universal polyglot harness behavior.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+const { TechnologyDetector } = require('../technologies/detector');
+
+class BaseAdapter {
+  constructor(name, projectType, testRunner) {
+    this.name = name;
+    this.projectType = projectType;
+    this.testRunner = testRunner;
+    this.techDetector = new TechnologyDetector();
+  }
+
+  detect(targetDir) {
+    return false;
+  }
+
+  getSafeguards() {
+    return [];
+  }
+
+  /**
+   * Returns the tool manifest for this adapter.
+   * Each entry describes one pre-commit tool (script or external CLI).
+   * Override in subclasses to declare stack-specific tools.
+   * @returns {Array<{name: string, language: string, path: string, command: string, description: string, extCLI?: string}>}
+   */
+  getTools() {
+    return [];
+  }
+
+  /**
+   * Merges technology-specific tools into the adapter tool manifest.
+   * Tech tools are inserted before check_custom to preserve user override escape hatch.
+   * @param {Array} baseTools - The adapter's base tool manifest
+   * @returns {Array} Merged tool manifest with technology tools inserted
+   */
+  _mergeTechTools(baseTools) {
+    const techTools = this.techDetector.getToolsForTech(this.detectedTech || []);
+    if (techTools.length === 0) return baseTools;
+
+    const result = [];
+    for (const tool of baseTools) {
+      if (tool.name === 'check_custom') {
+        // Insert tech tools before check_custom
+        result.push(...techTools);
+      }
+      result.push(tool);
+    }
+    return result;
+  }
+
+  provision(targetDir, config) {
+    // 1. Create docs/ and sdds/
+    fs.mkdirSync(path.join(targetDir, 'docs', 'Journal'), { recursive: true });
+    fs.mkdirSync(path.join(targetDir, 'docs', 'Architecture'), { recursive: true });
+    fs.mkdirSync(path.join(targetDir, 'docs', 'Development'), { recursive: true });
+    fs.mkdirSync(path.join(targetDir, 'sdds'), { recursive: true });
+    fs.mkdirSync(path.join(targetDir, 'tools'), { recursive: true });
+
+    // 2. Gitignore sdds/*
+    const gitignorePath = path.join(targetDir, '.gitignore');
+    let gitignore = fs.existsSync(gitignorePath) ? fs.readFileSync(gitignorePath, 'utf-8') : '';
+    if (!gitignore.includes('sdds/*')) {
+      gitignore += '\n\n# Local Spec-Driven Development (SDD) files\nsdds/*\n!sdds/.gitkeep\nopenspec/*\n!openspec/.gitkeep\n.ruff_cache/\n';
+      fs.writeFileSync(gitignorePath, gitignore, 'utf-8');
+    }
+    fs.writeFileSync(path.join(targetDir, 'sdds', '.gitkeep'), '', 'utf-8');
+
+    // 3. Write AGENTS.md
+    const isFront = this.projectType === 'frontend';
+    const agentsContent = `# 🔨 CLC Kernel ${this.name} (${this.projectType.toUpperCase()}) — AGENTS
+
+This document is the **authoritative law** for AI agents working in this repository.
+Forged by **CLC Kernel: The AI Agent Governance Engine**.
+
+> 🚨 **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 (${this.testRunner}).
+> 3. **Clean Architecture Implementation (Green Phase):** Make the test pass maintaining layer isolation.
+> 4. **Mandatory Educational Audit Gate:** Execute \`node tools/audit.js\` or \`python tools/audit.py\` and output the Educational Code Summary to stdout.
+> NEVER declare success or skip verification commands for quick fixes.
+
+## 1. The Loop (Every Task)
+1. **Research** — Inspect codebase / docs before writing code.
+2. **Plan** — Write an SDD under \`sdds/{change-name}/\`. SDDs live 100% locally and are gitignored.
+3. **Test** (TDD) — Write failing test first (${this.testRunner}).
+4. **Implement** — Make test pass.
+5. **Verify & Audit** — Run \`node tools/audit.js\` or \`python tools/audit.py\`.
+6. **DoD** — Lint, typecheck, tests, coverage, docs, memory.
+7. **Commit** — Pre-commit hook runs automated guards.
+8. **PR** — Generate PR body.
+
+## 2. Core AI Safeguards (${this.name})
+${this.getSafeguards().map(s => `- ${s}`).join('\n')}
+`;
+    fs.writeFileSync(path.join(targetDir, 'AGENTS.md'), agentsContent, 'utf-8');
+  }
+}
+
+module.exports = BaseAdapter;

package/src/adapters/django.js

@@ -0,0 +1,70 @@
+/**
+ * CLC Kernel — Django Stack Adapter
+ * Supports Django apps, pytest-django, Ruff AST, ORM idempotency, and Scope Guard.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const BaseAdapter = require('./base');
+
+class DjangoAdapter extends BaseAdapter {
+  constructor() {
+    super('Django Framework', 'backend', 'pytest-django / manage.py test');
+  }
+
+  detect(targetDir) {
+    const hasManagePy = fs.existsSync(path.join(targetDir, 'manage.py'));
+    const hasPyproject = fs.existsSync(path.join(targetDir, 'pyproject.toml'));
+    const hasRequirements = fs.existsSync(path.join(targetDir, 'requirements.txt'));
+
+    if (hasManagePy) return true;
+
+    if (hasPyproject || hasRequirements) {
+      try {
+        const pyproject = hasPyproject ? fs.readFileSync(path.join(targetDir, 'pyproject.toml'), 'utf-8') : '';
+        const reqs = hasRequirements ? fs.readFileSync(path.join(targetDir, 'requirements.txt'), 'utf-8') : '';
+        return pyproject.toLowerCase().includes('django') || reqs.toLowerCase().includes('django');
+      } catch (e) {}
+    }
+
+    return false;
+  }
+
+  getSafeguards() {
+    return [
+      'Flake8 / Ruff AST Python Code Quality Linter',
+      'Clean Architecture AST Guard (Domain -> Application -> Views)',
+      'Database Efficiency & N+1 Performance Guard (select_related / prefetch_related)',
+      'Django ORM Migration Idempotency & Schema Drift Guard',
+      'pytest-django Red-to-Green TDD Validator',
+      'Secret & Private Key Leak Scanner',
+      'Scope Guardrail (git diff vs SDD affected files)',
+      'Educational Audit Gate (05-audit-report.md)',
+      'Memory Guard (Engram / Graphify ADR Sync)'
+    ];
+  }
+
+  /**
+   * Returns the tool manifest for Django projects.
+   * Includes Python guard scripts and external CLI tools (ruff, manage.py test).
+   * @returns {Array<{name: string, language: string, path: string, command: string, description: string, extCLI?: string}>}
+   */
+  getTools() {
+    const baseTools = [
+      { name: 'scan_secrets',         language: 'py',       path: 'scan_secrets.py',         command: 'python3 tools/scan_secrets.py',         description: 'Scans for leaked secrets and API keys' },
+      { name: 'check_architecture',   language: 'py',       path: 'check_architecture.py',   command: 'python3 tools/check_architecture.py',   description: 'Validates Django layer boundaries' },
+      { name: 'check_db_efficiency',  language: 'py',       path: 'check_db_efficiency.py',  command: 'python3 tools/check_db_efficiency.py',  description: 'Audits database query efficiency and N+1 loop calls' },
+      { name: 'check_custom',          language: 'python',   path: 'check_custom.py',         command: 'python3 tools/check_custom.py',       description: 'Runs user-defined custom rules from .clc-forge.yml' },
+      { name: 'ruff',                 language: 'external', path: '', command: 'python3 -m ruff check .', description: 'Python AST linter', extCLI: 'ruff' },
+      { name: 'manage',               language: 'external', path: '', command: 'python3 manage.py test',  description: 'Django test runner', extCLI: 'manage.py' },
+    ];
+    return this._mergeTechTools(baseTools);
+  }
+
+  provision(targetDir, config) {
+    super.provision(targetDir, config);
+    // Pre-commit hook generation moved to generator.js via getTools() manifest
+  }
+}
+
+module.exports = DjangoAdapter;

package/src/adapters/fastapi.js

@@ -0,0 +1,69 @@
+/**
+ * CLC Kernel — FastAPI Stack Adapter
+ * Supports FastAPI apps, pytest, Pydantic V2, Alembic idempotency, and AST Clean Architecture.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const BaseAdapter = require('./base');
+
+class FastApiAdapter extends BaseAdapter {
+  constructor() {
+    super('FastAPI Framework', 'backend', 'Pytest');
+  }
+
+  detect(targetDir) {
+    const hasPyproject = fs.existsSync(path.join(targetDir, 'pyproject.toml'));
+    const hasRequirements = fs.existsSync(path.join(targetDir, 'requirements.txt'));
+
+    if (hasPyproject || hasRequirements) {
+      try {
+        const pyproject = hasPyproject ? fs.readFileSync(path.join(targetDir, 'pyproject.toml'), 'utf-8') : '';
+        const reqs = hasRequirements ? fs.readFileSync(path.join(targetDir, 'requirements.txt'), 'utf-8') : '';
+        return pyproject.toLowerCase().includes('fastapi') || reqs.toLowerCase().includes('fastapi');
+      } catch (e) {}
+    }
+
+    return false;
+  }
+
+  getSafeguards() {
+    return [
+      'Ruff / Flake8 Python AST Code Quality Linter',
+      'Clean Architecture AST Guard (Domain -> Application -> Routes)',
+      'Database Efficiency & N+1 Performance Guard (bulk queries & eager loading)',
+      'Alembic Migration Idempotency & Schema Drift Guard',
+      'Pytest Red-to-Green TDD Validator',
+      'Pydantic V2 Response Schema Validation Guard',
+      'Secret & Private Key Leak Scanner',
+      'Scope Guardrail (git diff vs SDD affected files)',
+      'Educational Audit Gate (05-audit-report.md)',
+      'Memory Guard (Engram / Graphify ADR Sync)'
+    ];
+  }
+
+  /**
+   * Returns the tool manifest for FastAPI projects.
+   * Includes Python guard scripts and external CLI tools (ruff, pytest).
+   * @returns {Array<{name: string, language: string, path: string, command: string, description: string, extCLI?: string}>}
+   */
+  getTools() {
+    const baseTools = [
+      { name: 'scan_secrets',         language: 'py',       path: 'scan_secrets.py',         command: 'python3 tools/scan_secrets.py',         description: 'Scans for leaked secrets and API keys' },
+      { name: 'check_architecture',   language: 'py',       path: 'check_architecture.py',   command: 'python3 tools/check_architecture.py',   description: 'Validates Clean Architecture layer boundaries' },
+      { name: 'check_db_efficiency',  language: 'py',       path: 'check_db_efficiency.py',  command: 'python3 tools/check_db_efficiency.py',  description: 'Audits database query efficiency and N+1 loop calls' },
+      { name: 'check_migrations',     language: 'py',       path: 'check_migrations.py',     command: 'python3 tools/check_migrations.py',     description: 'Checks Alembic migration idempotency' },
+      { name: 'check_custom',          language: 'python',   path: 'check_custom.py',         command: 'python3 tools/check_custom.py',       description: 'Runs user-defined custom rules from .clc-forge.yml' },
+      { name: 'ruff',                 language: 'external', path: '', command: 'python3 -m ruff check .', description: 'Python AST linter', extCLI: 'ruff' },
+      { name: 'pytest',               language: 'external', path: '', command: 'pytest',                   description: 'Test runner', extCLI: 'pytest' },
+    ];
+    return this._mergeTechTools(baseTools);
+  }
+
+  provision(targetDir, config) {
+    super.provision(targetDir, config);
+    // Pre-commit hook generation moved to generator.js via getTools() manifest
+  }
+}
+
+module.exports = FastApiAdapter;

package/src/adapters/go.js

@@ -0,0 +1,50 @@
+/**
+ * CLC Kernel — Go Stack Adapter
+ * Supports Golang apps, `go test`, golangci-lint AST, and Domain/UseCase Clean Architecture.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const BaseAdapter = require('./base');
+
+class GoAdapter extends BaseAdapter {
+  constructor() {
+    super('Go (Golang)', 'backend', 'go test');
+  }
+
+  detect(targetDir) {
+    return fs.existsSync(path.join(targetDir, 'go.mod'));
+  }
+
+  getSafeguards() {
+    return [
+      'golangci-lint Code Quality & AST Linter',
+      'Go Clean Architecture Guard (Domain -> UseCase -> Handler)',
+      'go test Red-to-Green TDD Validator',
+      'Secret & Private Key Leak Scanner',
+      'Educational Audit Gate (05-audit-report.md)',
+      'Memory Guard (Engram / Graphify ADR Sync)'
+    ];
+  }
+
+  /**
+   * Returns the tool manifest for Go projects.
+   * External CLIs only — no custom guard scripts bundled.
+   * @returns {Array<{name: string, language: string, path: string, command: string, description: string, extCLI?: string}>}
+   */
+  getTools() {
+    const baseTools = [
+      { name: 'check_custom',   language: 'js',       path: 'check_custom.js', command: 'node tools/check_custom.js', description: 'Runs user-defined custom rules from .clc-forge.yml' },
+      { name: 'golangci-lint', language: 'external', path: '', command: 'golangci-lint run',  description: 'Go linter and static analysis', extCLI: 'golangci-lint' },
+      { name: 'go_test',       language: 'external', path: '', command: 'go test ./...',       description: 'Go test runner', extCLI: 'go' },
+    ];
+    return this._mergeTechTools(baseTools);
+  }
+
+  provision(targetDir, config) {
+    super.provision(targetDir, config);
+    // Pre-commit hook generation moved to generator.js via getTools() manifest
+  }
+}
+
+module.exports = GoAdapter;

package/src/adapters/laravel.js

@@ -0,0 +1,52 @@
+/**
+ * CLC Kernel — PHP / Laravel Stack Adapter
+ * Supports Laravel, Pest / PHPUnit, PHPStan AST, and Eloquent migration idempotency.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const BaseAdapter = require('./base');
+
+class LaravelAdapter extends BaseAdapter {
+  constructor() {
+    super('PHP / Laravel', 'backend', 'Pest / PHPUnit');
+  }
+
+  detect(targetDir) {
+    const hasComposer = fs.existsSync(path.join(targetDir, 'composer.json'));
+    const hasArtisan = fs.existsSync(path.join(targetDir, 'artisan'));
+    return hasComposer && hasArtisan;
+  }
+
+  getSafeguards() {
+    return [
+      'PHPStan / PHP_CodeSniffer AST Code Quality Linter',
+      'Laravel Migration Idempotency & Schema Guard',
+      'Pest / PHPUnit Red-to-Green TDD Validator',
+      'Secret & Private Key Leak Scanner',
+      'Educational Audit Gate (05-audit-report.md)',
+      'Memory Guard (Engram / Graphify ADR Sync)'
+    ];
+  }
+
+  /**
+   * Returns the tool manifest for Laravel projects.
+   * External CLIs only — no custom guard scripts bundled.
+   * @returns {Array<{name: string, language: string, path: string, command: string, description: string, extCLI?: string}>}
+   */
+  getTools() {
+    const baseTools = [
+      { name: 'check_custom', language: 'python',   path: 'check_custom.py', command: 'python3 tools/check_custom.py', description: 'Runs user-defined custom rules from .clc-forge.yml' },
+      { name: 'phpstan',  language: 'external', path: '', command: './vendor/bin/phpstan analyse', description: 'PHP static analysis', extCLI: 'phpstan' },
+      { name: 'artisan',  language: 'external', path: '', command: 'php artisan test',            description: 'Laravel test runner', extCLI: 'artisan' },
+    ];
+    return this._mergeTechTools(baseTools);
+  }
+
+  provision(targetDir, config) {
+    super.provision(targetDir, config);
+    // Pre-commit hook generation moved to generator.js via getTools() manifest
+  }
+}
+
+module.exports = LaravelAdapter;

package/src/adapters/nextjs.js

@@ -0,0 +1,72 @@
+/**
+ * CLC Kernel — Next.js Stack Adapter
+ * Supports Next.js (App Router / Pages), React Server Components, Tailwind CSS, Vitest / Jest, and A11y.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const BaseAdapter = require('./base');
+
+class NextjsAdapter extends BaseAdapter {
+  constructor() {
+    super('Next.js (App Router)', 'frontend', 'Vitest / Jest');
+  }
+
+  detect(targetDir) {
+    const hasPkg = fs.existsSync(path.join(targetDir, 'package.json'));
+    if (!hasPkg) return false;
+
+    try {
+      const pkg = JSON.parse(fs.readFileSync(path.join(targetDir, 'package.json'), 'utf-8'));
+      const deps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
+      return Boolean(deps['next']);
+    } catch (e) {
+      return false;
+    }
+  }
+
+  getSafeguards() {
+    return [
+      'UI Component Reuse First Guard (components/ui/ & atomic primitives)',
+      'Tailwind v4 Semantic Design Token Guard (bg-primary, text-muted-foreground)',
+      'Next.js Clean Architecture & Server Components Guard (layout.tsx protection)',
+      'Secret & Client Token Exposure Guard',
+      'Accessibility & ARIA Guard (A11y & alt tags)',
+      'Responsive Design & Mobile-First Adaptability Guard (breakpoint & touch target audit)',
+      'SEO, GEO & Web Performance Guard (metadata, OpenGraph, Core Web Vitals)',
+      'Zod API Contract Guard (services response schema parsing)',
+      'Performance & Next/Image Guard (next/image & tree-shaking)',
+      'Storybook Story Coverage Guard (.stories.tsx)',
+      'Educational Audit Gate (05-audit-report.md)',
+      'Memory Guard & PR Generator (.github/pull_request_body.md)'
+    ];
+  }
+
+  /**
+   * Returns the tool manifest for Next.js projects.
+   * Includes JS guard scripts and external CLI tools (tsc, lint-staged).
+   * @returns {Array<{name: string, language: string, path: string, command: string, description: string, extCLI?: string}>}
+   */
+  getTools() {
+    const baseTools = [
+      { name: 'scan_secrets',       language: 'js',       path: 'scan_secrets.js',       command: 'node tools/scan_secrets.js',       description: 'Scans for leaked secrets and API keys' },
+      { name: 'check_a11y',         language: 'js',       path: 'check_a11y.js',         command: 'node tools/check_a11y.js',         description: 'Validates ARIA and accessibility rules' },
+      { name: 'check_responsive',   language: 'js',       path: 'check_responsive.js',   command: 'node tools/check_responsive.js',   description: 'Audits mobile-first responsiveness and fixed-width overflows' },
+      { name: 'check_seo',          language: 'js',       path: 'check_seo.js',          command: 'node tools/check_seo.js',          description: 'Validates SEO metadata, OpenGraph, GEO tags, and LCP priority' },
+      { name: 'check_ui_reuse',     language: 'js',       path: 'check_ui_reuse.js',     command: 'node tools/check_ui_reuse.js',     description: 'Enforces UI primitive reuse from components/ui/' },
+      { name: 'check_architecture', language: 'js',       path: 'check_architecture.js', command: 'node tools/check_architecture.js', description: 'Validates Next.js Server Component boundaries' },
+      { name: 'check_performance',  language: 'js',       path: 'check_performance.js',  command: 'node tools/check_performance.js',  description: 'Checks next/image and bundle optimization' },
+      { name: 'check_custom',        language: 'js',       path: 'check_custom.js',       command: 'node tools/check_custom.js',       description: 'Runs user-defined custom rules from .clc-forge.yml' },
+      { name: 'tsc',                language: 'external', path: '', command: 'npx tsc --noEmit',        description: 'TypeScript type checking', extCLI: 'tsc' },
+      { name: 'lint',               language: 'external', path: '', command: 'npx lint-staged',         description: 'Lint staged files', extCLI: 'lint-staged' },
+    ];
+    return this._mergeTechTools(baseTools);
+  }
+
+  provision(targetDir, config) {
+    super.provision(targetDir, config);
+    // Pre-commit hook generation moved to generator.js via getTools() manifest
+  }
+}
+
+module.exports = NextjsAdapter;

package/src/adapters/rails.js

@@ -0,0 +1,54 @@
+/**
+ * CLC Kernel — Ruby on Rails Stack Adapter
+ * Supports Rails, RSpec, RuboCop AST, Brakeman Security, and migration idempotency.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const BaseAdapter = require('./base');
+
+class RailsAdapter extends BaseAdapter {
+  constructor() {
+    super('Ruby on Rails', 'backend', 'RSpec / Minitest');
+  }
+
+  detect(targetDir) {
+    const hasGemfile = fs.existsSync(path.join(targetDir, 'Gemfile'));
+    const hasRailsRoute = fs.existsSync(path.join(targetDir, 'config', 'routes.rb'));
+    return hasGemfile && hasRailsRoute;
+  }
+
+  getSafeguards() {
+    return [
+      'RuboCop Code Style & AST Security Guard',
+      'Brakeman Rails Vulnerability Scanner',
+      'Rails Migration Idempotency Guard (schema drift protection)',
+      'RSpec / Minitest Red-to-Green TDD Validator',
+      'Secret & Private Credential Leak Scanner',
+      'Educational Audit Gate (05-audit-report.md)',
+      'Memory Guard (Engram / Graphify ADR Sync)'
+    ];
+  }
+
+  /**
+   * Returns the tool manifest for Rails projects.
+   * External CLIs only — no custom guard scripts bundled.
+   * @returns {Array<{name: string, language: string, path: string, command: string, description: string, extCLI?: string}>}
+   */
+  getTools() {
+    const baseTools = [
+      { name: 'check_custom', language: 'js',       path: 'check_custom.js', command: 'node tools/check_custom.js', description: 'Runs user-defined custom rules from .clc-forge.yml' },
+      { name: 'rubocop',  language: 'external', path: '', command: 'bundle exec rubocop --parallel', description: 'Ruby linter', extCLI: 'rubocop' },
+      { name: 'brakeman', language: 'external', path: '', command: 'bundle exec brakeman -q',        description: 'Rails vulnerability scanner', extCLI: 'brakeman' },
+      { name: 'rspec',    language: 'external', path: '', command: 'bundle exec rspec',               description: 'Test runner', extCLI: 'rspec' },
+    ];
+    return this._mergeTechTools(baseTools);
+  }
+
+  provision(targetDir, config) {
+    super.provision(targetDir, config);
+    // Pre-commit hook generation moved to generator.js via getTools() manifest
+  }
+}
+
+module.exports = RailsAdapter;

package/src/adapters/rust.js

@@ -0,0 +1,51 @@
+/**
+ * CLC Kernel — Rust Stack Adapter
+ * Supports Rust, `cargo test`, `cargo clippy`, `cargo audit`, and memory safety.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const BaseAdapter = require('./base');
+
+class RustAdapter extends BaseAdapter {
+  constructor() {
+    super('Rust Engine', 'backend', 'cargo test');
+  }
+
+  detect(targetDir) {
+    return fs.existsSync(path.join(targetDir, 'Cargo.toml'));
+  }
+
+  getSafeguards() {
+    return [
+      'cargo clippy AST Code Quality Linter',
+      'cargo audit Security Vulnerability Scanner',
+      'cargo test Red-to-Green TDD Validator',
+      'Secret & Private Key Leak Scanner',
+      'Educational Audit Gate (05-audit-report.md)',
+      'Memory Guard (Engram / Graphify ADR Sync)'
+    ];
+  }
+
+  /**
+   * Returns the tool manifest for Rust projects.
+   * External CLIs only — no custom guard scripts bundled.
+   * @returns {Array<{name: string, language: string, path: string, command: string, description: string, extCLI?: string}>}
+   */
+  getTools() {
+    const baseTools = [
+      { name: 'check_custom',  language: 'js',       path: 'check_custom.js', command: 'node tools/check_custom.js', description: 'Runs user-defined custom rules from .clc-forge.yml' },
+      { name: 'cargo_clippy',  language: 'external', path: '', command: 'cargo clippy -- -D warnings', description: 'Rust linter and static analysis', extCLI: 'clippy' },
+      { name: 'cargo_audit',   language: 'external', path: '', command: 'cargo audit',                description: 'Security vulnerability scanner', extCLI: 'cargo-audit' },
+      { name: 'cargo_test',    language: 'external', path: '', command: 'cargo test',                  description: 'Rust test runner', extCLI: 'cargo' },
+    ];
+    return this._mergeTechTools(baseTools);
+  }
+
+  provision(targetDir, config) {
+    super.provision(targetDir, config);
+    // Pre-commit hook generation moved to generator.js via getTools() manifest
+  }
+}
+
+module.exports = RustAdapter;