tribunal-kit 6.0.0 → 7.0.0

package/README.md

@@ -2,13 +2,16 @@
 <div align="center">
   <br>
   <img src="./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.15em; color: #88888b; font-weight: 500; letter-spacing: 3px; margin: 10px 0 25px 0; text-transform: uppercase;">
-    The Operating System for AI Software Engineering
+
+  <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 — 52 specialists, 28 reviewers, Rust core.
   </p>
 
   <!-- BADGES -->
@@ -16,15 +19,28 @@
     <a href="https://www.npmjs.com/package/tribunal-kit">
       <img src="https://img.shields.io/npm/v/tribunal-kit?style=for-the-badge&logo=npm&logoColor=white&color=ff1637" alt="NPM Version" />
     </a>
+    <a href="https://www.npmjs.com/package/tribunal-kit">
+      <img src="https://img.shields.io/npm/dw/tribunal-kit?style=for-the-badge&logo=npm&logoColor=white&color=1a1a1f&label=Downloads" alt="NPM Downloads" />
+    </a>
+    <a href="https://github.com/Harmitx7/tribunal-kit">
+      <img src="https://img.shields.io/github/stars/Harmitx7/tribunal-kit?style=for-the-badge&logo=github&logoColor=white&color=111111&label=Stars" alt="GitHub Stars" />
+    </a>
+    <a href="https://github.com/Harmitx7/tribunal-kit/actions/workflows/ci.yml">
+      <img src="https://img.shields.io/github/actions/workflow/status/Harmitx7/tribunal-kit/ci.yml?style=for-the-badge&logo=githubactions&logoColor=white&label=CI" alt="CI Status" />
+    </a>
+    <br>
     <a href="LICENSE">
       <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.0-ccff00?style=for-the-badge&color=111111&logo=github&logoColor=ccff00" alt="Release Version" />
+      <img src="https://img.shields.io/badge/Release-v7.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" />
     </a>
+    <a href="package.json">
+      <img src="https://img.shields.io/badge/Dependencies-0-ccff00?style=for-the-badge&color=111111" alt="Zero Dependencies" />
+    </a>
     <a href="SECURITY.md">
       <img src="https://img.shields.io/badge/Security-Strict_Sandbox-ff1637?style=for-the-badge" alt="Security Policy" />
     </a>
@@ -33,17 +49,54 @@
 
 <br>
 
-<!-- INTRO KEYNOTE -->
-<div style="background: linear-gradient(145deg, #111115, #16161c); border: 1px solid #22222a; border-radius: 12px; padding: 24px; margin-bottom: 40px; box-shadow: 0 4px 20px rgba(0, 0, 0, 0.25);">
+<!-- THE PROBLEM -->
+<div style="background: linear-gradient(145deg, #1a0a0a, #16161c); border: 1px solid #3a1a1a; border-radius: 12px; padding: 24px; margin-bottom: 20px;">
   <div style="display: flex; align-items: center; margin-bottom: 12px;">
-    <span style="background-color: #ff1637; color: white; padding: 4px 8px; border-radius: 4px; font-size: 0.75em; font-weight: bold; text-transform: uppercase; letter-spacing: 1px; margin-right: 10px;">Security Envelope</span>
-    <strong style="color: #ffffff; font-size: 1.1em;">AI GENERATES CODE. TRIBUNAL KIT GOVERNS IT.</strong>
+    <span style="background-color: #ff1637; color: white; padding: 4px 8px; border-radius: 4px; font-size: 0.75em; font-weight: bold; text-transform: uppercase; letter-spacing: 1px; margin-right: 10px;">The Problem</span>
+    <strong style="color: #ffffff; font-size: 1.1em;">AI coding agents hallucinate. Constantly.</strong>
   </div>
   <p style="color: #c9c9d1; font-size: 0.95em; line-height: 1.6; margin: 0;">
-    A zero-bloat <strong>.agent/</strong> intelligence payload and <strong>Model Context Protocol (MCP) server</strong> that upgrades your IDEs (<a href="#" style="color: #ccff00; text-decoration: none;">Cursor</a>, <a href="#" style="color: #ccff00; text-decoration: none;">VSCode</a>, <a href="#" style="color: #ccff00; text-decoration: none;">Windsurf</a>) and terminal AI coding assistants (<a href="#" style="color: #ccff00; text-decoration: none;">Claude Code</a>, <a href="#" style="color: #ccff00; text-decoration: none;">Aider</a>) with <strong>51 specialist agents</strong>, <strong>37 workflows</strong>, <strong>171 reusable skills</strong>, and a parallel <strong>27-reviewer Tribunal pipeline</strong>. Establishes absolute runtime correctness, optimizes context windows, and heavily mitigates AI code hallucinations.
+    They import packages that don't exist. They call API methods that were deprecated two versions ago. They forget your project conventions mid-conversation. They generate code that <em>looks</em> right but silently breaks at runtime. <strong>No linter catches this. No type-checker catches this.</strong> The hallucination happens at the semantic layer — and until now, nothing governed it.
+  </p>
+</div>
+
+<!-- THE SOLUTION -->
+<div style="background: linear-gradient(145deg, #0a1a0a, #16161c); border: 1px solid #1a3a1a; border-radius: 12px; padding: 24px; margin-bottom: 40px;">
+  <div style="display: flex; align-items: center; margin-bottom: 12px;">
+    <span style="background-color: #ccff00; color: #111; padding: 4px 8px; border-radius: 4px; font-size: 0.75em; font-weight: bold; text-transform: uppercase; letter-spacing: 1px; margin-right: 10px;">The Solution</span>
+    <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> — 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
+```
+
+<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**    | 38      | 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              |
+
+<br>
 <hr style="height: 1px; border: none; background: linear-gradient(to right, transparent, #33333f, transparent); margin: 40px 0;" />
 
 <!-- TABLE OF CONTENTS -->
@@ -53,15 +106,14 @@
   </summary>
   <div style="margin-top: 15px; padding-left: 10px;">
     <ul style="list-style-type: none; padding-left: 0; line-height: 1.8;">
-      <li>👉 <a href="#-the-competitive-advantage" style="color: #a0a0a5; text-decoration: none;">Why Tribunal Kit? (The Competitive Advantage)</a></li>
       <li>👉 <a href="#-comparative-analysis" style="color: #a0a0a5; text-decoration: none;">Comparative Analysis: Tribunal Kit vs. Alternatives</a></li>
       <li>👉 <a href="#-state-of-the-art-performance-rust-core" style="color: #a0a0a5; text-decoration: none;">State-of-the-Art Performance (Rust Core)</a></li>
-      <li>👉 <a href="#-quick-start" style="color: #a0a0a5; text-decoration: none;">Quick Start (Set Up in Under 60 Seconds)</a></li>
-      <li>👉 <a href="#-the-tribunal-pipeline" style="color: #a0a0a5; text-decoration: none;">The Tribunal Pipeline — Mitigating AI Code Hallucinations</a></li>
+      <li>👉 <a href="#%EF%B8%8F-advanced-setup" style="color: #a0a0a5; text-decoration: none;">Advanced Setup</a></li>
+      <li>👉 <a href="#%EF%B8%8F-the-tribunal-pipeline--mitigating-ai-code-hallucinations" style="color: #a0a0a5; text-decoration: none;">The Tribunal Pipeline — Mitigating AI Code Hallucinations</a></li>
       <li>👉 <a href="#-omniscience-cognitive-alignment-engine-ocae" style="color: #a0a0a5; text-decoration: none;">Omniscience Cognitive Alignment Engine (OCAE)</a></li>
       <li>👉 <a href="#-skillopt-autonomous-self-evolution-engine" style="color: #a0a0a5; text-decoration: none;">SkillOpt: Autonomous Self-Evolution Engine</a></li>
-      <li>👉 <a href="#-supreme-court-case-law--memory" style="color: #a0a0a5; text-decoration: none;">Supreme Court Case Law & Persistent Memory</a></li>
-      <li>👉 <a href="#-the-marathon-harness" style="color: #a0a0a5; text-decoration: none;">The Marathon Harness — Long-Running Autonomy</a></li>
+      <li>👉 <a href="#%EF%B8%8F-supreme-court-case-law--memory" style="color: #a0a0a5; text-decoration: none;">Supreme Court Case Law & Persistent Memory</a></li>
+      <li>👉 <a href="#-the-marathon-harness--long-running-autonomy" style="color: #a0a0a5; text-decoration: none;">The Marathon Harness — Long-Running Autonomy</a></li>
       <li>👉 <a href="#-mcp-server-integration" style="color: #a0a0a5; text-decoration: none;">Model Context Protocol (MCP) Server Integration</a></li>
       <li>👉 <a href="#-cli-command-reference" style="color: #a0a0a5; text-decoration: none;">CLI Command Reference</a></li>
       <li>👉 <a href="#-contributing--security" style="color: #a0a0a5; text-decoration: none;">Contributing & Security Guidelines</a></li>
@@ -69,42 +121,6 @@
   </div>
 </details>
 
-<!-- SECTION 1 -->
-## 🚀 The Competitive Advantage
-
-Standard AI coding assistants generate code linearly, without validating semantic boundaries or architectural constraints. This leads to **hallucinations, token window inflation, amnesia across sessions, and instruction drift**.
-
-Tribunal Kit wraps your coding agents in a **neurosymbolic verification envelope**. It intercepts agent outputs, runs them through parallel domain-specific reviewer swarms, enforces strict context budgeting, and uses a compiled Rust core to run self-evolution loops directly on your Git changes.
-
-### Key Capabilities
-
-<div style="display: grid; grid-template-columns: 1fr 1fr; gap: 20px; margin-top: 20px;">
-  <div style="background: #111115; border: 1px solid #22222a; border-radius: 8px; padding: 20px;">
-    <div style="font-size: 1.5em; margin-bottom: 8px;">🛡️</div>
-    <h3 style="color: #ffffff; margin-top: 0;">Zero-Hallucination Guardrails</h3>
-    <p style="color: #a0a0a5; font-size: 0.9em; margin: 0; line-height: 1.5;">Enforces strict check gates (<kbd>tk guardrail</kbd>) verifying that file links, count metrics, and package imports exist before code reaches disk.</p>
-  </div>
-  <div style="background: #111115; border: 1px solid #22222a; border-radius: 8px; padding: 20px;">
-    <div style="font-size: 1.5em; margin-bottom: 8px;">🧬</div>
-    <h3 style="color: #ffffff; margin-top: 0;">SkillOpt Self-Evolution</h3>
-    <p style="color: #a0a0a5; font-size: 0.9em; margin: 0; line-height: 1.5;">Optimizes your <code>.agent</code> instruction files automatically using a multi-epoch genetic evolution loop with candidate grading and Levenshtein deduplication.</p>
-  </div>
-  <div style="background: #111115; border: 1px solid #22222a; border-radius: 8px; padding: 20px;">
-    <div style="font-size: 1.5em; margin-bottom: 8px;">🎯</div>
-    <h3 style="color: #ffffff; margin-top: 0;">Fabel-5 Output Alignment</h3>
-    <p style="color: #a0a0a5; font-size: 0.9em; margin: 0; line-height: 1.5;">Programmatically aligns AI outputs to clean prose paragraphs, stripping conversational slop and catching known framework traps (Next.js 15 route headers, React 19 hooks, Drizzle ORM filters).</p>
-  </div>
-  <div style="background: #111115; border: 1px solid #22222a; border-radius: 8px; padding: 20px;">
-    <div style="font-size: 1.5em; margin-bottom: 8px;">🧠</div>
-    <h3 style="color: #ffffff; margin-top: 0;">4-Type Persistent Memory</h3>
-    <p style="color: #a0a0a5; font-size: 0.9em; margin: 0; line-height: 1.5;">Separates memory into Semantic, Procedural, Episodic, and Working categories to prevent context decay and model amnesia.</p>
-  </div>
-</div>
-
-<br>
-<hr style="height: 1px; border: none; background: linear-gradient(to right, transparent, #33333f, transparent); margin: 40px 0;" />
-
-<!-- SECTION 2 -->
 ## 📈 Comparative Analysis
 
 AI engineering requires more than static template rules or raw linters. See how Tribunal Kit stacks up against alternatives:
@@ -171,46 +187,55 @@ 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 -->
-## 🛠️ Quick Start (Set Up in Under 60 Seconds)
 
-Get Tribunal Kit up and running in any project instantly:
+## 🛠️ Advanced Setup
+
+Already ran `npx tribunal-kit init`? Here's how to go further:
 
 ```bash
-# 1. Initialize the intelligence payload
-npx tribunal-kit init
+# Install Git pre-push governance hook
+npx tribunal-kit hook
 
-# 2. Synchronize configuration bridges with Cursor / Windsurf / VSCode
-npx tribunal-kit sync
+# Scan your workspace for AI hallucinations (phantom packages, unverified APIs)
+npx tribunal-kit guardrail
 
-# 3. Verify project rule integrity
-npx tribunal-kit status
+# Record an AI coding mistake as permanent precedent (case law)
+npx tribunal-kit case add
+
+# Optimize a skill file using the SkillOpt evolution engine
+tk optimize-skill --target ./skills/auth-security.md "npm run test:auth" --epochs 5
 ```
 
 > [!TIP]
-> Run `npx tribunal-kit hook` to install a Git `pre-push` hook. This ensures your custom rules and agent configurations are auto-evolved and verified before code is pushed to your remote repository.
+> The `tk hook` command installs a Git `pre-push` hook that auto-runs `tk guardrail` before every push — catching hallucinated imports and unverified APIs before they reach your remote.
+
+> [!NOTE]
+> **MCP Server**: To connect Tribunal Kit to Cursor, VSCode, or Claude Desktop as an MCP server, see the [MCP Server Integration](#-mcp-server-integration) section below.
 
 <br>
 <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
@@ -221,7 +246,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;
@@ -233,28 +258,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:
@@ -273,21 +301,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.
 
@@ -295,18 +328,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.
@@ -328,14 +363,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`):
@@ -405,6 +470,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>
@@ -413,11 +483,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          |
-| ------- | ------------------ |
-| 5.x     | ✅ Active support  |
-| 4.x     | ⚠️ Critical fixes only |
-| < 4.0   | ❌ End of life     |
+| Version | Supported              |
+| ------- | ---------------------- |
+| 6.x     | ✅ Active support      |
+| 5.x     | ⚠️ Critical fixes only |
+| < 5.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