tribunal-kit 6.0.0 → 7.0.0

package/.agent/scripts/integrity_manifest.js

@@ -19,14 +19,14 @@
  * Zero external dependencies. Node.js stdlib only.
  */
 
-"use strict";
+'use strict';
 
-const fs = require("fs");
-const path = require("path");
+const fs = require('fs');
+const path = require('path');
 
 // ── Constants ─────────────────────────────────────────────────────────────────
 
-const AGENT_DIR_NAME = ".agent";
+const AGENT_DIR_NAME = '.agent';
 
 // ── YAML Frontmatter Parser (regex-based, zero deps) ─────────────────────────
 
@@ -57,24 +57,24 @@ function safeReaddir(dir) {
 
 function safeReadFile(filePath) {
   try {
-    return fs.readFileSync(filePath, "utf8");
+    return fs.readFileSync(filePath, 'utf8');
   } catch {
-    return "";
+    return '';
   }
 }
 
 // ── Agent Crawler ─────────────────────────────────────────────────────────────
 
 function crawlAgents(agentDir) {
-  const agentsDir = path.join(agentDir, "agents");
-  const files = safeReaddir(agentsDir).filter((f) => f.endsWith(".md"));
+  const agentsDir = path.join(agentDir, 'agents');
+  const files = safeReaddir(agentsDir).filter(f => f.endsWith('.md'));
 
   const reviewers = [];
   const specialists = [];
   const allAgents = [];
 
   for (const file of files) {
-    const name = file.replace(/\.md$/, "");
+    const name = file.replace(/\.md$/, '');
     allAgents.push(name);
 
     // Classify: reviewer if name contains "reviewer", "auditor", or "tester"
@@ -85,7 +85,6 @@ function crawlAgents(agentDir) {
       /reviewer|auditor|tester|throughput-optimizer/i.test(name) ||
       (fm.role && /reviewer/i.test(fm.role));
 
-
     if (isReviewer) {
       reviewers.push(name);
     } else {
@@ -105,12 +104,12 @@ function crawlAgents(agentDir) {
 // ── Skill Crawler ─────────────────────────────────────────────────────────────
 
 function crawlSkills(agentDir) {
-  const skillsDir = path.join(agentDir, "skills");
+  const skillsDir = path.join(agentDir, 'skills');
   const entries = safeReaddir(skillsDir);
   const names = [];
 
   for (const entry of entries) {
-    const skillPath = path.join(skillsDir, entry, "SKILL.md");
+    const skillPath = path.join(skillsDir, entry, 'SKILL.md');
     if (fs.existsSync(skillPath)) {
       const content = safeReadFile(skillPath);
       const fm = parseFrontmatter(content);
@@ -127,15 +126,13 @@ function crawlSkills(agentDir) {
 // ── Script Crawler ────────────────────────────────────────────────────────────
 
 function crawlScripts(agentDir) {
-  const scriptsDir = path.join(agentDir, "scripts");
-  const files = safeReaddir(scriptsDir).filter(
-    (f) => f.endsWith(".js") || f.endsWith(".py"),
-  );
+  const scriptsDir = path.join(agentDir, 'scripts');
+  const files = safeReaddir(scriptsDir).filter(f => f.endsWith('.js') || f.endsWith('.py'));
 
   const fileMap = {};
   for (const file of files) {
-    const relPath = path.join(AGENT_DIR_NAME, "scripts", file);
-    fileMap[file] = relPath.replace(/\\/g, "/");
+    const relPath = path.join(AGENT_DIR_NAME, 'scripts', file);
+    fileMap[file] = relPath.replace(/\\/g, '/');
   }
 
   return {
@@ -147,9 +144,9 @@ function crawlScripts(agentDir) {
 // ── Workflow Crawler ──────────────────────────────────────────────────────────
 
 function crawlWorkflows(agentDir) {
-  const workflowsDir = path.join(agentDir, "workflows");
-  const files = safeReaddir(workflowsDir).filter((f) => f.endsWith(".md"));
-  const names = files.map((f) => f.replace(/\.md$/, ""));
+  const workflowsDir = path.join(agentDir, 'workflows');
+  const files = safeReaddir(workflowsDir).filter(f => f.endsWith('.md'));
+  const names = files.map(f => f.replace(/\.md$/, ''));
 
   return {
     total: names.length,
@@ -170,11 +167,10 @@ function crawlWorkflows(agentDir) {
  */
 function extractCrossReferences(filePath, content, agentDir) {
   const refs = [];
-  const relSource = path.relative(agentDir, filePath).replace(/\\/g, "/");
+  const relSource = path.relative(agentDir, filePath).replace(/\\/g, '/');
 
   // Agent references: agents/name.md or `agent-name`
-  const agentRefRegex =
-    /(?:agents\/)([\w-]+)(?:\.md)?/g;
+  const agentRefRegex = /(?:agents\/)([\w-]+)(?:\.md)?/g;
   let m;
   while ((m = agentRefRegex.exec(content)) !== null) {
     const refFile = `agents/${m[1]}.md`;
@@ -183,13 +179,12 @@ function extractCrossReferences(filePath, content, agentDir) {
       source: relSource,
       ref: refFile,
       exists: fs.existsSync(fullPath),
-      type: "agent",
+      type: 'agent',
     });
   }
 
   // Script references: scripts/name.js or scripts/name.py
-  const scriptRefRegex =
-    /(?:scripts\/)([\w_-]+)\.(js|py)/g;
+  const scriptRefRegex = /(?:scripts\/)([\w_-]+)\.(js|py)/g;
   while ((m = scriptRefRegex.exec(content)) !== null) {
     const refFile = `scripts/${m[1]}.${m[2]}`;
     const fullPath = path.join(agentDir, refFile);
@@ -197,7 +192,7 @@ function extractCrossReferences(filePath, content, agentDir) {
       source: relSource,
       ref: refFile,
       exists: fs.existsSync(fullPath),
-      type: "script",
+      type: 'script',
     });
   }
 
@@ -205,7 +200,7 @@ function extractCrossReferences(filePath, content, agentDir) {
   const workflowRefRegex = /(?:workflows\/)([\w-]+)(?:\.md)?/g;
   while ((m = workflowRefRegex.exec(content)) !== null) {
     const precedingText = content.substring(Math.max(0, m.index - 100), m.index);
-    if (precedingText.includes(".github/") || precedingText.includes("github.com/")) {
+    if (precedingText.includes('.github/') || precedingText.includes('github.com/')) {
       continue;
     }
     const refFile = `workflows/${m[1]}.md`;
@@ -214,13 +209,13 @@ function extractCrossReferences(filePath, content, agentDir) {
       source: relSource,
       ref: refFile,
       exists: fs.existsSync(fullPath),
-      type: "workflow",
+      type: 'workflow',
     });
   }
 
   // Deduplicate
   const seen = new Set();
-  return refs.filter((r) => {
+  return refs.filter(r => {
     const key = `${r.source}→${r.ref}`;
     if (seen.has(key)) return false;
     seen.add(key);
@@ -236,18 +231,19 @@ function extractCrossReferences(filePath, content, agentDir) {
  */
 function extractNumericClaims(filePath, content, agentDir, actualCounts) {
   const claims = [];
-  const relSource = path.relative(agentDir, filePath).replace(/\\/g, "/");
+  const relSource = path.relative(agentDir, filePath).replace(/\\/g, '/');
   const lines = content.split(/\r?\n/);
 
   const claimPatterns = [
     {
-      regex: /(\d+)\s*(?:-\s*)?(?:(?:parallel|domain(?:-specific)?|tribunal|code)\s+)*reviewers?\b/gi,
-      entity: "reviewers",
+      regex:
+        /(\d+)\s*(?:-\s*)?(?:(?:parallel|domain(?:-specific)?|tribunal|code)\s+)*reviewers?\b/gi,
+      entity: 'reviewers',
     },
-    { regex: /(\d+)\s*(?:specialist\s+)?agents?\b/gi, entity: "agents" },
-    { regex: /(\d+)\s*(?:modular\s+)?skills?\b/gi, entity: "skills" },
-    { regex: /(\d+)\s*(?:slash\s+)?workflows?\b/gi, entity: "workflows" },
-    { regex: /(\d+)\s*(?:JS\s+)?scripts?\b/gi, entity: "scripts" },
+    { regex: /(\d+)\s*(?:specialist\s+)?agents?\b/gi, entity: 'agents' },
+    { regex: /(\d+)\s*(?:modular\s+)?skills?\b/gi, entity: 'skills' },
+    { regex: /(\d+)\s*(?:slash\s+)?workflows?\b/gi, entity: 'workflows' },
+    { regex: /(\d+)\s*(?:JS\s+)?scripts?\b/gi, entity: 'scripts' },
   ];
 
   for (let i = 0; i < lines.length; i++) {
@@ -290,16 +286,16 @@ function walkMdFiles(dir, fileList = []) {
       const stat = fs.statSync(fullPath);
       if (stat.isDirectory()) {
         // Skip node_modules, .git, history, .backups, .shared
-        if (
-          ["node_modules", ".git", "history", ".backups", ".shared"].includes(
-            entry,
-          )
-        ) {
+        if (['node_modules', '.git', 'history', '.backups', '.shared'].includes(entry)) {
           continue;
         }
         walkMdFiles(fullPath, fileList);
-      } else if (entry.endsWith(".md") || entry.endsWith(".json")) {
-        if (entry.startsWith("http") || entry.startsWith("#") || entry.startsWith("https://github.com/")) {
+      } else if (entry.endsWith('.md') || entry.endsWith('.json')) {
+        if (
+          entry.startsWith('http') ||
+          entry.startsWith('#') ||
+          entry.startsWith('https://github.com/')
+        ) {
           continue;
         }
         fileList.push(fullPath);
@@ -354,7 +350,7 @@ function generateManifest(projectRoot) {
 
   // Phase 3: Deduplicate cross-references
   const seenRefs = new Set();
-  const uniqueRefs = allRefs.filter((r) => {
+  const uniqueRefs = allRefs.filter(r => {
     const key = `${r.source}→${r.ref}`;
     if (seenRefs.has(key)) return false;
     seenRefs.add(key);
@@ -362,12 +358,10 @@ function generateManifest(projectRoot) {
   });
 
   // Phase 4: Build manifest
-  let version = "unknown";
+  let version = 'unknown';
   try {
-    const pkg = JSON.parse(
-      safeReadFile(path.join(projectRoot, "package.json")) || "{}",
-    );
-    version = pkg.version || "unknown";
+    const pkg = JSON.parse(safeReadFile(path.join(projectRoot, 'package.json')) || '{}');
+    version = pkg.version || 'unknown';
   } catch {
     // Ignore
   }
@@ -382,8 +376,8 @@ function generateManifest(projectRoot) {
     cross_references: uniqueRefs,
     numeric_claims: allClaims,
     integrity: {
-      phantom_references: uniqueRefs.filter((r) => !r.exists).length,
-      invalid_claims: allClaims.filter((c) => !c.valid).length,
+      phantom_references: uniqueRefs.filter(r => !r.exists).length,
+      invalid_claims: allClaims.filter(c => !c.valid).length,
       total_references: uniqueRefs.length,
       total_claims: allClaims.length,
     },
@@ -395,13 +389,13 @@ function generateManifest(projectRoot) {
 // ── Persist Manifest ──────────────────────────────────────────────────────────
 
 function saveManifest(manifest, projectRoot) {
-  const historyDir = path.join(projectRoot, AGENT_DIR_NAME, "history");
+  const historyDir = path.join(projectRoot, AGENT_DIR_NAME, 'history');
   if (!fs.existsSync(historyDir)) {
     fs.mkdirSync(historyDir, { recursive: true });
   }
 
-  const outputPath = path.join(historyDir, "integrity_manifest.json");
-  fs.writeFileSync(outputPath, JSON.stringify(manifest, null, 2), "utf8");
+  const outputPath = path.join(historyDir, 'integrity_manifest.json');
+  fs.writeFileSync(outputPath, JSON.stringify(manifest, null, 2), 'utf8');
   return outputPath;
 }
 
@@ -410,8 +404,8 @@ function saveManifest(manifest, projectRoot) {
 function main() {
   const args = process.argv.slice(2);
   const projectRoot = process.cwd();
-  const outputJson = args.includes("--output") && args.includes("json");
-  const validateOnly = args.includes("--validate");
+  const outputJson = args.includes('--output') && args.includes('json');
+  const validateOnly = args.includes('--validate');
 
   const manifest = generateManifest(projectRoot);
 
@@ -433,7 +427,9 @@ function main() {
   console.log(`\n🛡️  Integrity Manifest Generated`);
   console.log(`   Path: ${outputPath}`);
   console.log(`   ─────────────────────────────────`);
-  console.log(`   Agents:      ${manifest.agents.total} (${manifest.agents.reviewer_count} reviewers)`);
+  console.log(
+    `   Agents:      ${manifest.agents.total} (${manifest.agents.reviewer_count} reviewers)`,
+  );
   console.log(`   Skills:      ${manifest.skills.total}`);
   console.log(`   Scripts:     ${manifest.scripts.total}`);
   console.log(`   Workflows:   ${manifest.workflows.total}`);
@@ -443,7 +439,7 @@ function main() {
 
   if (integrity.phantom_references > 0) {
     console.log(`   ⚠️  Phantom references: ${integrity.phantom_references}`);
-    const phantoms = manifest.cross_references.filter((r) => !r.exists);
+    const phantoms = manifest.cross_references.filter(r => !r.exists);
     for (const p of phantoms) {
       console.log(`      ❌ ${p.source} → ${p.ref}`);
     }
@@ -451,24 +447,20 @@ function main() {
 
   if (integrity.invalid_claims > 0) {
     console.log(`   ⚠️  Invalid claims: ${integrity.invalid_claims}`);
-    const invalid = manifest.numeric_claims.filter((c) => !c.valid);
+    const invalid = manifest.numeric_claims.filter(c => !c.valid);
     for (const c of invalid) {
       console.log(`      ❌ ${c.source}: says "${c.claim}" but actual is ${c.actual}`);
     }
   }
 
-  if (
-    integrity.phantom_references === 0 &&
-    integrity.invalid_claims === 0
-  ) {
+  if (integrity.phantom_references === 0 && integrity.invalid_claims === 0) {
     console.log(`   ✅ All references valid. All claims accurate.`);
   }
 
   console.log();
 
   if (validateOnly) {
-    const exitCode =
-      integrity.phantom_references > 0 || integrity.invalid_claims > 0 ? 1 : 0;
+    const exitCode = integrity.phantom_references > 0 || integrity.invalid_claims > 0 ? 1 : 0;
     process.exit(exitCode);
   }
 }

package/.agent/scripts/lint_runner.js

@@ -8,11 +8,11 @@
  *   node .agent/scripts/lint_runner.js . --files src/index.ts src/utils.ts
  */
 
-"use strict";
+'use strict';
 
-const fs = require("fs");
-const path = require("path");
-const { spawnSync } = require("child_process");
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
 
 const {
   RED,
@@ -29,39 +29,38 @@ const {
   ok,
   fail,
   skip,
-} = require("./_colors");
+} = require('./_colors');
 
 const RESULTS = [];
 
 function runLinter(label, cmd, cwd) {
   const elapsed = timer();
   try {
-    const executable =
-      process.platform === "win32" && cmd[0] === "npx" ? "npx.cmd" : cmd[0];
+    const executable = process.platform === 'win32' && cmd[0] === 'npx' ? 'npx.cmd' : cmd[0];
     const result = spawnSync(executable, cmd.slice(1), {
       cwd,
-      encoding: "utf8",
+      encoding: 'utf8',
       timeout: 120000,
-      shell: process.platform === "win32",
+      shell: process.platform === 'win32',
     });
 
     const ms = elapsed();
     if (result.status === 0) {
       ok(`${label} — clean ${DIM}(${formatMs(ms)})${RESET}`);
-      RESULTS.push({ name: label, status: "pass", ms });
+      RESULTS.push({ name: label, status: 'pass', ms });
       return true;
     }
 
     fail(`${label} — issues found ${DIM}(${formatMs(ms)})${RESET}`);
-    RESULTS.push({ name: label, status: "fail", ms });
+    RESULTS.push({ name: label, status: 'fail', ms });
     if (result.error) {
       console.log(`    Error: ${result.error.message}`);
     }
-    const out = result.stdout ? result.stdout.toString() : "";
-    const err = result.stderr ? result.stderr.toString() : "";
-    const output = (out + "\n" + err).trim();
+    const out = result.stdout ? result.stdout.toString() : '';
+    const err = result.stderr ? result.stderr.toString() : '';
+    const output = (out + '\n' + err).trim();
     if (output) {
-      const lines = output.split("\n");
+      const lines = output.split('\n');
       for (const line of lines.slice(0, 15)) {
         console.log(`    ${line}`);
       }
@@ -72,45 +71,41 @@ function runLinter(label, cmd, cwd) {
     return false;
   } catch {
     skip(`${label} — tool not installed`);
-    RESULTS.push({ name: label, status: "skip" });
+    RESULTS.push({ name: label, status: 'skip' });
     return true;
   }
 }
 
 function detectLinters(projectRoot) {
   const available = {};
-  const pkgJson = path.join(projectRoot, "package.json");
+  const pkgJson = path.join(projectRoot, 'package.json');
 
   if (fs.existsSync(pkgJson)) {
     const eslintFiles = [
-      ".eslintrc",
-      ".eslintrc.js",
-      ".eslintrc.json",
-      ".eslintrc.yml",
-      "eslint.config.js",
-      "eslint.config.mjs",
+      '.eslintrc',
+      '.eslintrc.js',
+      '.eslintrc.json',
+      '.eslintrc.yml',
+      'eslint.config.js',
+      'eslint.config.mjs',
     ];
-    available.eslint = eslintFiles.some((f) =>
-      fs.existsSync(path.join(projectRoot, f)),
-    );
+    available.eslint = eslintFiles.some(f => fs.existsSync(path.join(projectRoot, f)));
 
     const prettierFiles = [
-      ".prettierrc",
-      ".prettierrc.js",
-      ".prettierrc.json",
-      "prettier.config.js",
+      '.prettierrc',
+      '.prettierrc.js',
+      '.prettierrc.json',
+      'prettier.config.js',
     ];
-    available.prettier = prettierFiles.some((f) =>
-      fs.existsSync(path.join(projectRoot, f)),
-    );
+    available.prettier = prettierFiles.some(f => fs.existsSync(path.join(projectRoot, f)));
   }
 
   available.ruff =
-    fs.existsSync(path.join(projectRoot, "pyproject.toml")) ||
-    fs.existsSync(path.join(projectRoot, "ruff.toml"));
+    fs.existsSync(path.join(projectRoot, 'pyproject.toml')) ||
+    fs.existsSync(path.join(projectRoot, 'ruff.toml'));
   available.flake8 =
-    fs.existsSync(path.join(projectRoot, ".flake8")) ||
-    fs.existsSync(path.join(projectRoot, "setup.cfg"));
+    fs.existsSync(path.join(projectRoot, '.flake8')) ||
+    fs.existsSync(path.join(projectRoot, 'setup.cfg'));
 
   return available;
 }
@@ -119,27 +114,25 @@ function main() {
   const args = process.argv.slice(2);
   let targetPath = null;
   let fixFlag = false;
-  let fileArgs = [];
+  const fileArgs = [];
 
   let i = 0;
   while (i < args.length) {
-    if (args[i] === "--fix") fixFlag = true;
-    else if (args[i] === "--files") {
+    if (args[i] === '--fix') fixFlag = true;
+    else if (args[i] === '--files') {
       i++;
-      while (i < args.length && !args[i].startsWith("--")) {
+      while (i < args.length && !args[i].startsWith('--')) {
         fileArgs.push(args[i++]);
       }
       continue;
-    } else if (!targetPath && !args[i].startsWith("-")) {
+    } else if (!targetPath && !args[i].startsWith('-')) {
       targetPath = args[i];
     }
     i++;
   }
 
   if (!targetPath) {
-    console.log(
-      "Usage: node lint_runner.js <path> [--fix] [--files <file1> <file2> ...]",
-    );
+    console.log('Usage: node lint_runner.js <path> [--fix] [--files <file1> <file2> ...]');
     process.exit(1);
   }
 
@@ -150,15 +143,15 @@ function main() {
   }
 
   console.log(
-    banner("lint_runner.js", {
+    banner('lint_runner.js', {
       Project: projectRoot,
-      Mode: fixFlag ? "fix" : "check",
+      Mode: fixFlag ? 'fix' : 'check',
     }),
   );
 
   const available = detectLinters(projectRoot);
   if (!Object.values(available).some(Boolean)) {
-    skip("No linter configuration detected in this project");
+    skip('No linter configuration detected in this project');
     process.exit(0);
   }
 
@@ -166,45 +159,44 @@ function main() {
   let failures = 0;
 
   if (available.eslint) {
-    console.log(sectionHeader("ESLint"));
-    const cmd = ["npx", "eslint"];
-    if (fixFlag) cmd.push("--fix");
+    console.log(sectionHeader('ESLint'));
+    const cmd = ['npx', 'eslint'];
+    if (fixFlag) cmd.push('--fix');
     if (fileArgs.length) cmd.push(...fileArgs);
-    else cmd.push(".", "--max-warnings=0");
-    if (!runLinter("ESLint", cmd, projectRoot)) failures++;
+    else cmd.push('.', '--max-warnings=0');
+    if (!runLinter('ESLint', cmd, projectRoot)) failures++;
   }
 
   if (available.prettier) {
-    console.log(sectionHeader("Prettier"));
-    const cmd = ["npx", "prettier"];
-    if (fixFlag) cmd.push("--write");
-    else cmd.push("--check");
+    console.log(sectionHeader('Prettier'));
+    const cmd = ['npx', 'prettier'];
+    if (fixFlag) cmd.push('--write');
+    else cmd.push('--check');
     if (fileArgs.length) cmd.push(...fileArgs);
-    else cmd.push(".");
-    if (!runLinter("Prettier", cmd, projectRoot)) failures++;
+    else cmd.push('.');
+    if (!runLinter('Prettier', cmd, projectRoot)) failures++;
   }
 
   if (available.ruff) {
-    console.log(sectionHeader("Ruff (Python)"));
-    const cmd = ["ruff", "check"];
-    if (fixFlag) cmd.push("--fix");
+    console.log(sectionHeader('Ruff (Python)'));
+    const cmd = ['ruff', 'check'];
+    if (fixFlag) cmd.push('--fix');
     if (fileArgs.length) cmd.push(...fileArgs);
-    else cmd.push(".");
-    if (!runLinter("Ruff", cmd, projectRoot)) failures++;
+    else cmd.push('.');
+    if (!runLinter('Ruff', cmd, projectRoot)) failures++;
   }
 
   if (available.flake8 && !available.ruff) {
-    console.log(sectionHeader("Flake8 (Python)"));
-    const cmd = ["flake8"];
+    console.log(sectionHeader('Flake8 (Python)'));
+    const cmd = ['flake8'];
     if (fileArgs.length) cmd.push(...fileArgs);
-    else cmd.push(".");
-    if (!runLinter("Flake8", cmd, projectRoot)) failures++;
+    else cmd.push('.');
+    if (!runLinter('Flake8', cmd, projectRoot)) failures++;
   }
 
-  if (fs.existsSync(path.join(projectRoot, "tsconfig.json"))) {
-    console.log(sectionHeader("TypeScript"));
-    if (!runLinter("TypeScript", ["npx", "tsc", "--noEmit"], projectRoot))
-      failures++;
+  if (fs.existsSync(path.join(projectRoot, 'tsconfig.json'))) {
+    console.log(sectionHeader('TypeScript'));
+    if (!runLinter('TypeScript', ['npx', 'tsc', '--noEmit'], projectRoot)) failures++;
   }
 
   console.log(`\n${BOLD}${CYAN}━━━ Lint Summary ━━━${RESET}`);
@@ -215,9 +207,7 @@ function main() {
   if (failures === 0) {
     console.log(`\n${GREEN}${BOLD}  ✔ All linters passed.${RESET}\n`);
   } else {
-    console.log(
-      `\n${RED}${BOLD}  ✖ ${failures} linter(s) reported issues.${RESET}\n`,
-    );
+    console.log(`\n${RED}${BOLD}  ✖ ${failures} linter(s) reported issues.${RESET}\n`);
   }
 
   process.exit(failures > 0 ? 1 : 0);