tribunal-kit 9.2.5 → 9.2.7

package/src/utils/version.js

@@ -1,23 +1,25 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
+'use strict';
+const __importDefault =
+  (this && this.__importDefault) ||
+  function (mod) {
+    return mod && mod.__esModule ? mod : { default: mod };
+  };
+Object.defineProperty(exports, '__esModule', { value: true });
 exports.compareSemver = compareSemver;
 exports.fetchLatestVersion = fetchLatestVersion;
 exports.autoUpdateCheck = autoUpdateCheck;
-const https_1 = __importDefault(require("https"));
-const _child_process_1 = require("child_process");
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const os_1 = __importDefault(require("os"));
-const logger_1 = require("./logger");
+const https_1 = __importDefault(require('https'));
+const _child_process_1 = require('child_process');
+const fs_1 = __importDefault(require('fs'));
+const path_1 = __importDefault(require('path'));
+const os_1 = __importDefault(require('os'));
+const logger_1 = require('./logger');
 
 // Cache TTL: 1 hour (in milliseconds)
 const CACHE_TTL_MS = 60 * 60 * 1000;
 
 function getCachePath() {
-    return path_1.default.join(os_1.default.homedir(), '.tribunal-kit-update-cache.json');
+  return path_1.default.join(os_1.default.homedir(), '.tribunal-kit-update-cache.json');
 }
 
 /**
@@ -25,33 +27,37 @@ function getCachePath() {
  * Returns { version, timestamp } or null if cache is missing/expired/corrupt.
  */
 function readCache() {
-    try {
-        const cachePath = getCachePath();
-        if (!fs_1.default.existsSync(cachePath)) return null;
-        const raw = fs_1.default.readFileSync(cachePath, 'utf8');
-        const data = JSON.parse(raw);
-        if (!data.version || !data.timestamp) return null;
-        // Check TTL
-        if (Date.now() - data.timestamp > CACHE_TTL_MS) return null;
-        return data;
-    } catch {
-        return null;
-    }
+  try {
+    const cachePath = getCachePath();
+    if (!fs_1.default.existsSync(cachePath)) return null;
+    const raw = fs_1.default.readFileSync(cachePath, 'utf8');
+    const data = JSON.parse(raw);
+    if (!data.version || !data.timestamp) return null;
+    // Check TTL
+    if (Date.now() - data.timestamp > CACHE_TTL_MS) return null;
+    return data;
+  } catch {
+    return null;
+  }
 }
 
 /**
  * Write version check result to cache.
  */
 function writeCache(version) {
-    try {
-        const cachePath = getCachePath();
-        fs_1.default.writeFileSync(cachePath, JSON.stringify({
-            version,
-            timestamp: Date.now()
-        }), 'utf8');
-    } catch {
-        // Cache write failure is non-critical — silently ignore
-    }
+  try {
+    const cachePath = getCachePath();
+    fs_1.default.writeFileSync(
+      cachePath,
+      JSON.stringify({
+        version,
+        timestamp: Date.now(),
+      }),
+      'utf8',
+    );
+  } catch {
+    // Cache write failure is non-critical — silently ignore
+  }
 }
 
 /**
@@ -59,17 +65,15 @@ function writeCache(version) {
  *   1 if a > b, -1 if a < b, 0 if equal.
  */
 function compareSemver(a, b) {
-    const pa = a.replace(/^v/, '').split('.').map(Number);
-    const pb = b.replace(/^v/, '').split('.').map(Number);
-    for (let i = 0; i < 3; i++) {
-        const na = pa[i] || 0;
-        const nb = pb[i] || 0;
-        if (na > nb)
-            return 1;
-        if (na < nb)
-            return -1;
-    }
-    return 0;
+  const pa = a.replace(/^v/, '').split('.').map(Number);
+  const pb = b.replace(/^v/, '').split('.').map(Number);
+  for (let i = 0; i < 3; i++) {
+    const na = pa[i] || 0;
+    const nb = pb[i] || 0;
+    if (na > nb) return 1;
+    if (na < nb) return -1;
+  }
+  return 0;
 }
 /**
  * Fetch the latest version from npm registry.
@@ -77,81 +81,96 @@ function compareSemver(a, b) {
  * Uses a 1-hour TTL cache to avoid redundant network calls.
  */
 function fetchLatestVersion(currentVersion) {
-    // Check cache first
-    const cached = readCache();
-    if (cached) {
-        return Promise.resolve(cached.version);
-    }
+  // Check cache first
+  const cached = readCache();
+  if (cached) {
+    return Promise.resolve(cached.version);
+  }
 
-    return new Promise((resolve) => {
-        const req = https_1.default.get('https://registry.npmjs.org/tribunal-kit/latest', {
-            headers: {
-                'Accept': 'application/json',
-                'User-Agent': `tribunal-kit/${currentVersion}`
-            },
-            timeout: 3000  // Reduced from 5s to 3s for faster fallback
-        }, (res) => {
-            let data = '';
-            res.on('data', (chunk) => { data += chunk; });
-            res.on('end', () => {
-                try {
-                    const json = JSON.parse(data);
-                    const version = json.version || null;
-                    if (version) writeCache(version);
-                    resolve(version);
-                }
-                catch {
-                    resolve(null);
-                }
-            });
+  return new Promise(resolve => {
+    const req = https_1.default.get(
+      'https://registry.npmjs.org/tribunal-kit/latest',
+      {
+        headers: {
+          Accept: 'application/json',
+          'User-Agent': `tribunal-kit/${currentVersion}`,
+        },
+        timeout: 3000, // Reduced from 5s to 3s for faster fallback
+      },
+      res => {
+        let data = '';
+        res.on('data', chunk => {
+          data += chunk;
         });
-        req.on('error', () => resolve(null));
-        req.on('timeout', () => { req.destroy(); resolve(null); });
+        res.on('end', () => {
+          try {
+            const json = JSON.parse(data);
+            const version = json.version || null;
+            if (version) writeCache(version);
+            resolve(version);
+          } catch {
+            resolve(null);
+          }
+        });
+      },
+    );
+    req.on('error', () => resolve(null));
+    req.on('timeout', () => {
+      req.destroy();
+      resolve(null);
     });
+  });
 }
 
 /**
  * Non-blocking update check.
- * 
+ *
  * PERF: Instead of blocking the command while checking for updates,
  * this fires the HTTP request and shows the result AFTER the command completes.
  * The check runs concurrently with command execution, adding zero latency.
- * 
+ *
  * Returns true if a re-invoke happened (caller should exit), false otherwise.
  */
 let hasRegisteredUpdateNotifier = false;
 
 async function autoUpdateCheck(originalArgs, currentVersion) {
-    // Recursion guard: if we're already a re-invoked process, skip
-    if (process.env.TK_SKIP_UPDATE_CHECK === '1') {
-        return false;
-    }
+  // Recursion guard: if we're already a re-invoked process, skip
+  if (process.env.TK_SKIP_UPDATE_CHECK === '1') {
+    return false;
+  }
 
-    if (hasRegisteredUpdateNotifier) {
-        return false;
-    }
-    hasRegisteredUpdateNotifier = true;
+  if (hasRegisteredUpdateNotifier) {
+    return false;
+  }
+  hasRegisteredUpdateNotifier = true;
 
-    // Fire the fetch but DON'T await it immediately — let the command run first
-    const versionPromise = fetchLatestVersion(currentVersion);
+  // Fire the fetch but DON'T await it immediately — let the command run first
+  const versionPromise = fetchLatestVersion(currentVersion);
 
-    // Register a process.once('beforeExit') hook to show the update notification
-    // AFTER the command has finished executing
-    process.once('beforeExit', async () => {
-        try {
-            const latestVersion = await versionPromise;
-            if (!latestVersion) return;
-            if (compareSemver(latestVersion, currentVersion) <= 0) return;
+  // Register a process.once('beforeExit') hook to show the update notification
+  // AFTER the command has finished executing
+  process.once('beforeExit', async () => {
+    try {
+      const latestVersion = await versionPromise;
+      if (!latestVersion) return;
+      if (compareSemver(latestVersion, currentVersion) <= 0) return;
 
-            // Show a non-intrusive update notification
-            console.log();
-            console.log((0, logger_1.colorize)('cyan', `  ⬆ Update available: ${(0, logger_1.colorize)('bold', currentVersion)} → ${(0, logger_1.colorize)('bold', latestVersion)}`));
-            console.log((0, logger_1.colorize)('gray', `  Run: npx tribunal-kit@${latestVersion} init --force`));
-            console.log();
-        } catch {
-            // Silently ignore — update notification is non-critical
-        }
-    });
+      // Show a non-intrusive update notification
+      console.log();
+      console.log(
+        (0, logger_1.colorize)(
+          'cyan',
+          `  ⬆ Update available: ${(0, logger_1.colorize)('bold', currentVersion)} → ${(0, logger_1.colorize)('bold', latestVersion)}`,
+        ),
+      );
+      console.log(
+        (0, logger_1.colorize)('gray', `  Run: npx tribunal-kit@${latestVersion} init --force`),
+      );
+      console.log();
+    } catch {
+      // Silently ignore — update notification is non-critical
+    }
+  });
 
-    return false; // Never block — always let the command proceed
+  return false; // Never block — always let the command proceed
 }

package/scripts/apply-version.js

@@ -1,57 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-
-const ROOT = path.resolve(__dirname, '..');
-const PKG_PATH = path.join(ROOT, 'package.json');
-const PKG = JSON.parse(fs.readFileSync(PKG_PATH, 'utf8'));
-const VERSION = PKG.version;
-
-function updateFiles() {
-  const filesToUpdate = [
-    'plugins/core-plugin.json',
-    'plugins/gemini/extension.json',
-    'npm/core-template/package.json',
-    'README.md',
-    'crates/core/Cargo.toml',
-    'bin/adapter-install.js',
-    'src/tui/banner.js',
-  ];
-
-  for (const relPath of filesToUpdate) {
-    const fullPath = path.join(ROOT, relPath);
-    if (fs.existsSync(fullPath)) {
-      let content = fs.readFileSync(fullPath, 'utf8');
-
-      if (relPath.endsWith('.json')) {
-        const json = JSON.parse(content);
-        if (json.version) {
-          json.version = VERSION;
-        }
-        fs.writeFileSync(fullPath, JSON.stringify(json, null, 2) + '\n');
-      } else if (relPath === 'crates/core/Cargo.toml') {
-        content = content.replace(/^version\s*=\s*"[^"]+"/m, `version = "${VERSION}"`);
-        fs.writeFileSync(fullPath, content);
-      } else if (relPath === 'README.md') {
-        content = content.replace(/Release-v([0-9]+\.[0-9]+\.[0-9]+)/g, `Release-v${VERSION}`);
-        fs.writeFileSync(fullPath, content);
-      } else if (relPath === 'bin/adapter-install.js' || relPath === 'src/tui/banner.js') {
-        content = content.replace(/v\d+\.\d+\.\d+/g, `v${VERSION}`);
-        content = content.replace(/version = '\d+\.\d+\.\d+'/g, `version = '${VERSION}'`);
-        fs.writeFileSync(fullPath, content);
-      }
-      console.log(`Updated ${relPath} to ${VERSION}`);
-    }
-  }
-
-  // Update optionalDependencies in package.json
-  if (PKG.optionalDependencies) {
-    for (const key of Object.keys(PKG.optionalDependencies)) {
-      PKG.optionalDependencies[key] = `^${VERSION}`;
-    }
-    fs.writeFileSync(PKG_PATH, JSON.stringify(PKG, null, 2) + '\n');
-    console.log(`Updated package.json optionalDependencies to ^${VERSION}`);
-  }
-}
-
-updateFiles();
-console.log('Applied version update across repository successfully.');

package/scripts/audit_skill_sdo.js

@@ -1,89 +0,0 @@
-#!/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/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);
-});