tribunal-kit 6.0.1 → 8.0.0

package/README.md

@@ -1,17 +1,17 @@
 <!-- PROJECT HEADER -->
 <div align="center">
   <br>
-  <img src="./docs/tribunalkit_no_bg.png" alt="TribunalKit Logo" width="380" style="margin-bottom: 20px;" />
-  
+  <img src="https://raw.githubusercontent.com/Harmitx7/tribunal-kit/main/docs/tribunalkit_no_bg.png" alt="TribunalKit Logo" width="380" style="margin-bottom: 20px;" />
+
   <h1 style="font-size: 3.25em; font-weight: 800; letter-spacing: -2px; margin: 0; color: #ffffff; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;">
     TRIBUNAL KIT
   </h1>
-  
+
   <p style="font-size: 1.35em; color: #ffffff; font-weight: 600; margin: 15px 0 8px 0;">
     Your AI writes code that doesn't exist. Tribunal Kit stops it.
   </p>
   <p style="font-size: 0.95em; color: #88888b; font-weight: 400; letter-spacing: 1px; margin: 0 0 25px 0;">
-    The governance layer for AI coding agents — 51 specialists, 27 reviewers, Rust core.
+    The governance layer for AI coding agents — 52 specialists, 28 reviewers, Rust core.
   </p>
 
   <!-- BADGES -->
@@ -33,7 +33,7 @@
       <img src="https://img.shields.io/badge/License-MIT-1a1a1f?style=for-the-badge&color=2d2d30" alt="License" />
     </a>
     <a href="CHANGELOG.md">
-      <img src="https://img.shields.io/badge/Release-v6.0.1-ccff00?style=for-the-badge&color=111111&logo=github&logoColor=ccff00" alt="Release Version" />
+      <img src="https://img.shields.io/badge/Release-v8.0.0-ccff00?style=for-the-badge&color=111111&logo=github&logoColor=ccff00" alt="Release Version" />
     </a>
     <a href="mcp_config.json">
       <img src="https://img.shields.io/badge/MCP-Ready-00c2ff?style=for-the-badge&logo=openai&logoColor=111" alt="MCP Server" />
@@ -67,33 +67,44 @@
     <strong style="color: #ffffff; font-size: 1.1em;">One command. Your AI stops lying.</strong>
   </div>
   <p style="color: #c9c9d1; font-size: 0.95em; line-height: 1.6; margin: 0 0 15px 0;">
-    Tribunal Kit wraps your coding agents in a <strong>neurosymbolic verification envelope</strong> — 51 specialist agents, 27 parallel reviewers, 183 reusable skills, and a compiled Rust core — that intercepts AI output, validates it against your actual codebase, and blocks hallucinated code before it reaches disk. Works with <strong>Cursor</strong>, <strong>VSCode</strong>, <strong>Windsurf</strong>, <strong>Claude Code</strong>, and <strong>Aider</strong>.
+    Tribunal Kit wraps your coding agents in a <strong>neurosymbolic verification envelope</strong> — 52 specialist agents, 28 parallel reviewers, 183 reusable skills, and a compiled Rust core — that intercepts AI output, validates it against your actual codebase, and blocks hallucinated code before it reaches disk. Works with <strong>Cursor</strong>, <strong>VSCode</strong>, <strong>Windsurf</strong>, <strong>Claude Code</strong>, and <strong>Aider</strong>.
   </p>
 </div>
 
 <!-- QUICK INSTALL -->
+
 ```bash
 npx tribunal-kit init    # Install the governance layer (< 60 seconds)
 npx tribunal-kit sync    # Bridge with Cursor / Windsurf / VSCode
 npx tribunal-kit status  # Verify everything is locked in
 ```
 
+### 🔌 CLI Agent Plugins (Claude Code, Aider, Cline)
+
+To automatically integrate Tribunal Kit into terminal-based AI agents, use the universal adapter:
+
+```bash
+npx tribunal-kit tk-adapt           # Auto-detect and install for all supported agents
+npx tribunal-kit tk-adapt claude    # Install strictly for Claude Code
+npx tribunal-kit tk-adapt --global  # Install globally to ~/.tribunal-kit/
+```
+
 <hr style="height: 1px; border: none; background: linear-gradient(to right, transparent, #33333f, transparent); margin: 40px 0;" />
 
 <!-- WHAT YOU GET -->
 
 ### What's Inside
 
-| Layer | Count | What It Does |
-|:--|:--|:--|
-| **Specialist Agents** | 51 | Domain-specific reasoning (frontend, backend, security, database, mobile, DevOps) |
-| **Tribunal Reviewers** | 27 | Parallel code review pipeline that catches hallucinations before they ship |
-| **Reusable Skills** | 183 | Deep knowledge packs (React 19, Next.js 15, Rust, Python, Vue, animations, a11y) |
-| **Slash Workflows** | 37 | One-command operations (`/generate`, `/debug`, `/audit`, `/deploy`, `/refactor`) |
-| **Rust Core** | 1 | Native binary for sub-50ms operations (hashing, dedup, DAG scheduling, compression) |
-| **MCP Server** | 1 | Model Context Protocol integration for dynamic tool access |
-| **Persistent Memory** | 4 types | Semantic, Procedural, Episodic, Working — survives across sessions |
-| **Case Law Database** | ∞ | Records past AI mistakes as permanent precedents to prevent recurrence |
+| Layer                  | Count | What It Does                                                                        |
+| :--------------------- | :---- | :---------------------------------------------------------------------------------- |
+| **Specialist Agents**  | 52    | Domain-specific reasoning (frontend, backend, security, database, mobile, DevOps)   |
+| **Tribunal Reviewers** | 28    | Parallel code review pipeline that catches hallucinations before they ship          |
+| **Reusable Skills**    | 183   | Deep knowledge packs (React 19, Next.js 15, Rust, Python, Vue, animations, a11y)    |
+| **Slash Workflows**    | 38    | One-command operations (`/generate`, `/debug`, `/audit`, `/deploy`, `/refactor`)    |
+| **Rust Core**          | 1     | Native binary for AOT Semantic Graph extraction, AST parsing, hashing, and deduping |
+| **MCP Server**         | 1     | Model Context Protocol integration with `query_semantic_graph` capabilities         |
+| **Native Plugins**     | ∞     | Direct integration into CLI tools like Claude Code via `/plugin marketplace add`    |
+| **Case Law Database**  | ∞     | Records past AI mistakes as permanent precedents to prevent recurrence              |
 
 <br>
 <hr style="height: 1px; border: none; background: linear-gradient(to right, transparent, #33333f, transparent); margin: 40px 0;" />
@@ -120,7 +131,6 @@ npx tribunal-kit status  # Verify everything is locked in
   </div>
 </details>
 
-
 ## 📈 Comparative Analysis
 
 AI engineering requires more than static template rules or raw linters. See how Tribunal Kit stacks up against alternatives:
@@ -187,19 +197,21 @@ AI engineering requires more than static template rules or raw linters. See how
 <hr style="height: 1px; border: none; background: linear-gradient(to right, transparent, #33333f, transparent); margin: 40px 0;" />
 
 <!-- SECTION 3 -->
+
 ## ⚡ State-of-the-Art Performance (Rust Core)
 
 Tribunal Kit v6 splits heavy computational tasks between a native Rust core and a flexible JS orchestrator:
 
-*   **Compiled Rust Core (`tribunal-core`)**: Powers all deterministic operations, such as path-traversal sandboxing, Levenshtein distance calculations, text merges, and memory database reads to eliminate Node startup latency.
-*   **Zero-Latency Hash Manifests**: File synchronization and updates use SHA-256 incremental hash diffs, copying only modified assets and reducing CLI setup time by **95%**.
-*   **Semaphore-Bounded Parallelism**: Fully concurrent operations with thread limits (64 in Rust, 32 in Node.js) to avoid resource starvation in complex monorepos.
+- **Compiled Rust Core (`tribunal-core`)**: Powers all deterministic operations, such as path-traversal sandboxing, Levenshtein distance calculations, text merges, and memory database reads to eliminate Node startup latency.
+- **Zero-Latency Hash Manifests**: File synchronization and updates use SHA-256 incremental hash diffs, copying only modified assets and reducing CLI setup time by **95%**.
+- **Semaphore-Bounded Parallelism**: Fully concurrent operations with thread limits (64 in Rust, 32 in Node.js) to avoid resource starvation in complex monorepos.
 
 <br>
 <hr style="border: 1px solid #222; margin: 40px 0;">
 <br>
 
 <!-- SECTION 4 -->
+
 ## 🛠️ Advanced Setup
 
 Already ran `npx tribunal-kit init`? Here's how to go further:
@@ -228,11 +240,12 @@ tk optimize-skill --target ./skills/auth-security.md "npm run test:auth" --epoch
 <hr style="height: 1px; border: none; background: linear-gradient(to right, transparent, #33333f, transparent); margin: 40px 0;" />
 
 <!-- SECTION 5 -->
+
 ## ⚖️ The Tribunal Pipeline — Mitigating AI Code Hallucinations
 
-Code generation is solved. **Code correctness is the frontier.** 
+Code generation is solved. **Code correctness is the frontier.**
 
-The Tribunal Pipeline intercepts raw agent generation and routes it through a parallel suite of **27 domain-specific reviewers** before presenting changes to the developer:
+The Tribunal Pipeline intercepts raw agent generation and routes it through a parallel suite of **28 domain-specific reviewers** before presenting changes to the developer:
 
 ```mermaid
 graph TD
@@ -243,7 +256,7 @@ graph TD
     C -.->|Failed| E[Maker Auto-Correction]
     E -.-> C
 
-    D -->|27 Domain Reviewers| F[Human Gate]
+    D -->|28 Domain Reviewers| F[Human Gate]
     F -->|Approved| G((Committed to Disk))
 
     classDef default fill:#1a1a1a,stroke:#333,stroke-width:2px,color:#fff;
@@ -255,28 +268,31 @@ graph TD
 ```
 
 ### Reviewer Swarms Include:
-*   **`logic-reviewer`** · Semantic soundness & behavior checks.
-*   **`security-auditor`** · Payload boundaries, SQL injection & OWASP scanning.
-*   **`resilience-reviewer`** · Async error boundaries and retry logic.
-*   **`ui-ux-auditor`** · Structural accessibility (a11y) & premium animations.
-*   **`schema-reviewer`** · Type narrowing and database integrity checks.
+
+- **`logic-reviewer`** · Semantic soundness & behavior checks.
+- **`security-auditor`** · Payload boundaries, SQL injection & OWASP scanning.
+- **`resilience-reviewer`** · Async error boundaries and retry logic.
+- **`ui-ux-auditor`** · Structural accessibility (a11y) & premium animations.
+- **`schema-reviewer`** · Type narrowing and database integrity checks.
 
 <br>
 <hr style="height: 1px; border: none; background: linear-gradient(to right, transparent, #33333f, transparent); margin: 40px 0;" />
 
 <!-- SECTION 6 -->
+
 ## 🧠 Omniscience Cognitive Alignment Engine (OCAE)
 
 The **Omniscience Cognitive Alignment Engine (OCAE)** aligns any LLM with the reasoning loops of a senior staff engineer:
 
-*   **Step 0 Epistemic Loop**: Always-on cognition loop enforcing confidence checking (L1–L5), knowledge freshness audits, and precision budgeting before any script execution.
-*   **Dynamic API Trap Mitigation**: Automatically guards code blocks against framework-specific compiler breakages (e.g., React 19 hook constraints, Drizzle ORM filtration issues, and Next.js 15 route headers).
-*   **Prose Alignment Formatting**: Collapses ugly lists and bullet points into highly readable, scannable documentation prose, stripping out typical AI conversational introduction/conclusion slop.
+- **Step 0 Epistemic Loop**: Always-on cognition loop enforcing confidence checking (L1–L5), knowledge freshness audits, and precision budgeting before any script execution.
+- **Dynamic API Trap Mitigation**: Automatically guards code blocks against framework-specific compiler breakages (e.g., React 19 hook constraints, Drizzle ORM filtration issues, and Next.js 15 route headers).
+- **Prose Alignment Formatting**: Collapses ugly lists and bullet points into highly readable, scannable documentation prose, stripping out typical AI conversational introduction/conclusion slop.
 
 <br>
 <hr style="height: 1px; border: none; background: linear-gradient(to right, transparent, #33333f, transparent); margin: 40px 0;" />
 
 <!-- SECTION 7 -->
+
 ## 🧬 SkillOpt: Autonomous Self-Evolution Engine
 
 Stop writing and tuning system prompts by hand. The **SkillOpt Self-Evolution Engine** automatically refines your prompt rules directly from test harness feedback:
@@ -295,21 +311,26 @@ tk optimize-skill --target ./skills/auth-security.md "npm run test:auth" --epoch
 <hr style="height: 1px; border: none; background: linear-gradient(to right, transparent, #33333f, transparent); margin: 40px 0;" />
 
 <!-- SECTION 8 -->
+
 ## 🏛️ Supreme Court Case Law & Memory
 
 Tribunal Kit builds a permanent repository memory layer that spans across conversation sessions:
 
 ### 1. Supreme Court Case Law (`tk case`)
+
 Record AI coding errors as permanent local precedents. The `precedence-reviewer` actively references this local database to block the AI from repeating past code defects or pattern bugs.
-*   Add precedence: `tk case add`
-*   Search case law: `tk case search "postgres deadlock"`
+
+- Add precedence: `tk case add`
+- Search case law: `tk case search "postgres deadlock"`
 
 ### 2. 4-Type Persistent Memory (`tk memory`)
+
 Manages your project context utilizing a strict 4-category cognitive taxonomy:
-*   **Semantic Memory** — Project context (e.g., "Uses Drizzle with SQLite").
-*   **Procedural Memory** — Action guidelines (e.g., "Compile Rust binary before publishing").
-*   **Episodic Memory** — Development history and events.
-*   **Working Memory** — Current task scope.
+
+- **Semantic Memory** — Project context (e.g., "Uses Drizzle with SQLite").
+- **Procedural Memory** — Action guidelines (e.g., "Compile Rust binary before publishing").
+- **Episodic Memory** — Development history and events.
+- **Working Memory** — Current task scope.
 
 Budget-gated recall ensures that agents only pull relevant memory segments, avoiding token window bloat and context dilution.
 
@@ -317,18 +338,20 @@ Budget-gated recall ensures that agents only pull relevant memory segments, avoi
 <hr style="height: 1px; border: none; background: linear-gradient(to right, transparent, #33333f, transparent); margin: 40px 0;" />
 
 <!-- SECTION 9 -->
+
 ## 🏃 The Marathon Harness — Long-Running Autonomy
 
 The **Marathon Harness** governs long-running multi-session tasks, keeping agents on track without looping or stalling:
 
-*   **Feature DAG Graphing**: Declare tasks with dependency bounds (e.g., `--deps=1,2`). If a core schema migration fails, dependent API route tasks are dynamically deadlocked and bypassed until fixed.
-*   **ANSI TUI Swarm Dashboard**: Intercepts verbose, noisy terminal output when running parallel swarms (`tk /swarm`), projecting agent research, coding, and review steps in real-time.
-*   **Failure Context Recalls**: Tracks failure histories, error stacks, and retry budgets. If a task is picked up by a new agent session, the agent receives the exact history of failed approaches to course-correct instantly.
+- **Feature DAG Graphing**: Declare tasks with dependency bounds (e.g., `--deps=1,2`). If a core schema migration fails, dependent API route tasks are dynamically deadlocked and bypassed until fixed.
+- **ANSI TUI Swarm Dashboard**: Intercepts verbose, noisy terminal output when running parallel swarms (`tk /swarm`), projecting agent research, coding, and review steps in real-time.
+- **Failure Context Recalls**: Tracks failure histories, error stacks, and retry budgets. If a task is picked up by a new agent session, the agent receives the exact history of failed approaches to course-correct instantly.
 
 <br>
 <hr style="height: 1px; border: none; background: linear-gradient(to right, transparent, #33333f, transparent); margin: 40px 0;" />
 
 <!-- SECTION 10 -->
+
 ## 🔌 Model Context Protocol (MCP) Server Integration
 
 Tribunal Kit hosts an out-of-the-box **Model Context Protocol (MCP)** server via stdio. Connect it to Cursor, VSCode, Windsurf, or Claude Desktop to allow coding agents to query tools dynamically.
@@ -350,14 +373,44 @@ Tribunal Kit hosts an out-of-the-box **Model Context Protocol (MCP)** server via
 ```
 
 ### Exposed MCP Tools
-*   `run_tribunal_audit` — Triggers a workspace security, lint, and build checklist.
-*   `search_case_law` — Queries historical codebase rejections.
-*   `get_tribunal_skill` / `list_tribunal_agents` — Dynamically injects skills/agent guidelines without overloading system prompts.
+
+- `verify_contracts` — Proactively verifies proposed code against team contract rules before writing to disk.
+- `get_tribunal_skill` / `list_tribunal_agents` — Dynamically injects skills/agent guidelines without overloading system prompts.
+
+<br>
+<hr style="height: 1px; border: none; background: linear-gradient(to right, transparent, #33333f, transparent); margin: 40px 0;" />
+
+<!-- SECTION 13 -->
+
+## 📜 Sovereign Covenant Protocol — AI Agent Behavioral Contract Testing (`tk contract`)
+
+Design by Contract applied to AI coding agents. Declare invariants in declarative YAML rules stored in `.tribunal/contracts/`:
+
+```yaml
+name: 'No console.log in production code'
+scope: 'src/**/*.ts, src/**/*.tsx'
+severity: block
+must_not:
+  - pattern: 'console.log'
+    message: 'Use structured logger instead of console.log'
+```
+
+```bash
+# Scaffold starter contracts
+npx tribunal-kit contract init
+
+# Run contract checks against target or modified files
+npx tribunal-kit contract verify
+
+# Replay a failure context trace snapshot
+npx tribunal-kit contract replay <trace_id>
+```
 
 <br>
 <hr style="height: 1px; border: none; background: linear-gradient(to right, transparent, #33333f, transparent); margin: 40px 0;" />
 
 <!-- SECTION 11 -->
+
 ## 💻 CLI Command Reference
 
 Below is the structured list of all core commands available via `npx tribunal-kit <command>` (or the alias `tk`):
@@ -427,6 +480,11 @@ Below is the structured list of all core commands available via `npx tribunal-ki
         <td style="padding: 12px 16px; color: #c9c9d1;"><code>init | status | next</code></td>
         <td style="padding: 12px 16px; color: #a0a0a5;">Sets up and executes long-running autonomous development.</td>
       </tr>
+      <tr style="border-bottom: 1px solid #222225;">
+        <td style="padding: 12px 16px;"><kbd style="background: #1c1c24; border: 1px solid #333; padding: 2px 6px; border-radius: 4px; color: #ffffff;">contract</kbd></td>
+        <td style="padding: 12px 16px; color: #c9c9d1;"><code>init | verify | list | trace | replay</code></td>
+        <td style="padding: 12px 16px; color: #a0a0a5;">AI Agent Behavioral Contract Testing and failure context trace replay.</td>
+      </tr>
     </tbody>
   </table>
 </div>
@@ -435,11 +493,13 @@ Below is the structured list of all core commands available via `npx tribunal-ki
 <hr style="height: 1px; border: none; background: linear-gradient(to right, transparent, #33333f, transparent); margin: 40px 0;" />
 
 <!-- SECTION 12 -->
+
 ## 🤝 Contributing & Security
 
 We maintain high code standards and absolute runtime safety:
-*   **Security Policy**: Tribunal Kit operates with **zero runtime network dependencies**, zero dangerous `eval` executes, and sandboxed file paths to protect your codebase. Read more in [SECURITY.md](SECURITY.md).
-*   **Contributing Guide**: We welcome community-authored agents, skills, and workflows! Please read [CONTRIBUTING.md](CONTRIBUTING.md) to set up your local development environment and run our verification tests.
+
+- **Security Policy**: Tribunal Kit operates with **zero runtime network dependencies**, zero dangerous `eval` executes, and sandboxed file paths to protect your codebase. Read more in [SECURITY.md](SECURITY.md).
+- **Contributing Guide**: We welcome community-authored agents, skills, and workflows! Please read [CONTRIBUTING.md](CONTRIBUTING.md) to set up your local development environment and run our verification tests.
 
 <br>
 <br>

package/SECURITY.md

@@ -2,11 +2,11 @@
 
 ## Supported Versions
 
-| Version | Supported          |
-| ------- | ------------------ |
-| 6.x     | ✅ Active support  |
-| 5.x     | ⚠️ Critical fixes only |
-| < 5.0   | ❌ End of life     |
+| Version | Supported              |
+| ------- | ---------------------- |
+| 7.x     | ✅ Active support      |
+| 6.x     | ⚠️ Critical fixes only |
+| < 6.0   | ❌ End of life         |
 
 ## Reporting a Vulnerability
 
@@ -28,12 +28,12 @@ Instead, please report vulnerabilities privately using one of these methods:
 
 ### Response timeline
 
-| Action | Timeline |
-| --- | --- |
-| Acknowledgment | Within 48 hours |
-| Initial assessment | Within 5 business days |
-| Fix release (critical) | Within 7 days |
-| Fix release (moderate) | Within 30 days |
+| Action                 | Timeline               |
+| ---------------------- | ---------------------- |
+| Acknowledgment         | Within 48 hours        |
+| Initial assessment     | Within 5 business days |
+| Fix release (critical) | Within 7 days          |
+| Fix release (moderate) | Within 30 days         |
 
 ## Security Design
 

package/bin/adapter-install.js

@@ -0,0 +1,240 @@
+#!/usr/bin/env node
+
+/**
+ * Tribunal Kit — Universal CLI Agent Adapter
+ *
+ * Auto-detects installed CLI agents and configures Tribunal Kit
+ * for each one. Supports Claude Code, Aider, Codex, Gemini CLI,
+ * OpenCode, Copilot CLI, Cursor, Windsurf, and Cline.
+ *
+ * Usage:
+ *   node bin/adapter-install.js           # Auto-detect and install all
+ *   node bin/adapter-install.js claude     # Install for Claude Code only
+ *   node bin/adapter-install.js --global   # Install to ~/.tribunal-kit/
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execSync } = require('child_process');
+
+const ADAPTERS = {
+  'claude-code': {
+    detect: () => commandExists('claude'),
+    rulesFile: '.claude/CLAUDE.md',
+    description: 'Claude Code CLI',
+    setup: (projectRoot, _globalMode) => {
+      const rulesDir = path.join(projectRoot, '.claude');
+      ensureDir(rulesDir);
+      const source = path.join(__dirname, '..', '.claude', 'CLAUDE.md');
+      const target = path.join(rulesDir, 'CLAUDE.md');
+      if (fs.existsSync(source)) {
+        fs.copyFileSync(source, target);
+      }
+      // Also install MCP server config
+      installMcpConfig(projectRoot, 'claude');
+    },
+  },
+
+  aider: {
+    detect: () => commandExists('aider'),
+    rulesFile: '.aider.conf.yml',
+    description: 'Aider CLI',
+    setup: projectRoot => {
+      const conventionsPath = path.join(projectRoot, 'CONVENTIONS.md');
+      const systemPrompt = fs.readFileSync(
+        path.join(__dirname, '..', '.agent', 'config', 'system-prompt.md'),
+        'utf8',
+      );
+      fs.writeFileSync(conventionsPath, systemPrompt);
+      console.log(`  ✓ Wrote ${conventionsPath}`);
+    },
+  },
+
+  codex: {
+    detect: () => commandExists('codex'),
+    rulesFile: 'AGENTS.md',
+    description: 'OpenAI Codex CLI',
+    setup: projectRoot => {
+      const agentsPath = path.join(projectRoot, 'AGENTS.md');
+      const systemPrompt = fs.readFileSync(
+        path.join(__dirname, '..', '.agent', 'config', 'system-prompt.md'),
+        'utf8',
+      );
+      fs.writeFileSync(agentsPath, systemPrompt);
+      console.log(`  ✓ Wrote ${agentsPath}`);
+    },
+  },
+
+  'gemini-cli': {
+    detect: () => commandExists('gemini'),
+    rulesFile: '.gemini/rules/GEMINI.md',
+    description: 'Google Gemini CLI',
+    setup: projectRoot => {
+      const geminiDir = path.join(projectRoot, '.gemini', 'rules');
+      ensureDir(geminiDir);
+      const systemPrompt = fs.readFileSync(
+        path.join(__dirname, '..', '.agent', 'config', 'system-prompt.md'),
+        'utf8',
+      );
+      fs.writeFileSync(path.join(geminiDir, 'GEMINI.md'), systemPrompt);
+      console.log(`  ✓ Wrote ${path.join(geminiDir, 'GEMINI.md')}`);
+      // Also install MCP config
+      installMcpConfig(projectRoot, 'gemini');
+    },
+  },
+
+  opencode: {
+    detect: () => commandExists('opencode'),
+    rulesFile: '.opencode/rules.md',
+    description: 'OpenCode CLI',
+    setup: projectRoot => {
+      const opencodeDir = path.join(projectRoot, '.opencode');
+      ensureDir(opencodeDir);
+      const systemPrompt = fs.readFileSync(
+        path.join(__dirname, '..', '.agent', 'config', 'system-prompt.md'),
+        'utf8',
+      );
+      fs.writeFileSync(path.join(opencodeDir, 'rules.md'), systemPrompt);
+      console.log(`  ✓ Wrote ${path.join(opencodeDir, 'rules.md')}`);
+    },
+  },
+
+  'copilot-cli': {
+    detect: () => commandExists('gh') && hasGhExtension('copilot'),
+    rulesFile: '.github/copilot-instructions.md',
+    description: 'GitHub Copilot CLI',
+    setup: projectRoot => {
+      const ghDir = path.join(projectRoot, '.github');
+      ensureDir(ghDir);
+      const systemPrompt = fs.readFileSync(
+        path.join(__dirname, '..', '.agent', 'config', 'system-prompt.md'),
+        'utf8',
+      );
+      fs.writeFileSync(path.join(ghDir, 'copilot-instructions.md'), systemPrompt);
+      console.log(`  ✓ Wrote ${path.join(ghDir, 'copilot-instructions.md')}`);
+    },
+  },
+};
+
+// --- Utility Functions ---
+
+function commandExists(cmd) {
+  try {
+    const isWin = os.platform() === 'win32';
+    const check = isWin ? `where ${cmd}` : `which ${cmd}`;
+    execSync(check, { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function hasGhExtension(ext) {
+  try {
+    const output = execSync('gh extension list', { encoding: 'utf8' });
+    return output.includes(ext);
+  } catch {
+    return false;
+  }
+}
+
+function ensureDir(dirPath) {
+  if (!fs.existsSync(dirPath)) {
+    fs.mkdirSync(dirPath, { recursive: true });
+  }
+}
+
+function installMcpConfig(projectRoot, target) {
+  const mcpConfig = {
+    mcpServers: {
+      'tribunal-kit': {
+        command: 'node',
+        args: [path.join(__dirname, '..', 'bin', 'mcp-server.js')],
+        env: { NODE_ENV: 'production' },
+      },
+    },
+  };
+
+  let configPath;
+  if (target === 'claude') {
+    configPath = path.join(projectRoot, '.claude', 'mcp.json');
+  } else if (target === 'gemini') {
+    configPath = path.join(projectRoot, '.gemini', 'settings.json');
+  } else {
+    configPath = path.join(projectRoot, 'mcp_config.json');
+  }
+
+  fs.writeFileSync(configPath, JSON.stringify(mcpConfig, null, 2));
+  console.log(`  ✓ MCP server registered at ${configPath}`);
+}
+
+// --- Main ---
+
+function main() {
+  const args = process.argv.slice(2);
+  const globalMode = args.includes('--global');
+  const targetAgent = args.find(a => !a.startsWith('-'));
+  const projectRoot = globalMode ? path.join(os.homedir(), '.tribunal-kit') : process.cwd();
+
+  console.log('');
+  console.log('┌─────────────────────────────────────────────┐');
+  console.log('│  🔱 Tribunal Kit — Universal Agent Adapter  │');
+  console.log('│  v7.0.0 · 52 specialists · 186 skills       │');
+  console.log('└─────────────────────────────────────────────┘');
+  console.log('');
+
+  if (globalMode) {
+    ensureDir(projectRoot);
+    console.log(`📁 Global mode: Installing to ${projectRoot}`);
+  } else {
+    console.log(`📁 Project mode: Installing to ${projectRoot}`);
+  }
+  console.log('');
+
+  let installed = 0;
+  let detected = 0;
+
+  for (const [name, adapter] of Object.entries(ADAPTERS)) {
+    if (targetAgent && name !== targetAgent) continue;
+
+    const isDetected = adapter.detect();
+    if (isDetected) detected++;
+
+    if (targetAgent || isDetected) {
+      console.log(`⚡ ${adapter.description} ${isDetected ? '(detected)' : '(manual)'}`);
+      try {
+        adapter.setup(projectRoot, globalMode);
+        installed++;
+        console.log(`  ✅ Tribunal Kit configured for ${adapter.description}`);
+      } catch (err) {
+        console.error(`  ❌ Failed: ${err.message}`);
+      }
+      console.log('');
+    }
+  }
+
+  if (installed === 0 && !targetAgent) {
+    console.log('⚠️  No CLI agents detected on this machine.');
+    console.log('');
+    console.log('   Supported agents:');
+    for (const [name, adapter] of Object.entries(ADAPTERS)) {
+      console.log(`     • ${name.padEnd(15)} → ${adapter.description}`);
+    }
+    console.log('');
+    console.log('   Install one, then run this command again.');
+    console.log('   Or specify manually: node bin/adapter-install.js claude-code');
+  } else {
+    console.log('─────────────────────────────────────────────');
+    console.log(`✅ Configured ${installed} agent(s) (${detected} auto-detected)`);
+    console.log('');
+    console.log('   Next steps:');
+    console.log('   1. Open your CLI agent normally');
+    console.log('   2. The Tribunal rules are now enforced automatically');
+    console.log('   3. Use /tribunal, /summon, /audit, /debug commands');
+  }
+
+  console.log('');
+}
+
+main();

package/bin/global-store.js

@@ -0,0 +1,48 @@
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const GLOBAL_STORE_PATH = path.join(os.homedir(), '.tribunal-kit');
+const LOCAL_AGENT_PATH = path.join(__dirname, '..', '.agent');
+
+function initializeGlobalStore() {
+  if (!fs.existsSync(GLOBAL_STORE_PATH)) {
+    console.log(`[Tribunal Kit] Initializing global knowledge base at ${GLOBAL_STORE_PATH}...`);
+    fs.mkdirSync(GLOBAL_STORE_PATH, { recursive: true });
+  }
+
+  // Copy .agent folder if it doesn't exist in the global store or if we want to force update
+  const globalAgentPath = path.join(GLOBAL_STORE_PATH, '.agent');
+  if (!fs.existsSync(globalAgentPath)) {
+    console.log(`[Tribunal Kit] Copying specialists and skills to global store...`);
+    copyDirectoryRecursiveSync(LOCAL_AGENT_PATH, globalAgentPath);
+  }
+}
+
+function copyDirectoryRecursiveSync(source, target) {
+  if (!fs.existsSync(target)) {
+    fs.mkdirSync(target, { recursive: true });
+  }
+
+  const files = fs.readdirSync(source);
+  for (const file of files) {
+    const sourcePath = path.join(source, file);
+    const targetPath = path.join(target, file);
+
+    if (fs.lstatSync(sourcePath).isDirectory()) {
+      copyDirectoryRecursiveSync(sourcePath, targetPath);
+    } else {
+      fs.copyFileSync(sourcePath, targetPath);
+    }
+  }
+}
+
+function getGlobalAgentPath() {
+  return path.join(GLOBAL_STORE_PATH, '.agent');
+}
+
+module.exports = {
+  initializeGlobalStore,
+  getGlobalAgentPath,
+  GLOBAL_STORE_PATH,
+};