tribunal-kit 6.0.1 → 8.0.0

package/dist/tui/wizard.js

@@ -0,0 +1,148 @@
+'use strict';
+
+/**
+ * Zero-dependency interactive terminal multi-select wizard.
+ * Handles keyboard navigation, space-to-toggle, and non-TTY fallback.
+ */
+
+const readline = require('readline');
+const { isTTY, hasColor, RGB, GLYPHS, color, bold } = require('./theme');
+
+class WizardPrompt {
+  displaySummary(question, options) {
+    const g = GLYPHS;
+    const prefix = color(RGB.AMBER, '?');
+    const boldQ = bold(question);
+    console.log(`  ${prefix} ${boldQ}`);
+
+    for (const opt of options) {
+      const check = opt.selected
+        ? color(RGB.EMERALD, g.check)
+        : color(RGB.ZINC_600, g.uncheck);
+
+      const labelColored = opt.selected
+        ? color(RGB.WHITE, opt.label)
+        : color(RGB.ZINC_500, opt.label);
+
+      const detailColored = color(RGB.ZINC_600, opt.detail || '');
+
+      console.log(`    ${check} ${labelColored} ${detailColored}`);
+    }
+
+    const hint = '[Space] Toggle · [Enter] Confirm · [A] Select All';
+    console.log(`  ${color(RGB.ZINC_600, hint)}`);
+    console.log();
+  }
+
+  async selectMultiple(question, initialOptions) {
+    if (!isTTY || !process.stdin.isTTY) {
+      this.displaySummary(question, initialOptions);
+      return initialOptions;
+    }
+
+    const options = initialOptions.map(opt => ({ ...opt }));
+    let cursor = 0;
+    const g = GLYPHS;
+
+    return new Promise(resolve => {
+      readline.emitKeypressEvents(process.stdin);
+      if (process.stdin.isTTY) {
+        process.stdin.setRawMode(true);
+      }
+      process.stdin.resume();
+
+      // Hide cursor
+      process.stdout.write('\x1b[?25l');
+
+      const render = (isFinal = false) => {
+        // Move back up lines if not initial render
+        const totalLines = options.length + 3;
+        
+        let out = '';
+        const prefix = color(RGB.AMBER, '?');
+        out += `  ${prefix} ${bold(question)}\n`;
+
+        options.forEach((opt, idx) => {
+          const isCursor = idx === cursor;
+          const pointer = isCursor ? color(RGB.FLAME, g.chevron) : ' ';
+          const check = opt.selected
+            ? color(RGB.EMERALD, g.check)
+            : color(RGB.ZINC_600, g.uncheck);
+
+          const labelColored = opt.selected
+            ? color(RGB.WHITE, bold(opt.label))
+            : color(RGB.ZINC_400, opt.label);
+
+          const detailColored = color(RGB.ZINC_600, opt.detail || '');
+          out += `  ${pointer} ${check} ${labelColored} ${detailColored}\n`;
+        });
+
+        if (isFinal) {
+          out += `  ${color(RGB.EMERALD, '✔ Configuration selected.')}\n`;
+        } else {
+          const hint = '[Space] Toggle · [Enter] Confirm · [A] All · [↑/↓] Move';
+          out += `  ${color(RGB.ZINC_600, hint)}\n`;
+        }
+
+        return { out, totalLines };
+      };
+
+      let renderedOnce = false;
+
+      const draw = (isFinal = false) => {
+        const { out } = render(isFinal);
+        if (renderedOnce) {
+          // Clear and rewrite lines
+          process.stdout.write(`\x1b[${options.length + 2}A\r`);
+        }
+        process.stdout.write(out);
+        renderedOnce = true;
+      };
+
+      draw();
+
+      const onKeypress = (str, key) => {
+        if (!key) return;
+
+        if (key.ctrl && key.name === 'c') {
+          cleanup();
+          process.exit(130);
+        }
+
+        if (key.name === 'up' || key.name === 'k') {
+          cursor = (cursor - 1 + options.length) % options.length;
+          draw();
+        } else if (key.name === 'down' || key.name === 'j') {
+          cursor = (cursor + 1) % options.length;
+          draw();
+        } else if (key.name === 'space') {
+          options[cursor].selected = !options[cursor].selected;
+          draw();
+        } else if (str === 'a' || str === 'A') {
+          const allSelected = options.every(o => o.selected);
+          options.forEach(o => (o.selected = !allSelected));
+          draw();
+        } else if (key.name === 'return' || key.name === 'enter') {
+          cleanup();
+          draw(true);
+          resolve(options);
+        }
+      };
+
+      const cleanup = () => {
+        process.stdin.removeListener('keypress', onKeypress);
+        if (process.stdin.isTTY) {
+          process.stdin.setRawMode(false);
+        }
+        process.stdin.pause();
+        process.stdout.write('\x1b[?25h'); // restore cursor
+      };
+
+      process.stdin.on('keypress', onKeypress);
+    });
+  }
+}
+
+module.exports = {
+  WizardPrompt,
+};

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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tribunal-kit",
-  "version": "6.0.1",
-  "description": "Your AI writes code that doesn't exist. Tribunal Kit stops it. The governance layer for AI coding agents — 51 specialists, 27 parallel reviewers, 183 skills, Rust core, MCP server. Works with Cursor, VSCode, Windsurf, Claude Code, and Aider.",
+  "version": "8.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",
@@ -43,13 +43,19 @@
     "ai-code-reviewer",
     "hallucination-mitigation",
     "autonomous-workflows",
-    "code-correctness"
+    "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",
@@ -63,26 +69,33 @@
   },
   "bin": {
     "tribunal-kit": "bin/wrapper.js",
-    "tk": "bin/wrapper.js"
+    "tk": "bin/wrapper.js",
+    "tk-proxy": "bin/tk-proxy.js",
+    "tk-adapt": "bin/adapter-install.js"
   },
   "files": [
     "bin/",
     "dist/",
     "scripts/",
     ".agent/",
+    ".claude/CLAUDE.md",
     "README.md",
     "LICENSE",
     "SECURITY.md",
     "CONTRIBUTING.md",
-    "mcp_config.json"
+    "mcp_config.json",
+    ".agent/config/plugin.json",
+    ".agent/config/system-prompt.md",
+    ".agent/config/slash-commands.json",
+    ".agent/config/specialist-registry.json"
   ],
   "engines": {
     "node": ">=18.0.0"
   },
   "scripts": {
-    "test": "npm run validate-payload && jest --runInBand --coverage",
-    "test:unit": "jest test/unit --coverage",
-    "test:integration": "jest test/integration --coverage",
+    "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",
@@ -90,11 +103,12 @@
     "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",
+    "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"
@@ -106,12 +120,12 @@
     "typescript": "^5.4.5"
   },
   "optionalDependencies": {
-    "@tribunal-kit/core-darwin-arm64": "^6.0.1",
-    "@tribunal-kit/core-darwin-x64": "^6.0.1",
-    "@tribunal-kit/core-linux-arm64": "^6.0.1",
-    "@tribunal-kit/core-linux-x64": "^6.0.1",
-    "@tribunal-kit/core-win32-arm64": "^6.0.1",
-    "@tribunal-kit/core-win32-x64": "^6.0.1"
+    "@tribunal-kit/core-darwin-arm64": "^8.0.0",
+    "@tribunal-kit/core-darwin-x64": "^8.0.0",
+    "@tribunal-kit/core-linux-arm64": "^8.0.0",
+    "@tribunal-kit/core-linux-x64": "^8.0.0",
+    "@tribunal-kit/core-win32-arm64": "^8.0.0",
+    "@tribunal-kit/core-win32-x64": "^8.0.0"
   },
   "jest": {
     "testMatch": [
@@ -124,5 +138,9 @@
       ".agent/scripts/**/*.js",
       "dist/**/*.js"
     ]
+  },
+  "dependencies": {
+    "better-sqlite3": "^13.0.3",
+    "zod": "^4.5.4"
   }
 }

package/scripts/benchmark.js

@@ -6,22 +6,22 @@
  * Run: node scripts/benchmark.js
  */
 
-const { spawnSync } = require("child_process");
-const path = require("path");
-const fs = require("fs");
-const os = require("os");
+const { spawnSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
 
 // ANSI colors
 const C = {
-  reset: "\x1b[0m",
-  bold: "\x1b[1m",
-  dim: "\x1b[2m",
-  red: "\x1b[91m",
-  green: "\x1b[92m",
-  yellow: "\x1b[93m",
-  cyan: "\x1b[96m",
-  white: "\x1b[97m",
-  gray: "\x1b[90m",
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  red: '\x1b[91m',
+  green: '\x1b[92m',
+  yellow: '\x1b[93m',
+  cyan: '\x1b[96m',
+  white: '\x1b[97m',
+  gray: '\x1b[90m',
 };
 
 function c(color, text) {
@@ -59,10 +59,10 @@ function benchmarkCommand(label, command, runs = 3) {
   return benchmark(
     label,
     () => {
-      spawnSync("node", command.split(" "), {
-        stdio: "pipe",
-        encoding: "utf8",
-        env: { ...process.env, TK_SKIP_UPDATE_CHECK: "1" },
+      spawnSync('node', command.split(' '), {
+        stdio: 'pipe',
+        encoding: 'utf8',
+        env: { ...process.env, TK_SKIP_UPDATE_CHECK: '1' },
       });
     },
     runs,
@@ -72,67 +72,50 @@ function benchmarkCommand(label, command, runs = 3) {
 async function main() {
   console.log();
   console.log(bold(`  ⚡ Tribunal-Kit Performance Benchmark`));
-  console.log(c("gray", `  ─────────────────────────────────────────`));
-  console.log(c("gray", `  Platform: ${os.platform()} ${os.arch()}`));
-  console.log(c("gray", `  Node: ${process.version}`));
-  console.log(
-    c(
-      "gray",
-      `  CPUs: ${os.cpus().length}x ${os.cpus()[0]?.model || "unknown"}`,
-    ),
-  );
-  console.log(c("gray", `  ─────────────────────────────────────────`));
+  console.log(c('gray', `  ─────────────────────────────────────────`));
+  console.log(c('gray', `  Platform: ${os.platform()} ${os.arch()}`));
+  console.log(c('gray', `  Node: ${process.version}`));
+  console.log(c('gray', `  CPUs: ${os.cpus().length}x ${os.cpus()[0]?.model || 'unknown'}`));
+  console.log(c('gray', `  ─────────────────────────────────────────`));
   console.log();
 
-  const cliPath = path.resolve(__dirname, "../bin/wrapper.js");
+  const cliPath = path.resolve(__dirname, '../bin/wrapper.js');
   const tempDir = path.join(os.tmpdir(), `tribunal-bench-${Date.now()}`);
   fs.mkdirSync(tempDir, { recursive: true });
 
   const results = [];
 
   // 1. Cold start (help)
-  console.log(c("cyan", "  ▸ Benchmarking: CLI cold-start (--help)"));
-  const helpResult = await benchmarkCommand(
-    "CLI cold-start (--help)",
-    `${cliPath} --help`,
-    5,
-  );
+  console.log(c('cyan', '  ▸ Benchmarking: CLI cold-start (--help)'));
+  const helpResult = await benchmarkCommand('CLI cold-start (--help)', `${cliPath} --help`, 5);
   results.push(helpResult);
 
   // 2. Status check
-  console.log(c("cyan", "  ▸ Benchmarking: tk status"));
-  const statusResult = await benchmarkCommand(
-    "Status check",
-    `${cliPath} status --quiet`,
-    5,
-  );
+  console.log(c('cyan', '  ▸ Benchmarking: tk status'));
+  const statusResult = await benchmarkCommand('Status check', `${cliPath} status --quiet`, 5);
   results.push(statusResult);
 
   // 3. Init (dry-run)
-  console.log(c("cyan", "  ▸ Benchmarking: tk init --dry-run"));
+  console.log(c('cyan', '  ▸ Benchmarking: tk init --dry-run'));
   const initResult = await benchmarkCommand(
-    "Init (dry-run)",
+    'Init (dry-run)',
     `${cliPath} init --dry-run --quiet --skip-update-check --path=${tempDir}`,
     3,
   );
   results.push(initResult);
 
   // 4. Init (real, to temp dir)
-  console.log(c("cyan", "  ▸ Benchmarking: tk init (real copy)"));
+  console.log(c('cyan', '  ▸ Benchmarking: tk init (real copy)'));
   const initRealResult = await benchmark(
-    "Init (full copy)",
+    'Init (full copy)',
     () => {
       const runDir = path.join(tempDir, `run-${Date.now()}`);
       fs.mkdirSync(runDir, { recursive: true });
-      spawnSync(
-        "node",
-        [cliPath, "init", "--quiet", "--skip-update-check", `--path=${runDir}`],
-        {
-          stdio: "pipe",
-          encoding: "utf8",
-          env: { ...process.env, TK_SKIP_UPDATE_CHECK: "1" },
-        },
-      );
+      spawnSync('node', [cliPath, 'init', '--quiet', '--skip-update-check', `--path=${runDir}`], {
+        stdio: 'pipe',
+        encoding: 'utf8',
+        env: { ...process.env, TK_SKIP_UPDATE_CHECK: '1' },
+      });
       // Cleanup
       try {
         fs.rmSync(runDir, { recursive: true, force: true });
@@ -143,35 +126,35 @@ async function main() {
   results.push(initRealResult);
 
   // 5. DAG scheduling benchmark
-  console.log(c("cyan", "  ▸ Benchmarking: DAG scheduling calculation"));
+  console.log(c('cyan', '  ▸ Benchmarking: DAG scheduling calculation'));
   const dagResult = await benchmark(
-    "DAG wave scheduling",
+    'DAG wave scheduling',
     () => {
       const workers = [
-        { task_id: "w1", dependencies: [] },
-        { task_id: "w2", dependencies: ["w1"] },
-        { task_id: "w3", dependencies: ["w1"] },
-        { task_id: "w4", dependencies: ["w2", "w3"] },
+        { task_id: 'w1', dependencies: [] },
+        { task_id: 'w2', dependencies: ['w1'] },
+        { task_id: 'w3', dependencies: ['w1'] },
+        { task_id: 'w4', dependencies: ['w2', 'w3'] },
       ];
       const inDegree = {};
       const adjList = {};
-      workers.forEach((w) => {
+      workers.forEach(w => {
         inDegree[w.task_id] = 0;
         adjList[w.task_id] = [];
       });
-      workers.forEach((w) => {
-        w.dependencies.forEach((dep) => {
+      workers.forEach(w => {
+        w.dependencies.forEach(dep => {
           adjList[dep].push(w.task_id);
           inDegree[w.task_id] += 1;
         });
       });
-      let currentWave = Object.keys(inDegree).filter((id) => inDegree[id] === 0);
+      let currentWave = Object.keys(inDegree).filter(id => inDegree[id] === 0);
       const waves = [];
       while (currentWave.length > 0) {
         waves.push(currentWave);
         const next = [];
-        currentWave.forEach((id) => {
-          adjList[id].forEach((nbr) => {
+        currentWave.forEach(id => {
+          adjList[id].forEach(nbr => {
             inDegree[nbr] -= 1;
             if (inDegree[nbr] === 0) next.push(nbr);
           });
@@ -184,12 +167,12 @@ async function main() {
   results.push(dagResult);
 
   // 6. Minimal Change Governance Engine benchmark
-  console.log(c("cyan", "  ▸ Benchmarking: Minimal Change Governance Engine"));
+  console.log(c('cyan', '  ▸ Benchmarking: Minimal Change Governance Engine'));
   const minResult = await benchmark(
-    "Minimal Change Audit",
+    'Minimal Change Audit',
     () => {
-      const minEngine = require("../.agent/scripts/minimal_change_engine");
-      minEngine.evaluateMinimalChange("add retry logic to API requests", {
+      const minEngine = require('../.agent/scripts/minimal_change_engine');
+      minEngine.evaluateMinimalChange('add retry logic to API requests', {
         files_added: 0,
         files_modified: 1,
         estimated_lines_added: 15,
@@ -199,39 +182,32 @@ async function main() {
   );
   results.push(minResult);
 
-
   // Print results table
   console.log();
   console.log(bold(`  Results`));
+  console.log(c('gray', `  ─────────────────────────────────────────────────────────`));
   console.log(
-    c("gray", `  ─────────────────────────────────────────────────────────`),
-  );
-  console.log(
-    `  ${c("white", "Operation".padEnd(30))} ${c("white", "Avg (ms)".padStart(10))} ${c("white", "Min".padStart(8))} ${c("white", "Max".padStart(8))}`,
-  );
-  console.log(
-    c("gray", `  ─────────────────────────────────────────────────────────`),
+    `  ${c('white', 'Operation'.padEnd(30))} ${c('white', 'Avg (ms)'.padStart(10))} ${c('white', 'Min'.padStart(8))} ${c('white', 'Max'.padStart(8))}`,
   );
+  console.log(c('gray', `  ─────────────────────────────────────────────────────────`));
 
   for (const r of results) {
-    const avgColor = r.avg < 100 ? "green" : r.avg < 500 ? "yellow" : "red";
+    const avgColor = r.avg < 100 ? 'green' : r.avg < 500 ? 'yellow' : 'red';
     console.log(
-      `  ${c("white", r.label.padEnd(30))} ${c(avgColor, String(Math.round(r.avg)).padStart(10))} ${c("gray", String(Math.round(r.min)).padStart(8))} ${c("gray", String(Math.round(r.max)).padStart(8))}`,
+      `  ${c('white', r.label.padEnd(30))} ${c(avgColor, String(Math.round(r.avg)).padStart(10))} ${c('gray', String(Math.round(r.min)).padStart(8))} ${c('gray', String(Math.round(r.max)).padStart(8))}`,
     );
   }
 
-  console.log(
-    c("gray", `  ─────────────────────────────────────────────────────────`),
-  );
+  console.log(c('gray', `  ─────────────────────────────────────────────────────────`));
   console.log();
 
   // Write results to JSON for CI/comparison
-  const outputPath = path.resolve(__dirname, "../benchmark-results.json");
+  const outputPath = path.resolve(__dirname, '../benchmark-results.json');
   const outputData = {
     timestamp: new Date().toISOString(),
     platform: `${os.platform()}-${os.arch()}`,
     node: process.version,
-    results: results.map((r) => ({
+    results: results.map(r => ({
       label: r.label,
       avg_ms: Math.round(r.avg),
       min_ms: Math.round(r.min),
@@ -240,7 +216,7 @@ async function main() {
     })),
   };
   fs.writeFileSync(outputPath, JSON.stringify(outputData, null, 2));
-  console.log(c("green", `  ✔ Results saved to benchmark-results.json`));
+  console.log(c('green', `  ✔ Results saved to benchmark-results.json`));
 
   // Cleanup temp
   try {
@@ -249,7 +225,7 @@ async function main() {
   console.log();
 }
 
-main().catch((err) => {
+main().catch(err => {
   console.error(`Benchmark failed: ${err.message}`);
   process.exit(1);
 });

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