tribunal-kit 5.8.0 → 5.8.2

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/SECURITY.md

@@ -0,0 +1,52 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 5.x     | ✅ Active support  |
+| 4.x     | ⚠️ Critical fixes only |
+| < 4.0   | ❌ End of life     |
+
+## Reporting a Vulnerability
+
+**Do not open a public GitHub issue for security vulnerabilities.**
+
+Instead, please report vulnerabilities privately using one of these methods:
+
+1. **GitHub Security Advisory** (preferred): Use [GitHub's private vulnerability reporting](https://github.com/Harmitx7/tribunal-kit/security/advisories/new) to submit a confidential report.
+
+2. **Email**: Send details to the maintainer via the email listed in the npm package.
+
+### What to include
+
+- Description of the vulnerability
+- Steps to reproduce
+- Affected versions
+- Potential impact
+- Suggested fix (if any)
+
+### 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 |
+
+## Security Design
+
+Tribunal Kit follows these security principles:
+
+- **No network requests at runtime** — The CLI operates entirely offline. The only network call is an optional npm registry version check during `init`/`update`, which can be skipped with `--skip-update-check`.
+- **No code execution from user input** — CLI arguments are parsed without `eval()` or shell interpolation. All subprocess spawning uses array-based arguments (never string concatenation).
+- **No secrets stored** — Tribunal Kit does not store, read, or transmit API keys, tokens, or credentials.
+- **Minimal dependencies** — Zero production dependencies. Only `jest`, `eslint`, and `typescript` as devDependencies.
+- **Platform binaries are optional** — The Rust core binary is distributed as optional dependencies. The CLI falls back to pure JavaScript if binaries are unavailable.
+
+## Supply Chain
+
+- All releases are published from CI via GitHub Actions
+- Platform binaries are built in GitHub-hosted runners with pinned action versions
+- The package uses `npm provenance` for verifiable supply chain attestation

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/tribunal-kit.js

@@ -158,6 +158,34 @@ function parseArgs(argv) {
     if (arg.startsWith("--branch=")) {
       args.flags.branch = arg.split("=").slice(1).join("=");
     }
+    if (arg.startsWith("--log=")) {
+      args.flags.log = arg.split("=").slice(1).join("=");
+    }
+    if (arg === "--log") {
+      const idx = raw.indexOf("--log");
+      const nextVal = raw[idx + 1];
+      if (!nextVal || nextVal.startsWith("--")) {
+        console.error(
+          `  \x1b[91m✖ --log requires a file path argument\x1b[0m`,
+        );
+        process.exit(1);
+      }
+      args.flags.log = nextVal;
+    }
+    if (arg.startsWith("--strategy=")) {
+      args.flags.strategy = arg.split("=").slice(1).join("=");
+    }
+    if (arg === "--strategy") {
+      const idx = raw.indexOf("--strategy");
+      const nextVal = raw[idx + 1];
+      if (!nextVal || nextVal.startsWith("--")) {
+        console.error(
+          `  \x1b[91m✖ --strategy requires a strategy value (balanced/harden/repair-only)\x1b[0m`,
+        );
+        process.exit(1);
+      }
+      args.flags.strategy = nextVal;
+    }
   }
 
   return args;
@@ -412,8 +440,19 @@ function banner() {
   const _maxLen = Math.max(...art.map((line) => line.length));
   for (const line of art) {
     let gradientLine = "  " + C.bold;
-    for (let i = 0; i < line.length; i++) {
-      gradientLine += `\x1b[38;2;255;22;55m${line[i]}`;
+    const len = line.length;
+    for (let i = 0; i < len; i++) {
+      const char = line[i];
+      if (char === ' ') {
+        gradientLine += ' ';
+        continue;
+      }
+      // Horizontal gradient: flame red (left) to coral/orange (right)
+      const ratio = i / len;
+      const r = 255;
+      const g = Math.floor(30 + ratio * 100);
+      const b = Math.floor(60 - ratio * 40);
+      gradientLine += `\x1b[38;2;${r};${g};${b}m${char}`;
     }
     gradientLine += C.reset;
     log(gradientLine);
@@ -421,16 +460,13 @@ function banner() {
   console.log();
   // Subtitle strip
   const W = 84;
-  const sub = "Anti-Hallucination Agent System";
-  const sp = Math.max(0, W - sub.length);
-  const centred =
-    " ".repeat(Math.floor(sp / 2)) + sub + " ".repeat(Math.ceil(sp / 2));
-  const RED_ANSI = "\x1b[38;2;255;22;55m";
-  console.log(`  ${RED_ANSI}╔${"═".repeat(W)}╗${C.reset}`);
-  console.log(
-    `  ${RED_ANSI}║${C.reset}${c("gray", centred)}${RED_ANSI}║${C.reset}`,
-  );
-  console.log(`  ${RED_ANSI}╚${"═".repeat(W)}╝${C.reset}`);
+  const plainSub = '🛡️  ANTI-HALLUCINATION AGENT SYSTEM';
+  const coloredSub = `${bold(c('white', '🛡️  ANTI-HALLUCINATION AGENT SYSTEM'))}`;
+  const sp = Math.max(0, W - plainSub.length);
+  const centred = ' '.repeat(Math.floor(sp / 2)) + coloredSub + ' '.repeat(Math.ceil(sp / 2));
+  log(`  ${c('gray', `✦  ${'━'.repeat(W - 6)}  ✦`)}`);
+  log(`  ${centred}`);
+  log(`  ${c('gray', `✦  ${'━'.repeat(W - 6)}  ✦`)}`);
   console.log();
 }
 
@@ -560,6 +596,7 @@ async function cmdInit(flags) {
     } else {
       // ── Success card — W=62, rows padded by plain-text length ──
       const W = 62;
+      const borderCol = "red";
       const agentsCount = fs.readdirSync(path.join(agentDest, "agents")).length;
       const workflowsCount = fs.readdirSync(
         path.join(agentDest, "workflows"),
@@ -569,23 +606,28 @@ async function cmdInit(flags) {
         path.join(agentDest, "scripts"),
       ).length;
 
-      // Stat rows: compute trailing spaces from plain text so right ║ aligns
-      const statRow = (icon, label, val, col) => {
-        // emoji JS .length===2 == terminal display width 2 ✓
-        const plain = `  ${icon}  ${label.padEnd(10)}${String(val).padStart(3)} installed`;
-        const trail = " ".repeat(Math.max(0, W - plain.length));
-        return `  ${c("cyan", "║")}  ${icon}  ${c("white", label.padEnd(10))}${c(col, String(val).padStart(3))} ${c("gray", "installed")}${trail}${c("cyan", "║")}`;
+      const drawRow = (plainText, styledText) => {
+        const trail = " ".repeat(Math.max(0, W - plainText.length));
+        return `  ${c(borderCol, "│")}${styledText}${trail}${c(borderCol, "│")}`;
       };
-      // Plain-text rows (header / blank)
-      const plainRow = (text, wrapFn) => {
-        const trail = " ".repeat(Math.max(0, W - text.length));
-        return `  ${c("cyan", "║")}${wrapFn(text)}${trail}${c("cyan", "║")}`;
+
+      const compRow = (icon, label, count, color) => {
+        const leftPlain = `    ${icon}  ${label.padEnd(10)} `;
+        const rightPlain = ` [ ${String(count).padStart(3)} ]`;
+        const numDots = W - leftPlain.length - rightPlain.length - 4; // 4 spaces margin
+        const dots = ".".repeat(Math.max(0, numDots));
+
+        const plain = `${leftPlain}${dots}${rightPlain}`;
+        const styled = `    ${icon}  ${c("white", label.padEnd(10))} ${c("gray", dots)} ${c("gray", "[")} ${c(color, String(count).padStart(3))} ${c("gray", "]")}`;
+        return drawRow(plain, styled);
       };
-      // Next-step rows: fixed cmd column + description
+
       const stepRow = (cmd, desc) => {
-        const plain = `  ${cmd.padEnd(16)}${desc}`;
-        const trail = " ".repeat(Math.max(0, W - plain.length));
-        return `  ${c("cyan", "║")}  ${c("white", cmd.padEnd(16))}${c("gray", desc)}${trail}${c("cyan", "║")}`;
+        const leftPlain = `    ${cmd.padEnd(16)}`;
+        const rightPlain = `▸  ${desc}`;
+        const plain = `${leftPlain}${rightPlain}`;
+        const styled = `    ${c("white", cmd.padEnd(16))}${c("gray", "▸")}  ${c("gray", desc)}`;
+        return drawRow(plain, styled);
       };
 
       console.log(
@@ -593,27 +635,25 @@ async function cmdInit(flags) {
       );
       console.log(`  ${c("gray", "  ╰─")} ${c("gray", agentDest)}`);
       console.log();
-      console.log(`  ${c("cyan", "╔" + "═".repeat(W) + "╗")}`);
-      console.log(
-        plainRow(`  What's inside:`, (s) => c("bold", c("white", s))),
-      );
-      console.log(`  ${c("cyan", "╠" + "═".repeat(W) + "╣")}`);
-      console.log(statRow("🤖", "Agents", agentsCount, "magenta"));
-      console.log(statRow("⚡", "Workflows", workflowsCount, "yellow"));
-      console.log(statRow("🧠", "Skills", skillsCount, "blue"));
-      console.log(statRow("🔧", "Scripts", scriptsCount, "green"));
-      console.log(`  ${c("cyan", "╠" + "═".repeat(W) + "╣")}`);
-      console.log(plainRow("", () => ""));
-      console.log(plainRow(`  Next steps:`, (s) => c("gray", s)));
-      console.log(
-        stepRow("/generate", "Generate code with anti-hallucination"),
-      );
+      console.log(`  ${c(borderCol, "┌" + "─".repeat(W) + "┐")}`);
+      console.log(drawRow("  TRIBUNAL ENVIRONMENT SYNCHRONIZED", `${bold(c("white", "  TRIBUNAL ENVIRONMENT SYNCHRONIZED"))}`));
+      console.log(`  ${c(borderCol, "├" + "─".repeat(W) + "┤")}`);
+      console.log(drawRow("  Guarding:  Active & Enforcing", `${c("gray", "  Guarding:")}  ${c("green", "Active & Enforcing")}`));
+      console.log(drawRow("  Manifest:  Verified", `${c("gray", "  Manifest:")}  ${c("cyan", "Verified")}`));
+      console.log(drawRow("", ""));
+      console.log(drawRow("  Installed Components:", bold(c("white", "  Installed Components:"))));
+      console.log(compRow("🤖", "Agents", agentsCount, "magenta"));
+      console.log(compRow("⚡", "Workflows", workflowsCount, "yellow"));
+      console.log(compRow("🧠", "Skills", skillsCount, "blue"));
+      console.log(compRow("🔧", "Scripts", scriptsCount, "green"));
+      console.log(`  ${c(borderCol, "├" + "─".repeat(W) + "┤")}`);
+      console.log(drawRow("", ""));
+      console.log(drawRow("  Next Steps:", c("gray", "  Next Steps:")));
+      console.log(stepRow("/generate", "Generate code with reviews"));
       console.log(stepRow("/review", "Audit existing code for issues"));
-      console.log(
-        stepRow("/tribunal-full", "Run all 16 reviewers in parallel"),
-      );
-      console.log(plainRow("", () => ""));
-      console.log(`  ${c("cyan", "╚" + "═".repeat(W) + "╝")}`);
+      console.log(stepRow("/tribunal-full", "Run all 20 reviewers in parallel"));
+      console.log(drawRow("", ""));
+      console.log(`  ${c(borderCol, "└" + "─".repeat(W) + "┘")}`);
       console.log();
       log(`  ${c("gray", "✦ Updating .gitignore...")}`);
       await updateGitignore(targetDir, dryRun);
@@ -912,6 +952,8 @@ async function cmdLearn(flags) {
   const evoArgs = ["digest"];
   if (flags.dryRun) evoArgs.push("--dry-run");
   if (flags.head) evoArgs.push("--head");
+  if (flags.log) evoArgs.push(`--log=${flags.log}`);
+  if (flags.strategy) evoArgs.push(`--strategy=${flags.strategy}`);
 
   // Phase 1: Skill Evolution
   log(
@@ -1287,6 +1329,8 @@ function cmdHelp() {
   log(opt("--minimal", "Install core agents/skills only (~13 agents)"));
   log(opt("--skip-update-check", "Skip auto-update version check"));
   log(opt("--head", "(learn) Diff against last commit instead of staged"));
+  log(opt("--log <file>", "(learn) Extract signals and evolve from a log/transcript file"));
+  log(opt("--strategy <val>", "(learn) Evolution strategy: balanced, harden, repair-only"));
   console.log();
   log(bold("  Aliases"));
   log(`  ${c("gray", "─".repeat(40))}`);
@@ -1305,6 +1349,8 @@ function cmdHelp() {
   log(ex("tk learn"));
   log(ex("tk learn --dry-run"));
   log(ex("tk learn --head"));
+  log(ex("tk learn --log=run.log"));
+  log(ex("tk learn --log=eslint.log --strategy=harden"));
   log(ex("tk case add"));
   log(ex('tk case search "useEffect"'));
   log(ex("tk case list"));

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);