tribunal-kit 6.0.1 → 7.0.0

package/.agent/scripts/skill_integrator.js

@@ -14,18 +14,17 @@
  *   node .agent/scripts/skill_integrator.js --report --verify
  */
 
-"use strict";
+'use strict';
 
-const fs = require("fs");
-const path = require("path");
-const { execFileSync } = require("child_process");
+const fs = require('fs');
+const path = require('path');
+const { execFileSync } = require('child_process');
 
-const { CYAN, GREEN, YELLOW, RED, BOLD, RESET } = require("./_colors");
+const { CYAN, GREEN, YELLOW, RED, BOLD, RESET } = require('./_colors');
 
-const REPORT_FILE = "skill-integration-report.md";
-
-const { findAgentDir } = require("./_utils");
+const REPORT_FILE = 'skill-integration-report.md';
 
+const { findAgentDir } = require('./_utils');
 
 function getAssociatedScript(skillDir, scriptsDir) {
   /** Check if the skill has an explicit frontmatter script or an implicit script file. */
@@ -43,10 +42,10 @@ function getAssociatedScript(skillDir, scriptsDir) {
   }
 
   // 2. Explicit check: does the SKILL.md define 'script:' in its frontmatter?
-  const skillMd = path.join(skillDir, "SKILL.md");
+  const skillMd = path.join(skillDir, 'SKILL.md');
   if (fs.existsSync(skillMd)) {
     try {
-      const content = fs.readFileSync(skillMd, "utf8");
+      const content = fs.readFileSync(skillMd, 'utf8');
       const match = content.match(/---([\s\S]*?)---/);
       if (match) {
         const frontmatter = match[1];
@@ -64,8 +63,8 @@ function getAssociatedScript(skillDir, scriptsDir) {
 }
 
 function scanAllSkills(agentDir) {
-  const skillsDir = path.join(agentDir, "skills");
-  const scriptsDir = path.join(agentDir, "scripts");
+  const skillsDir = path.join(agentDir, 'skills');
+  const scriptsDir = path.join(agentDir, 'scripts');
 
   if (!fs.existsSync(skillsDir) || !fs.existsSync(scriptsDir)) {
     console.log(
@@ -105,38 +104,36 @@ function verifyScript(scriptPathStr, workspaceRoot) {
   }
 
   try {
-    if (fullPath.endsWith(".js")) {
+    if (fullPath.endsWith('.js')) {
       // use node to syntax check
-      execFileSync("node", ["-c", fullPath], { stdio: "pipe" });
-    } else if (fullPath.endsWith(".py")) {
+      execFileSync('node', ['-c', fullPath], { stdio: 'pipe' });
+    } else if (fullPath.endsWith('.py')) {
       // use python to syntax check
-      execFileSync("python", ["-m", "py_compile", fullPath], { stdio: "pipe" });
+      execFileSync('python', ['-m', 'py_compile', fullPath], { stdio: 'pipe' });
     }
-    return { valid: true, message: "Syntax OK" };
+    return { valid: true, message: 'Syntax OK' };
   } catch (e) {
     let msg = e.message;
     if (e.stderr) {
       msg = e.stderr.toString().trim();
     }
-    return { valid: false, message: `Syntax error: ${msg.split("\n")[0]}` };
+    return { valid: false, message: `Syntax error: ${msg.split('\n')[0]}` };
   }
 }
 
 function checkSkill(skillName, agentDir) {
-  const skillDir = path.join(agentDir, "skills", skillName);
-  const scriptsDir = path.join(agentDir, "scripts");
+  const skillDir = path.join(agentDir, 'skills', skillName);
+  const scriptsDir = path.join(agentDir, 'scripts');
 
   if (!fs.existsSync(skillDir)) {
-    console.log(
-      `${YELLOW}Skill '${skillName}' not found in .agent/skills/${RESET}`,
-    );
+    console.log(`${YELLOW}Skill '${skillName}' not found in .agent/skills/${RESET}`);
     return;
   }
 
   const scriptPath = getAssociatedScript(skillDir, scriptsDir);
   if (scriptPath) {
     console.log(`${GREEN}✓ Associated script found:${RESET} ${scriptPath}`);
-    const runner = scriptPath.endsWith(".py") ? "python" : "node";
+    const runner = scriptPath.endsWith('.py') ? 'python' : 'node';
     console.log(`\nTo execute:\n  ${runner} ${scriptPath}`);
   } else {
     console.log(`No executable script mapped for '${skillName}'.`);
@@ -158,7 +155,7 @@ function cmdReport(integratedSkills, workspaceRoot) {
   for (const skill of keys) {
     const script = integratedSkills[skill];
     const scriptPath = path.resolve(workspaceRoot, script);
-    const exists = fs.existsSync(scriptPath) ? "✅" : "❌ Missing";
+    const exists = fs.existsSync(scriptPath) ? '✅' : '❌ Missing';
     content += `| \`${skill}\` | \`${script}\` | ${exists} |\n`;
   }
 
@@ -166,7 +163,7 @@ function cmdReport(integratedSkills, workspaceRoot) {
   content += `_Run \`node .agent/scripts/skill_integrator.js --verify\` to validate syntax of all mapped scripts._\n`;
 
   const reportPath = path.join(workspaceRoot, REPORT_FILE);
-  fs.writeFileSync(reportPath, content, "utf8");
+  fs.writeFileSync(reportPath, content, 'utf8');
 
   console.log(`${GREEN}✅ Report written to:${RESET} ${reportPath}`);
 }
@@ -193,13 +190,9 @@ function cmdVerify(integratedSkills, workspaceRoot) {
     const script = integratedSkills[skill];
     const res = verifyScript(script, workspaceRoot);
     if (res.valid) {
-      console.log(
-        `  ${GREEN}✅ PASS${RESET}  ${BOLD}${skill}${RESET} → ${script}`,
-      );
+      console.log(`  ${GREEN}✅ PASS${RESET}  ${BOLD}${skill}${RESET} → ${script}`);
     } else {
-      console.log(
-        `  ${RED}❌ FAIL${RESET}  ${BOLD}${skill}${RESET} → ${script}`,
-      );
+      console.log(`  ${RED}❌ FAIL${RESET}  ${BOLD}${skill}${RESET} → ${script}`);
       console.log(`         ${RED}${res.message}${RESET}`);
       allPassed = false;
       failures.push(skill);
@@ -208,9 +201,7 @@ function cmdVerify(integratedSkills, workspaceRoot) {
 
   console.log(`\n${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}`);
   if (allPassed) {
-    console.log(
-      `${GREEN}All ${keys.length} mapped scripts passed verification.${RESET}\n`,
-    );
+    console.log(`${GREEN}All ${keys.length} mapped scripts passed verification.${RESET}\n`);
   } else {
     console.log(
       `${RED}${failures.length} script(s) failed verification. Fix before deploying.${RESET}\n`,
@@ -223,7 +214,7 @@ function cmdVerify(integratedSkills, workspaceRoot) {
 function main() {
   const rawArgs = process.argv.slice(2);
 
-  if (rawArgs.length > 0 && ["-h", "--help", "help"].includes(rawArgs[0])) {
+  if (rawArgs.length > 0 && ['-h', '--help', 'help'].includes(rawArgs[0])) {
     console.log(`
 ${BOLD}skill_integrator.js${RESET} — Skill-Script Integrator
 
@@ -245,18 +236,18 @@ ${BOLD}Options:${RESET}
 
   // Parse args
   let skillArg = null;
-  let workspaceArg = ".";
+  let workspaceArg = '.';
   let reportArg = false;
   let verifyArg = false;
 
   for (let i = 0; i < rawArgs.length; i++) {
-    if (rawArgs[i] === "--skill" && i + 1 < rawArgs.length) {
+    if (rawArgs[i] === '--skill' && i + 1 < rawArgs.length) {
       skillArg = rawArgs[++i];
-    } else if (rawArgs[i] === "--workspace" && i + 1 < rawArgs.length) {
+    } else if (rawArgs[i] === '--workspace' && i + 1 < rawArgs.length) {
       workspaceArg = rawArgs[++i];
-    } else if (rawArgs[i] === "--report") {
+    } else if (rawArgs[i] === '--report') {
       reportArg = true;
-    } else if (rawArgs[i] === "--verify") {
+    } else if (rawArgs[i] === '--verify') {
       verifyArg = true;
     }
   }
@@ -293,19 +284,15 @@ ${BOLD}Options:${RESET}
   if (!reportArg && !verifyArg) {
     const keys = Object.keys(integratedSkills).sort();
     if (keys.length === 0) {
-      console.log("No integrated scripts found for any active skills.");
+      console.log('No integrated scripts found for any active skills.');
     } else {
-      console.log(
-        `\n${BOLD}${CYAN}--- Skill-Script Integrations (${keys.length}) ---${RESET}\n`,
-      );
+      console.log(`\n${BOLD}${CYAN}--- Skill-Script Integrations (${keys.length}) ---${RESET}\n`);
       for (const skill of keys) {
         const script = integratedSkills[skill];
         console.log(` ${BOLD}${skill}${RESET}`);
         console.log(`   ↳ ${GREEN}${script}${RESET}\n`);
       }
-      console.log(
-        `${CYAN}To run a skill script, use: python <path> or node <path>${RESET}\n`,
-      );
+      console.log(`${CYAN}To run a skill script, use: python <path> or node <path>${RESET}\n`);
     }
   }
 }

package/.agent/scripts/socratic_gate_policy.js

@@ -10,9 +10,9 @@
  *   - Tier 3: Trigger Socratic Gate unless explicitly overridden with --no-gate or --express.
  */
 
-"use strict";
+'use strict';
 
-const { parseArgs } = require("./_utils");
+const { parseArgs } = require('./_utils');
 
 /**
  * Evaluates whether the Socratic Gate should be engaged.
@@ -20,31 +20,34 @@ const { parseArgs } = require("./_utils");
  * @returns {Object} { shouldBlock, reason }
  */
 function evaluateSocraticGate(opts = {}) {
-  const tier = typeof opts.tier === "number" ? opts.tier : 1;
-  const ambiguityScore = typeof opts.ambiguityScore === "number" ? opts.ambiguityScore : 0.2;
+  const tier = typeof opts.tier === 'number' ? opts.tier : 1;
+  const ambiguityScore = typeof opts.ambiguityScore === 'number' ? opts.ambiguityScore : 0.2;
   const flags = opts.flags || {};
 
-  if (flags["no-gate"] || flags.express || flags.force) {
-    return { shouldBlock: false, reason: "Explicit user override (--no-gate / --express)" };
+  if (flags['no-gate'] || flags.express || flags.force) {
+    return { shouldBlock: false, reason: 'Explicit user override (--no-gate / --express)' };
   }
 
   if (tier === 0) {
-    return { shouldBlock: false, reason: "Tier 0 Fast-Pass (low impact)" };
+    return { shouldBlock: false, reason: 'Tier 0 Fast-Pass (low impact)' };
   }
 
   if (tier === 1) {
-    return { shouldBlock: false, reason: "Tier 1 Express Pass (single component / logic edit)" };
+    return { shouldBlock: false, reason: 'Tier 1 Express Pass (single component / logic edit)' };
   }
 
   if (tier === 2) {
     if (ambiguityScore > 0.5) {
-      return { shouldBlock: true, reason: `Tier 2 ambiguity exceeds threshold (${ambiguityScore} > 0.5)` };
+      return {
+        shouldBlock: true,
+        reason: `Tier 2 ambiguity exceeds threshold (${ambiguityScore} > 0.5)`,
+      };
     }
-    return { shouldBlock: false, reason: "Tier 2 low-ambiguity edit (gate bypassed)" };
+    return { shouldBlock: false, reason: 'Tier 2 low-ambiguity edit (gate bypassed)' };
   }
 
   // Tier 3
-  return { shouldBlock: true, reason: "Tier 3 Full Gauntlet (high risk / architectural change)" };
+  return { shouldBlock: true, reason: 'Tier 3 Full Gauntlet (high risk / architectural change)' };
 }
 
 if (require.main === module) {
@@ -52,7 +55,7 @@ if (require.main === module) {
   const result = evaluateSocraticGate({
     tier: args.tier ? parseInt(args.tier, 10) : 1,
     ambiguityScore: args.ambiguity ? parseFloat(args.ambiguity) : 0.2,
-    flags: args
+    flags: args,
   });
   console.log(JSON.stringify(result, null, 2));
 }

package/.agent/scripts/strengthen_skills.js

@@ -9,12 +9,12 @@
  *   node .agent/scripts/strengthen_skills.js . --skills-path /custom/skills/dir
  */
 
-"use strict";
+'use strict';
 
-const fs = require("fs");
-const path = require("path");
+const fs = require('fs');
+const path = require('path');
 
-const { RED, GREEN, YELLOW, BLUE, BOLD, RESET } = require("./_colors.js");
+const { RED, GREEN, YELLOW, BLUE, BOLD, RESET } = require('./_colors.js');
 
 const GUARDRAILS_BLOCK = `
 
@@ -60,19 +60,16 @@ Review these questions before confirming output:
 - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
 `;
 
-const TRIBUNAL_MARKERS = [
-  "Tribunal Integration",
-  "Tribunal Integration (Anti-Hallucination)",
-];
+const TRIBUNAL_MARKERS = ['Tribunal Integration', 'Tribunal Integration (Anti-Hallucination)'];
 
-const VBC_MARKERS = ["Verification-Before-Completion", "VBC Protocol"];
+const VBC_MARKERS = ['Verification-Before-Completion', 'VBC Protocol'];
 
 function hasTribunalBlock(content) {
-  return TRIBUNAL_MARKERS.some((m) => content.includes(m));
+  return TRIBUNAL_MARKERS.some(m => content.includes(m));
 }
 
 function hasVbcBlock(content) {
-  return VBC_MARKERS.some((m) => content.includes(m));
+  return VBC_MARKERS.some(m => content.includes(m));
 }
 
 function header(title) {
@@ -94,54 +91,54 @@ function fail(msg) {
 function processSkill(skillMd, dryRun) {
   const skillName = path.basename(path.dirname(skillMd));
   try {
-    const content = fs.readFileSync(skillMd, "utf8");
+    const content = fs.readFileSync(skillMd, 'utf8');
     const hasTribunal = hasTribunalBlock(content);
     const hasVbc = hasVbcBlock(content);
 
     if (hasTribunal && hasVbc) {
       skip(`${skillName} — already has Tribunal + VBC blocks`);
-      return "skipped";
+      return 'skipped';
     }
 
     const missing = [];
-    if (!hasTribunal) missing.push("Tribunal Integration");
-    if (!hasVbc) missing.push("VBC Protocol");
+    if (!hasTribunal) missing.push('Tribunal Integration');
+    if (!hasVbc) missing.push('VBC Protocol');
 
     if (dryRun) {
-      warn(`[DRY RUN] ${skillName} — would add: ${missing.join(", ")}`);
-      return "updated";
+      warn(`[DRY RUN] ${skillName} — would add: ${missing.join(', ')}`);
+      return 'updated';
     }
 
-    fs.appendFileSync(skillMd, GUARDRAILS_BLOCK, "utf8");
-    ok(`${skillName} — strengthened (${missing.join(", ")} added)`);
-    return "updated";
+    fs.appendFileSync(skillMd, GUARDRAILS_BLOCK, 'utf8');
+    ok(`${skillName} — strengthened (${missing.join(', ')} added)`);
+    return 'updated';
   } catch (e) {
     fail(`${skillName} — ${e.message}`);
-    return "error";
+    return 'error';
   }
 }
 
 function main() {
   const args = process.argv.slice(2);
-  let targetPath = ".";
+  let targetPath = '.';
   let dryRun = false;
   let skillArg = null;
   let skillsPathArg = null;
 
   let i = 0;
   while (i < args.length) {
-    if (args[i] === "--dry-run") {
+    if (args[i] === '--dry-run') {
       dryRun = true;
-    } else if (args[i] === "--skill" && i + 1 < args.length) {
+    } else if (args[i] === '--skill' && i + 1 < args.length) {
       skillArg = args[++i];
-    } else if (args[i] === "--skills-path" && i + 1 < args.length) {
+    } else if (args[i] === '--skills-path' && i + 1 < args.length) {
       skillsPathArg = args[++i];
-    } else if (args[i] === "-h" || args[i] === "--help") {
+    } else if (args[i] === '-h' || args[i] === '--help') {
       console.log(
-        "Usage: node strengthen_skills.js <path> [--dry-run] [--skill <name>] [--skills-path <path>]",
+        'Usage: node strengthen_skills.js <path> [--dry-run] [--skill <name>] [--skills-path <path>]',
       );
       process.exit(0);
-    } else if (!args[i].startsWith("-")) {
+    } else if (!args[i].startsWith('-')) {
       targetPath = args[i];
     }
     i++;
@@ -152,7 +149,7 @@ function main() {
   if (skillsPathArg) {
     skillsDir = path.resolve(skillsPathArg);
   } else {
-    skillsDir = path.join(projectRoot, ".agent", "skills");
+    skillsDir = path.join(projectRoot, '.agent', 'skills');
   }
 
   if (!fs.existsSync(skillsDir) || !fs.statSync(skillsDir).isDirectory()) {
@@ -161,12 +158,11 @@ function main() {
   }
 
   console.log(`${BOLD}Tribunal — strengthen_skills.js${RESET}`);
-  if (dryRun)
-    console.log(`  ${YELLOW}DRY RUN — no files will be written${RESET}`);
+  if (dryRun) console.log(`  ${YELLOW}DRY RUN — no files will be written${RESET}`);
   console.log(`Skills dir: ${skillsDir}\n`);
 
   const counts = { updated: 0, skipped: 0, error: 0 };
-  header("Strengthening Skills");
+  header('Strengthening Skills');
 
   const dirs = fs.readdirSync(skillsDir, { withFileTypes: true });
   dirs.sort((a, b) => a.name.localeCompare(b.name));
@@ -175,7 +171,7 @@ function main() {
     if (!dir.isDirectory()) continue;
     if (skillArg && dir.name !== skillArg) continue;
 
-    const skillMd = path.join(skillsDir, dir.name, "SKILL.md");
+    const skillMd = path.join(skillsDir, dir.name, 'SKILL.md');
     if (!fs.existsSync(skillMd)) {
       warn(`${dir.name} — no SKILL.md found`);
       continue;