tribunal-kit 9.2.5 → 9.2.7

package/scripts/fix-vbc.js

@@ -1,96 +0,0 @@
-#!/usr/bin/env node
-/**
- * fix-vbc.js — Batch appends missing VBC Protocol and Pre-Flight sections
- * to all SKILL.md files in .agent/skills/ that are failing validation.
- *
- * Run: node scripts/fix-vbc.js
- * Dry-run: node scripts/fix-vbc.js --dry-run
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const ROOT = path.resolve(__dirname, '..');
-const SKILLS_DIR = path.join(ROOT, '.agent', 'skills');
-const DRY_RUN = process.argv.includes('--dry-run');
-
-const PRE_FLIGHT_BLOCK = `
-### ✅ Pre-Flight Self-Audit
-
-\`\`\`
-✅ Did I rely ONLY on real, verified tools and methods?
-✅ Is this solution appropriately scoped to the user's constraints?
-✅ Did I handle potential failure modes and edge cases?
-✅ Have I avoided generic boilerplate that doesn't add value?
-\`\`\`
-`;
-
-const VBC_BLOCK = `
-### 🛑 Verification-Before-Completion (VBC) Protocol
-
-**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
-
-- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
-- ✅ **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.
-`;
-
-let fixedCount = 0;
-let skippedCount = 0;
-let errorCount = 0;
-
-const skillDirs = fs.readdirSync(SKILLS_DIR).filter(d => {
-  return fs.statSync(path.join(SKILLS_DIR, d)).isDirectory();
-});
-
-for (const dir of skillDirs) {
-  const skillPath = path.join(SKILLS_DIR, dir, 'SKILL.md');
-  if (!fs.existsSync(skillPath)) continue;
-
-  let content;
-  try {
-    content = fs.readFileSync(skillPath, 'utf8');
-  } catch (e) {
-    console.error(`  ❌ Failed to read: ${dir}/SKILL.md — ${e.message}`);
-    errorCount++;
-    continue;
-  }
-
-  const hasPreFlight = content.includes('Pre-Flight Checklist') || content.includes('Pre-Flight');
-  const hasVBC = content.includes('VBC Protocol') || content.includes('VBC');
-
-  if (hasPreFlight && hasVBC) {
-    skippedCount++;
-    continue;
-  }
-
-  let appendText = '';
-
-  if (!hasPreFlight) {
-    appendText += PRE_FLIGHT_BLOCK;
-    console.log(`  🔧 ${dir}/SKILL.md — appending Pre-Flight Self-Audit`);
-  }
-
-  if (!hasVBC) {
-    appendText += VBC_BLOCK;
-    console.log(`  🔧 ${dir}/SKILL.md — appending VBC Protocol`);
-  }
-
-  if (DRY_RUN) {
-    console.log(`  [DRY-RUN] Would append to ${dir}/SKILL.md`);
-  } else {
-    try {
-      fs.appendFileSync(skillPath, appendText, 'utf8');
-      fixedCount++;
-    } catch (e) {
-      console.error(`  ❌ Failed to write: ${dir}/SKILL.md — ${e.message}`);
-      errorCount++;
-    }
-  }
-}
-
-console.log(`\n━━━ VBC Fix Summary ━━━━━━━━━━━━━━━━━━━━━`);
-console.log(`  Fixed:   ${fixedCount}`);
-console.log(`  Skipped: ${skippedCount} (already compliant)`);
-console.log(`  Errors:  ${errorCount}`);
-console.log(`  Mode:    ${DRY_RUN ? 'DRY-RUN (no changes)' : 'LIVE'}`);
-console.log();

package/scripts/fix-vbc.ps1

@@ -1,3 +0,0 @@
-# DEPRECATED — Use cross-platform Node script: node scripts/fix-vbc.js
-Write-Host "Please run 'node scripts/fix-vbc.js' instead." -ForegroundColor Yellow
-

package/scripts/modernize_skills.js

@@ -1,268 +0,0 @@
-#!/usr/bin/env node
-/**
- * modernize_skills.js — Tribunal Kit Skill Modernizer & Schema Validator (v4.0.0)
- *
- * Scans, deduplicates, standardizes, and validates all SKILL.md files across:
- * - tribunal-kit/.agent/skills/
- * - .agent/skills/ (when --sync-to-root is passed)
- *
- * Usage:
- *   node scripts/modernize_skills.js --validate
- *   node scripts/modernize_skills.js --dry-run
- *   node scripts/modernize_skills.js --fix
- *   node scripts/modernize_skills.js --fix --sync-to-root
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const ROOT = path.resolve(__dirname, '..');
-const SKILLS_DIR = path.join(ROOT, '.agent', 'skills');
-const WORKSPACE_ROOT = path.resolve(ROOT, '..');
-const ROOT_SKILLS_DIR = path.join(WORKSPACE_ROOT, '.agent', 'skills');
-
-const ARGS = process.argv.slice(2);
-const DRY_RUN = ARGS.includes('--dry-run');
-const FIX = ARGS.includes('--fix');
-const _VALIDATE = ARGS.includes('--validate') || (!DRY_RUN && !FIX);
-const SYNC_TO_ROOT = ARGS.includes('--sync-to-root');
-
-const CANONICAL_FOOTER = `---
-
-## 🏛️ Tribunal Verification & Guardrails
-
-**Slash command: \`/review\` or \`/tribunal-full\`**
-**Active reviewers: \`logic-reviewer\` · \`security-auditor\`**
-
-### ❌ Forbidden AI Tropes
-1. **Blind Assumptions:** Never make an assumption without documenting it clearly with \`// VERIFY: [reason]\`.
-2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
-3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
-
-### ✅ Pre-Flight Self-Audit
-\`\`\`
-✅ Did I rely ONLY on real, verified tools and methods?
-✅ Is this solution appropriately scoped to the user's constraints?
-✅ Did I handle potential failure modes and edge cases?
-✅ Have I avoided generic boilerplate that doesn't add value?
-\`\`\`
-
-### 🛑 Verification-Before-Completion (VBC) Protocol
-**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
-- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
-- ✅ **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.
-`;
-
-function parseFrontmatter(content) {
-  if (!content.startsWith('---')) return { frontmatter: null, body: content };
-  const endIdx = content.indexOf('\n---', 3);
-  if (endIdx === -1) return { frontmatter: null, body: content };
-
-  const rawYaml = content.slice(4, endIdx).trim();
-  const body = content.slice(endIdx + 4).trim();
-  const meta = {};
-
-  const lines = rawYaml.split('\n');
-  let currentKey = null;
-  let isList = false;
-
-  for (const line of lines) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith('#')) continue;
-
-    const match = line.match(/^([a-zA-Z0-9_-]+):\s*(.*)$/);
-    if (match) {
-      currentKey = match[1];
-      const val = match[2].trim();
-      if (!val) {
-        meta[currentKey] = [];
-        isList = true;
-      } else {
-        meta[currentKey] = val;
-        isList = false;
-      }
-    } else if (isList && trimmed.startsWith('-')) {
-      const item = trimmed
-        .slice(1)
-        .trim()
-        .replace(/^['"]|['"]$/g, '');
-      if (Array.isArray(meta[currentKey])) {
-        meta[currentKey].push(item);
-      }
-    }
-  }
-
-  return { frontmatter: rawYaml, meta, body };
-}
-
-function deduplicateAndCleanBody(body, skillName, description) {
-  let cleaned = body;
-
-  // 1. Remove duplicate top-level headers if repeated identical lines
-  const titleMatch = cleaned.match(/^#\s+(.+)$/m);
-  if (titleMatch) {
-    const title = titleMatch[1].trim();
-    const titleRegex = new RegExp(`(^|\\n)#\\s+${escapeRegex(title)}(\\r?\\n)+`, 'g');
-    let first = true;
-    cleaned = cleaned.replace(titleRegex, (match, prefix) => {
-      if (first) {
-        first = false;
-        return match;
-      }
-      return prefix;
-    });
-  }
-
-  // 2. Strip existing canonical footer if present to ensure idempotency
-  const existingFooterIdx = cleaned.indexOf('## 🏛️ Tribunal Verification & Guardrails');
-  if (existingFooterIdx !== -1) {
-    cleaned = cleaned.slice(0, existingFooterIdx).trim();
-  }
-
-  // Cut off legacy trailing guardrail stacks
-  const footerMarkerRegex =
-    /\n---\s*\n+(\*\*Slash command: `\/review`|## 🤖 LLM-Specific Traps|## 🏛️ Tribunal Integration|### ❌ Forbidden AI Tropes|## Pre-Flight Checklist|## VBC Protocol)[\s\S]*$/;
-  cleaned = cleaned.replace(footerMarkerRegex, '').trim();
-
-  // Remove any remaining isolated duplicate VBC blocks (H2 or H3)
-  const isolatedVbcRegex =
-    /(##|###)\s+🛑?\s*Verification-Before-Completion \(VBC\) Protocol[\s\S]*?(?=\n## |\n---|\n# |$)/g;
-  cleaned = cleaned.replace(isolatedVbcRegex, '');
-
-  // Remove trailing horizontal rules or whitespace
-  cleaned = cleaned.replace(/(\n---\s*)+$/, '').trim();
-
-  // 3. Ensure Activation Boundaries section exists near the top
-  if (!cleaned.includes('Activation Boundaries') && !cleaned.includes('Activate when:')) {
-    const activationBlock = `\n\n## Activation Boundaries\n\n- **Activate when:** Operating in tasks requiring ${description || skillName}.\n- **DO NOT activate when:** The task falls strictly outside ${skillName} domain or belongs to a different dedicated specialist.\n`;
-
-    if (cleaned.includes('## Mandatory Pre-Flight Context Inspection')) {
-      cleaned = cleaned.replace(
-        /(## Mandatory Pre-Flight Context Inspection[\s\S]*?(?=\n## |\n# |\n---|$))/,
-        `$1${activationBlock}`,
-      );
-    } else {
-      cleaned = cleaned.replace(/^(#[^\n]+\n+)/, `$1${activationBlock}\n`);
-    }
-  }
-
-  // 4. Append single Canonical Footer
-  cleaned = `${cleaned}\n\n${CANONICAL_FOOTER}`;
-
-  return cleaned.trim();
-}
-
-function escapeRegex(string) {
-  return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-
-function processSkill(skillDirName) {
-  const skillFile = path.join(SKILLS_DIR, skillDirName, 'SKILL.md');
-  if (!fs.existsSync(skillFile)) return null;
-
-  const originalContent = fs.readFileSync(skillFile, 'utf8');
-  const { frontmatter, meta, body } = parseFrontmatter(originalContent);
-
-  if (!frontmatter) {
-    return { name: skillDirName, error: 'Missing frontmatter' };
-  }
-
-  const desc = meta ? meta.description || '' : '';
-  const newBody = deduplicateAndCleanBody(body, skillDirName, desc);
-
-  // Rebuild frontmatter with version: 4.0.0 and canonical scripts-binding
-  let updatedFrontmatter = frontmatter
-    .replace(/^version:\s*.*$/m, 'version: 4.0.0')
-    .replace(/^last-updated:\s*.*$/m, 'last-updated: 2026-09-07');
-
-  if (!updatedFrontmatter.includes('version:')) {
-    updatedFrontmatter += '\nversion: 4.0.0';
-  }
-  if (!updatedFrontmatter.includes('scripts-binding:')) {
-    updatedFrontmatter +=
-      '\nscripts-binding:\n  - .agent/scripts/lint_runner.js\n  - .agent/scripts/verify_all.js';
-  }
-
-  const newContent = `---\n${updatedFrontmatter.trim()}\n---\n\n${newBody}\n`;
-
-  const vbcMatches = (newContent.match(/Verification-Before-Completion \(VBC\) Protocol/g) || [])
-    .length;
-  const trapsMatches = (newContent.match(/LLM-Specific Traps/g) || []).length;
-  const isDuplicated = vbcMatches > 1 || trapsMatches > 1;
-
-  const modified = newContent !== originalContent;
-
-  if (modified && FIX) {
-    fs.writeFileSync(skillFile, newContent, 'utf8');
-    if (SYNC_TO_ROOT && fs.existsSync(ROOT_SKILLS_DIR)) {
-      const rootSkillDir = path.join(ROOT_SKILLS_DIR, skillDirName);
-      if (!fs.existsSync(rootSkillDir)) fs.mkdirSync(rootSkillDir, { recursive: true });
-      fs.writeFileSync(path.join(rootSkillDir, 'SKILL.md'), newContent, 'utf8');
-    }
-  }
-
-  return {
-    name: skillDirName,
-    isDuplicated,
-    modified,
-    vbcMatches,
-    trapsMatches,
-  };
-}
-
-function main() {
-  console.log(`━━━ Tribunal Kit Skill Modernizer ━━━━━━━━━━━━━━━━━━━━━`);
-  console.log(`Target: ${SKILLS_DIR}`);
-  console.log(
-    `Mode:   ${FIX ? 'FIX (Overwriting files)' : DRY_RUN ? 'DRY-RUN (Simulated)' : 'VALIDATE (Read-only)'}`,
-  );
-  if (SYNC_TO_ROOT) console.log(`Sync:   Enabled -> ${ROOT_SKILLS_DIR}`);
-  console.log();
-
-  const skillDirs = fs.readdirSync(SKILLS_DIR).filter(d => {
-    return fs.statSync(path.join(SKILLS_DIR, d)).isDirectory();
-  });
-
-  let totalSkills = 0;
-  let totalDuplicated = 0;
-  let totalModified = 0;
-  const errors = [];
-
-  for (const dir of skillDirs) {
-    totalSkills++;
-    const res = processSkill(dir);
-    if (!res) continue;
-    if (res.error) {
-      errors.push(`${dir}: ${res.error}`);
-      continue;
-    }
-    if (res.isDuplicated) {
-      totalDuplicated++;
-    }
-    if (res.modified) {
-      totalModified++;
-    }
-  }
-
-  console.log(`📊 Summary:`);
-  console.log(`  Total Skills Analyzed: ${totalSkills}`);
-  console.log(`  Skills with Remaining Duplications: ${totalDuplicated}`);
-  console.log(`  Skills Needing Modification: ${totalModified}`);
-  console.log(`  Errors: ${errors.length}`);
-
-  if (errors.length > 0) {
-    console.log(`\n❌ Errors encountered:`);
-    errors.forEach(e => console.log(`  - ${e}`));
-  }
-
-  console.log();
-  if (!FIX && totalModified > 0) {
-    console.log(
-      `💡 Run with --fix to apply cleanups and V4 schema across all ${totalModified} skills.`,
-    );
-  } else if (FIX) {
-    console.log(`✅ Successfully modernized and deduplicated skills to V4 schema!`);
-  }
-}
-
-main();

package/scripts/package-cores.js

@@ -1,116 +0,0 @@
-#!/usr/bin/env node
-/**
- * package-cores.js — Automates bundling of @tribunal-kit/core-* platform npm packages.
- *
- * Reads npm/core-template/package.json and generates platform-specific packages
- * for Darwin, Linux, and Windows (x64 and arm64).
- *
- * Usage:
- *   node scripts/package-cores.js            # Generate package directories
- *   node scripts/package-cores.js --pack     # Run npm pack in each generated package
- */
-
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { execFileSync } = require('child_process');
-
-const ROOT = path.resolve(__dirname, '..');
-const TEMPLATE_PKG = path.join(ROOT, 'npm', 'core-template', 'package.json');
-const OUTPUT_DIR = path.join(ROOT, 'npm', 'packages');
-const PKG = require(path.join(ROOT, 'package.json'));
-const VERSION = PKG.version;
-
-const PLATFORMS = [
-  { platform: 'darwin', arch: 'arm64', ext: '', rustTarget: 'aarch64-apple-darwin' },
-  { platform: 'darwin', arch: 'x64', ext: '', rustTarget: 'x86_64-apple-darwin' },
-  { platform: 'linux', arch: 'arm64', ext: '', rustTarget: 'aarch64-unknown-linux-gnu' },
-  { platform: 'linux', arch: 'x64', ext: '', rustTarget: 'x86_64-unknown-linux-gnu' },
-  { platform: 'win32', arch: 'arm64', ext: '.exe', rustTarget: 'aarch64-pc-windows-msvc' },
-  { platform: 'win32', arch: 'x64', ext: '.exe', rustTarget: 'x86_64-pc-windows-msvc' },
-];
-
-function ensureDir(dir) {
-  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-}
-
-function findBinary(platform, ext, rustTarget) {
-  const binaryName = `tribunal-core${ext}`;
-  const candidates = [
-    path.join(ROOT, 'target', rustTarget, 'release', binaryName),
-    path.join(ROOT, 'target', 'release', binaryName),
-    path.join(
-      ROOT,
-      `tribunal-core-${platform}-${rustTarget.includes('arm64') || rustTarget.includes('aarch64') ? 'arm64' : 'x64'}${ext}`,
-    ),
-  ];
-
-  for (const cand of candidates) {
-    if (fs.existsSync(cand)) return cand;
-  }
-  return null;
-}
-
-function buildPackages(shouldPack = false) {
-  if (!fs.existsSync(TEMPLATE_PKG)) {
-    console.error(`Missing template: ${TEMPLATE_PKG}`);
-    process.exit(1);
-  }
-
-  const templateRaw = fs.readFileSync(TEMPLATE_PKG, 'utf8');
-  ensureDir(OUTPUT_DIR);
-
-  console.log(`\n  🔱 Packaging Tribunal Core Platform Packages (v${VERSION})\n`);
-
-  for (const target of PLATFORMS) {
-    const pkgName = `core-${target.platform}-${target.arch}`;
-    const pkgDir = path.join(OUTPUT_DIR, pkgName);
-    const binDir = path.join(pkgDir, 'bin');
-    ensureDir(binDir);
-
-    const pkgContent = templateRaw
-      .replace(/\$\{PLATFORM\}/g, target.platform)
-      .replace(/\$\{ARCH\}/g, target.arch)
-      .replace(/\$\{EXT\}/g, target.ext);
-
-    const pkgJson = JSON.parse(pkgContent);
-    pkgJson.version = VERSION;
-
-    fs.writeFileSync(path.join(pkgDir, 'package.json'), JSON.stringify(pkgJson, null, 2));
-
-    // Write README
-    fs.writeFileSync(
-      path.join(pkgDir, 'README.md'),
-      `# @tribunal-kit/${pkgName}\n\nPrecompiled native Rust binary of Tribunal Core for ${target.platform} (${target.arch}).\n`,
-    );
-
-    // Copy binary if available
-    const binarySource = findBinary(target.platform, target.ext, target.rustTarget);
-    const destBinary = path.join(binDir, `tribunal-core${target.ext}`);
-
-    if (binarySource && fs.existsSync(binarySource)) {
-      fs.copyFileSync(binarySource, destBinary);
-      if (target.platform !== 'win32') {
-        fs.chmodSync(destBinary, 0o755);
-      }
-      console.log(`  ✓ Built ${pkgName} (with binary)`);
-    } else {
-      console.log(`  ⚠ Built ${pkgName} (staged, binary not found in build tree)`);
-    }
-
-    if (shouldPack) {
-      try {
-        execFileSync('npm', ['pack'], { cwd: pkgDir, stdio: 'ignore' });
-        console.log(`    ↳ Packed .tgz`);
-      } catch (e) {
-        console.error(`    ↳ Failed to pack: ${e.message}`);
-      }
-    }
-  }
-
-  console.log(`\n  ✓ Generated 6 platform packages in ${OUTPUT_DIR}\n`);
-}
-
-const isPack = process.argv.includes('--pack');
-buildPackages(isPack);