tribunal-kit 4.3.0 → 4.3.1

package/README.md

@@ -1,242 +1,242 @@
-<div align="center">
-  <picture>
-    <img src="./docs/tribunalkit_no_bg.png" alt="TribunalKit — Code Without Hallucinations" width="480">
-  </picture>
-
-  <br><br>
-
-  [![NPM](https://img.shields.io/npm/v/tribunal-kit?style=for-the-badge&logo=npm&logoColor=white)](https://www.npmjs.com/package/tribunal-kit)
-  [![License](https://img.shields.io/badge/License-MIT-8b5cf6?style=for-the-badge)](LICENSE)
-  [![Version](https://img.shields.io/badge/Version-4.2.0_Supreme_Court-black?style=for-the-badge)](CHANGELOG.md)
-</div>
-
-
-<br><br>
-
-> 🚨 **AI GENERATES CODE. TRIBUNAL ENSURES IT WORKS.**  
-> A plug-in `.agent/` intelligence payload that upgrades your IDE with **41 specialist agents**, **31 slash commands**, **16 parallel Tribunal reviewers**, and a core **Swarm/Supervisor** engine.
-
----
-
-<br>
-
-## ▓▒░ INITIATION SEQUENCE
-
-Drop Tribunal into any project. Global or local.
-
-```bash
-# Pull the intelligence payload into your project
-npx tribunal-kit init
-```
-*(Installs the `.agent/` architecture directly. No bloat. Pure capability.)*
-
-<details>
-<summary><b>📺 Quick Demo — What happens when you run it</b></summary>
-<br>
-
-```
-$ npx tribunal-kit init
-
-  ████████╗██████╗ ██╗██████╗ ██╗   ██╗███╗   ██╗ █████╗ ██╗
-  ╚══██╔══╝██╔══██╗██║██╔══██╗██║   ██║████╗  ██║██╔══██╗██║
-     ██║   ██████╔╝██║██████╔╝██║   ██║██╔██╗ ██║███████║██║
-     ██║   ██╔══██╗██║██╔══██╗██║   ██║██║╚██╗██║██╔══██║██║
-     ██║   ██║  ██║██║██████╔╝╚██████╔╝██║ ╚████║██║  ██║███████╗
-     ╚═╝   ╚═╝  ╚═╝╚═╝╚═════╝  ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝╚══════╝
-
-  ╔══════════════════════════════════════════════════════════════╗
-  ║              Anti-Hallucination Agent System                ║
-  ╚══════════════════════════════════════════════════════════════╝
-
-  ✔ Installed → .agent/
-
-  ╔══════════════════════════════════════════════════════════════╗
-  ║  🤖  Agents         40 installed                            ║
-  ║  ⚡  Workflows       31 installed                            ║
-  ║  🧠  Skills          90 installed                            ║
-  ║  🔧  Scripts         27 installed                            ║
-  ╚══════════════════════════════════════════════════════════════╝
-
-  ✔ 700+ files installed. 16 parallel Tribunal reviewers armed.
-
-$ npx tribunal-kit status
-
-  ✔ Installed at .agent/
-  🤖  agents         40 files
-  ⚡  workflows      31 files
-  🧠  skills         90 files
-  🔧  scripts        27 files
-```
-
-> 💡 **Lighter install?** Use `npx tribunal-kit init --minimal` for just 13 core agents + 15 essential skills.
-
-</details>
-
-> ✅ **IDE Auto-Detection:** `init` automatically generates bridge files for every major AI coding IDE:
->
-> | IDE | Bridge File Generated |
-> | :--- | :--- |
-> | **Cursor** | `.cursorrules` |
-> | **Windsurf** | `.windsurfrules` |
-> | **Gemini / Antigravity** | `.gemini/settings.json` + `.gemini/GEMINI.md` |
-> | **GitHub Copilot** | `.github/copilot-instructions.md` |
-> | **Claude** | `.claude/CLAUDE.md` |
->
-> Bridge files are never overwritten on re-init — your customizations are safe.
-
-**Prerequisites:** Node.js ≥ 18 • Python ≥ 3.10 *(optional — required for utility scripts like `checklist.py`, `security_scan.py`)*
-
-> 💡 **Shorthand alias:** You can use `tk` instead of `tribunal-kit` for all commands (e.g., `tk init`, `tk status`).
-
-<br>
-
-## ▓▒░ THE PIPELINE // HOW IT WORKS
-
-**Code generation is solved. Code correctness is the frontier.** We enforce a strict **Evidence-Based Closeout**.
-
-```diff
-- AI Generates -> Commits to Disk -> You Find Bugs Later
-+ AI Generates -> Parallel Tribunal Review -> Human Gate -> Commits to Disk
-```
-
-### 🎯 Auto-Routing Intelligence
-No manual tagging required. The system self-organizes.
-
-<p>
-<kbd>User</kbd> "Add JWT authentication" <br>
-<kbd>System</kbd> <code>🤖 Applying @security-auditor + @backend-specialist...</code> <br><br>
-
-<kbd>User</kbd> "Fix the dark mode button" <br>
-<kbd>System</kbd> <code>🤖 Applying @ui-ux-pro-max + @frontend-specialist...</code> <br><br>
-
-<kbd>User</kbd> "/swarm build a API" <br>
-<kbd>System</kbd> <code>🤖 supervisor-agent → Dispatching 3 Workers...</code>
-</p>
-
-<br>
-
-## ▓▒░ THE SUPREME COURT (v4.0)
-
-*(New in v4)* The Tribunal Kit now features persistent memory so the AI **never makes the same mistake twice** and automatically learns your team's coding style.
-
-**1. The Case Law Engine (Never repeat mistakes)**
-If an agent makes a mistake, you can record it as a legal precedent. Before writing any future code, the `precedence-reviewer` checks this database locally to forcefully block the AI from repeating that mistake.
-- `npx tribunal-kit case add` *(Record an AI hallucination)*
-- `npx tribunal-kit case search "query"` *(Search your precedents)*
-
-**2. Skill Evolution Forge (Auto-learns your style)**
-You no longer need to write manual rules. The system reads your Git commits, strips out the noise to save tokens, and automatically extracts your project's unique architectural patterns to teach the AI.
-- `npx tribunal-kit learn` *(Run a learning digest on staged files)*
-- `npx tribunal-kit hook` *(Automate learning every time you `git push`)*
-
-<br>
-
-## ▓▒░ CAPABILITY MATRIX
-
-| System Asset | Count | Operational Scope |
-| :--- | :---: | :--- |
-| 🤖 **Agents** | `40` | Specialist personas — 16 reviewers + 24 domain specialists |
-| 🧠 **Skills** | `90` | Domain modules (Edge Computing, Red Team Tactics, GSAP, Framer Motion, TypeScript Advanced) |
-| ⚡ **Workflows** | `31` | Slash command procedures including `/swarm`, `/tribunal-full`, `/ui-ux-pro-max` |
-| 🛠️ **Scripts** | `25` | CI/CD, linting, payload dispatching, security scanning, case law, skill evolution |
-
-
-<br>
-
-## ▓▒░ COMMAND TERMINAL
-
-Expand the accordions to view the operational commands at your disposal.
-
-<details open>
-<summary><b>🔥 CORE EXECUTION</b></summary>
-<br>
-
-| Command | Action |
-| :--- | :--- |
-| <code>/generate</code> | Trigger full Tribunal: Generate → Audit → Approve. |
-| <code>/create</code> | Scaffold major features or apps, routed by App Builder. |
-| <code>/enhance</code> | Safely extend existing structures without regression. |
-| <code>/deploy</code> | Force the 3-gate production release sequence. |
-
-</details>
-
-<details>
-<summary><b>⚖️ THE TRIBUNAL GAUNTLET (REVIEWERS)</b></summary>
-<br>
-Unleash parallel reviewers on existing code.
-
-| Command | Action |
-| :--- | :--- |
-| <code>/review</code> | Audit code for silent degradation and logic holes. |
-| <code>/tribunal-full</code> | Unleash **ALL 16** reviewers simultaneously. Maximum scrutiny. |
-| <code>/tribunal-backend</code> | Summons <code>[ Logic + Security + Dependency + Types ]</code> |
-| <code>/tribunal-frontend</code> | Summons <code>[ Logic + Security + Frontend + Types ]</code> |
-| <code>/tribunal-database</code> | Summons <code>[ Logic + Security + SQL ]</code> |
-| <code>/tribunal-mobile</code> | Summons <code>[ Logic + Security + Mobile ]</code> |
-
-</details>
-
-<details>
-<summary><b>🧠 SWARM & ORCHESTRATION</b></summary>
-<br>
-
-| Command | Action |
-| :--- | :--- |
-| <code>/swarm</code> | Supervisor breaks goal → sends to isolated workers → synthesizes. |
-| <code>/orchestrate</code> | Manual multi-agent sync for complex integrations. |
-| <code>/plan</code> | Architectural mapping before a single line is written. |
-| <code>/ui-ux-pro-max</code>| Triggers peak aesthetic frontend design. |
-
-</details>
-
-<details>
-<summary><b>⚖️ SUPREME COURT / MEMORY</b></summary>
-<br>
-
-| Command | Action |
-| :--- | :--- |
-| <code>npx tribunal-kit case add</code> | Record an AI hallucination to ban it forever. |
-| <code>npx tribunal-kit case search</code> | Search your local database of banned code. |
-| <code>npx tribunal-kit learn</code> | Auto-extract project idioms from your git diffs. |
-| <code>npx tribunal-kit hook</code> | Install a git hook to auto-learn the moment you push. |
-
-</details>
-
-<details>
-<summary><b>🔧 TROUBLESHOOTING & OPS</b></summary>
-<br>
-
-| Command | Action |
-| :--- | :--- |
-| <code>/debug</code> | Systematic root-cause investigation. |
-| <code>/preview</code> | Local development server control. |
-| <code>/status</code> | View Tribunal session status. |
-
-</details>
-
-<br>
-
-## ▓▒░ POST-INSTALL TELEMETRY
-
-After initialization, utility scripts unlock local ops:
-
-```bash
-# 01. Pre-commit audit
-python .agent/scripts/checklist.py .
-
-# 02. Pre-deploy full suite verification
-python .agent/scripts/verify_all.py
-
-# 03. Start local development environment
-python .agent/scripts/auto_preview.py start
-```
-
-<br>
-
-<div align="center">
-  <br>
-  <img src="https://img.shields.io/badge/Status-Active_&_Secured-00e5ff?style=for-the-badge" alt="Status" />
-  <br><br>
-  <i>"Never guess database column names. Error handling on every async function. Evidence-based closeouts. Welcome to the Tribunal."</i><br>
-  <sub><b>MIT Licensed</b> • Hand-forged for high-performance agentic engineering.</sub>
-</div>
+<div align="center">
+  <picture>
+    <img src="./docs/tribunalkit_no_bg.png" alt="TribunalKit — Code Without Hallucinations" width="480">
+  </picture>
+
+  <br><br>
+
+  [![NPM](https://img.shields.io/npm/v/tribunal-kit?style=for-the-badge&logo=npm&logoColor=white)](https://www.npmjs.com/package/tribunal-kit)
+  [![License](https://img.shields.io/badge/License-MIT-8b5cf6?style=for-the-badge)](LICENSE)
+  [![Version](https://img.shields.io/badge/Version-4.3.1_Supreme_Court-black?style=for-the-badge)](CHANGELOG.md)
+</div>
+
+
+<br><br>
+
+> 🚨 **AI GENERATES CODE. TRIBUNAL ENSURES IT WORKS.**  
+> A plug-in `.agent/` intelligence payload that upgrades your IDE with **41 specialist agents**, **32 slash commands**, **16 parallel Tribunal reviewers**, and a core **Swarm/Supervisor** engine.
+
+---
+
+<br>
+
+## ▓▒░ INITIATION SEQUENCE
+
+Drop Tribunal into any project. Global or local.
+
+```bash
+# Pull the intelligence payload into your project
+npx tribunal-kit init
+```
+*(Installs the `.agent/` architecture directly. No bloat. Pure capability.)*
+
+<details>
+<summary><b>📺 Quick Demo — What happens when you run it</b></summary>
+<br>
+
+```
+$ npx tribunal-kit init
+
+  ████████╗██████╗ ██╗██████╗ ██╗   ██╗███╗   ██╗ █████╗ ██╗
+  ╚══██╔══╝██╔══██╗██║██╔══██╗██║   ██║████╗  ██║██╔══██╗██║
+     ██║   ██████╔╝██║██████╔╝██║   ██║██╔██╗ ██║███████║██║
+     ██║   ██╔══██╗██║██╔══██╗██║   ██║██║╚██╗██║██╔══██║██║
+     ██║   ██║  ██║██║██████╔╝╚██████╔╝██║ ╚████║██║  ██║███████╗
+     ╚═╝   ╚═╝  ╚═╝╚═╝╚═════╝  ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝╚══════╝
+
+  ╔══════════════════════════════════════════════════════════════╗
+  ║              Anti-Hallucination Agent System                ║
+  ╚══════════════════════════════════════════════════════════════╝
+
+  ✔ Installed → .agent/
+
+  ╔══════════════════════════════════════════════════════════════╗
+  ║  🤖  Agents         41 installed                            ║
+  ║  ⚡  Workflows       32 installed                            ║
+  ║  🧠  Skills          91 installed                            ║
+  ║  🔧  Scripts         27 installed                            ║
+  ╚══════════════════════════════════════════════════════════════╝
+
+  ✔ 700+ files installed. 16 parallel Tribunal reviewers armed.
+
+$ npx tribunal-kit status
+
+  ✔ Installed at .agent/
+  🤖  agents         40 files
+  ⚡  workflows      31 files
+  🧠  skills         90 files
+  🔧  scripts        27 files
+```
+
+> 💡 **Lighter install?** Use `npx tribunal-kit init --minimal` for just 13 core agents + 15 essential skills.
+
+</details>
+
+> ✅ **IDE Auto-Detection:** `init` automatically generates bridge files for every major AI coding IDE:
+>
+> | IDE | Bridge File Generated |
+> | :--- | :--- |
+> | **Cursor** | `.cursorrules` |
+> | **Windsurf** | `.windsurfrules` |
+> | **Gemini / Antigravity** | `.gemini/settings.json` + `.gemini/GEMINI.md` |
+> | **GitHub Copilot** | `.github/copilot-instructions.md` |
+> | **Claude** | `.claude/CLAUDE.md` |
+>
+> Bridge files are never overwritten on re-init — your customizations are safe.
+
+**Prerequisites:** Node.js ≥ 18
+
+> 💡 **Shorthand alias:** You can use `tk` instead of `tribunal-kit` for all commands (e.g., `tk init`, `tk status`).
+
+<br>
+
+## ▓▒░ THE PIPELINE // HOW IT WORKS
+
+**Code generation is solved. Code correctness is the frontier.** We enforce a strict **Evidence-Based Closeout**.
+
+```diff
+- AI Generates -> Commits to Disk -> You Find Bugs Later
++ AI Generates -> Parallel Tribunal Review -> Human Gate -> Commits to Disk
+```
+
+### 🎯 Auto-Routing Intelligence
+No manual tagging required. The system self-organizes.
+
+<p>
+<kbd>User</kbd> "Add JWT authentication" <br>
+<kbd>System</kbd> <code>🤖 Applying @security-auditor + @backend-specialist...</code> <br><br>
+
+<kbd>User</kbd> "Fix the dark mode button" <br>
+<kbd>System</kbd> <code>🤖 Applying @ui-ux-pro-max + @frontend-specialist...</code> <br><br>
+
+<kbd>User</kbd> "/swarm build a API" <br>
+<kbd>System</kbd> <code>🤖 supervisor-agent → Dispatching 3 Workers...</code>
+</p>
+
+<br>
+
+## ▓▒░ THE SUPREME COURT (v4.0)
+
+*(New in v4)* The Tribunal Kit now features persistent memory so the AI **never makes the same mistake twice** and automatically learns your team's coding style.
+
+**1. The Case Law Engine (Never repeat mistakes)**
+If an agent makes a mistake, you can record it as a legal precedent. Before writing any future code, the `precedence-reviewer` checks this database locally to forcefully block the AI from repeating that mistake.
+- `npx tribunal-kit case add` *(Record an AI hallucination)*
+- `npx tribunal-kit case search "query"` *(Search your precedents)*
+
+**2. Skill Evolution Forge (Auto-learns your style)**
+You no longer need to write manual rules. The system reads your Git commits, strips out the noise to save tokens, and automatically extracts your project's unique architectural patterns to teach the AI.
+- `npx tribunal-kit learn` *(Run a learning digest on staged files)*
+- `npx tribunal-kit hook` *(Automate learning every time you `git push`)*
+
+<br>
+
+## ▓▒░ CAPABILITY MATRIX
+
+| System Asset | Count | Operational Scope |
+| :--- | :---: | :--- |
+| 🤖 **Agents** | `40` | Specialist personas — 16 reviewers + 24 domain specialists |
+| 🧠 **Skills** | `90` | Domain modules (Edge Computing, Red Team Tactics, GSAP, Framer Motion, TypeScript Advanced) |
+| ⚡ **Workflows** | `31` | Slash command procedures including `/swarm`, `/tribunal-full`, `/ui-ux-pro-max` |
+| 🛠️ **Scripts** | `25` | CI/CD, linting, payload dispatching, security scanning, case law, skill evolution |
+
+
+<br>
+
+## ▓▒░ COMMAND TERMINAL
+
+Expand the accordions to view the operational commands at your disposal.
+
+<details open>
+<summary><b>🔥 CORE EXECUTION</b></summary>
+<br>
+
+| Command | Action |
+| :--- | :--- |
+| <code>/generate</code> | Trigger full Tribunal: Generate → Audit → Approve. |
+| <code>/create</code> | Scaffold major features or apps, routed by App Builder. |
+| <code>/enhance</code> | Safely extend existing structures without regression. |
+| <code>/deploy</code> | Force the 3-gate production release sequence. |
+
+</details>
+
+<details>
+<summary><b>⚖️ THE TRIBUNAL GAUNTLET (REVIEWERS)</b></summary>
+<br>
+Unleash parallel reviewers on existing code.
+
+| Command | Action |
+| :--- | :--- |
+| <code>/review</code> | Audit code for silent degradation and logic holes. |
+| <code>/tribunal-full</code> | Unleash **ALL 16** reviewers simultaneously. Maximum scrutiny. |
+| <code>/tribunal-backend</code> | Summons <code>[ Logic + Security + Dependency + Types ]</code> |
+| <code>/tribunal-frontend</code> | Summons <code>[ Logic + Security + Frontend + Types ]</code> |
+| <code>/tribunal-database</code> | Summons <code>[ Logic + Security + SQL ]</code> |
+| <code>/tribunal-mobile</code> | Summons <code>[ Logic + Security + Mobile ]</code> |
+
+</details>
+
+<details>
+<summary><b>🧠 SWARM & ORCHESTRATION</b></summary>
+<br>
+
+| Command | Action |
+| :--- | :--- |
+| <code>/swarm</code> | Supervisor breaks goal → sends to isolated workers → synthesizes. |
+| <code>/orchestrate</code> | Manual multi-agent sync for complex integrations. |
+| <code>/plan</code> | Architectural mapping before a single line is written. |
+| <code>/ui-ux-pro-max</code>| Triggers peak aesthetic frontend design. |
+
+</details>
+
+<details>
+<summary><b>⚖️ SUPREME COURT / MEMORY</b></summary>
+<br>
+
+| Command | Action |
+| :--- | :--- |
+| <code>npx tribunal-kit case add</code> | Record an AI hallucination to ban it forever. |
+| <code>npx tribunal-kit case search</code> | Search your local database of banned code. |
+| <code>npx tribunal-kit learn</code> | Auto-extract project idioms from your git diffs. |
+| <code>npx tribunal-kit hook</code> | Install a git hook to auto-learn the moment you push. |
+
+</details>
+
+<details>
+<summary><b>🔧 TROUBLESHOOTING & OPS</b></summary>
+<br>
+
+| Command | Action |
+| :--- | :--- |
+| <code>/debug</code> | Systematic root-cause investigation. |
+| <code>/preview</code> | Local development server control. |
+| <code>/status</code> | View Tribunal session status. |
+
+</details>
+
+<br>
+
+## ▓▒░ POST-INSTALL TELEMETRY
+
+After initialization, utility scripts unlock local ops:
+
+```bash
+# 01. Pre-commit audit
+node .agent/scripts/checklist.js .
+
+# 02. Pre-deploy full suite verification
+node .agent/scripts/verify_all.js
+
+# 03. Start local development environment
+node .agent/scripts/auto_preview.js start
+```
+
+<br>
+
+<div align="center">
+  <br>
+  <img src="https://img.shields.io/badge/Status-Active_&_Secured-00e5ff?style=for-the-badge" alt="Status" />
+  <br><br>
+  <i>"Never guess database column names. Error handling on every async function. Evidence-based closeouts. Welcome to the Tribunal."</i><br>
+  <sub><b>MIT Licensed</b> • Hand-forged for high-performance agentic engineering.</sub>
+</div> 

package/bin/tribunal-kit.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 /**
  * tribunal-kit CLI (alias: tk)
  * 
@@ -373,6 +373,35 @@ function cmdInit(flags) {
     }
     // ────────────────────────────────────────────────────────
 
+    // ── Backup / Cleanup ────────────────────────────────────
+    if (!dryRun && fs.existsSync(agentDest) && flags.force) {
+        // Backup the existing subdirectories before overwriting
+        const backupDir = path.join(agentDest, '.backups', `backup-${Date.now()}`);
+        fs.mkdirSync(backupDir, { recursive: true });
+
+        // PRESERVE_DIRS: user-generated content that must survive updates
+        const PRESERVE_DIRS = ['history', 'patterns', 'mcp_config.json'];
+        const subdirs = ['agents', 'workflows', 'skills', 'scripts', '.shared', 'rules'];
+        for (const sub of subdirs) {
+            const subPath = path.join(agentDest, sub);
+            if (fs.existsSync(subPath)) {
+                // Copy to backup dir
+                copyDir(subPath, path.join(backupDir, sub), false);
+                fs.rmSync(subPath, { recursive: true, force: true });
+            }
+        }
+        log(`  ${c('gray', '✦ Backed up existing configurations to .agent/.backups/')}`);
+
+        // Verify preserved dirs still exist after cleanup
+        for (const kept of PRESERVE_DIRS) {
+            const keptPath = path.join(agentDest, kept);
+            if (kept.includes('.') ? false : !fs.existsSync(keptPath)) {
+                // It's okay if it doesn't exist yet — it'll be created below
+            }
+        }
+    }
+    // ────────────────────────────────────────────────────────
+
     banner();
 
     if (dryRun) {
@@ -395,25 +424,6 @@ function cmdInit(flags) {
         process.exit(0);
     }
 
-    if (!dryRun && fs.existsSync(agentDest) && flags.force) {
-        // PRESERVE_DIRS: user-generated content that must survive updates
-        const PRESERVE_DIRS = ['history', 'patterns', 'mcp_config.json'];
-        const subdirs = ['agents', 'workflows', 'skills', 'scripts', '.shared', 'rules'];
-        for (const sub of subdirs) {
-            const subPath = path.join(agentDest, sub);
-            if (fs.existsSync(subPath)) {
-                fs.rmSync(subPath, { recursive: true, force: true });
-            }
-        }
-        // Verify preserved dirs still exist after cleanup
-        for (const kept of PRESERVE_DIRS) {
-            const keptPath = path.join(agentDest, kept);
-            if (kept.includes('.') ? false : !fs.existsSync(keptPath)) {
-                // It's okay if it doesn't exist yet — it'll be created below
-            }
-        }
-    }
-
     // Ensure history dirs exist (Case Law + Skill Evolution)
     if (!dryRun) {
         const caseDir = path.join(agentDest, 'history', 'case-law', 'cases');
@@ -671,7 +681,6 @@ function cmdLearn(flags) {
 
     const dryRun  = flags.dryRun ? '--dry-run' : '';
     const useHead = flags.head   ? '--head'    : '';
-    const python  = process.platform === 'win32' ? 'python' : 'python3';
     const { execSync } = require('child_process');
 
     // Phase 1: Skill Evolution
@@ -780,7 +789,6 @@ function cmdCase(flags) {
         process.exit(1);
     }
 
-    const python  = process.platform === 'win32' ? 'python' : 'python3';
     const caseLawScript = path.join(agentDest, 'scripts', 'case_law_manager.js');
 
     // Make shorthand aliases