tribunal-kit 9.2.4 → 9.2.6

package/scripts/benchmark.js

@@ -1,231 +0,0 @@
-#!/usr/bin/env node
-/**
- * Tribunal-Kit Performance Benchmark
- *
- * Measures and reports performance metrics for key operations.
- * Run: node scripts/benchmark.js
- */
-
-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',
-};
-
-function c(color, text) {
-  return `${C[color]}${text}${C.reset}`;
-}
-function bold(text) {
-  return `${C.bold}${text}${C.reset}`;
-}
-
-/**
- * Time a command execution in milliseconds.
- * @param {string} label - Description of the benchmark
- * @param {function} fn - Function to benchmark
- * @param {number} [runs=3] - Number of runs for averaging
- * @returns {{ label: string, avg: number, min: number, max: number, runs: number }}
- */
-async function benchmark(label, fn, runs = 3) {
-  const times = [];
-  for (let i = 0; i < runs; i++) {
-    const start = performance.now();
-    await fn();
-    const end = performance.now();
-    times.push(end - start);
-  }
-  const avg = times.reduce((a, b) => a + b, 0) / times.length;
-  const min = Math.min(...times);
-  const max = Math.max(...times);
-  return { label, avg, min, max, runs };
-}
-
-/**
- * Time a shell command.
- */
-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' },
-      });
-    },
-    runs,
-  );
-}
-
-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();
-
-  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);
-  results.push(helpResult);
-
-  // 2. Status check
-  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'));
-  const initResult = await benchmarkCommand(
-    '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)'));
-  const initRealResult = await benchmark(
-    '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' },
-      });
-      // Cleanup
-      try {
-        fs.rmSync(runDir, { recursive: true, force: true });
-      } catch {}
-    },
-    3,
-  );
-  results.push(initRealResult);
-
-  // 5. DAG scheduling benchmark
-  console.log(c('cyan', '  ▸ Benchmarking: DAG scheduling calculation'));
-  const dagResult = await benchmark(
-    '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'] },
-      ];
-      const inDegree = {};
-      const adjList = {};
-      workers.forEach(w => {
-        inDegree[w.task_id] = 0;
-        adjList[w.task_id] = [];
-      });
-      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);
-      const waves = [];
-      while (currentWave.length > 0) {
-        waves.push(currentWave);
-        const next = [];
-        currentWave.forEach(id => {
-          adjList[id].forEach(nbr => {
-            inDegree[nbr] -= 1;
-            if (inDegree[nbr] === 0) next.push(nbr);
-          });
-        });
-        currentWave = next;
-      }
-    },
-    100,
-  );
-  results.push(dagResult);
-
-  // 6. Minimal Change Governance Engine benchmark
-  console.log(c('cyan', '  ▸ Benchmarking: Minimal Change Governance Engine'));
-  const minResult = await benchmark(
-    'Minimal Change Audit',
-    () => {
-      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,
-      });
-    },
-    20,
-  );
-  results.push(minResult);
-
-  // Print results table
-  console.log();
-  console.log(bold(`  Results`));
-  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', `  ─────────────────────────────────────────────────────────`));
-
-  for (const r of results) {
-    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))}`,
-    );
-  }
-
-  console.log(c('gray', `  ─────────────────────────────────────────────────────────`));
-  console.log();
-
-  // Write results to JSON for CI/comparison
-  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 => ({
-      label: r.label,
-      avg_ms: Math.round(r.avg),
-      min_ms: Math.round(r.min),
-      max_ms: Math.round(r.max),
-      runs: r.runs,
-    })),
-  };
-  fs.writeFileSync(outputPath, JSON.stringify(outputData, null, 2));
-  console.log(c('green', `  ✔ Results saved to benchmark-results.json`));
-
-  // Cleanup temp
-  try {
-    fs.rmSync(tempDir, { recursive: true, force: true });
-  } catch {}
-  console.log();
-}
-
-main().catch(err => {
-  console.error(`Benchmark failed: ${err.message}`);
-  process.exit(1);
-});

package/scripts/build-graph.js

@@ -1,71 +0,0 @@
-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 };

package/scripts/changelog.js

@@ -1,190 +0,0 @@
-#!/usr/bin/env node
-/**
- * changelog.js — Auto-generate CHANGELOG from git history
- *
- * Categorizes commits by conventional commit type:
- *   feat:     → ✨ Features
- *   fix:      → 🐛 Bug Fixes
- *   perf:     → ⚡ Performance
- *   docs:     → 📝 Documentation
- *   test:     → ✅ Tests
- *   refactor: → ♻️ Refactors
- *   chore:    → 🔧 Chores
- *   BREAKING: → 💥 Breaking Changes
- *
- * Usage:
- *   node scripts/changelog.js                  → Generate full changelog
- *   node scripts/changelog.js --preview        → Preview unreleased changes
- *   node scripts/changelog.js --since v4.1.0   → Changes since a specific tag
- */
-
-'use strict';
-
-const { execSync } = require('child_process');
-const fs = require('fs');
-const path = require('path');
-
-const PKG = require(path.resolve(__dirname, '..', 'package.json'));
-const CHANGELOG_PATH = path.resolve(__dirname, '..', 'CHANGELOG.md');
-
-// ── Commit Categories ────────────────────────────────────
-const CATEGORIES = {
-  feat: { emoji: '✨', title: 'Features' },
-  fix: { emoji: '🐛', title: 'Bug Fixes' },
-  perf: { emoji: '⚡', title: 'Performance' },
-  docs: { emoji: '📝', title: 'Documentation' },
-  test: { emoji: '✅', title: 'Tests' },
-  refactor: { emoji: '♻️', title: 'Refactors' },
-  chore: { emoji: '🔧', title: 'Chores' },
-  ci: { emoji: '🏗️', title: 'CI/CD' },
-  style: { emoji: '🎨', title: 'Style' },
-  breaking: { emoji: '💥', title: 'Breaking Changes' },
-};
-
-// ── Git Helpers ──────────────────────────────────────────
-function git(cmd) {
-  try {
-    return execSync(`git ${cmd}`, { encoding: 'utf8', timeout: 10000 }).trim();
-  } catch {
-    return '';
-  }
-}
-
-function getLatestTag() {
-  return (
-    git('describe --tags --abbrev=0 2>nul') || git('describe --tags --abbrev=0 2>/dev/null') || ''
-  );
-}
-
-function getCommits(since) {
-  const range = since ? `${since}..HEAD` : 'HEAD';
-  const MAX_COMMITS = 500;
-  const format = '--format=%H||%s||%an||%ai';
-  const raw = git(`log ${range} ${format} --no-merges -n ${MAX_COMMITS}`);
-  if (!raw) return [];
-
-  return raw
-    .replace(/\r/g, '')
-    .split('\n')
-    .filter(line => line.includes('||'))
-    .map(line => {
-      const [hash, subject = '', author = '', date = ''] = line.split('||');
-      return {
-        hash: hash?.replace(/^"/, '').slice(0, 7),
-        subject: subject.trim(),
-        author: author.trim(),
-        date: date?.replace(/"$/, '').slice(0, 10),
-      };
-    });
-}
-
-function categorize(subject = '') {
-  const lower = (subject || '').toLowerCase();
-
-  // Check for BREAKING CHANGE
-  if (lower.includes('breaking') || lower.includes('!:')) {
-    return 'breaking';
-  }
-
-  // Match conventional commit prefix
-  const match = (subject || '').match(/^(\w+)(?:\(.+?\))?:\s*/);
-  if (match) {
-    const type = match[1].toLowerCase();
-    if (CATEGORIES[type]) return type;
-  }
-
-  // Heuristic fallback
-  if (lower.includes('fix') || lower.includes('bug')) return 'fix';
-  if (lower.includes('add') || lower.includes('new') || lower.includes('feat')) return 'feat';
-  if (lower.includes('doc') || lower.includes('readme')) return 'docs';
-  if (lower.includes('test')) return 'test';
-  if (lower.includes('refactor') || lower.includes('clean')) return 'refactor';
-  if (lower.includes('perf') || lower.includes('optim')) return 'perf';
-  if (lower.includes('ci') || lower.includes('workflow')) return 'ci';
-
-  return 'chore';
-}
-
-// ── Changelog Generation ─────────────────────────────────
-function generateChangelog(commits, version, date) {
-  const grouped = {};
-  for (const commit of commits) {
-    const cat = categorize(commit.subject);
-    if (!grouped[cat]) grouped[cat] = [];
-    // Strip conventional prefix for cleaner display
-    const clean = (commit.subject || '').replace(/^\w+(\(.+?\))?:\s*/, '');
-    grouped[cat].push({ ...commit, clean });
-  }
-
-  let md = `## [${version}] — ${date}\n\n`;
-
-  // Breaking changes first
-  const order = [
-    'breaking',
-    'feat',
-    'fix',
-    'perf',
-    'refactor',
-    'docs',
-    'test',
-    'ci',
-    'style',
-    'chore',
-  ];
-  for (const cat of order) {
-    if (!grouped[cat] || grouped[cat].length === 0) continue;
-    const { emoji, title } = CATEGORIES[cat];
-    md += `### ${emoji} ${title}\n\n`;
-    for (const c of grouped[cat]) {
-      md += `- ${c.clean} (\`${c.hash}\`)\n`;
-    }
-    md += '\n';
-  }
-
-  return md;
-}
-
-// ── Main ─────────────────────────────────────────────────
-function main() {
-  const args = process.argv.slice(2);
-  const isPreview = args.includes('--preview');
-  const sinceIdx = args.indexOf('--since');
-  const sinceTag = sinceIdx !== -1 ? args[sinceIdx + 1] : null;
-
-  const since = sinceTag || getLatestTag();
-  const commits = getCommits(since);
-
-  if (commits.length === 0) {
-    console.log('  ℹ️  No new commits found since', since || 'beginning');
-    process.exit(0);
-  }
-
-  const today = new Date().toISOString().slice(0, 10);
-  const version = isPreview ? 'Unreleased' : PKG.version;
-
-  const changelog = generateChangelog(commits, version, today);
-
-  if (isPreview) {
-    console.log('\n  📋 Changelog Preview\n  ' + '─'.repeat(40) + '\n');
-    console.log(changelog);
-    console.log(`  📊 ${commits.length} commits since ${since || 'initial commit'}`);
-    return;
-  }
-
-  // Write or prepend to CHANGELOG.md
-  const header = `# Changelog\n\nAll notable changes to Tribunal Kit are documented here.\nFormat follows [Keep a Changelog](https://keepachangelog.com/).\n\n`;
-
-  let existing = '';
-  if (fs.existsSync(CHANGELOG_PATH)) {
-    existing = fs.readFileSync(CHANGELOG_PATH, 'utf8');
-    // Remove existing header
-    existing = existing.replace(/^# Changelog[\s\S]*?(?=## )/, '');
-  }
-
-  const full = header + changelog + existing;
-  fs.writeFileSync(CHANGELOG_PATH, full, 'utf8');
-
-  console.log(`  ✔ CHANGELOG.md updated — v${version} (${commits.length} commits)`);
-}
-
-main();

package/scripts/clean-pycache.js

@@ -1,42 +0,0 @@
-#!/usr/bin/env node
-/**
- * clean-pycache.js — Removes Python bytecode and __pycache__ directories.
- * Ensures clean npm tarballs without platform-specific Python artifacts.
- */
-
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-
-const ROOT = path.resolve(__dirname, '..');
-const TARGET_DIR = path.join(ROOT, '.agent');
-
-let removedCount = 0;
-
-function cleanRecursively(dir) {
-  if (!fs.existsSync(dir)) return;
-
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    const fullPath = path.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      if (entry.name === '__pycache__') {
-        fs.rmSync(fullPath, { recursive: true, force: true });
-        removedCount++;
-        // console.log(`  Removed: ${path.relative(ROOT, fullPath)}`);
-      } else {
-        cleanRecursively(fullPath);
-      }
-    } else if (/\.(?:pyc|pyo|pyd)$/i.test(entry.name)) {
-      fs.unlinkSync(fullPath);
-      removedCount++;
-      // console.log(`  Removed: ${path.relative(ROOT, fullPath)}`);
-    }
-  }
-}
-
-cleanRecursively(TARGET_DIR);
-if (removedCount > 0) {
-  console.log(`✓ Cleaned ${removedCount} Python cache files/directories from .agent/`);
-}