tribunal-kit 6.0.0 → 6.0.1

package/README.md

@@ -7,8 +7,11 @@
     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 — 51 specialists, 27 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-v6.0.1-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,53 @@
 
 <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> — 51 specialist agents, 27 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** | 37 | 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 +105,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 +120,7 @@
   </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:
@@ -184,23 +200,29 @@ Tribunal Kit v6 splits heavy computational tasks between a native Rust core and
 <br>
 
 <!-- SECTION 4 -->
-## 🛠️ Quick Start (Set Up in Under 60 Seconds)
+## 🛠️ Advanced Setup
 
-Get Tribunal Kit up and running in any project instantly:
+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;" />

package/SECURITY.md

@@ -4,9 +4,9 @@
 
 | Version | Supported          |
 | ------- | ------------------ |
-| 5.x     | ✅ Active support  |
-| 4.x     | ⚠️ Critical fixes only |
-| < 4.0   | ❌ End of life     |
+| 6.x     | ✅ Active support  |
+| 5.x     | ⚠️ Critical fixes only |
+| < 5.0   | ❌ End of life     |
 
 ## Reporting a Vulnerability
 

package/bin/mcp-server.js

@@ -110,24 +110,26 @@ function stripBoilerplate(text) {
   return minified.trim();
 }
 
+function getAgentDir() {
+  const fs = require("fs");
+  const local = path.join(process.cwd(), ".agent");
+  if (fs.existsSync(local)) return local;
+  return path.resolve(__dirname, "../.agent");
+}
+
 function handleRequest(req) {
+  const fs = require("fs");
   if (req.method === "notifications/initialized" || req.method === "notifications/cancelled") {
     return null;
   }
   if (req.method === "ping") {
     return {};
   }
-  if (req.method === "resources/list") {
-    return { resources: [] };
-  }
-  if (req.method === "prompts/list") {
-    return { prompts: [] };
-  }
 
   // MCP spec: method names follow path-style convention
   if (req.method === "initialize") {
     return {
-      protocolVersion: "2024-11-05",
+      protocolVersion: "2025-03-26",
       capabilities: {
         tools: {},
         resources: { subscribe: false, listChanged: false },
@@ -140,6 +142,148 @@ function handleRequest(req) {
     };
   }
 
+  if (req.method === "resources/list") {
+    const agentDir = getAgentDir();
+    const resources = [];
+    
+    // Agents
+    const agentsDir = path.join(agentDir, "agents");
+    if (fs.existsSync(agentsDir)) {
+      const files = fs.readdirSync(agentsDir).filter((f) => f.endsWith(".md"));
+      for (const f of files) {
+        const name = path.basename(f, ".md");
+        resources.push({
+          uri: `tribunal://agent/${name}`,
+          name: `Agent: ${name}`,
+          description: `Tribunal Specialist Agent rule file for ${name}`,
+          mimeType: "text/markdown",
+        });
+      }
+    }
+
+    // Skills
+    const skillsDir = path.join(agentDir, "skills");
+    if (fs.existsSync(skillsDir)) {
+      const dirs = fs.readdirSync(skillsDir, { withFileTypes: true });
+      for (const d of dirs) {
+        if (d.isDirectory()) {
+          const skillFile = path.join(skillsDir, d.name, "SKILL.md");
+          if (fs.existsSync(skillFile)) {
+            resources.push({
+              uri: `tribunal://skill/${d.name}`,
+              name: `Skill: ${d.name}`,
+              description: `Tribunal Skill instruction file for ${d.name}`,
+              mimeType: "text/markdown",
+            });
+          }
+        }
+      }
+    }
+
+    // Workflows
+    const workflowsDir = path.join(agentDir, "workflows");
+    if (fs.existsSync(workflowsDir)) {
+      const files = fs.readdirSync(workflowsDir).filter((f) => f.endsWith(".md"));
+      for (const f of files) {
+        const name = path.basename(f, ".md");
+        resources.push({
+          uri: `tribunal://workflow/${name}`,
+          name: `Workflow: ${name}`,
+          description: `Tribunal Workflow guide for ${name}`,
+          mimeType: "text/markdown",
+        });
+      }
+    }
+
+    return { resources };
+  }
+
+  if (req.method === "resources/read") {
+    const uri = req.params && req.params.uri;
+    if (!uri) throw new Error("Missing uri parameter");
+    const agentDir = getAgentDir();
+    let filePath = null;
+
+    if (uri.startsWith("tribunal://agent/")) {
+      const name = uri.replace("tribunal://agent/", "");
+      filePath = path.join(agentDir, "agents", `${name}.md`);
+    } else if (uri.startsWith("tribunal://skill/")) {
+      const name = uri.replace("tribunal://skill/", "");
+      filePath = path.join(agentDir, "skills", name, "SKILL.md");
+    } else if (uri.startsWith("tribunal://workflow/")) {
+      const name = uri.replace("tribunal://workflow/", "");
+      filePath = path.join(agentDir, "workflows", `${name}.md`);
+    }
+
+    if (!filePath || !fs.existsSync(filePath)) {
+      throw new Error(`Resource not found: ${uri}`);
+    }
+
+    const text = fs.readFileSync(filePath, "utf8");
+    return {
+      contents: [
+        {
+          uri,
+          mimeType: "text/markdown",
+          text,
+        },
+      ],
+    };
+  }
+
+  if (req.method === "prompts/list") {
+    const agentDir = getAgentDir();
+    const prompts = [];
+    const workflowsDir = path.join(agentDir, "workflows");
+
+    if (fs.existsSync(workflowsDir)) {
+      const files = fs.readdirSync(workflowsDir).filter((f) => f.endsWith(".md"));
+      for (const f of files) {
+        const name = path.basename(f, ".md");
+        prompts.push({
+          name,
+          description: `Execute tribunal workflow /${name}`,
+          arguments: [
+            {
+              name: "task",
+              description: "The task or target file to execute the workflow against",
+              required: false,
+            },
+          ],
+        });
+      }
+    }
+
+    return { prompts };
+  }
+
+  if (req.method === "prompts/get") {
+    const name = req.params && req.params.name;
+    const task = (req.params && req.params.arguments && req.params.arguments.task) || "";
+    if (!name) throw new Error("Missing prompt name parameter");
+
+    const agentDir = getAgentDir();
+    const workflowPath = path.join(agentDir, "workflows", `${name}.md`);
+    if (!fs.existsSync(workflowPath)) {
+      throw new Error(`Prompt workflow not found: ${name}`);
+    }
+
+    const content = fs.readFileSync(workflowPath, "utf8");
+    const promptText = task ? `${content}\n\nTarget Task/File: ${task}` : content;
+
+    return {
+      messages: [
+        {
+          role: "user",
+          content: {
+            type: "text",
+            text: promptText,
+          },
+        },
+      ],
+    };
+  }
+
   if (req.method === "tools/list") {
     return {
       tools: [
@@ -337,26 +481,28 @@ function handleRequest(req) {
           ],
         };
       }
-      // Run synchronously by spawning a minimal script
-      const result = spawnSync(
-        process.execPath,
-        [
-          "-e",
-          `
-                const { generateIDEBridges } = require('${path.resolve(__dirname, "../dist/commands/init.js").replace(/\\/g, "\\\\")}');
-                generateIDEBridges('${cwd.replace(/\\/g, "\\\\")}', '${agentDest.replace(/\\/g, "\\\\")}', false).then(() => console.log('Sync complete'));
-            `,
-        ],
-        { encoding: "utf8", timeout: SPAWN_TIMEOUT_MS },
-      );
-      return {
-        content: [
-          {
-            type: "text",
-            text: result.stdout || result.stderr || "Sync complete",
-          },
-        ],
-      };
+      try {
+        const { generateIDEBridges } = require(path.resolve(__dirname, "../dist/commands/init.js"));
+        // generateIDEBridges is async — execute synchronously in MCP context
+        generateIDEBridges(cwd, agentDest, true).then(() => {}).catch(() => {});
+        return {
+          content: [
+            {
+              type: "text",
+              text: "Sync complete",
+            },
+          ],
+        };
+      } catch (e) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Sync failed: ${e.message}`,
+            },
+          ],
+        };
+      }
     }
 
     if (toolName === "search_case_law") {
@@ -374,7 +520,7 @@ function handleRequest(req) {
 
     if (toolName === "list_tribunal_agents") {
       const fs = require("fs");
-      const agentDir = path.join(process.cwd(), ".agent", "agents");
+      const agentDir = path.join(getAgentDir(), "agents");
       if (!fs.existsSync(agentDir)) return { content: [{ type: "text", text: "No agents found or .agent directory missing." }] };
       const agents = fs.readdirSync(agentDir).filter(f => f.endsWith('.md')).map(f => f.replace('.md', ''));
       return { content: [{ type: "text", text: "Available Agents:\n- " + agents.join("\n- ") }] };
@@ -385,7 +531,7 @@ function handleRequest(req) {
       const name = req.params?.arguments?.name;
       if (!name || typeof name !== "string") throw { code: -32602, message: "Missing or invalid argument: name (string)" };
       const sanitizedName = path.basename(name);
-      const agentsDir = path.resolve(process.cwd(), ".agent", "agents");
+      const agentsDir = path.resolve(getAgentDir(), "agents");
       const agentPath = path.resolve(agentsDir, `${sanitizedName}.md`);
       // Path containment: ensure resolved path stays within agents directory
       if (!agentPath.startsWith(agentsDir)) throw { code: -32602, message: "Invalid agent name: path traversal detected" };
@@ -396,7 +542,7 @@ function handleRequest(req) {
 
     if (toolName === "list_tribunal_skills") {
       const fs = require("fs");
-      const skillsDir = path.join(process.cwd(), ".agent", "skills");
+      const skillsDir = path.join(getAgentDir(), "skills");
       if (!fs.existsSync(skillsDir)) return { content: [{ type: "text", text: "No skills found or .agent directory missing." }] };
       const skills = fs.readdirSync(skillsDir, { withFileTypes: true }).filter(d => d.isDirectory()).map(d => d.name);
       return { content: [{ type: "text", text: "Available Skills:\n- " + skills.join("\n- ") }] };
@@ -407,7 +553,7 @@ function handleRequest(req) {
       const name = req.params?.arguments?.name;
       if (!name || typeof name !== "string") throw { code: -32602, message: "Missing or invalid argument: name (string)" };
       const sanitizedName = path.basename(name);
-      const skillsDir = path.resolve(process.cwd(), ".agent", "skills");
+      const skillsDir = path.resolve(getAgentDir(), "skills");
       const skillPath = path.resolve(skillsDir, sanitizedName, "SKILL.md");
       // Path containment: ensure resolved path stays within skills directory
       if (!skillPath.startsWith(skillsDir)) throw { code: -32602, message: "Invalid skill name: path traversal detected" };
@@ -423,7 +569,7 @@ function handleRequest(req) {
 
       if (!task) throw { code: -32602, message: "Missing required argument: task" };
 
-      const agentDest = path.join(process.cwd(), ".agent");
+      const agentDest = getAgentDir();
       const fs = require("fs");
       if (!fs.existsSync(agentDest)) {
         return { content: [{ type: "text", text: "Error: .agent/ directory not found. Run `tk init` first." }] };
@@ -445,7 +591,7 @@ function handleRequest(req) {
         throw { code: -32602, message: "Missing or invalid required argument: query (string)" };
       }
       const budget = req.params?.arguments?.budget || 2000;
-      const agentDest = path.join(process.cwd(), ".agent");
+      const agentDest = getAgentDir();
       const fs = require("fs");
       if (!fs.existsSync(agentDest)) {
         return { content: [{ type: "text", text: "Error: .agent/ directory not found. Run `tk init` first." }] };
@@ -479,7 +625,7 @@ function handleRequest(req) {
       if (!validTypes.includes(memType)) {
         throw { code: -32602, message: `Invalid memory type: "${memType}". Must be one of: ${validTypes.join(", ")}` };
       }
-      const agentDest = path.join(process.cwd(), ".agent");
+      const agentDest = getAgentDir();
       const fs = require("fs");
       if (!fs.existsSync(agentDest)) {
         return { content: [{ type: "text", text: "Error: .agent/ directory not found. Run `tk init` first." }] };

package/bin/wrapper.js

@@ -26,6 +26,7 @@ const RUST_COMMANDS = new Set([
   "context-compress",
   "context-broker",
   "optimize-step",
+  "impact-tier",
 ]);
 
 
@@ -164,10 +165,12 @@ function main() {
       }
       // rustResult === false means spawn error; fall through to JS fallback
     } else {
-      // Warn if Rust command was requested but binary is missing
-      console.warn(
-        "\x1b[93m⚠ Rust binary not found in target/. Falling back to JS engine.\x1b[0m",
-      );
+      // Warn if Rust command was requested but binary is missing (in verbose mode)
+      if (process.env.TK_VERBOSE || process.env.VERBOSE) {
+        console.warn(
+          "\x1b[93m⚠ Rust binary not found in target/. Falling back to JS engine.\x1b[0m",
+        );
+      }
     }
   }
 

package/dist/cli.js

@@ -42,6 +42,15 @@ function parseArgs(argv) {
             args.flags.minimal = true;
             continue;
         }
+        if (arg.startsWith('--profile=')) {
+            args.flags.profile = arg.split('=').slice(1).join('=');
+            continue;
+        }
+        if (arg === '--profile') {
+            const idx = raw.indexOf('--profile');
+            args.flags.profile = raw[idx + 1] || 'full';
+            continue;
+        }
         if (arg === '--skip-update-check') {
             args.flags.skipUpdateCheck = true;
             continue;
@@ -112,6 +121,7 @@ function cmdHelp(quiet = false) {
     (0, logger_1.log)(cmd('context-compress', 'Compress a context file while retaining VERIFY comments'));
     (0, logger_1.log)(cmd('optimize-step', 'Apply bounded SkillOpt edits from a JSON payload'));
     (0, logger_1.log)(cmd('guardrail', 'Validate .agent/ integrity (phantom refs, count mismatches, drift)'));
+    (0, logger_1.log)(cmd('impact-tier', 'Classify task governance impact tier (0-3)'));
     (0, logger_1.log)(cmd('uninstall', 'Remove .agent/ folder from project'));
     console.log();
     (0, logger_1.log)((0, logger_1.bold)('  Options'));
@@ -126,6 +136,7 @@ function cmdHelp(quiet = false) {
     (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'));
+    (0, logger_1.log)(opt('--version, -v', 'Print installed version'));
     console.log();
     (0, logger_1.log)((0, logger_1.bold)('  Aliases'));
     (0, logger_1.log)(`  ${(0, logger_1.c)('gray', '─'.repeat(40))}`);
@@ -302,12 +313,21 @@ async function runWithUpdateCheck(command, flags) {
             cmdOptimizeStep(process.argv, quiet);
             break;
         }
+        case 'impact-tier': {
+            const cmdImpactTier = loadCmd('./commands/native', 'cmdImpactTier');
+            cmdImpactTier(process.argv, quiet);
+            break;
+        }
         case 'help':
         case '--help':
         case '-h':
         case null:
             cmdHelp(quiet);
             break;
+        case '--version':
+        case '-v':
+            (0, logger_1.log)(CURRENT_VERSION);
+            break;
         default:
             (0, logger_1.err)(`Unknown command: "${command}"`);
             console.log();

package/dist/commands/memory.js

@@ -43,8 +43,9 @@ function acquireLock(agentDest) {
             if (err.code !== 'EEXIST') {
                 throw err;
             }
-            const start = Date.now();
-            while (Date.now() - start < 50) {}
+            // Non-blocking sleep — avoids busy-wait event loop blocking
+            const waitBuf = new Int32Array(new SharedArrayBuffer(4));
+            Atomics.wait(waitBuf, 0, 0, 50);
         }
     }
     try {

package/dist/commands/native.js

@@ -219,10 +219,46 @@ function cmdOptimizeStep(processArgs, quiet = false) {
   console.log(JSON.stringify(result));
   return true;
 }
+function cmdImpactTier(processArgs, quiet = false) {
+  const args = processArgs.slice(3);
+  const files = getOption(args, ["--files"]) || "";
+  const lines = parseInt(getOption(args, ["--lines"]) || "0", 10);
+  const task = getOption(args, ["--task"]) || "";
+
+  const fileList = files ? files.split(",").map(f => f.trim()).filter(Boolean) : [];
+  const fileCount = fileList.length;
+
+  // Tier classification heuristics (mirrors Rust ImpactTier logic)
+  let tier = 0;
+  if (fileCount === 0 && lines <= 5) tier = 0;
+  else if (fileCount <= 1 && lines <= 50) tier = 1;
+  else if (fileCount <= 5 && lines <= 200) tier = 2;
+  else tier = 3;
+
+  // Check for high-risk patterns that force Tier 3
+  const highRiskPatterns = /\b(auth|migration|schema|security|password|token|jwt|rbac|permissions)\b/i;
+  const highRiskExtensions = /\.(sql|prisma|tf|tofu)$/i;
+  if (highRiskPatterns.test(task) || fileList.some(f => highRiskExtensions.test(f))) {
+    tier = Math.max(tier, 3);
+  }
+
+  const tierNames = ["Fast-Pass", "Express Pass", "Targeted Audit", "Full Gauntlet"];
+  const result = {
+    tier,
+    tier_name: tierNames[tier],
+    file_count: fileCount,
+    line_count: lines,
+    socratic_gate: tier >= 3 ? "required" : tier >= 2 ? "conditional" : "bypass",
+  };
+  if (!quiet) console.error(`✓ Impact Tier: ${tier} (${tierNames[tier]})`);
+  console.log(JSON.stringify(result));
+  return true;
+}
 
 module.exports = {
   cmdMinContext,
   cmdDagSchedule,
   cmdContextCompress,
   cmdOptimizeStep,
+  cmdImpactTier,
 };