tribunal-kit 5.8.0 → 5.8.1

package/.agent/history/memory/MEMORY.md

@@ -1,6 +1,6 @@
 # 🧠 Tribunal Memory Index
 > Auto-generated by `tribunal-kit memory export`. Do not edit manually.
-> Entries: 50 | Semantic: 40 | Procedural: 10 | Episodic: 0 | Working: 0
+> Entries: 111 | Semantic: 89 | Procedural: 22 | Episodic: 0 | Working: 0
 
 ## SEMANTIC (Permanent Facts)
 | ID | Content | Tags | Source | Created |
@@ -45,6 +45,55 @@
 | 46 | [ ] Have I checked the environment for relevant existing implementations? | project-idiom, auto-learned | manual | 1783152364Z |
 | 47 | ❌ **Forbidden:** Declaring a task complete because the output "looks correct." | project-idiom, auto-learned | manual | 1783152364Z |
 | 48 | ✅ **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. | project-idiom, auto-learned | manual | 1783152364Z |
+| 51 | ❌ Overriding project idioms without explicit justification -> ✅ Idioms represent team decisions; flag deviations with reasoning | project-idiom, auto-learned | manual | 1783438387Z |
+| 52 | ❌ Applying idioms from one project to a different project -> ✅ Idioms are project-specific; verify they apply to the current codebase | project-idiom, auto-learned | manual | 1783438387Z |
+| 53 | ❌ **Forbidden:** Declaring a task complete because the output "looks correct." | project-idiom, auto-learned | manual | 1783438387Z |
+| 54 | ✅ **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. | project-idiom, auto-learned | manual | 1783438387Z |
+| 55 | [ ] Have I reviewed the user's specific constraints and requests? | project-idiom, auto-learned | manual | 1783438387Z |
+| 56 | [ ] Have I checked the environment for relevant existing implementations? | project-idiom, auto-learned | manual | 1783438387Z |
+| 57 | ❌ **Forbidden:** Declaring a task complete because the output "looks correct." | project-idiom, auto-learned | manual | 1783438387Z |
+| 58 | ✅ **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. | project-idiom, auto-learned | manual | 1783438387Z |
+| 61 | ❌ Overriding project idioms without explicit justification -> ✅ Idioms represent team decisions; flag deviations with reasoning | project-idiom, auto-learned | manual | 1783438449Z |
+| 62 | ❌ Applying idioms from one project to a different project -> ✅ Idioms are project-specific; verify they apply to the current codebase | project-idiom, auto-learned | manual | 1783438449Z |
+| 63 | ❌ **Forbidden:** Declaring a task complete because the output "looks correct." | project-idiom, auto-learned | manual | 1783438449Z |
+| 64 | ✅ **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. | project-idiom, auto-learned | manual | 1783438449Z |
+| 65 | [ ] Have I reviewed the user's specific constraints and requests? | project-idiom, auto-learned | manual | 1783438449Z |
+| 66 | [ ] Have I checked the environment for relevant existing implementations? | project-idiom, auto-learned | manual | 1783438449Z |
+| 67 | ❌ **Forbidden:** Declaring a task complete because the output "looks correct." | project-idiom, auto-learned | manual | 1783438449Z |
+| 68 | ✅ **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. | project-idiom, auto-learned | manual | 1783438449Z |
+| 71 | ❌ Overriding project idioms without explicit justification -> ✅ Idioms represent team decisions; flag deviations with reasoning | project-idiom, auto-learned | manual | 1783438727Z |
+| 72 | ❌ Applying idioms from one project to a different project -> ✅ Idioms are project-specific; verify they apply to the current codebase | project-idiom, auto-learned | manual | 1783438727Z |
+| 73 | ❌ **Forbidden:** Declaring a task complete because the output "looks correct." | project-idiom, auto-learned | manual | 1783438727Z |
+| 74 | ✅ **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. | project-idiom, auto-learned | manual | 1783438727Z |
+| 75 | [ ] Have I reviewed the user's specific constraints and requests? | project-idiom, auto-learned | manual | 1783438727Z |
+| 76 | [ ] Have I checked the environment for relevant existing implementations? | project-idiom, auto-learned | manual | 1783438727Z |
+| 77 | ❌ **Forbidden:** Declaring a task complete because the output "looks correct." | project-idiom, auto-learned | manual | 1783438727Z |
+| 78 | ✅ **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. | project-idiom, auto-learned | manual | 1783438727Z |
+| 81 | ❌ Overriding project idioms without explicit justification -> ✅ Idioms represent team decisions; flag deviations with reasoning | project-idiom, auto-learned | manual | 1783782112Z |
+| 82 | ❌ Applying idioms from one project to a different project -> ✅ Idioms are project-specific; verify they apply to the current codebase | project-idiom, auto-learned | manual | 1783782112Z |
+| 83 | ❌ **Forbidden:** Declaring a task complete because the output "looks correct." | project-idiom, auto-learned | manual | 1783782112Z |
+| 84 | ✅ **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. | project-idiom, auto-learned | manual | 1783782112Z |
+| 85 | [ ] Have I reviewed the user's specific constraints and requests? | project-idiom, auto-learned | manual | 1783782112Z |
+| 86 | [ ] Have I checked the environment for relevant existing implementations? | project-idiom, auto-learned | manual | 1783782112Z |
+| 87 | ❌ **Forbidden:** Declaring a task complete because the output "looks correct." | project-idiom, auto-learned | manual | 1783782112Z |
+| 88 | ✅ **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. | project-idiom, auto-learned | manual | 1783782112Z |
+| 91 | ❌ Overriding project idioms without explicit justification -> ✅ Idioms represent team decisions; flag deviations with reasoning | project-idiom, auto-learned | manual | 1783782132Z |
+| 92 | ❌ Applying idioms from one project to a different project -> ✅ Idioms are project-specific; verify they apply to the current codebase | project-idiom, auto-learned | manual | 1783782132Z |
+| 93 | ❌ **Forbidden:** Declaring a task complete because the output "looks correct." | project-idiom, auto-learned | manual | 1783782132Z |
+| 94 | ✅ **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. | project-idiom, auto-learned | manual | 1783782132Z |
+| 95 | [ ] Have I reviewed the user's specific constraints and requests? | project-idiom, auto-learned | manual | 1783782132Z |
+| 96 | [ ] Have I checked the environment for relevant existing implementations? | project-idiom, auto-learned | manual | 1783782132Z |
+| 97 | ❌ **Forbidden:** Declaring a task complete because the output "looks correct." | project-idiom, auto-learned | manual | 1783782132Z |
+| 98 | ✅ **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. | project-idiom, auto-learned | manual | 1783782132Z |
+| 101 | Database is PostgreSQL | db, postgres | manual | 1783783700Z |
+| 102 | ❌ Overriding project idioms without explicit justification -> ✅ Idioms represent team decisions; flag deviations with reasoning | project-idiom, auto-learned | manual | 1783785670Z |
+| 103 | ❌ Applying idioms from one project to a different project -> ✅ Idioms are project-specific; verify they apply to the current codebase | project-idiom, auto-learned | manual | 1783785670Z |
+| 104 | ❌ **Forbidden:** Declaring a task complete because the output "looks correct." | project-idiom, auto-learned | manual | 1783785670Z |
+| 105 | ✅ **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. | project-idiom, auto-learned | manual | 1783785670Z |
+| 106 | [ ] Have I reviewed the user's specific constraints and requests? | project-idiom, auto-learned | manual | 1783785670Z |
+| 107 | [ ] Have I checked the environment for relevant existing implementations? | project-idiom, auto-learned | manual | 1783785670Z |
+| 108 | ❌ **Forbidden:** Declaring a task complete because the output "looks correct." | project-idiom, auto-learned | manual | 1783785670Z |
+| 109 | ✅ **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. | project-idiom, auto-learned | manual | 1783785670Z |
 
 ## PROCEDURAL (How-To Recipes)
 | ID | Content | Tags | Source | Created |
@@ -59,4 +108,16 @@
 | 40 | Run `npm run validate-payload && jest --coverage` to test the project | build-script, test, auto-learned | manual | 1783148917Z |
 | 49 | Run `echo 'No build step required for this project'` to build the project | build-script, build, auto-learned | manual | 1783152364Z |
 | 50 | Run `npm run validate-payload && jest --coverage` to test the project | build-script, test, auto-learned | manual | 1783152364Z |
+| 59 | Run `echo 'No build step required for this project'` to build the project | build-script, build, auto-learned | manual | 1783438387Z |
+| 60 | Run `npm run validate-payload && jest --coverage` to test the project | build-script, test, auto-learned | manual | 1783438387Z |
+| 69 | Run `echo 'No build step required for this project'` to build the project | build-script, build, auto-learned | manual | 1783438449Z |
+| 70 | Run `npm run validate-payload && jest --coverage` to test the project | build-script, test, auto-learned | manual | 1783438449Z |
+| 79 | Run `echo 'No build step required for this project'` to build the project | build-script, build, auto-learned | manual | 1783438727Z |
+| 80 | Run `npm run validate-payload && jest --coverage` to test the project | build-script, test, auto-learned | manual | 1783438727Z |
+| 89 | Run `echo 'No build step required for this project'` to build the project | build-script, build, auto-learned | manual | 1783782112Z |
+| 90 | Run `npm run validate-payload && jest --coverage` to test the project | build-script, test, auto-learned | manual | 1783782112Z |
+| 99 | Run `echo 'No build step required for this project'` to build the project | build-script, build, auto-learned | manual | 1783782132Z |
+| 100 | Run `npm run validate-payload && jest --coverage` to test the project | build-script, test, auto-learned | manual | 1783782132Z |
+| 110 | Run `echo 'No build step required for this project'` to build the project | build-script, build, auto-learned | manual | 1783785670Z |
+| 111 | Run `npm run validate-payload && jest --coverage` to test the project | build-script, test, auto-learned | manual | 1783785670Z |
 

package/.agent/rules/GEMINI.md

@@ -22,6 +22,13 @@ Has this information possibly changed since my training?
   → Yes → Search before answering. Never serve stale facts.
 Am I importing a package/method that exists?
   → Verify against package.json / requirements.txt / official docs.
+
+Epistemic Confidence Levels (L1-L5):
+  - L1: Absolute Certainty (Verified against active codebase or official docs)
+  - L2: High Confidence (Standard library or stable unchanged APIs)
+  - L3: Moderate Confidence (Likely but unverified custom utils; requires // VERIFY)
+  - L4: Low Confidence (Speculative unstable features; requires immediate search)
+  - L5: Pure Speculation (Guessed; strictly forbidden from code generation)
 ```
 
 ### 0b. Response Format Decision
@@ -210,12 +217,12 @@ The Human Gate is never skipped. No code is written to a file without explicit u
 
 | Code type             | Reviewers                                                                                           |
 | --------------------- | --------------------------------------------------------------------------------------------------- |
-| Backend/API           | logic + security + dependency + type-safety + resilience + schema                                   |
-| Frontend/React        | logic + security + frontend + type-safety + ui-ux-auditor + review-animations                       |
-| Database/SQL          | logic + security + sql + schema                                                                     |
-| Mobile/Cross-platform | logic + security + mobile-reviewer + type-safety                                                    |
+| Backend/API           | logic + security + dependency + type-safety + resilience + schema + complexity-reviewer             |
+| Frontend/React        | logic + security + frontend + type-safety + ui-ux-auditor + review-animations + complexity-reviewer |
+| Database/SQL          | logic + security + sql + schema + complexity-reviewer                                               |
+| Mobile/Cross-platform | logic + security + mobile-reviewer + type-safety + complexity-reviewer                              |
 | Any domain            | + performance (if optimization)                                                                     |
-| Before merge          | /tribunal-full (all 19)                                                                             |
+| Before merge          | /tribunal-full (all 20)                                                                             |
 
 ---
 
@@ -399,6 +406,24 @@ Before modifying any file:
 
 ---
 
+## Fabel-5 Cognitive Boundaries (Wellbeing, Evenhandedness, Memory)
+
+### User Wellbeing & Safety
+* **No Psychoanalysis / Diagnosis**: Reflect what is said without diagnosing or assigning psychological narratives (e.g. "you restrict because of trauma"). Suggest professional help without clinical labels.
+* **Self-Harm Interruptions**: Never suggest physical substitutes (holding ice, snapping rubber bands, drawing lines) or mimic self-harm. They reinforce the self-harm loop.
+* **No Over-reliance**: Do not thank the user for reaching out, encourage them to stay, or reiterate willingness to continue. Avoid conversational dependencies.
+* **Positive Paths**: Acknowledge distress without reflective listening that amplifies negative spirals. Keep paths to external help open.
+
+### Moral & Political Evenhandedness
+* **Nuance Over Brevity**: Reject requests for simple yes/no or one-word answers on contested political, ethical, or policy issues. Give a fair, balanced overview of existing positions.
+* **Opposing Perspectives**: Conclude arguments for positions by presenting opposing viewpoints or empirical disputes even if the user/AI agrees with the primary view.
+
+### Memory & Preference Boundaries
+* **Invisible Integration**: Integrate remembered user context silently without attribution or observation verbs ("I notice in your profile...", "Based on your memory...").
+* **Expertise Tuning**: Match language and technical depth to the user's stated background without lecturing.
+
+---
+
 ## Quick Reference
 
 **Scripts:** `.agent/scripts/`

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

@@ -32,6 +32,15 @@ CONFIDENCE CHECK:
     → Standard library (Node, Python, Rust) → Low risk. Proceed with confidence.
 ```
 
+### Epistemic Confidence Levels (L1-L5)
+
+Rate the certainty of your implementation decisions using this hierarchy:
+- **L1: Absolute Certainty (Verified Truth)**: Code is fully checked against active files in the workspace or verified in up-to-date documentation.
+- **L2: High Confidence (Standard API)**: Using standard library or stable, unchanged language features (e.g. standard Node `fs` methods, basic Python functions).
+- **L3: Moderate Confidence (Likely but Unverified)**: Custom utilities or package features that are likely correct but not actively verified. Must add `// VERIFY: [reason]` tags.
+- **L4: Low Confidence (Speculative)**: Unstable APIs, recently modified dependencies, or legacy components. Search or audit first.
+- **L5: Pure Speculation (Guessed / Blind)**: Complete guesswork. Strictly prohibited from code generation. Must stop and research or ask.
+
 ### Uncertainty Markers
 
 When uncertain, never silently guess. Use explicit markers:
@@ -193,7 +202,25 @@ ALWAYS:
 
 ---
 
-## 6. Anti-Hallucination Quick Reference
+## 6. Fabel-5 Cognitive Boundaries (Wellbeing, Evenhandedness, Memory)
+
+### User Wellbeing & Safety
+* **No Psychoanalysis / Diagnosis**: Reflect what is said without diagnosing or assigning psychological narratives (e.g. "you restrict because of trauma"). Suggest professional help without clinical labels.
+* **Self-Harm Interruptions**: Never suggest physical substitutes (holding ice, snapping rubber bands, drawing lines) or mimic self-harm. They reinforce the self-harm loop.
+* **No Over-reliance**: Do not thank the user for reaching out, encourage them to stay, or reiterate willingness to continue. Avoid conversational dependencies.
+* **Positive Paths**: Acknowledge distress without reflective listening that amplifies negative spirals. Keep paths to external help open.
+
+### Moral & Political Evenhandedness
+* **Nuance Over Brevity**: Reject requests for simple yes/no or one-word answers on contested political, ethical, or policy issues. Give a fair, balanced overview of existing positions.
+* **Opposing Perspectives**: Conclude arguments for positions by presenting opposing viewpoints or empirical disputes even if the user/AI agrees with the primary view.
+
+### Memory & Preference Boundaries
+* **Invisible Integration**: Integrate remembered user context silently without attribution or observation verbs ("I notice in your profile...", "Based on your memory...").
+* **Expertise Tuning**: Match language and technical depth to the user's stated background without lecturing.
+
+---
+
+## 7. Anti-Hallucination Quick Reference
 
 High-risk hallucination zones (verify before using):
 
@@ -211,6 +238,15 @@ When in doubt: **search the official docs**. Never trust training data for API s
 
 ---
 
+## ⚡ Hallucination Heatmap (High-Risk Zones)
+
+- **Next.js 15+ Route Handlers**: Dynamic functions (`headers()`, `cookies()`, `params`) are now async and must be awaited. Unawaited calls throw runtime errors.
+- **React 19 Hooks**: `useFormState` was renamed to `useActionState`. Direct context creation using `React.createServerContext()` was removed.
+- **Drizzle ORM Queries**: `db.select().from().filter()` does not exist; Drizzle uses `.where()` for filtering.
+- **OpenAI / Anthropic SDKs**: Model strings (e.g., trying to use `gpt-5` or `claude-4-opus` which do not exist or are incorrect).
+
+---
+
 ## LLM Traps — Self-Audit
 
 ```

package/.agent/workflows/generate.md

@@ -109,6 +109,7 @@ When unsure: write `// VERIFY: [specific reason]` instead of hallucinating.
 precedence-reviewer→ Enforces repository Case Law and past rejections (Runs First)
 logic-reviewer     → Hallucinated methods, undefined refs, impossible logic
 security-auditor   → OWASP vulnerabilities, hardcoded secrets, injection
+complexity-reviewer→ Enforces the Dependency Ladder to prevent over-engineering
 ```
 
 **Auto-activated by keywords:**

package/.agent/workflows/tribunal-full.md

@@ -1,9 +1,9 @@
 ---
-description: Run ALL 19 Tribunal reviewer agents simultaneously. Maximum hallucination coverage. Use before merging any AI-generated code, before production deployments, or when maximum confidence is required.
+description: Run ALL 20 Tribunal reviewer agents simultaneously. Maximum hallucination coverage. Use before merging any AI-generated code, before production deployments, or when maximum confidence is required.
 required-skills: all domain skills auto-loaded
 ---
 
-# /tribunal-full — Complete 19-Reviewer Audit
+# /tribunal-full — Complete 20-Reviewer Audit
 
 $ARGUMENTS
 
@@ -32,7 +32,7 @@ Read BEFORE full review:
 
 ---
 
-## 19 Reviewers — All Active Simultaneously
+## 20 Reviewers — All Active Simultaneously
 
 ```
 Tier 1: Always active (universal concerns)
@@ -44,6 +44,7 @@ Tier 1: Always active (universal concerns)
 Tier 2: Code quality
 ├── dependency-reviewer    → Fabricated packages, supply chain, version compatibility
 ├── type-safety-reviewer   → 'any' epidemic, Zod parse vs cast, unguarded access
+├── complexity-reviewer    → Enforces the Dependency Ladder to prevent over-engineering
 ├── schema-reviewer        → Missing input validation, loose schemas, raw req.body
 └── sql-reviewer           → Injection, N+1, missing indexes, unscoped mutations
 

package/README.md

@@ -12,7 +12,7 @@
 
 [![NPM](https://img.shields.io/npm/v/tribunal-kit?style=for-the-badge&logo=npm&logoColor=white&color=ff1637)](https://www.npmjs.com/package/tribunal-kit)
 [![License](https://img.shields.io/badge/License-MIT-1a1a1a?style=for-the-badge)](LICENSE)
-[![Version](https://img.shields.io/badge/Version-5.8.0-1a1a1a?style=for-the-badge)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/Version-5.8.1-1a1a1a?style=for-the-badge)](CHANGELOG.md)
 [![MCP](https://img.shields.io/badge/MCP-Ready-ccff00?style=for-the-badge&logo=openai&logoColor=1a1a1a)](mcp_config.json)
 [![Code Quality](https://img.shields.io/badge/Hallucination_Mitigation-ff1637?style=for-the-badge)](AGENT_FLOW.md)
 [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/Y6C122DUQJ)
@@ -23,13 +23,30 @@
 
 > [!IMPORTANT]
 > **AI GENERATES CODE. TRIBUNAL ENSURES IT WORKS.**  
-> A zero-bloat `.agent/` intelligence payload that upgrades your IDE with **43 specialist agents**, **34 workflows**, and a **19-reviewer Tribunal pipeline**. Maximizes execution reliability and heavily mitigates hallucinations.
+> A zero-bloat `.agent/` intelligence payload and **Model Context Protocol (MCP) server** that upgrades your IDE (**Cursor**, **VSCode**, **Windsurf**) and terminal AI coding assistants (**Claude Code**, **Aider**) with **43 specialist agents**, **34 workflows**, and a parallel **20-reviewer Tribunal pipeline**. Maximizes execution reliability, optimizes context windows, and heavily mitigates AI code hallucinations.
 
 <br>
 <hr style="border: 1px solid #222; margin: 40px 0;">
 <br>
 
-## 🚀 QUICK START
+## 📋 Table of Contents
+
+- [🚀 Quick Start — Setting Up your AI Agent Code Review Engine](#-quick-start--setting-up-your-ai-agent-code-review-engine)
+- [⚡ State-of-the-Art Performance (Tokio Rust Core)](#-state-of-the-art-performance-tokio-rust-core)
+- [⚔️ The Command Arsenal — Swarms & Agentic Workflows](#️-the-command-arsenal--swarms--agentic-workflows)
+- [💻 CLI Command Reference](#-cli-command-reference)
+- [⚖️ The Tribunal Pipeline — Mitigating AI Code Hallucinations](#️-the-tribunal-pipeline--mitigating-ai-code-hallucinations)
+- [🏛️ The Supreme Court Case Law Engine — Persistent Memory for AI Coding](#️-the-supreme-court-case-law-engine--persistent-memory-for-ai-coding)
+- [🏃 The Marathon Harness — Long-Running Autonomous AI Agents](#-the-marathon-harness--long-running-autonomous-ai-agents)
+- [🧠 Advanced Capabilities & System Prompt Rules (v5.8)](#-advanced-capabilities--system-prompt-rules-v58)
+- [🔌 Model Context Protocol (MCP) Server for Cursor, VSCode & Windsurf](#-model-context-protocol-mcp-server-for-cursor-vscode--windsurf)
+- [❓ Frequently Asked Questions (FAQ)](#-frequently-asked-questions-faq)
+
+<br>
+<hr style="border: 1px solid #222; margin: 40px 0;">
+<br>
+
+## 🚀 Quick Start — Setting Up your AI Agent Code Review Engine
 
 Drop Tribunal into any existing project to instantly weaponize your IDE.
 
@@ -53,7 +70,7 @@ Tribunal Kit breaks out of the IDE with first-class support for terminal-based A
 <hr style="border: 1px solid #222; margin: 40px 0;">
 <br>
 
-## ⚡ STATE-OF-THE-ART PERFORMANCE (v5.0)
+## ⚡ State-of-the-Art Performance (Tokio Rust Core)
 
 Tribunal-Kit v5 is rebuilt from the ground up to be blazingly fast. We've eliminated initialization latency and blocking I/O:
 
@@ -67,7 +84,7 @@ Tribunal-Kit v5 is rebuilt from the ground up to be blazingly fast. We've elimin
 <hr style="border: 1px solid #222; margin: 40px 0;">
 <br>
 
-## ⚔️ THE COMMAND ARSENAL
+## ⚔️ The Command Arsenal — Swarms & Agentic Workflows
 
 | Workflow Command          | Operational Scope                                                        |
 | :------------------------ | :----------------------------------------------------------------------- |
@@ -75,7 +92,7 @@ Tribunal-Kit v5 is rebuilt from the ground up to be blazingly fast. We've elimin
 | <kbd>/create</kbd>        | Scaffold major applications via App Builder routing.                     |
 | <kbd>/enhance</kbd>       | Safely extend existing codebases with zero regression.                   |
 | <kbd>/swarm</kbd>         | Fan-out orchestrator. Dispatch isolated workers, synthesize output.      |
-| <kbd>/tribunal-full</kbd> | Unleash **ALL 19** domain reviewers simultaneously for maximum scrutiny. |
+| <kbd>/tribunal-full</kbd> | Unleash **ALL 20** domain reviewers simultaneously for maximum scrutiny. |
 | <kbd>/debug</kbd>         | Systematic 4-phase root-cause investigation. No guessing.                |
 | <kbd>/ui-ux-pro-max</kbd> | Advanced visual aesthetic engine. No generic AI slop.                    |
 
@@ -83,7 +100,98 @@ Tribunal-Kit v5 is rebuilt from the ground up to be blazingly fast. We've elimin
 <hr style="border: 1px solid #222; margin: 40px 0;">
 <br>
 
-## ⚖️ THE PIPELINE // EVIDENCE-BASED CLOSEOUT
+## 💻 CLI Command Reference
+
+You can run Tribunal commands using `npx tribunal-kit <command>` (or the short alias `tk <command>` if installed globally/locally).
+
+### Core Commands
+*   **`init`**: Initialize the `.agent/` configuration payload in the current directory.
+    ```bash
+    npx tribunal-kit init [--force] [--path <dir>] [--minimal] [--dry-run]
+    ```
+*   **`status`**: Check the status and integrity of the `.agent/` directory.
+    ```bash
+    npx tribunal-kit status
+    ```
+*   **`update`**: Re-install or refresh to pull the latest agent configurations into the project.
+    ```bash
+    npx tribunal-kit update
+    ```
+*   **`sync`**: Instantly synchronize the latest `.agent` rules directly with local IDE config files (Cursor, Windsurf, Copilot, VSCode, Gemini).
+    ```bash
+    npx tribunal-kit sync
+    ```
+*   **`hook`**: Install or configure Git `pre-push` hooks to auto-sync rules on push.
+    ```bash
+    npx tribunal-kit hook
+    ```
+*   **`compile`**: Compile static context rules into a `.tribunal-compiled.md` file for terminal agents.
+    ```bash
+    npx tribunal-kit compile
+    ```
+*   **`uninstall`**: Cleanly remove `.agent/` from the target project.
+    ```bash
+    npx tribunal-kit uninstall [--path <dir>]
+    ```
+
+### Case Law Engine (`case`)
+Manage the Supreme Court Case Law database to prevent AI hallucinations.
+*   **`case add`**: Interactively record a new AI mistake/precedent.
+*   **`case list`**: List all recorded precedence entries.
+*   **`case search "<query>"`**: Search historical cases.
+*   **`case show --id <id>`**: Show details of a specific case.
+*   **`case stats`**: Display statistics on case counts and types.
+*   **`case export`**: Export database to a readable `.agent/history/case-law/CASE_LAW.md`.
+*   **`case overrule --id <id>`**: Remove/overrule a case entry.
+
+### Memory Engine (`memory`)
+Manage the 4-Type Taxonomy Persistent Memory Engine.
+*   **`memory store`**: Store a tagged memory (`semantic`, `procedural`, `episodic`, or `working`).
+    ```bash
+    npx tribunal-kit memory store --type semantic --content "Uses PostgreSQL" --tags "db"
+    ```
+*   **`memory recall`**: Recall budget-gated memories.
+    ```bash
+    npx tribunal-kit memory recall --query "postgres" --budget 1000
+    ```
+*   **`memory gc`**: Garbage collect expired episodic and all working memories.
+*   **`memory stats`**: Show memory index statistics.
+*   **`memory export`**: Export the human-readable `MEMORY.md` index projection.
+
+### Codebase Graphs & Context
+*   **`graph`**: Analyze codebase dependencies, generate architecture graphs, and build context snapshots.
+    ```bash
+    npx tribunal-kit graph
+    ```
+*   **`context <file>`**: Read and inspect a specific context snapshot for a given file.
+    ```bash
+    npx tribunal-kit context src/utils.js
+    ```
+*   **`mutate <file> "<test-cmd>"`**: Run mutation testing on a file to verify test suite robustness.
+    ```bash
+    npx tribunal-kit mutate src/utils.js "npm test"
+    ```
+
+### Learning & Evolving
+*   **`learn`**: Evolve your project's custom skills and architectural idioms by reading git diffs.
+    ```bash
+    npx tribunal-kit learn [--dry-run] [--head]
+    ```
+
+### Marathon Long-Running Harness (`marathon`)
+Run long-running, multi-session tasks tracked inside the feature DAG.
+*   **`marathon init "<spec>"`**: Start a new long-running task.
+*   **`marathon status`**: Show interactive progress dashboard.
+*   **`marathon next`**: Print next incomplete feature task.
+*   **`marathon mark <id> <pass|fail>`**: Mark a specific feature status.
+*   **`marathon log "<note>"`**: Append a progress log.
+*   **`marathon session-start` / `session-end`**: Manage session contexts.
+
+<br>
+<hr style="border: 1px solid #222; margin: 40px 0;">
+<br>
+
+## ⚖️ The Tribunal Pipeline — Mitigating AI Code Hallucinations
 
 Code generation is solved. **Code correctness is the frontier.**
 
@@ -96,7 +204,7 @@ graph TD
     C -.->|Failed| E[Maker Auto-Correction]
     E -.-> C
 
-    D -->|19 Domain Reviewers| F[Human Gate]
+    D -->|20 Domain Reviewers| F[Human Gate]
     F -->|Approved| G((Committed to Disk))
 
     classDef default fill:#1a1a1a,stroke:#333,stroke-width:2px,color:#fff;
@@ -111,7 +219,7 @@ graph TD
 <hr style="border: 1px solid #222; margin: 40px 0;">
 <br>
 
-## 🏛️ THE SUPREME COURT (CASE LAW ENGINE)
+## 🏛️ The Supreme Court Case Law Engine — Persistent Memory for AI Coding
 
 The Tribunal Kit features persistent memory. The AI **never makes the same mistake twice** and auto-learns your engineering culture.
 
@@ -129,7 +237,7 @@ The Tribunal Kit features persistent memory. The AI **never makes the same mista
 <hr style="border: 1px solid #222; margin: 40px 0;">
 <br>
 
-## 🏃 THE MARATHON HARNESS (v4.4+)
+## 🏃 The Marathon Harness — Long-Running Autonomous AI Agents
 
 The **Marathon Harness** is an engine designed to keep autonomous agents on track during long-running, multi-session projects without looping or losing context.
 
@@ -160,7 +268,7 @@ The **Marathon Harness** is an engine designed to keep autonomous agents on trac
 <hr style="border: 1px solid #222; margin: 40px 0;">
 <br>
 
-## 🧠 ADVANCED CAPABILITIES (v5.8)
+## 🧠 Advanced Capabilities & System Prompt Rules (v5.8)
 
 The 5.8 update introduces a massive leap in long-running agent capabilities and code correctness:
 
@@ -173,7 +281,7 @@ The 5.8 update introduces a massive leap in long-running agent capabilities and
 <hr style="border: 1px solid #222; margin: 40px 0;">
 <br>
 
-## 🔌 NATIVE MCP SERVER
+## 🔌 Model Context Protocol (MCP) Server for Cursor, VSCode & Windsurf
 
 Tribunal-Kit functions as a standalone **Model Context Protocol (MCP)** server via `stdio`.
 
@@ -184,6 +292,24 @@ Bind your AI IDE directly to `tribunal-kit` to unlock autonomous tool execution:
 - `sync_ide_bridges`: Force rule alignment directly from the AI chat.
 - `list_tribunal_agents` & `get_tribunal_skill`: Terminal agents can dynamically fetch specific skills without overloading their context windows.
 
+<br>
+<hr style="border: 1px solid #222; margin: 40px 0;">
+<br>
+
+## ❓ Frequently Asked Questions (FAQ)
+
+### How does Tribunal-Kit prevent AI hallucinations?
+Tribunal-Kit introduces a systematic, multi-reviewer pipeline called the **Tribunal Review**. When an AI agent generates code, it routes that code through up to 20 specialized domain reviewers (e.g., security, logic, schema) and verifies it against local tests and lint rules before presenting it to the developer.
+
+### Which IDEs and AI tools are supported by Tribunal-Kit?
+Tribunal-Kit natively supports and automatically syncs rules with **Cursor**, **Windsurf**, **VSCode**, **Gemini**, **Copilot**, and **Claude Desktop**. It also supports terminal-based agents like **Claude Code**, **Aider**, and **OpenCode** via Model Context Protocol (MCP) or compiled static context files.
+
+### How do I connect Claude Code or Aider to Tribunal-Kit via MCP?
+Tribunal-Kit includes a built-in Model Context Protocol (MCP) server. You can configure your AI assistant (like Claude Desktop or Claude Code) to spawn `node bin/wrapper.js` as an MCP server. This allows the AI agent to dynamically fetch custom skills, search the local case law precedence database, and run audits on demand.
+
+### What is the Supreme Court Case Law Engine?
+It is a local, lightweight database that records past AI mistakes as legal precedent. Before code generation is committed, the `precedence-reviewer` queries this database to prevent the AI from repeating known codebase anti-patterns.
+
 <br>
 <br>
 

package/bin/mcp-server.js

@@ -272,6 +272,21 @@ function handleRequest(req) {
             additionalProperties: false,
           },
         },
+        {
+          name: "align_output",
+          description: "Align model outputs to Fabel-5 constraints: strips conversational introductions and conclusions, collapses single/double bullet items to prose, and checks for code traps (unawaited dynamic functions in Next.js 15, deprecated hooks in React 19, or non-existent models).",
+          inputSchema: {
+            type: "object",
+            properties: {
+              text: {
+                type: "string",
+                description: "The raw output text generated by the model to be aligned.",
+              },
+            },
+            required: ["text"],
+            additionalProperties: false,
+          },
+        },
       ],
     };
   }
@@ -455,6 +470,29 @@ function handleRequest(req) {
       }
     }
 
+    if (toolName === "align_output") {
+      const text = req.params?.arguments?.text;
+      if (typeof text !== "string") {
+        throw { code: -32602, message: "Missing or invalid required argument: text (string)" };
+      }
+      try {
+        const { alignText, validateCodeContent } = require("../dist/commands/align.js");
+        const aligned = alignText(text);
+        const warnings = validateCodeContent(aligned);
+        
+        let outputText = aligned;
+        if (warnings.length > 0) {
+          outputText += "\n\n⚠️  OCAE Alignment Validator Warnings:\n";
+          for (const warnMsg of warnings) {
+            outputText += `● ${warnMsg}\n`;
+          }
+        }
+        return { content: [{ type: "text", text: outputText }] };
+      } catch (e) {
+        return { content: [{ type: "text", text: `Alignment failed: ${e.message}` }] };
+      }
+    }
+
     throw { code: -32601, message: `Unknown tool: ${toolName}` };
   }
 

package/bin/wrapper.js

@@ -20,12 +20,16 @@ const RUST_COMMANDS = new Set([
   "sync",
   "hook",
   "uninstall",
+  "memory",
 ]);
 
 // Determine the path to the compiled Rust binary
 // In a full production release, this checks optionalDependencies in node_modules
 // For development, it checks the local target/release folder
 function getBinaryPath() {
+  if (process.env.TRIBUNAL_FORCE_JS === "1") {
+    return null;
+  }
   const isWindows = os.platform() === "win32";
   const ext = isWindows ? ".exe" : "";
   const platform = os.platform();
@@ -77,7 +81,7 @@ function getBinaryPath() {
 function runRustBinary(binPath, args) {
   const stdio = [
     "inherit",
-    process.stdout.isTTY ? "ignore" : "inherit",
+    "inherit",
     "inherit",
   ];
   const result = spawnSync(binPath, args, {

package/dist/cli.js

@@ -46,6 +46,10 @@ function parseArgs(argv) {
             args.flags.skipUpdateCheck = true;
             continue;
         }
+        if (arg === '--write') {
+            args.flags.write = true;
+            continue;
+        }
         if (arg === '--head') {
             args.flags.head = true;
             continue;
@@ -96,6 +100,7 @@ function cmdHelp(quiet = false) {
     (0, logger_1.log)(cmd('mutate', 'Run the Mutation Engine to test test-suite reliability'));
     (0, logger_1.log)(cmd('context', 'Retrieve a highly-optimized Context Snapshot for a file'));
     (0, logger_1.log)(cmd('sync', 'Synchronize IDE bridge files with current rules'));
+    (0, logger_1.log)(cmd('align', 'Clean AI outputs (strip slop, collapse lists, validate code traps)'));
     (0, logger_1.log)(cmd('marathon', 'Long-running agent harness (init, status, next, mark)'));
     (0, logger_1.log)(cmd('hook', 'Install pre-push git hook for auto-learning'));
     (0, logger_1.log)(cmd('compile', 'Compile rules into a static instruction file for terminal agents'));
@@ -113,6 +118,7 @@ function cmdHelp(quiet = false) {
     (0, logger_1.log)(opt('--minimal', 'Install core agents/skills only (~13 agents)'));
     (0, logger_1.log)(opt('--skip-update-check', 'Skip auto-update version check'));
     (0, logger_1.log)(opt('--head', '(learn) Diff against last commit instead of staged'));
+    (0, logger_1.log)(opt('--write', '(align) Write aligned output in-place to the target file'));
     console.log();
     (0, logger_1.log)((0, logger_1.bold)('  Aliases'));
     (0, logger_1.log)(`  ${(0, logger_1.c)('gray', '─'.repeat(40))}`);
@@ -144,6 +150,8 @@ function cmdHelp(quiet = false) {
     (0, logger_1.log)(ex('tk marathon mark 5 pass'));
     (0, logger_1.log)(ex('tk hook'));
     (0, logger_1.log)(ex('tk compile'));
+    (0, logger_1.log)(ex('echo "Certainly! Here is - item 1" | tk align'));
+    (0, logger_1.log)(ex('tk align output.md --write'));
     (0, logger_1.log)(ex('tk memory store --type semantic --content "Uses PostgreSQL" --tags db,orm'));
     (0, logger_1.log)(ex('tk memory recall --query "database" --budget 2000'));
     (0, logger_1.log)(ex('tk memory gc'));
@@ -221,6 +229,11 @@ async function runWithUpdateCheck(command, flags) {
             await cmdSync();
             break;
         }
+        case 'align': {
+            const cmdAlign = loadCmd('./commands/align', 'cmdAlign');
+            await cmdAlign(flags, process.argv, quiet);
+            break;
+        }
         case 'marathon': {
             const cmdMarathon = loadCmd('./commands/marathon', 'cmdMarathon');
             await cmdMarathon(flags, process.argv, quiet);