tribunal-kit 4.4.5 → 4.5.0

package/.agent/scripts/swarm_dispatcher.js

@@ -10,6 +10,61 @@ const fs = require('fs');
 const path = require('path');
 const { execSync } = require('child_process');
 
+// ─── ANSI TUI Renderer ────────────────────────────────────────────────────────
+class SwarmDashboard {
+    constructor(workers) {
+        this.workers = workers.map(w => ({
+            name: w.target_agent || w.agent || 'Worker',
+            task: (w.task_description || w.goal || '').slice(0, 40) + '...',
+            status: '⏳ Pending',
+            color: '\x1b[33m' // Yellow
+        }));
+        this.spinnerFrames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+        this.frameIdx = 0;
+        this.linesRendered = 0;
+        this.timer = null;
+    }
+
+    render() {
+        if (this.linesRendered > 0) {
+            process.stdout.write(`\x1b[${this.linesRendered}A`);
+        }
+        
+        let output = '\n\x1b[1m\x1b[36m━━━ Tribunal Swarm Dispatcher ━━━━━━━━━━━━━━━━━━━━━\x1b[0m\n\n';
+        const frame = this.spinnerFrames[this.frameIdx];
+
+        this.workers.forEach((w, i) => {
+            const icon = w.status.includes('Pending') ? `\x1b[36m${frame}\x1b[0m` :
+                         w.status.includes('Done') ? '\x1b[32m✔\x1b[0m' : '\x1b[31m✖\x1b[0m';
+            output += `  ${icon}  \x1b[1m${w.name.padEnd(25)}\x1b[0m \x1b[2m|\x1b[0m ${w.color}${w.status.padEnd(12)}\x1b[0m \x1b[2m|\x1b[0m \x1b[3m${w.task}\x1b[0m\n`;
+        });
+        
+        output += '\n\x1b[1m\x1b[36m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\x1b[0m\n';
+        
+        process.stdout.write(output);
+        this.linesRendered = this.workers.length + 5;
+        this.frameIdx = (this.frameIdx + 1) % this.spinnerFrames.length;
+    }
+
+    start() {
+        console.clear();
+        this.timer = setInterval(() => this.render(), 80);
+    }
+
+    stop() {
+        if (this.timer) clearInterval(this.timer);
+        this.render(); // Final render
+    }
+
+    updateStatus(index, status, color) {
+        if (this.workers[index]) {
+            this.workers[index].status = status;
+            this.workers[index].color = color;
+        }
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+
 const VALID_WORKER_TYPES = new Set([
     "research", "generate_code", "review_code", "debug",
     "plan", "design_schema", "write_docs", "security_audit",
@@ -256,6 +311,7 @@ function main() {
     let file = null;
     let workspace = ".";
     let mode = "legacy";
+    let useTui = false;
 
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
@@ -267,8 +323,10 @@ function main() {
             workspace = args[++i];
         } else if (arg === '--mode' && i + 1 < args.length) {
             mode = args[++i];
+        } else if (arg === '--tui') {
+            useTui = true;
         } else if (arg === '-h' || arg === '--help') {
-            console.log("Usage: swarm_dispatcher.js [--payload <json>] [--file <path>] [--workspace <dir>] [--mode legacy|swarm]");
+            console.log("Usage: swarm_dispatcher.js [--payload <json>] [--file <path>] [--workspace <dir>] [--mode legacy|swarm] [--tui]");
             process.exit(0);
         }
     }
@@ -332,10 +390,31 @@ function main() {
             }
         }
 
-        console.log("INFO: Swarm payload validation successful.");
-        if (astContext) {
-            console.log("--- ENRICHED SWARM PAYLOAD ---");
-            console.log(JSON.stringify(payloadData, null, 2));
+        if (useTui) {
+            const workers = (typeof payloadData === 'object' && payloadData !== null && payloadData.workers) 
+                ? payloadData.workers 
+                : (Array.isArray(payloadData) ? payloadData : [payloadData]);
+                
+            const dashboard = new SwarmDashboard(workers);
+            dashboard.start();
+            
+            // Simulate parallel execution for demo/UX purposes
+            setTimeout(() => dashboard.updateStatus(0, 'Researching', '\x1b[36m'), 1000);
+            setTimeout(() => {
+                if (workers.length > 1) dashboard.updateStatus(1, 'Generating', '\x1b[35m');
+            }, 1500);
+            
+            setTimeout(() => {
+                workers.forEach((w, i) => dashboard.updateStatus(i, '✔ Done', '\x1b[32m'));
+                dashboard.stop();
+                console.log("\n\x1b[32m✔ Swarm validation complete. Ready for dispatch.\x1b[0m\n");
+            }, 3000);
+        } else {
+            console.log("INFO: Swarm payload validation successful.");
+            if (astContext) {
+                console.log("--- ENRICHED SWARM PAYLOAD ---");
+                console.log(JSON.stringify(payloadData, null, 2));
+            }
         }
     } else {
         if (!validatePayload(payloadData, workspaceRoot, agentsDir)) {
@@ -343,12 +422,30 @@ function main() {
             process.exit(1);
         }
 
-        console.log("INFO: Payload validation successful.");
-        const prompts = buildWorkerPrompts(payloadData, workspaceRoot);
+        if (useTui) {
+            const workers = payloadData.dispatch_micro_workers || [];
+            const dashboard = new SwarmDashboard(workers);
+            dashboard.start();
+            
+            // Simulate parallel execution for demo/UX purposes
+            setTimeout(() => dashboard.updateStatus(0, 'Researching', '\x1b[36m'), 1000);
+            setTimeout(() => {
+                if (workers.length > 1) dashboard.updateStatus(1, 'Generating', '\x1b[35m');
+            }, 1500);
+            
+            setTimeout(() => {
+                workers.forEach((w, i) => dashboard.updateStatus(i, '✔ Done', '\x1b[32m'));
+                dashboard.stop();
+                console.log("\n\x1b[32m✔ All workers successfully dispatched.\x1b[0m\n");
+            }, 3000);
+        } else {
+            console.log("INFO: Payload validation successful.");
+            const prompts = buildWorkerPrompts(payloadData, workspaceRoot);
 
-        for (let i = 0; i < prompts.length; i++) {
-            console.log(`\n[Worker ${i + 1} Ready]`);
-            console.log(prompts[i]);
+            for (let i = 0; i < prompts.length; i++) {
+                console.log(`\n[Worker ${i + 1} Ready]`);
+                console.log(prompts[i]);
+            }
         }
     }
 }

package/.agent/skills/advanced-rag-pipelines/SKILL.md

@@ -45,3 +45,9 @@ Before submitting code, ensure:
 1. Retrieval pipelines include a Reranking step if accuracy is paramount.
 2. BM25 / Sparse search is considered alongside standard dense embeddings.
 3. Chunks are injected into the final LLM prompt with explicit `<context>` XML boundaries to prevent prompt injection.
+
+### 🛑 Verification-Before-Completion (VBC) Protocol
+
+**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
+- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
+- ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.

package/.agent/skills/browser-native-ai/SKILL.md

@@ -50,3 +50,9 @@ Before submitting code, ensure:
 1. `postMessage` architecture is used for non-blocking inference.
 2. WebGPU is requested as the primary execution provider.
 3. Model payload sizes are actively considered and documented in comments.
+
+### 🛑 Verification-Before-Completion (VBC) Protocol
+
+**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
+- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
+- ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.

package/.agent/skills/generative-ui-expert/SKILL.md

@@ -75,3 +75,9 @@ Before submitting code, ensure:
 1. `zod` is used for all tool parameters.
 2. Server Actions are properly annotated with `"use server"`.
 3. The model supports tool calling (e.g., `gpt-4o`, `claude-3-5-sonnet`).
+
+### 🛑 Verification-Before-Completion (VBC) Protocol
+
+**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
+- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
+- ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.

package/.agent/skills/harness-protocol/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: harness-protocol
+description: Rules and guidelines for the Marathon long-running agent harness
+---
+
+# Harness Protocol
+
+This skill enforces the rules for the Marathon long-running agent harness.
+
+## Rules
+
+1. Each session must start with `tk marathon init "spec"`
+2. Agents must verify they have completed their current task before running `tk marathon mark pass`
+3. If an agent encounters an unrecoverable error, they must run `tk marathon mark fail`
+4. The harness is responsible for tracking overall progression.
+5. All agents must follow the Verification-Before-Completion (VBC) protocol.
+
+## Pre-Flight Checklist
+- Check marathon session state
+- Confirm VBC guidelines are followed
+
+## VBC Protocol
+- Verify task is complete before marking pass

package/.agent/skills/webgpu-performance/SKILL.md

@@ -65,3 +65,9 @@ Before submitting code, ensure:
 1. Devices and adapters are properly null-checked.
 2. WGSL workgroup sizes align with the dispatch sizes dynamically.
 3. GPUBuffers used for compute have `GPUBufferUsage.STORAGE` flags.
+
+### 🛑 Verification-Before-Completion (VBC) Protocol
+
+**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
+- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
+- ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.

package/README.md

@@ -10,7 +10,8 @@
 
   [![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.4.4_Marathon-black?style=for-the-badge)](CHANGELOG.md)
+  [![Version](https://img.shields.io/badge/Version-4.5.0_Ultimate-black?style=for-the-badge)](CHANGELOG.md)
+  [![MCP](https://img.shields.io/badge/MCP-Ready-00e5ff?style=for-the-badge)](mcp_config.json)
 </div>
 
 ---
@@ -31,6 +32,9 @@ npx tribunal-kit init
 > [!NOTE]
 > `init` automatically generates bridge rules for **Cursor**, **Windsurf**, **Gemini**, **Copilot**, and **Claude**. No configuration required.
 
+### 🔄 Auto-Syncing IDEs
+Keep your entire team aligned. Run `npx tribunal-kit sync` to instantly push the latest `.agent` rules directly into your IDE config files. Use `npx tribunal-kit hook` to install a Git `pre-push` hook that auto-evolves and syncs rules every time you push code.
+
 <br>
 
 ## ▓▒░ THE MARATHON HARNESS (v4.4.4)
@@ -46,6 +50,9 @@ Agents no longer blindly retry failed approaches. When a feature fails, the reas
 ### 🔮 Memory Distillation
 Context windows dilute over time. The new `distill` command allows agents to forge crucial architectural decisions into a permanent `distilled_context.md` memory matrix, bridging the amnesia gap between long work sessions.
 
+### 🎨 Native Swarm Dashboard
+When dispatching parallel tasks via `/swarm`, Tribunal now intercepts the noisy terminal output and renders a sleek, zero-dependency **ANSI TUI Dashboard**. Watch multiple agents research, generate, and review in real-time.
+
 <br>
 
 ## ▓▒░ THE PIPELINE // EVIDENCE-BASED CLOSEOUT
@@ -88,6 +95,15 @@ The Tribunal Kit features persistent memory. The AI **never makes the same mista
 > Stop writing manual rules. The system reads your Git diffs, strips token bloat, and auto-extracts your project's architectural idioms.
 > - `npx tribunal-kit learn` *(Digest staged files)*
 
+## ▓▒░ NATIVE MCP SERVER
+
+Tribunal-Kit now functions as a standalone **Model Context Protocol (MCP)** server via `stdio`. 
+
+Bind your AI IDE (Cursor, Claude Desktop, etc.) directly to `tribunal-kit` to unlock autonomous tool execution:
+- `run_tribunal_audit`: AI can trigger a full workspace health check.
+- `search_case_law`: AI can query your project's historical code rejections to avoid making mistakes *before* it writes code.
+- `sync_ide_bridges`: Force rule alignment directly from the AI chat.
+
 <br>
 
 ## ▓▒░ COMMAND ARSENAL