tribunal-kit 7.0.0 → 9.0.0

package/dist/utils/helpers.js

@@ -43,47 +43,11 @@ function getKitAgent() {
     }
     return agentDir;
 }
+const { renderBanner } = require('../tui/banner');
+
 function banner(quiet) {
-    if (quiet)
-        return;
-    // Big ASCII art (TRIBUNAL-KIT)
-    const art = String.raw `
-████████╗██████╗ ██╗██████╗ ██╗   ██╗███╗   ██╗ █████╗ ██╗      ██╗  ██╗██╗████████╗
-╚══██╔══╝██╔══██╗██║██╔══██╗██║   ██║████╗  ██║██╔══██╗██║      ██║ ██╔╝██║╚══██╔══╝
-   ██║   ██████╔╝██║██████╔╝██║   ██║██╔██╗ ██║███████║██║█████╗█████╔╝ ██║   ██║   
-   ██║   ██╔══██╗██║██╔══██╗██║   ██║██║╚██╗██║██╔══██║██║╚════╝██╔═██╗ ██║   ██║   
-   ██║   ██║  ██║██║██████╔╝╚██████╔╝██║ ╚████║██║  ██║███████╗ ██║  ██╗██║   ██║   
-   ╚═╝   ╚═╝  ╚═╝╚═╝╚═════╝  ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝╚══════╝ ╚═╝  ╚═╝╚═╝   ╚═╝   `.split('\n').filter(Boolean);
-    console.log();
-    for (const line of art) {
-        let gradientLine = '  \x1b[1m';
-        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 += '\x1b[0m';
-        (0, logger_1.log)(gradientLine);
-    }
-    console.log();
-    // Subtitle strip
-    const W = 84;
-    const plainSub = '🛡️  ANTI-HALLUCINATION AGENT SYSTEM';
-    const coloredSub = `${(0, logger_1.bold)((0, logger_1.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));
-    (0, logger_1.log)(`  ${(0, logger_1.c)('gray', `✦  ${'━'.repeat(W - 6)}  ✦`)}`);
-    (0, logger_1.log)(`  ${centred}`);
-    (0, logger_1.log)(`  ${(0, logger_1.c)('gray', `✦  ${'━'.repeat(W - 6)}  ✦`)}`);
-    console.log();
+    if (quiet) return;
+    const PKG = require('../../package.json');
+    renderBanner(PKG.version, quiet);
 }
 

package/gemini-extension.json

@@ -0,0 +1,6 @@
+{
+  "name": "tribunal-kit",
+  "description": "Enterprise-grade governance layer and anti-hallucination engine: 52 specialists, 28 parallel reviewers, Rust core, and SDD workflows.",
+  "version": "9.0.0",
+  "contextFileName": ".agent/rules/GEMINI.md"
+}

package/hooks/hooks-cursor.json

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CURSOR_PLUGIN_ROOT}/hooks/session-start.js\"",
+            "async": false
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/hooks.json

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/session-start.js\"",
+            "async": false
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/session-start.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+/**
+ * Cross-Platform SessionStart Hook for Tribunal Kit
+ *
+ * Injects Tribunal Kit master governance instructions into the host agent session
+ * on startup, clear, and context compaction.
+ *
+ * Supports:
+ * - Cursor Agent (emits additional_context)
+ * - Claude Code (emits hookSpecificOutput.additionalContext)
+ * - GitHub Copilot CLI / Standard Agent SDK (emits additionalContext)
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+function getPluginRoot() {
+  if (process.env.CURSOR_PLUGIN_ROOT) return process.env.CURSOR_PLUGIN_ROOT;
+  if (process.env.CLAUDE_PLUGIN_ROOT) return process.env.CLAUDE_PLUGIN_ROOT;
+  return path.resolve(__dirname, '..');
+}
+
+function loadMasterRules(pluginRoot) {
+  const candidates = [
+    path.join(pluginRoot, '.agent', 'rules', 'GEMINI.md'),
+    path.join(pluginRoot, '.agent', 'config', 'system-prompt.md'),
+    path.join(pluginRoot, '.cursorrules'),
+  ];
+
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) {
+      try {
+        return fs.readFileSync(candidate, 'utf8');
+      } catch (_err) {
+        // Continue to next candidate
+      }
+    }
+  }
+
+  return '# Tribunal Kit Master Governance Active\nEnforce strict TDD, out-of-band context isolation, and parallel reviewer waves.';
+}
+
+function main() {
+  const pluginRoot = getPluginRoot();
+  const rules = loadMasterRules(pluginRoot);
+
+  const sessionContext = [
+    '<EXTREMELY_IMPORTANT>',
+    'Tribunal Kit Master Governance is active.',
+    'You are operating under the Tribunal Anti-Hallucination & Subagent-Driven Development (SDD) protocol.',
+    'Enforce: Iron Law of TDD (Red-Green-Refactor), 28-Specialist Review Waves, Out-of-Band Context Isolation, and Zero Placeholders.',
+    '',
+    rules,
+    '</EXTREMELY_IMPORTANT>',
+  ].join('\n');
+
+  let outputObj;
+  if (process.env.CURSOR_PLUGIN_ROOT) {
+    // Cursor expects snake_case additional_context
+    outputObj = { additional_context: sessionContext };
+  } else if (process.env.CLAUDE_PLUGIN_ROOT && !process.env.COPILOT_CLI) {
+    // Claude Code expects nested hookSpecificOutput
+    outputObj = {
+      hookSpecificOutput: {
+        hookEventName: 'SessionStart',
+        additionalContext: sessionContext,
+      },
+    };
+  } else {
+    // Standard SDK / Copilot CLI
+    outputObj = { additionalContext: sessionContext };
+  }
+
+  process.stdout.write(JSON.stringify(outputObj, null, 2) + '\n');
+}
+
+main();

package/package.json

@@ -1,129 +1,165 @@
-{
-  "name": "tribunal-kit",
-  "version": "7.0.0",
-  "description": "Your AI writes code that doesn't exist. Tribunal Kit stops it. The governance layer for AI coding agents — 52 specialists, 28 parallel reviewers, 183 skills, Rust core, MCP server. Works with Cursor, VSCode, Windsurf, Claude Code, and Aider.",
-  "keywords": [
-    "ai",
-    "ai-agent",
-    "long-running-agents",
-    "agent",
-    "agents",
-    "multi-agent",
-    "agentic",
-    "swarm",
-    "orchestration",
-    "llm",
-    "anti-hallucination",
-    "hallucination",
-    "code-review",
-    "code-quality",
-    "cursor",
-    "cursor-rules",
-    "cursorrules",
-    "windsurf",
-    "copilot",
-    "cline",
-    "gemini",
-    "antigravity",
-    "tribunal",
-    "mcp",
-    "model-context-protocol",
-    "cli",
-    "devtools",
-    "ai-coding",
-    "autonomous-agents",
-    "coding-assistant",
-    "automation",
-    "model-context-protocol-server",
-    "mcp-server",
-    "claude-code",
-    "aider",
-    "cursor-rules-generator",
-    "agentic-ai",
-    "ai-code-reviewer",
-    "hallucination-mitigation",
-    "autonomous-workflows",
-    "code-correctness"
-  ],
-  "homepage": "https://github.com/Harmitx7/tribunal-kit",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Harmitx7/tribunal-kit.git"
-  },
-  "license": "MIT",
-  "types": "dist/index.d.ts",
-  "main": "dist/cli.js",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/esm/index.mjs",
-      "require": "./dist/cli.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "bin": {
-    "tribunal-kit": "bin/wrapper.js",
-    "tk": "bin/wrapper.js"
-  },
-  "files": [
-    "bin/",
-    "dist/",
-    "scripts/",
-    ".agent/",
-    "README.md",
-    "LICENSE",
-    "SECURITY.md",
-    "CONTRIBUTING.md",
-    "mcp_config.json"
-  ],
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "scripts": {
-    "test": "npm run validate-payload && jest --runInBand --coverage --forceExit",
-    "test:unit": "jest test/unit --coverage --forceExit",
-    "test:integration": "jest test/integration --coverage --forceExit",
-    "preversion": "node scripts/sync-version.js",
-    "version": "node scripts/changelog.js && git add CHANGELOG.md",
-    "changelog": "node scripts/changelog.js",
-    "changelog:preview": "node scripts/changelog.js --preview",
-    "sync": "node scripts/sync-version.js",
-    "validate-payload": "node scripts/validate-payload.js",
-    "benchmark": "node scripts/benchmark.js",
-    "benchmark:stress": "node scripts/stress_benchmark.js",
-    "benchmark:rust": "cargo build --release && node scripts/benchmark.js",
-    "build:rust": "cargo build --release",
-    "build:core": "cargo build --release --manifest-path crates/core/Cargo.toml",
-    "test:rust": "cargo test --manifest-path crates/core/Cargo.toml",
-    "test:all": "npm run validate-payload && npm run test:rust && jest --runInBand --coverage --forceExit",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "build": "npm run build:rust"
-  },
-  "devDependencies": {
-    "eslint": "^9.1.1",
-    "jest": "^30.4.2",
-    "prettier": "^3.2.5",
-    "typescript": "^5.4.5"
-  },
-  "optionalDependencies": {
-    "@tribunal-kit/core-darwin-arm64": "^7.0.0",
-    "@tribunal-kit/core-darwin-x64": "^7.0.0",
-    "@tribunal-kit/core-linux-arm64": "^7.0.0",
-    "@tribunal-kit/core-linux-x64": "^7.0.0",
-    "@tribunal-kit/core-win32-arm64": "^7.0.0",
-    "@tribunal-kit/core-win32-x64": "^7.0.0"
-  },
-  "jest": {
-    "testMatch": [
-      "**/test/**/*.test.js"
-    ],
-    "testEnvironment": "node",
-    "coverageDirectory": "coverage",
-    "collectCoverageFrom": [
-      "bin/**/*.js",
-      ".agent/scripts/**/*.js",
-      "dist/**/*.js"
-    ]
-  }
-}
+{
+  "name": "tribunal-kit",
+  "version": "9.0.0",
+  "description": "Your AI writes code that doesn't exist. Tribunal Kit stops it. The governance layer for AI coding agents — 52 specialists, 28 parallel reviewers, 184 skills, Rust core, MCP server. Works with Cursor, VSCode, Windsurf, Claude Code, and Aider.",
+  "keywords": [
+    "ai",
+    "ai-agent",
+    "long-running-agents",
+    "agent",
+    "agents",
+    "multi-agent",
+    "agentic",
+    "swarm",
+    "orchestration",
+    "llm",
+    "anti-hallucination",
+    "hallucination",
+    "code-review",
+    "code-quality",
+    "cursor",
+    "cursor-rules",
+    "cursorrules",
+    "windsurf",
+    "copilot",
+    "cline",
+    "gemini",
+    "antigravity",
+    "tribunal",
+    "mcp",
+    "model-context-protocol",
+    "cli",
+    "devtools",
+    "ai-coding",
+    "autonomous-agents",
+    "coding-assistant",
+    "automation",
+    "model-context-protocol-server",
+    "mcp-server",
+    "claude-code",
+    "aider",
+    "cursor-rules-generator",
+    "agentic-ai",
+    "ai-code-reviewer",
+    "hallucination-mitigation",
+    "autonomous-workflows",
+    "code-correctness",
+    "claude-code-plugin",
+    "claude-plugin"
+  ],
+  "homepage": "https://github.com/Harmitx7/tribunal-kit",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Harmitx7/tribunal-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Harmitx7/tribunal-kit/issues"
+  },
+  "author": "Harmitx7",
+  "license": "MIT",
+  "types": "dist/index.d.ts",
+  "main": "dist/cli.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/esm/index.mjs",
+      "require": "./dist/cli.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "tribunal-kit": "bin/wrapper.js",
+    "tk": "bin/wrapper.js",
+    "tk-proxy": "bin/tk-proxy.js",
+    "tk-adapt": "bin/adapter-install.js"
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "scripts/",
+    "hooks/",
+    ".claude-plugin/",
+    ".cursor-plugin/",
+    ".codex-plugin/",
+    ".devin-plugin/",
+    ".hermes-plugin/",
+    ".kimi-plugin/",
+    ".opencode/",
+    ".agents/",
+    ".pi/",
+    "gemini-extension.json",
+    ".agent/",
+    ".claude/CLAUDE.md",
+    "README.md",
+    "LICENSE",
+    "SECURITY.md",
+    "CONTRIBUTING.md",
+    "mcp_config.json",
+    ".agent/config/plugin.json",
+    ".agent/config/system-prompt.md",
+    ".agent/config/slash-commands.json",
+    ".agent/config/specialist-registry.json"
+  ],
+  "pi": {
+    "extensions": [
+      "./.pi/extensions/tribunal.ts"
+    ],
+    "skills": [
+      "./.agent/skills"
+    ]
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "test": "npm run validate-payload && jest --runInBand --coverage --forceExit",
+    "test:unit": "jest test/unit --coverage --forceExit",
+    "test:integration": "jest test/integration --coverage --forceExit",
+    "preversion": "node scripts/sync-version.js",
+    "version": "node scripts/changelog.js && git add CHANGELOG.md",
+    "changelog": "node scripts/changelog.js",
+    "changelog:preview": "node scripts/changelog.js --preview",
+    "sync": "node scripts/sync-version.js",
+    "validate-payload": "node scripts/validate-payload.js",
+    "benchmark": "node scripts/benchmark.js",
+    "benchmark:stress": "node scripts/stress_benchmark.js",
+    "benchmark:rust": "cargo build --release && node scripts/benchmark.js",
+    "build:rust": "cargo build --release",
+    "build:core": "cargo build --release --manifest-path crates/core/Cargo.toml",
+    "test:rust": "cargo test --manifest-path crates/core/Cargo.toml",
+    "test:all": "npm run validate-payload && npm run test:rust && jest --runInBand --coverage --forceExit",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "build": "npm run build:rust"
+  },
+  "devDependencies": {
+    "eslint": "^9.1.1",
+    "jest": "^30.4.2",
+    "prettier": "^3.2.5",
+    "typescript": "^5.4.5"
+  },
+  "optionalDependencies": {
+    "@tribunal-kit/core-darwin-arm64": "^9.0.0",
+    "@tribunal-kit/core-darwin-x64": "^9.0.0",
+    "@tribunal-kit/core-linux-arm64": "^9.0.0",
+    "@tribunal-kit/core-linux-x64": "^9.0.0",
+    "@tribunal-kit/core-win32-arm64": "^9.0.0",
+    "@tribunal-kit/core-win32-x64": "^9.0.0"
+  },
+  "jest": {
+    "testMatch": [
+      "**/test/**/*.test.js"
+    ],
+    "testEnvironment": "node",
+    "coverageDirectory": "coverage",
+    "collectCoverageFrom": [
+      "bin/**/*.js",
+      ".agent/scripts/**/*.js",
+      "dist/**/*.js"
+    ]
+  },
+  "dependencies": {
+    "better-sqlite3": "^13.0.3",
+    "zod": "^4.5.4"
+  }
+}

package/scripts/audit_skill_sdo.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+/**
+ * Skill Discovery Optimization (SDO) Linter for Tribunal-Kit
+ *
+ * Scans all skills in .agent/skills/ to ensure their frontmatter descriptions
+ * follow the SDO invariant:
+ * - Must describe *when to trigger* (symptoms, contexts, conditions)
+ * - Must NOT summarize the internal workflow or process (which causes LLMs to skim/hallucinate)
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const SKILLS_DIR = path.resolve(__dirname, '..', '.agent', 'skills');
+
+function parseFrontmatter(content) {
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!match) return null;
+
+  const yamlBlock = match[1];
+  const nameMatch = yamlBlock.match(/^name:\s*(.+)$/m);
+  const descMatch = yamlBlock.match(/^description:\s*(.+)$/m);
+
+  return {
+    name: nameMatch ? nameMatch[1].trim().replace(/^["']|["']$/g, '') : null,
+    description: descMatch ? descMatch[1].trim().replace(/^["']|["']$/g, '') : null,
+  };
+}
+
+function auditSkills() {
+  if (!fs.existsSync(SKILLS_DIR)) {
+    console.error(`✖ Skills directory not found: ${SKILLS_DIR}`);
+    process.exit(1);
+  }
+
+  const entries = fs.readdirSync(SKILLS_DIR, { withFileTypes: true });
+  const skillDirs = entries.filter(e => e.isDirectory()).map(e => e.name);
+
+  let totalSkills = 0;
+  let validSkills = 0;
+  const warnings = [];
+
+  for (const dir of skillDirs) {
+    const skillMdPath = path.join(SKILLS_DIR, dir, 'SKILL.md');
+    if (!fs.existsSync(skillMdPath)) continue;
+
+    totalSkills++;
+    const content = fs.readFileSync(skillMdPath, 'utf8');
+    const fm = parseFrontmatter(content);
+
+    if (!fm || !fm.description) {
+      warnings.push({ skill: dir, issue: 'Missing frontmatter description' });
+      continue;
+    }
+
+    const desc = fm.description;
+    const isTriggerFocused = desc.toLowerCase().includes('use when') || 
+                             desc.toLowerCase().includes('activate when') ||
+                             desc.toLowerCase().includes('when ');
+
+    if (!isTriggerFocused) {
+      warnings.push({
+        skill: dir,
+        issue: 'Description does not explicitly specify trigger condition (should start with "Use when...")',
+        description: desc.slice(0, 80) + '...',
+      });
+    } else {
+      validSkills++;
+    }
+  }
+
+  console.log(`\n🔍 Skill Discovery Optimization (SDO) Audit Results:`);
+  console.log(`  Total Skills Analyzed: ${totalSkills}`);
+  console.log(`  SDO Trigger-Compliant: ${validSkills}`);
+  console.log(`  Advisory Warnings:     ${warnings.length}\n`);
+
+  if (warnings.length > 0) {
+    console.log(`⚠️  Advisory Sample (first 5):`);
+    for (const w of warnings.slice(0, 5)) {
+      console.log(`  - [${w.skill}]: ${w.issue}`);
+    }
+  }
+
+  console.log(`\n✔ SDO audit complete. System has ${totalSkills} searchable skills.\n`);
+}
+
+auditSkills();

package/scripts/build-graph.js

@@ -0,0 +1,71 @@
+const { spawn } = require('child_process');
+const path = require('path');
+const os = require('os');
+const fs = require('fs');
+
+async function buildSemanticGraph(targetPath = process.cwd()) {
+  return new Promise((resolve, reject) => {
+    // Determine platform-specific binary
+    const platform = os.platform();
+    const _arch = os.arch();
+
+    let binaryName = 'tribunal-core';
+    if (platform === 'win32') binaryName += '.exe';
+
+    // For development, try to use the locally compiled debug/release binary
+    let binaryPath = path.join(__dirname, '..', 'target', 'release', binaryName);
+    if (!fs.existsSync(binaryPath)) {
+      binaryPath = path.join(__dirname, '..', 'target', 'debug', binaryName);
+    }
+
+    if (!fs.existsSync(binaryPath)) {
+      console.error("Tribunal Core binary not found. Please run 'npm run build:core'.");
+      return reject(new Error('Tribunal Core binary not found.'));
+    }
+
+    console.log(`Building Semantic Context Graph for ${targetPath}...`);
+
+    const coreProcess = spawn(binaryPath, ['graph', targetPath], {
+      stdio: ['ignore', 'pipe', 'pipe'],
+    });
+
+    let stdoutData = '';
+    let stderrData = '';
+
+    coreProcess.stdout.on('data', data => {
+      stdoutData += data.toString();
+    });
+
+    coreProcess.stderr.on('data', data => {
+      stderrData += data.toString();
+    });
+
+    coreProcess.on('close', code => {
+      if (code !== 0) {
+        console.error(`Graph generation failed with code ${code}`);
+        console.error(stderrData);
+        return reject(new Error(`Graph generation failed: ${stderrData}`));
+      }
+
+      try {
+        const result = JSON.parse(stdoutData.trim());
+        console.log(`Graph built successfully: ${result.nodes} nodes parsed.`);
+        console.log(`Graph saved to: ${result.graph_path}`);
+        resolve(result);
+      } catch (err) {
+        console.error('Failed to parse core engine output:', stdoutData);
+        reject(err);
+      }
+    });
+  });
+}
+
+// Allow running directly from CLI
+if (require.main === module) {
+  const targetDir = process.argv[2] || process.cwd();
+  buildSemanticGraph(targetDir).catch(_err => {
+    process.exit(1);
+  });
+}
+
+module.exports = { buildSemanticGraph };