tribunal-kit 4.4.1 → 4.4.2

package/.agent/history/architecture-graph.yaml

@@ -0,0 +1,140 @@
+# Auto-generated Architecture Graph by Tribunal Kit
+# DO NOT EDIT MANUALLY - Auto-updates via incremental cache
+
+"bin/tribunal-kit.js":
+  riskScore: "Medium"
+  blastRadius: 4
+  imports:
+    - "fs"
+    - "path"
+    - "https"
+    - "child_process"
+  exports:
+    - "parseArgs"
+    - "compareSemver"
+    - "copyDir"
+    - "countDir"
+    - "isSelfInstall"
+    - "CORE_AGENTS"
+    - "CORE_SKILLS"
+    - "generateIDEBridges"
+  dependents:
+    - "test/unit/args.test.js"
+    - "test/unit/copyDir.test.js"
+    - "test/unit/selfInstall.test.js"
+    - "test/unit/semver.test.js"
+"migrate_refs.js":
+  riskScore: "Low"
+  blastRadius: 0
+  imports:
+    - "fs"
+"scripts/changelog.js":
+  riskScore: "Low"
+  blastRadius: 0
+  imports:
+    - "child_process"
+    - "fs"
+    - "path"
+"scripts/sync-version.js":
+  riskScore: "Low"
+  blastRadius: 0
+  imports:
+    - "fs"
+    - "path"
+"scripts/validate-payload.js":
+  riskScore: "Low"
+  blastRadius: 0
+  imports:
+    - "fs"
+    - "path"
+"test/integration/bridges.test.js":
+  riskScore: "Low"
+  blastRadius: 0
+  imports:
+    - "child_process"
+    - "path"
+    - "fs"
+    - "os"
+"test/integration/init.test.js":
+  riskScore: "Low"
+  blastRadius: 0
+  imports:
+    - "child_process"
+    - "path"
+    - "fs"
+    - "os"
+"test/integration/routing.test.js":
+  riskScore: "Low"
+  blastRadius: 0
+  imports:
+    - "path"
+    - "fs"
+"test/integration/swarm_dispatcher.test.js":
+  riskScore: "Low"
+  blastRadius: 0
+  imports:
+    - "path"
+    - "fs"
+    - "os"
+    - "../../.agent/scripts/swarm_dispatcher.js"
+"test/integration/wave2.test.js":
+  riskScore: "Low"
+  blastRadius: 0
+  imports:
+    - "fs"
+    - "../../.agent/scripts/skill_integrator.js"
+    - "../../.agent/scripts/skill_evolution.js"
+    - "../../.agent/scripts/case_law_manager.js"
+"test/unit/args.test.js":
+  riskScore: "Low"
+  blastRadius: 0
+  imports:
+    - "../../bin/tribunal-kit"
+"test/unit/case_law_manager.test.js":
+  riskScore: "Low"
+  blastRadius: 0
+  imports:
+    - "../../.agent/scripts/case_law_manager"
+"test/unit/context_broker.test.js":
+  riskScore: "Low"
+  blastRadius: 0
+  imports:
+    - "../../.agent/scripts/context_broker"
+"test/unit/copyDir.test.js":
+  riskScore: "Low"
+  blastRadius: 0
+  imports:
+    - "fs"
+    - "path"
+    - "os"
+    - "../../bin/tribunal-kit"
+"test/unit/graph_tools.test.js":
+  riskScore: "Low"
+  blastRadius: 0
+  imports:
+    - "fs"
+    - "path"
+"test/unit/inner_loop_validator.test.js":
+  riskScore: "Low"
+  blastRadius: 0
+  imports:
+    - "../../.agent/scripts/inner_loop_validator"
+"test/unit/selfInstall.test.js":
+  riskScore: "Low"
+  blastRadius: 0
+  imports:
+    - "path"
+    - "fs"
+    - "os"
+    - "../../bin/tribunal-kit"
+"test/unit/semver.test.js":
+  riskScore: "Low"
+  blastRadius: 0
+  imports:
+    - "../../bin/tribunal-kit"
+"test/unit/swarm_dispatcher.test.js":
+  riskScore: "Low"
+  blastRadius: 0
+  imports:
+    - "path"
+    - "fs"

package/.agent/history/graph-cache.json

@@ -0,0 +1,262 @@
+{
+  "bin/tribunal-kit.js": {
+    "mtimeMs": 1777585239622.425,
+    "hash": "044b396a83a94d6d3787df1bebd6c58f6261f8b3",
+    "imports": [
+      "fs",
+      "path",
+      "https",
+      "child_process"
+    ],
+    "exports": [
+      "parseArgs",
+      "compareSemver",
+      "copyDir",
+      "countDir",
+      "isSelfInstall",
+      "CORE_AGENTS",
+      "CORE_SKILLS",
+      "generateIDEBridges"
+    ],
+    "dependents": [
+      "test/unit/args.test.js",
+      "test/unit/copyDir.test.js",
+      "test/unit/selfInstall.test.js",
+      "test/unit/semver.test.js"
+    ],
+    "riskScore": "Medium",
+    "blastRadius": 4
+  },
+  "eslint.config.js": {
+    "mtimeMs": 1777583796319.5537,
+    "hash": "d80785ac22194886311daa5c82c9765de8530876",
+    "imports": [],
+    "exports": [],
+    "dependents": [],
+    "riskScore": "Low",
+    "blastRadius": 0
+  },
+  "migrate_refs.js": {
+    "mtimeMs": 1777584044503.6833,
+    "hash": "35b39052ff45b0b768fced3417c6245d9637ac18",
+    "imports": [
+      "fs"
+    ],
+    "exports": [],
+    "dependents": [],
+    "riskScore": "Low",
+    "blastRadius": 0
+  },
+  "scripts/changelog.js": {
+    "mtimeMs": 1777583387323.24,
+    "hash": "a078be5cb402a420593b4759afdae249cde78fdf",
+    "imports": [
+      "child_process",
+      "fs",
+      "path"
+    ],
+    "exports": [],
+    "dependents": [],
+    "riskScore": "Low",
+    "blastRadius": 0
+  },
+  "scripts/sync-version.js": {
+    "mtimeMs": 1777583387323.24,
+    "hash": "222ce95e5cbce0525359105d277688cfe61c7c6c",
+    "imports": [
+      "fs",
+      "path"
+    ],
+    "exports": [],
+    "dependents": [],
+    "riskScore": "Low",
+    "blastRadius": 0
+  },
+  "scripts/validate-payload.js": {
+    "mtimeMs": 1777583387324.2456,
+    "hash": "deefae3cc5c6807b56978fc47c36b85e7db03bc6",
+    "imports": [
+      "fs",
+      "path"
+    ],
+    "exports": [],
+    "dependents": [],
+    "riskScore": "Low",
+    "blastRadius": 0
+  },
+  "test/integration/bridges.test.js": {
+    "mtimeMs": 1777583387324.2456,
+    "hash": "9941a025cf46512d813660e4a09bf304f7fce64f",
+    "imports": [
+      "child_process",
+      "path",
+      "fs",
+      "os"
+    ],
+    "exports": [],
+    "dependents": [],
+    "riskScore": "Low",
+    "blastRadius": 0
+  },
+  "test/integration/init.test.js": {
+    "mtimeMs": 1777583387326.36,
+    "hash": "43387fa138c7bdde2ee4d42d07ec3c82ed754275",
+    "imports": [
+      "child_process",
+      "path",
+      "fs",
+      "os"
+    ],
+    "exports": [],
+    "dependents": [],
+    "riskScore": "Low",
+    "blastRadius": 0
+  },
+  "test/integration/routing.test.js": {
+    "mtimeMs": 1777583387327.369,
+    "hash": "aa8ff34289fee5be72e1d3f97083944f8f731dbd",
+    "imports": [
+      "path",
+      "fs"
+    ],
+    "exports": [],
+    "dependents": [],
+    "riskScore": "Low",
+    "blastRadius": 0
+  },
+  "test/integration/swarm_dispatcher.test.js": {
+    "mtimeMs": 1777584098830.7102,
+    "hash": "959cf59504544f624aea7ccad55fe2d9dc25ca4d",
+    "imports": [
+      "path",
+      "fs",
+      "os",
+      "../../.agent/scripts/swarm_dispatcher.js"
+    ],
+    "exports": [],
+    "dependents": [],
+    "riskScore": "Low",
+    "blastRadius": 0
+  },
+  "test/integration/wave2.test.js": {
+    "mtimeMs": 1777584104244.1404,
+    "hash": "703c635a4a0091e20785c3418b1ab294607a1635",
+    "imports": [
+      "fs",
+      "../../.agent/scripts/skill_integrator.js",
+      "../../.agent/scripts/skill_evolution.js",
+      "../../.agent/scripts/case_law_manager.js"
+    ],
+    "exports": [],
+    "dependents": [],
+    "riskScore": "Low",
+    "blastRadius": 0
+  },
+  "test/unit/args.test.js": {
+    "mtimeMs": 1777583387329.4229,
+    "hash": "b5863d3402957aae7315537ff9845c99899eeb50",
+    "imports": [
+      "../../bin/tribunal-kit"
+    ],
+    "exports": [],
+    "dependents": [],
+    "riskScore": "Low",
+    "blastRadius": 0
+  },
+  "test/unit/case_law_manager.test.js": {
+    "mtimeMs": 1777583387329.4229,
+    "hash": "172bdb2790ea2305d176f44b4d48826343e3fdc0",
+    "imports": [
+      "../../.agent/scripts/case_law_manager"
+    ],
+    "exports": [],
+    "dependents": [],
+    "riskScore": "Low",
+    "blastRadius": 0
+  },
+  "test/unit/context_broker.test.js": {
+    "mtimeMs": 1777585177453.438,
+    "hash": "5fa154b5885a89376a937bd4825b1ba5643c92f6",
+    "imports": [
+      "../../.agent/scripts/context_broker"
+    ],
+    "exports": [],
+    "dependents": [],
+    "riskScore": "Low",
+    "blastRadius": 0
+  },
+  "test/unit/copyDir.test.js": {
+    "mtimeMs": 1777583387330.4292,
+    "hash": "1f3111ef91650adcb45b728779000c03b9bdcb3f",
+    "imports": [
+      "fs",
+      "path",
+      "os",
+      "../../bin/tribunal-kit"
+    ],
+    "exports": [],
+    "dependents": [],
+    "riskScore": "Low",
+    "blastRadius": 0
+  },
+  "test/unit/graph_tools.test.js": {
+    "mtimeMs": 1777583387330.4292,
+    "hash": "08b5b30f66169e34f86a9b8ad9aa842e0917f218",
+    "imports": [
+      "fs",
+      "path"
+    ],
+    "exports": [],
+    "dependents": [],
+    "riskScore": "Low",
+    "blastRadius": 0
+  },
+  "test/unit/inner_loop_validator.test.js": {
+    "mtimeMs": 1777585153973.2224,
+    "hash": "48487187be036a1448dcb2089cb17d01258f964f",
+    "imports": [
+      "../../.agent/scripts/inner_loop_validator"
+    ],
+    "exports": [],
+    "dependents": [],
+    "riskScore": "Low",
+    "blastRadius": 0
+  },
+  "test/unit/selfInstall.test.js": {
+    "mtimeMs": 1777583387331.756,
+    "hash": "65b099af8b884c6c1d174f7f70c6d836c27e02ea",
+    "imports": [
+      "path",
+      "fs",
+      "os",
+      "../../bin/tribunal-kit"
+    ],
+    "exports": [],
+    "dependents": [],
+    "riskScore": "Low",
+    "blastRadius": 0
+  },
+  "test/unit/semver.test.js": {
+    "mtimeMs": 1777583387332.7576,
+    "hash": "d3b4e92656e66f496f034174abd53012ed00b33c",
+    "imports": [
+      "../../bin/tribunal-kit"
+    ],
+    "exports": [],
+    "dependents": [],
+    "riskScore": "Low",
+    "blastRadius": 0
+  },
+  "test/unit/swarm_dispatcher.test.js": {
+    "mtimeMs": 1777583387332.7576,
+    "hash": "59ea8d2f8e73dd3a384df1966e55002db2df0947",
+    "imports": [
+      "path",
+      "fs"
+    ],
+    "exports": [],
+    "dependents": [],
+    "riskScore": "Low",
+    "blastRadius": 0
+  }
+}

package/.agent/history/snapshots/bin__tribunal-kit.js.json

@@ -0,0 +1,19 @@
+{
+  "file": "bin/tribunal-kit.js",
+  "hash": "044b396a83a94d6d3787df1bebd6c58f6261f8b3",
+  "riskScore": "Medium",
+  "blastRadius": 4,
+  "imports": {
+    "fs": [],
+    "path": [],
+    "https": [],
+    "child_process": []
+  },
+  "dependents": [
+    "test/unit/args.test.js",
+    "test/unit/copyDir.test.js",
+    "test/unit/selfInstall.test.js",
+    "test/unit/semver.test.js"
+  ],
+  "content": "#!/usr/bin/env node\r\n/**\r\n * tribunal-kit CLI (alias: tk)\r\n * \r\n * Commands:\r\n *   init      — Install .agent/ into target project\r\n *   update    — Re-install to get latest changes\r\n *   status    — Check if .agent/ is installed\r\n *   learn     — Evolve project idioms based on git diffs\r\n *   case      — Manage Case Law precedents\r\n *   hook      — Install pre-push git hook\r\n *   uninstall — Remove .agent/ from project\r\n * \r\n * Usage:\r\n *   npx tribunal-kit init\r\n *   npx tribunal-kit init --force\r\n *   npx tribunal-kit init --path ./myapp\r\n *   npx tribunal-kit init --quiet\r\n *   npx tribunal-kit init --dry-run\r\n *   tribunal-kit update\r\n *   tribunal-kit status\r\n *   tribunal-kit uninstall\r\n */\r\n\r\nconst fs = require('fs');\r\nconst path = require('path');\r\nconst https = require('https');\r\nconst { execSync } = require('child_process');\r\n\r\nconst PKG = require(path.resolve(__dirname, '..', 'package.json'));\r\nconst CURRENT_VERSION = PKG.version;\r\n\r\n// ── Colors ───────────────────────────────────────────────\r\nconst C = {\r\n    reset:   '\\x1b[0m',\r\n    bold:    '\\x1b[1m',\r\n    dim:     '\\x1b[2m',\r\n    red:     '\\x1b[91m',\r\n    green:   '\\x1b[92m',\r\n    yellow:  '\\x1b[93m',\r\n    blue:    '\\x1b[94m',\r\n    magenta: '\\x1b[95m',\r\n    cyan:    '\\x1b[96m',\r\n    white:   '\\x1b[97m',\r\n    gray:    '\\x1b[90m',\r\n    bgCyan:  '\\x1b[46m',\r\n};\r\n\r\nfunction colorize(color, text) {\r\n    return `${C[color]}${text}${C.reset}`;\r\n}\r\n\r\nfunction c(color, text) { return `${C[color]}${text}${C.reset}`; }\r\nfunction bold(text)     { return `${C.bold}${text}${C.reset}`; }\r\n\r\n// ── Logging ──────────────────────────────────────────────\r\nlet quiet = false;\r\nlet verbose = false;\r\n\r\nfunction log(msg)  { if (!quiet) console.log(msg); }\r\nfunction ok(msg)   { if (!quiet) console.log(`  ${c('green',  '✔')} ${msg}`); }\r\nfunction warn(msg) { if (!quiet) console.log(`  ${c('yellow', '⚠')}  ${msg}`); }\r\nfunction err(msg)  { console.error(`  ${c('red', '✖')} ${msg}`); }\r\nfunction dim(msg)  { if (!quiet) console.log(`  ${c('gray', msg)}`); }\r\nfunction dbg(msg)  { if (verbose) console.log(`  ${c('gray', '⊡')} ${c('gray', msg)}`); }\r\n\r\n// ── Arg Parser ───────────────────────────────────────────\r\nfunction parseArgs(argv) {\r\n    const args = { command: null, flags: {} };\r\n    const raw = argv.slice(2);\r\n\r\n    // First non-flag arg is the command\r\n    for (const arg of raw) {\r\n        if (!arg.startsWith('--') && !args.command) {\r\n            args.command = arg;\r\n            continue;\r\n        }\r\n        if (arg === '--force') { args.flags.force = true; continue; }\r\n        if (arg === '--quiet') { args.flags.quiet = true; continue; }\r\n        if (arg === '--verbose') { args.flags.verbose = true; continue; }\r\n        if (arg === '--dry-run') { args.flags.dryRun = true; continue; }\r\n        if (arg === '--minimal') { args.flags.minimal = true; continue; }\r\n        if (arg === '--skip-update-check') { args.flags.skipUpdateCheck = true; continue; }\r\n        if (arg === '--head') { args.flags.head = true; continue; }\r\n        if (arg.startsWith('--path=')) {\r\n            args.flags.path = arg.split('=').slice(1).join('=');\r\n        }\r\n        if (arg === '--path') {\r\n            const idx = raw.indexOf('--path');\r\n            const nextVal = raw[idx + 1];\r\n            if (!nextVal || nextVal.startsWith('--')) {\r\n                console.error(`  \\x1b[91m✖ --path requires a directory argument\\x1b[0m`);\r\n                process.exit(1);\r\n            }\r\n            args.flags.path = nextVal;\r\n        }\r\n        if (arg.startsWith('--branch=')) {\r\n            args.flags.branch = arg.split('=').slice(1).join('=');\r\n        }\r\n    }\r\n\r\n    return args;\r\n}\r\n\r\n// ── File Utilities ────────────────────────────────────────\r\n\r\n// Core agents to install in --minimal mode\r\nconst CORE_AGENTS = new Set([\r\n    'backend-specialist.md',\r\n    'frontend-specialist.md',\r\n    'database-architect.md',\r\n    'debugger.md',\r\n    'security-auditor.md',\r\n    'logic-reviewer.md',\r\n    'dependency-reviewer.md',\r\n    'type-safety-reviewer.md',\r\n    'performance-reviewer.md',\r\n    'orchestrator.md',\r\n    'explorer-agent.md',\r\n    'project-planner.md',\r\n    'test-engineer.md',\r\n]);\r\n\r\n// Core skills to install in --minimal mode\r\nconst CORE_SKILLS = new Set([\r\n    'clean-code', 'architecture', 'testing-patterns', 'systematic-debugging',\r\n    'frontend-design', 'database-design', 'api-patterns', 'nodejs-best-practices',\r\n    'vulnerability-scanner', 'typescript-advanced', 'python-pro', 'nextjs-react-expert',\r\n    'react-specialist', 'performance-profiling', 'lint-and-validate',\r\n]);\r\n\r\nfunction copyDir(src, dest, dryRun = false, filter = null) {\r\n    if (!dryRun) {\r\n        fs.mkdirSync(dest, { recursive: true });\r\n    }\r\n\r\n    const entries = fs.readdirSync(src, { withFileTypes: true });\r\n    let count = 0;\r\n\r\n    for (const entry of entries) {\r\n        // Apply filter if provided (for --minimal mode)\r\n        if (filter && !filter(entry.name, src)) {\r\n            dbg(`  skip: ${entry.name}`);\r\n            continue;\r\n        }\r\n\r\n        const srcPath = path.join(src, entry.name);\r\n        const destPath = path.join(dest, entry.name);\r\n\r\n        if (entry.isDirectory()) {\r\n            count += copyDir(srcPath, destPath, dryRun, filter);\r\n        } else {\r\n            if (!dryRun) {\r\n                fs.cpSync(srcPath, destPath, { force: true });\r\n            }\r\n            dbg(`  copy: ${entry.name}`);\r\n            count++;\r\n        }\r\n    }\r\n\r\n    return count;\r\n}\r\n\r\nfunction countDir(dir) {\r\n    let count = 0;\r\n    const entries = fs.readdirSync(dir, { withFileTypes: true });\r\n    for (const e of entries) {\r\n        if (e.isDirectory()) count += countDir(path.join(dir, e.name));\r\n        else count++;\r\n    }\r\n    return count;\r\n}\r\n\r\n// ── Version Check & Auto-Update ──────────────────────────\r\n\r\n/**\r\n * Compare two semver strings. Returns:\r\n *   1 if a > b, -1 if a < b, 0 if equal.\r\n */\r\nfunction compareSemver(a, b) {\r\n    const pa = a.replace(/^v/, '').split('.').map(Number);\r\n    const pb = b.replace(/^v/, '').split('.').map(Number);\r\n    for (let i = 0; i < 3; i++) {\r\n        const na = pa[i] || 0;\r\n        const nb = pb[i] || 0;\r\n        if (na > nb) return 1;\r\n        if (na < nb) return -1;\r\n    }\r\n    return 0;\r\n}\r\n\r\n/**\r\n * Fetch the latest version from npm registry.\r\n * Returns the version string (e.g. '4.0.0') or null on failure.\r\n */\r\nfunction fetchLatestVersion() {\r\n    return new Promise((resolve) => {\r\n        const req = https.get(\r\n            'https://registry.npmjs.org/tribunal-kit/latest',\r\n            {\r\n                headers: {\r\n                    'Accept': 'application/json',\r\n                    'User-Agent': `tribunal-kit/${CURRENT_VERSION}`\r\n                },\r\n                timeout: 5000\r\n            },\r\n            (res) => {\r\n                let data = '';\r\n                res.on('data', (chunk) => { data += chunk; });\r\n                res.on('end', () => {\r\n                    try {\r\n                        const json = JSON.parse(data);\r\n                        const version = json.version || null;\r\n                        resolve(version);\r\n                    } catch {\r\n                        resolve(null);\r\n                    }\r\n                });\r\n            }\r\n        );\r\n        req.on('error', () => resolve(null));\r\n        req.on('timeout', () => { req.destroy(); resolve(null); });\r\n    });\r\n}\r\n\r\n/**\r\n * Check for a newer version and re-invoke with @latest if found.\r\n * Uses TK_SKIP_UPDATE_CHECK env var as recursion guard.\r\n * Returns true if a re-invoke happened (caller should exit), false otherwise.\r\n */\r\nasync function autoUpdateCheck(originalArgs) {\r\n    // Recursion guard: if we're already a re-invoked process, skip\r\n    if (process.env.TK_SKIP_UPDATE_CHECK === '1') {\r\n        return false;\r\n    }\r\n\r\n    const latestVersion = await fetchLatestVersion();\r\n\r\n    if (!latestVersion) {\r\n        // Network fail — proceed silently with current version\r\n        return false;\r\n    }\r\n\r\n    if (compareSemver(latestVersion, CURRENT_VERSION) <= 0) {\r\n        // Already up to date\r\n        dim(`Version ${CURRENT_VERSION} is up to date.`);\r\n        return false;\r\n    }\r\n\r\n    // Newer version available — re-invoke\r\n    log('');\r\n    log(colorize('cyan', `  ⬆ New version available: ${colorize('bold', CURRENT_VERSION)} → ${colorize('bold', latestVersion)}`));\r\n    log(colorize('gray', '  Re-invoking with latest version...'));\r\n    log('');\r\n\r\n    try {\r\n        // Build the command pulling from npm registry\r\n        const args = originalArgs.join(' ');\r\n        const cmd = `npx -y tribunal-kit@${latestVersion} ${args}`;\r\n\r\n        execSync(cmd, {\r\n            stdio: 'inherit',\r\n            env: { ...process.env, TK_SKIP_UPDATE_CHECK: '1' },\r\n        });\r\n        return true; // Re-invoke succeeded, caller should exit\r\n    } catch (e) {\r\n        warn(`Auto-update failed: ${e.message}`);\r\n        warn('Continuing with current version...');\r\n        return false; // Fall through to current version\r\n    }\r\n}\r\n\r\n// ── Kit Source Location ───────────────────────────────────\r\nfunction getKitAgent() {\r\n    // When installed via npm, the .agent/ folder is next to this script's package\r\n    const kitRoot = path.resolve(__dirname, '..');\r\n    const agentDir = path.join(kitRoot, '.agent');\r\n\r\n    if (!fs.existsSync(agentDir)) {\r\n        err(`Kit .agent/ folder not found at: ${agentDir}`);\r\n        err('The package may be corrupted. Try: npm install -g tribunal-kit');\r\n        process.exit(1);\r\n    }\r\n\r\n    return agentDir;\r\n}\r\n\r\n// ── Self-Install Guard ────────────────────────────────────\r\n/**\r\n * Returns true if the target directory IS the tribunal-kit package itself.\r\n * This prevents `init --force` / `update` from deleting the package's own files\r\n * when run from inside the project directory.\r\n */\r\nfunction isSelfInstall(targetDir) {\r\n    const kitRoot = path.resolve(__dirname, '..');\r\n    const resolvedTarget = path.resolve(targetDir);\r\n\r\n    // Direct path match\r\n    if (resolvedTarget === kitRoot) return true;\r\n\r\n    // Check if the target's package.json is this package\r\n    const targetPkg = path.join(resolvedTarget, 'package.json');\r\n    if (fs.existsSync(targetPkg)) {\r\n        try {\r\n            const targetName = JSON.parse(fs.readFileSync(targetPkg, 'utf8')).name;\r\n            if (targetName === PKG.name) return true;\r\n        } catch {\r\n            // Unreadable package.json — not a match\r\n        }\r\n    }\r\n\r\n    return false;\r\n}\r\n\r\n// ── Banner ────────────────────────────────────────────────\r\nfunction banner() {\r\n    if (quiet) return;\r\n    // Big ASCII art (TRIBUNAL-KIT)\r\n    const art = String.raw`\r\n████████╗██████╗ ██╗██████╗ ██╗   ██╗███╗   ██╗ █████╗ ██╗      ██╗  ██╗██╗████████╗\r\n╚══██╔══╝██╔══██╗██║██╔══██╗██║   ██║████╗  ██║██╔══██╗██║      ██║ ██╔╝██║╚══██╔══╝\r\n   ██║   ██████╔╝██║██████╔╝██║   ██║██╔██╗ ██║███████║██║█████╗█████╔╝ ██║   ██║   \r\n   ██║   ██╔══██╗██║██╔══██╗██║   ██║██║╚██╗██║██╔══██║██║╚════╝██╔═██╗ ██║   ██║   \r\n   ██║   ██║  ██║██║██████╔╝╚██████╔╝██║ ╚████║██║  ██║███████╗ ██║  ██╗██║   ██║   \r\n   ╚═╝   ╚═╝  ╚═╝╚═╝╚═════╝  ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝╚══════╝ ╚═╝  ╚═╝╚═╝   ╚═╝   `.split('\\n').filter(Boolean);\r\n    console.log();\r\n    const _maxLen = Math.max(...art.map(line => line.length));\r\n    for (const line of art) {\r\n        let gradientLine = '  ' + C.bold;\r\n        for (let i = 0; i < line.length; i++) {\r\n            gradientLine += `\\x1b[38;2;255;22;55m${line[i]}`;\r\n        }\r\n        gradientLine += C.reset;\r\n        log(gradientLine);\r\n    }\r\n    console.log();\r\n    // Subtitle strip\r\n    const W   = 84;\r\n    const sub = 'Anti-Hallucination Agent System';\r\n    const sp  = Math.max(0, W - sub.length);\r\n    const centred = ' '.repeat(Math.floor(sp / 2)) + sub + ' '.repeat(Math.ceil(sp / 2));\r\n    const RED_ANSI = '\\x1b[38;2;255;22;55m';\r\n    console.log(`  ${RED_ANSI}╔${'═'.repeat(W)}╗${C.reset}`);\r\n    console.log(`  ${RED_ANSI}║${C.reset}${c('gray', centred)}${RED_ANSI}║${C.reset}`);\r\n    console.log(`  ${RED_ANSI}╚${'═'.repeat(W)}╝${C.reset}`);\r\n    console.log();\r\n}\r\n\r\n// ── Commands ──────────────────────────────────────────────\r\nfunction cmdInit(flags) {\r\n    const agentSrc = getKitAgent();\r\n    const targetDir = flags.path ? path.resolve(flags.path) : process.cwd();\r\n    const agentDest = path.join(targetDir, '.agent');\r\n    const dryRun = flags.dryRun || false;\r\n\r\n    // ── Self-install guard ──────────────────────────────────\r\n    if (isSelfInstall(targetDir)) {\r\n        err('Cannot run init/update inside the tribunal-kit package itself.');\r\n        err(`Target: ${targetDir}`);\r\n        err(`Package: ${path.resolve(__dirname, '..')}`);\r\n        console.log();\r\n        dim('This command is designed to install .agent/ into OTHER projects.');\r\n        dim('Run it from the root of the project you want to set up:');\r\n        dim('  cd /path/to/your-project');\r\n        dim('  npx tribunal-kit init');\r\n        console.log();\r\n        process.exit(1);\r\n    }\r\n    // ────────────────────────────────────────────────────────\r\n\r\n    // ── Backup / Cleanup ────────────────────────────────────\r\n    if (!dryRun && fs.existsSync(agentDest) && flags.force) {\r\n        // Backup the existing subdirectories before overwriting\r\n        const backupDir = path.join(agentDest, '.backups', `backup-${Date.now()}`);\r\n        fs.mkdirSync(backupDir, { recursive: true });\r\n\r\n        // PRESERVE_DIRS: user-generated content that must survive updates\r\n        const _PRESERVE_DIRS = ['history', 'patterns', 'mcp_config.json'];\r\n        const subdirs = ['agents', 'workflows', 'skills', 'scripts', '.shared', 'rules'];\r\n        for (const sub of subdirs) {\r\n            const subPath = path.join(agentDest, sub);\r\n            if (fs.existsSync(subPath)) {\r\n                // Copy to backup dir\r\n                copyDir(subPath, path.join(backupDir, sub), false);\r\n                fs.rmSync(subPath, { recursive: true, force: true });\r\n            }\r\n        }\r\n        log(`  ${c('gray', '✦ Backed up existing configurations to .agent/.backups/')}`);\r\n\r\n\r\n    }\r\n    // ────────────────────────────────────────────────────────\r\n\r\n    banner();\r\n\r\n    if (dryRun) {\r\n        log(colorize('yellow', '  DRY RUN — no files will be written'));\r\n        console.log();\r\n    }\r\n\r\n    // Check target exists\r\n    if (!fs.existsSync(targetDir)) {\r\n        err(`Target directory not found: ${targetDir}`);\r\n        process.exit(1);\r\n    }\r\n\r\n    // Check if .agent already exists\r\n    if (fs.existsSync(agentDest) && !flags.force) {\r\n        warn('.agent/ already exists in this project.');\r\n        log(`  ${c('gray', '▸')} To refresh or update it, run: ${colorize('white', 'tribunal-kit init --force')}`);\r\n        log(`  ${c('gray', '▸')} Or check status with:    ${colorize('cyan', 'tribunal-kit status')}`);\r\n        console.log();\r\n        process.exit(0);\r\n    }\r\n\r\n    // Ensure history dirs exist (Case Law + Skill Evolution)\r\n    if (!dryRun) {\r\n        const caseDir = path.join(agentDest, 'history', 'case-law', 'cases');\r\n        const evoDir  = path.join(agentDest, 'history', 'skill-evolution');\r\n        fs.mkdirSync(caseDir, { recursive: true });\r\n        fs.mkdirSync(evoDir,  { recursive: true });\r\n        const gkCase = path.join(caseDir, '.gitkeep');\r\n        const gkEvo  = path.join(evoDir, '.gitkeep');\r\n        if (!fs.existsSync(gkCase)) fs.writeFileSync(gkCase, '');\r\n        if (!fs.existsSync(gkEvo))  fs.writeFileSync(gkEvo,  '');\r\n    }\r\n\r\n    // Count what we're installing\r\n    const isMinimal = flags.minimal || false;\r\n    if (isMinimal) {\r\n        log(`  ${c('yellow','⚡')} ${bold('Minimal mode')} — installing core agents and skills only`);\r\n        console.log();\r\n    }\r\n    const totalFiles = countDir(agentSrc);\r\n    dbg(`Source: ${agentSrc}`);\r\n    dbg(`Target: ${agentDest}`);\r\n    dbg(`Total source files: ${totalFiles}`);\r\n    log(`  ${c('gray','▸')} Scanning ${c('white', String(totalFiles))} files  ${c('gray','→')}  ${c('gray', agentDest)}`);\r\n\r\n    try {\r\n        // Build filter for --minimal mode\r\n        const minimalFilter = isMinimal ? (name, parentDir) => {\r\n            const parentName = path.basename(parentDir);\r\n            if (parentName === 'agents') return CORE_AGENTS.has(name);\r\n            if (parentName === 'skills') return CORE_SKILLS.has(name);\r\n            return true; // everything else passes\r\n        } : null;\r\n\r\n        const copied = copyDir(agentSrc, agentDest, dryRun, minimalFilter);\r\n\r\n        console.log();\r\n        if (dryRun) {\r\n            ok(`${bold('DRY RUN')} complete — would install ${c('cyan', String(copied))} files`);\r\n            dim(`Target: ${agentDest}`);\r\n        } else {\r\n            // ── Success card — W=62, rows padded by plain-text length ──\r\n            const W = 62;\r\n            const agentsCount    = fs.readdirSync(path.join(agentDest, 'agents')).length;\r\n            const workflowsCount = fs.readdirSync(path.join(agentDest, 'workflows')).length;\r\n            const skillsCount    = fs.readdirSync(path.join(agentDest, 'skills')).length;\r\n            const scriptsCount   = fs.readdirSync(path.join(agentDest, 'scripts')).length;\r\n\r\n            // Stat rows: compute trailing spaces from plain text so right ║ aligns\r\n            const statRow = (icon, label, val, col) => {\r\n                // emoji JS .length===2 == terminal display width 2 ✓\r\n                const plain = `  ${icon}  ${label.padEnd(10)}${String(val).padStart(3)} installed`;\r\n                const trail = ' '.repeat(Math.max(0, W - plain.length));\r\n                return `  ${c('cyan','║')}  ${icon}  ${c('white',label.padEnd(10))}${c(col,String(val).padStart(3))} ${c('gray','installed')}${trail}${c('cyan','║')}`;\r\n            };\r\n            // Plain-text rows (header / blank)\r\n            const plainRow = (text, wrapFn) => {\r\n                const trail = ' '.repeat(Math.max(0, W - text.length));\r\n                return `  ${c('cyan','║')}${wrapFn(text)}${trail}${c('cyan','║')}`;\r\n            };\r\n            // Next-step rows: fixed cmd column + description\r\n            const stepRow = (cmd, desc) => {\r\n                const plain = `  ${cmd.padEnd(16)}${desc}`;\r\n                const trail = ' '.repeat(Math.max(0, W - plain.length));\r\n                return `  ${c('cyan','║')}  ${c('white',cmd.padEnd(16))}${c('gray',desc)}${trail}${c('cyan','║')}`;\r\n            };\r\n\r\n            console.log(`  ${c('green','✔')} ${bold(c('green','Installation complete'))} ${c('gray','—')} ${c('white',String(copied))} files`);\r\n            console.log(`  ${c('gray','  ╰─')} ${c('gray', agentDest)}`);\r\n            console.log();\r\n            console.log(`  ${c('cyan', '╔' + '═'.repeat(W) + '╗')}`);\r\n            console.log(plainRow(`  What's inside:`, s => c('bold', c('white', s))));\r\n            console.log(`  ${c('cyan', '╠' + '═'.repeat(W) + '╣')}`);\r\n            console.log(statRow('🤖', 'Agents',    agentsCount,    'magenta'));\r\n            console.log(statRow('⚡',  'Workflows', workflowsCount, 'yellow'));\r\n            console.log(statRow('🧠', 'Skills',    skillsCount,    'blue'));\r\n            console.log(statRow('🔧', 'Scripts',   scriptsCount,   'green'));\r\n            console.log(`  ${c('cyan', '╠' + '═'.repeat(W) + '╣')}`);\r\n            console.log(plainRow('', () => ''));\r\n            console.log(plainRow(`  Next steps:`, s => c('gray', s)));\r\n            console.log(stepRow('/generate',      'Generate code with anti-hallucination'));\r\n            console.log(stepRow('/review',         'Audit existing code for issues'));\r\n            console.log(stepRow('/tribunal-full',  'Run all 16 reviewers in parallel'));\r\n            console.log(plainRow('', () => ''));\r\n            console.log(`  ${c('cyan', '╚' + '═'.repeat(W) + '╝')}`);\r\n            console.log();\r\n            log(`  ${c('gray', '✦ Generating IDE bridge files...')}`);\r\n            generateIDEBridges(targetDir, agentDest, dryRun);\r\n        }\r\n\r\n        console.log();\r\n    } catch (e) {\r\n        err(`Failed to install: ${e.message}`);\r\n        process.exit(1);\r\n    }\r\n}\r\n\r\n// ── IDE Bridge Files ──────────────────────────────────────\r\n// Each AI IDE reads rules from a different location.\r\n// We generate bridge files that point each IDE at .agent/\r\nfunction generateIDEBridges(targetDir, agentDest, dryRun = false) {\r\n    const rulesFile = path.join(agentDest, 'rules', 'GEMINI.md');\r\n    let rulesContent = '';\r\n    if (fs.existsSync(rulesFile)) {\r\n        rulesContent = fs.readFileSync(rulesFile, 'utf8');\r\n    }\r\n\r\n    // Helper: write a bridge file only if it doesn't already exist\r\n    const writeBridge = (filePath, content, label) => {\r\n        if (dryRun) {\r\n            dbg(`  would create: ${filePath}`);\r\n            return;\r\n        }\r\n        const dir = path.dirname(filePath);\r\n        if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });\r\n        if (fs.existsSync(filePath)) {\r\n            dbg(`  skip (exists): ${path.basename(filePath)}`);\r\n            return;\r\n        }\r\n        fs.writeFileSync(filePath, content, 'utf8');\r\n        ok(`${label} → ${c('gray', path.relative(targetDir, filePath))}`);\r\n    };\r\n\r\n    // ── 1. Cursor (.cursorrules) ──────────────────────────\r\n    const cursorRules = `# Tribunal Kit — Cursor Bridge\r\n# Auto-generated by tribunal-kit init. Do not edit manually.\r\n# Source: .agent/rules/GEMINI.md\r\n\r\n${rulesContent}\r\n`;\r\n    writeBridge(\r\n        path.join(targetDir, '.cursorrules'),\r\n        cursorRules,\r\n        'Cursor'\r\n    );\r\n\r\n    // ── 2. Windsurf (.windsurfrules) ─────────────────────\r\n    const windsurfRules = `# Tribunal Kit — Windsurf Bridge\r\n# Auto-generated by tribunal-kit init. Do not edit manually.\r\n# Source: .agent/rules/GEMINI.md\r\n\r\n${rulesContent}\r\n`;\r\n    writeBridge(\r\n        path.join(targetDir, '.windsurfrules'),\r\n        windsurfRules,\r\n        'Windsurf'\r\n    );\r\n\r\n    // ── 3. Gemini / Antigravity (.gemini/settings.json) ──\r\n    const geminiSettings = JSON.stringify({\r\n        \"$schema\": \"https://raw.githubusercontent.com/anthropics/anthropic-cookbook/main/.gemini/settings.schema.json\",\r\n        \"rules\": [\r\n            { \"path\": \"../.agent/rules/GEMINI.md\", \"trigger\": \"always_on\" }\r\n        ],\r\n        \"agents\": { \"directory\": \"../.agent/agents\" },\r\n        \"skills\": { \"directory\": \"../.agent/skills\" },\r\n        \"workflows\": { \"directory\": \"../.agent/workflows\" }\r\n    }, null, 2) + '\\n';\r\n    writeBridge(\r\n        path.join(targetDir, '.gemini', 'settings.json'),\r\n        geminiSettings,\r\n        'Gemini/Antigravity'\r\n    );\r\n\r\n    // ── Also create .gemini/GEMINI.md as a direct rules file ──\r\n    const geminiRulesBridge = `---\r\ntrigger: always_on\r\n---\r\n\r\n# Tribunal Kit — Gemini Bridge\r\n# Auto-generated by tribunal-kit init.\r\n# Full rules: .agent/rules/GEMINI.md\r\n\r\n${rulesContent}\r\n`;\r\n    writeBridge(\r\n        path.join(targetDir, '.gemini', 'GEMINI.md'),\r\n        geminiRulesBridge,\r\n        'Gemini rules'\r\n    );\r\n\r\n    // ── 4. GitHub Copilot (.github/copilot-instructions.md) ──\r\n    const copilotInstructions = `# Tribunal Kit — Copilot Bridge\r\n# Auto-generated by tribunal-kit init. Do not edit manually.\r\n# Source: .agent/rules/GEMINI.md\r\n\r\n${rulesContent}\r\n`;\r\n    writeBridge(\r\n        path.join(targetDir, '.github', 'copilot-instructions.md'),\r\n        copilotInstructions,\r\n        'GitHub Copilot'\r\n    );\r\n\r\n    // ── 5. Claude (.claude/CLAUDE.md) ─────────────────────\r\n    const claudeRules = `# Tribunal Kit — Claude Bridge\r\n# Auto-generated by tribunal-kit init. Do not edit manually.\r\n# Source: .agent/rules/GEMINI.md\r\n\r\n${rulesContent}\r\n`;\r\n    writeBridge(\r\n        path.join(targetDir, '.claude', 'CLAUDE.md'),\r\n        claudeRules,\r\n        'Claude'\r\n    );\r\n\r\n    console.log();\r\n}\r\n\r\nfunction cmdUpdate(flags) {\r\n    // ── Self-install guard (early, before banner) ───────────\r\n    const targetDir = flags.path ? path.resolve(flags.path) : process.cwd();\r\n    if (isSelfInstall(targetDir)) {\r\n        err('Cannot run update inside the tribunal-kit package itself.');\r\n        err(`Target: ${targetDir}`);\r\n        console.log();\r\n        dim('This command is designed to update .agent/ in OTHER projects.');\r\n        dim('Run it from the root of the project you want to update:');\r\n        dim('  cd /path/to/your-project');\r\n        dim('  npx tribunal-kit update');\r\n        console.log();\r\n        process.exit(1);\r\n    }\r\n    // ────────────────────────────────────────────────────────\r\n\r\n    // Update = init with --force\r\n    flags.force = true;\r\n    if (!quiet) {\r\n        log(`  ${c('cyan','↻')} ${bold('Updating')} ${c('white','.agent/')} to latest version...`);\r\n        console.log();\r\n    }\r\n    cmdInit(flags);\r\n}\r\n\r\n\r\nfunction cmdLearn(flags) {\r\n    const targetDir = flags.path ? path.resolve(flags.path) : process.cwd();\r\n    const agentDest = path.join(targetDir, '.agent');\r\n\r\n    if (!fs.existsSync(agentDest)) {\r\n        err('.agent/ not found. Run: npx tribunal-kit init');\r\n        process.exit(1);\r\n    }\r\n\r\n    banner();\r\n\r\n    const W     = 62;\r\n    const title = '  Tribunal Learn — Supreme Court Mode';\r\n    const trail = ' '.repeat(Math.max(0, W - title.length));\r\n    console.log(`  ${c('cyan', '\\u2554' + '\\u2550'.repeat(W) + '\\u2557')}`);\r\n    console.log(`  ${c('cyan', '\\u2551')}${c('bold', c('white', title))}${trail}${c('cyan', '\\u2551')}`);\r\n    console.log(`  ${c('cyan', '\\u255a' + '\\u2550'.repeat(W) + '\\u255d')}`);\r\n    console.log();\r\n\r\n    const dryRun  = flags.dryRun ? '--dry-run' : '';\r\n    const useHead = flags.head   ? '--head'    : '';\r\n\r\n\r\n    // Phase 1: Skill Evolution\r\n    log(`  ${c('cyan', '\\u229b')} ${bold('Phase 1')} \\u2014 Skill Evolution Forge (auto-generating project idioms)`);\r\n    const evoScript = path.join(agentDest, 'scripts', 'skill_evolution.js');\r\n    if (!fs.existsSync(evoScript)) {\r\n        warn('skill_evolution.js not found \\u2014 run: npx tribunal-kit update');\r\n    } else {\r\n        try {\r\n            const cmd = `node \"${evoScript}\" digest ${dryRun} ${useHead}`.trim();\r\n            execSync(cmd, { stdio: 'inherit', cwd: targetDir });\r\n        } catch (e) {\r\n            warn(`Skill Evolution error: ${e.message}`);\r\n        }\r\n    }\r\n\r\n    console.log();\r\n\r\n    // Phase 2: Case Law prompt\r\n    log(`  ${c('cyan', '\\u229b')} ${bold('Phase 2')} \\u2014 Case Law Engine (building precedence record)`);\r\n    console.log();\r\n    log(`  ${c('gray','\\u25b8')} Record a new rejection precedent:`);\r\n    log(`    ${c('white', 'npx tribunal-kit case add')}`);\r\n    console.log();\r\n    log(`  ${c('gray','\\u25b8')} Search existing case law:`);\r\n    log(`    ${c('white', 'npx tribunal-kit case search \"your query\"')}`);\r\n    console.log();\r\n    log(`  ${c('green', '\\u2714')} ${bold('Learn cycle complete.')} Your Tribunal grows smarter with every commit.`);\r\n    console.log();\r\n}\r\n\r\n// ── Async Main Wrapper ───────────────────────────────────\r\nasync function runWithUpdateCheck(command, flags) {\r\n    const shouldSkip = flags.skipUpdateCheck || process.env.TK_SKIP_UPDATE_CHECK === '1';\r\n\r\n    if (!shouldSkip && (command === 'init' || command === 'update')) {\r\n        // Pass through the original args (minus the node/script path)\r\n        const originalArgs = process.argv.slice(2);\r\n        const didReInvoke = await autoUpdateCheck(originalArgs);\r\n        if (didReInvoke) {\r\n            process.exit(0); // Latest version handled it\r\n        }\r\n    }\r\n\r\n    // Proceed with current version\r\n    switch (command) {\r\n        case 'init':\r\n            cmdInit(flags);\r\n            break;\r\n        case 'update':\r\n            cmdUpdate(flags);\r\n            break;\r\n        case 'status':\r\n            cmdStatus(flags);\r\n            break;\r\n        case 'learn':\r\n            cmdLearn(flags);\r\n            break;\r\n        case 'case':\r\n            cmdCase(flags);\r\n            break;\r\n        case 'hook':\r\n            cmdHook(flags);\r\n            break;\r\n        case 'graph':\r\n            cmdGraph(flags);\r\n            break;\r\n        case 'mutate':\r\n            cmdMutate(flags);\r\n            break;\r\n        case 'context':\r\n            cmdContext(flags);\r\n            break;\r\n        case 'uninstall':\r\n            cmdUninstall(flags);\r\n            break;\r\n        case 'help':\r\n        case '--help':\r\n        case '-h':\r\n        case null:\r\n            cmdHelp();\r\n            break;\r\n        default:\r\n            err(`Unknown command: \"${command}\"`);\r\n            console.log();\r\n            dim('Run tribunal-kit --help for usage');\r\n            process.exit(1);\r\n    }\r\n}\r\n\r\nfunction cmdCase(flags) {\r\n    const targetDir = flags.path ? path.resolve(flags.path) : process.cwd();\r\n    const agentDest = path.join(targetDir, '.agent');\r\n\r\n    if (!fs.existsSync(agentDest)) {\r\n        err('.agent/ not found. Run: npx tribunal-kit init');\r\n        process.exit(1);\r\n    }\r\n\r\n    const args = process.argv.slice(3).join(' ');\r\n    if (!args || args === 'help' || args === '--help' || args === '-h') {\r\n        banner();\r\n        log(`  ${c('cyan', '\\u2554' + '\\u2550'.repeat(60) + '\\u2557')}`);\r\n        log(`  ${c('cyan', '\\u2551')}${c('bold', c('white', '  Tribunal Case Law Engine \\u2014 Supreme Court             '))}${c('cyan', '\\u2551')}`);\r\n        log(`  ${c('cyan', '\\u255a' + '\\u2550'.repeat(60) + '\\u255d')}`);\r\n        console.log();\r\n        log(`  ${c('cyan', 'add'.padEnd(10))}  ${c('gray', 'Record a new Case Law rejection pattern')}`);\r\n        log(`  ${c('cyan', 'search'.padEnd(10))}  ${c('gray', 'Search existing cases (e.g., search \"query\")')}`);\r\n        log(`  ${c('cyan', 'list'.padEnd(10))}  ${c('gray', 'List all recorded case law')}`);\r\n        log(`  ${c('cyan', 'show'.padEnd(10))}  ${c('gray', 'Show full diff for a case (e.g., show --id 1)')}`);\r\n        log(`  ${c('cyan', 'stats'.padEnd(10))}  ${c('gray', 'Show case law stats by domain/verdict')}`);\r\n        log(`  ${c('cyan', 'export'.padEnd(10))}  ${c('gray', 'Export all cases to Markdown')}`);\r\n        log(`  ${c('cyan', 'overrule'.padEnd(10))}  ${c('gray', 'Overrule a past precedent (e.g., overrule --id 1)')}`);\r\n        console.log();\r\n        process.exit(1);\r\n    }\r\n\r\n    const caseLawScript = path.join(agentDest, 'scripts', 'case_law_manager.js');\r\n\r\n    // Make shorthand aliases\r\n    let pyArgs = args;\r\n    if (pyArgs.startsWith('add')) pyArgs = pyArgs.replace(/^add/, 'add-case');\r\n    if (pyArgs.startsWith('search')) pyArgs = pyArgs.replace(/^search/, 'search-cases');\r\n\r\n    try {\r\n        const { execSync } = require('child_process');\r\n        execSync(`node \"${caseLawScript}\" ${pyArgs}`, { stdio: 'inherit', cwd: targetDir });\r\n    } catch {\r\n        process.exit(1); // Script already prints errors\r\n    }\r\n}\r\n\r\nfunction cmdGraph(flags) {\r\n    const targetDir = flags.path ? path.resolve(flags.path) : process.cwd();\r\n    const agentDest = path.join(targetDir, '.agent');\r\n\r\n    if (!fs.existsSync(agentDest)) {\r\n        err('.agent/ not found. Run: npx tribunal-kit init');\r\n        process.exit(1);\r\n    }\r\n\r\n    banner();\r\n    const { execSync } = require('child_process');\r\n    const builderScript = path.join(agentDest, 'scripts', 'graph_builder.js');\r\n    const visualizerScript = path.join(agentDest, 'scripts', 'graph_visualizer.js');\r\n    const htmlFile = path.join(agentDest, 'history', 'architecture-explorer.html');\r\n\r\n    try {\r\n        execSync(`node \"${builderScript}\"`, { stdio: 'inherit', cwd: targetDir });\r\n        execSync(`node \"${visualizerScript}\"`, { stdio: 'inherit', cwd: targetDir });\r\n        \r\n        log(`  ${c('cyan', '▸')} Opening visualizer in browser...`);\r\n        const opener = process.platform === 'win32' ? 'start' : process.platform === 'darwin' ? 'open' : 'xdg-open';\r\n        execSync(`${opener} \"${htmlFile}\"`);\r\n    } catch (e) {\r\n        err(`Graph generation failed: ${e.message}`);\r\n        process.exit(1);\r\n    }\r\n}\r\n\r\nfunction cmdHook(flags) {\r\n    const targetDir = flags.path ? path.resolve(flags.path) : process.cwd();\r\n    const gitDir = path.join(targetDir, '.git');\r\n    \r\n    if (!fs.existsSync(gitDir)) {\r\n        err('Not a git repository. Cannot install git hooks here.');\r\n        process.exit(1);\r\n    }\r\n    \r\n    const hooksDir = path.join(gitDir, 'hooks');\r\n    if (!fs.existsSync(hooksDir)) {\r\n        fs.mkdirSync(hooksDir, { recursive: true });\r\n    }\r\n    \r\n    const prePushPath = path.join(hooksDir, 'pre-push');\r\n    const hookScript = `#!/bin/sh\\n# Supreme Court - Auto Learn on Push\\necho \"⚖️  Tribunal Supreme Court: Evolving Skills...\"\\nnpx tribunal-kit learn --head\\n`;\r\n    \r\n    fs.writeFileSync(prePushPath, hookScript, { mode: 0o755 });\r\n    \r\n    console.log();\r\n    log(`  ${c('green', '✔')} Installed pre-push git hook.`);\r\n    log(`  ${c('gray', '▸')} Skill Evolution will now run automatically every time you git push.`);\r\n    console.log();\r\n}\r\n\r\nfunction cmdMutate(flags) {\r\n    const targetDir = flags.path ? path.resolve(flags.path) : process.cwd();\r\n    const agentDest = path.join(targetDir, '.agent');\r\n\r\n    if (!fs.existsSync(agentDest)) {\r\n        err('.agent/ not found. Run: npx tribunal-kit init');\r\n        process.exit(1);\r\n    }\r\n\r\n    const args = process.argv.slice(3);\r\n    if (args.length < 2) {\r\n        err('Usage: npx tribunal-kit mutate <target_file> <test_command>');\r\n        process.exit(1);\r\n    }\r\n\r\n    const mutateScript = path.join(agentDest, 'scripts', 'mutation_runner.js');\r\n    const { execSync } = require('child_process');\r\n    try {\r\n        execSync(`node \"${mutateScript}\" ${args.join(' ')}`, { stdio: 'inherit', cwd: targetDir });\r\n    } catch {\r\n        process.exit(1);\r\n    }\r\n}\r\n\r\nfunction cmdUninstall(flags) {\r\n    const targetDir = flags.path ? path.resolve(flags.path) : process.cwd();\r\n    const agentDest = path.join(targetDir, '.agent');\r\n\r\n    banner();\r\n\r\n    if (!fs.existsSync(agentDest)) {\r\n        log(`  ${c('yellow','⚠')} ${bold('.agent/')} is not installed in this project.`);\r\n        console.log();\r\n        return;\r\n    }\r\n\r\n    if (flags.dryRun) {\r\n        log(colorize('yellow', '  DRY RUN — would remove:'));\r\n        log(`  ${c('gray','  ╰─')} ${agentDest}`);\r\n        console.log();\r\n        return;\r\n    }\r\n\r\n    try {\r\n        fs.rmSync(agentDest, { recursive: true, force: true });\r\n        log(`  ${c('green','✔')} ${bold('.agent/')} has been removed from this project.`);\r\n        console.log();\r\n        log(`  ${c('gray','▸')} To reinstall: ${c('cyan','npx tribunal-kit init')}`);\r\n        console.log();\r\n    } catch (e) {\r\n        err(`Failed to remove .agent/: ${e.message}`);\r\n        process.exit(1);\r\n    }\r\n}\r\n\r\nfunction cmdStatus(flags) {\r\n    const targetDir = flags.path ? path.resolve(flags.path) : process.cwd();\r\n    const agentDest = path.join(targetDir, '.agent');\r\n\r\n    banner();\r\n\r\n    if (!fs.existsSync(agentDest)) {\r\n        log(`  ${c('red','✖')} ${bold('Not installed')} in this project`);\r\n        console.log();\r\n        log(`  ${c('gray','Run:')} ${c('cyan','npx tribunal-kit init')}`);\r\n        console.log();\r\n        return;\r\n    }\r\n\r\n    log(`  ${c('green','✔')} ${bold(c('green','Installed'))}  ${c('gray','→')}  ${c('gray', agentDest)}`);\r\n    console.log();\r\n\r\n    const icons   = { agents: '🤖', workflows: '⚡', skills: '🧠', scripts: '🔧' };\r\n    const colors  = { agents: 'magenta', workflows: 'yellow', skills: 'blue', scripts: 'green' };\r\n    const subdirs = ['agents', 'workflows', 'skills', 'scripts'];\r\n    for (const sub of subdirs) {\r\n        const subPath = path.join(agentDest, sub);\r\n        if (fs.existsSync(subPath)) {\r\n            const count = fs.readdirSync(subPath).filter(f => !fs.statSync(path.join(subPath, f)).isDirectory()).length;\r\n            log(`  ${icons[sub]}  ${c(colors[sub], sub.padEnd(12))}${c('white', String(count).padStart(3))} files`);\r\n        }\r\n    }\r\n    console.log();\r\n}\r\n\r\nfunction cmdHelp() {\r\n    banner();\r\n    const cmd  = (name, desc) => `  ${c('cyan', name.padEnd(10))}  ${c('gray', desc)}`;\r\n    const opt  = (flag, desc) => `  ${c('yellow', flag.padEnd(22))}  ${c('gray', desc)}`;\r\n    const ex   = (s)          => `  ${c('gray', '▸')} ${c('white', s)}`;\r\n\r\n    log(bold('  Commands'));\r\n    log(`  ${c('gray','─'.repeat(40))}`);\r\n    log(cmd('init',     'Install .agent/ into current project'));\r\n    log(cmd('update',   'Re-install to get latest version'));\r\n    log(cmd('status',   'Check if .agent/ is installed'));\r\n    log(cmd('learn',    'Evolve project idioms based on git diffs'));\r\n    log(cmd('case',     'Manage Case Law precedents (add, search, list, show, stats, overrule)'));\r\n    log(cmd('graph',    'Build and visualize the architecture graph'));\r\n    log(cmd('mutate',   'Run the Mutation Engine to test test-suite reliability'));\r\n    log(cmd('context',  'Retrieve a highly-optimized Context Snapshot for a file'));\r\n    log(cmd('hook',     'Install pre-push git hook for auto-learning'));\r\n    log(cmd('uninstall','Remove .agent/ folder from project'));\r\n    console.log();\r\n    log(bold('  Options'));\r\n    log(`  ${c('gray','─'.repeat(40))}`);\r\n    log(opt('--force',              'Overwrite existing .agent/ folder'));\r\n    log(opt('--path <dir>',         'Install in specific directory'));\r\n    log(opt('--quiet',              'Suppress all output'));\r\n    log(opt('--verbose',            'Show detailed debug logging'));\r\n    log(opt('--dry-run',            'Preview actions without executing'));\r\n    log(opt('--minimal',            'Install core agents/skills only (~13 agents)'));\r\n    log(opt('--skip-update-check',  'Skip auto-update version check'));\r\n    log(opt('--head',               '(learn) Diff against last commit instead of staged'));\r\n    console.log();\r\n    log(bold('  Aliases'));\r\n    log(`  ${c('gray','─'.repeat(40))}`);\r\n    log(`  ${c('cyan', 'tk')}  ${c('gray', 'Shorthand for tribunal-kit (e.g., tk init, tk status)')}`);\r\n    console.log();\r\n    log(bold('  Examples'));\r\n    log(`  ${c('gray','─'.repeat(40))}`);\r\n    log(ex('npx tribunal-kit init'));\r\n    log(ex('tk init --force'));\r\n    log(ex('tk init --path ./my-app'));\r\n    log(ex('npx tribunal-kit init --dry-run'));\r\n    log(ex('tk update'));\r\n    log(ex('tk status'));\r\n    log(ex('tk learn'));\r\n    log(ex('tk learn --dry-run'));\r\n    log(ex('tk learn --head'));\r\n    log(ex('tk case add'));\r\n    log(ex('tk case search \"useEffect\"'));\r\n    log(ex('tk case list'));\r\n    log(ex('tk case show --id 1'));\r\n    log(ex('tk case stats'));\r\n    log(ex('tk case export'));\r\n    log(ex('tk case overrule --id 1'));\r\n    log(ex('tk graph'));\r\n    log(ex('tk mutate src/utils.js \"npm test\"'));\r\n    log(ex('tk hook'));\r\n    log(ex('tk uninstall'));\r\n    console.log();\r\n}\r\n\r\n\r\nfunction cmdContext(flags) {\r\n    const targetDir = flags.path ? path.resolve(flags.path) : process.cwd();\r\n    const agentDest = path.join(targetDir, '.agent');\r\n    \r\n    if (!fs.existsSync(agentDest)) {\r\n        err('.agent/ not found. Run: npx tribunal-kit init');\r\n        process.exit(1);\r\n    }\r\n\r\n    const args = process.argv.slice(3);\r\n    if (args.length === 0 || args[0] === 'help' || args[0] === '--help') {\r\n        console.error('Usage: npx tribunal-kit context <target_file>');\r\n        process.exit(1);\r\n    }\r\n\r\n    const targetFile = args[0].replace(/\\\\/g, '/');\r\n    const snapshotName = targetFile.replace(/[\\\\\\/]/g, '__') + '.json';\r\n    const snapshotPath = require('path').join(agentDest, 'history', 'snapshots', snapshotName);\r\n\r\n    if (!require('fs').existsSync(snapshotPath)) {\r\n        console.error('  \\x1b[91m✖\\x1b[0m Context Snapshot not found for: ' + targetFile);\r\n        console.log('    Run: npx tribunal-kit graph  (to generate snapshots)');\r\n        process.exit(1);\r\n    }\r\n\r\n    try {\r\n        const snapshot = JSON.parse(require('fs').readFileSync(snapshotPath, 'utf8'));\r\n        \r\n        console.log('\\n# Context Snapshot: ' + snapshot.file);\r\n        process.stdout.write('> Size Estimate: ' + (snapshot['estimatedTokens'] || 'Unknown') + '\\n');\r\n        console.log('> Risk Score: ' + snapshot.riskScore + ' (Blast Radius: ' + snapshot.blastRadius + ')\\n');\r\n        \r\n        if (Object.keys(snapshot.imports).length > 0) {\r\n            console.log('## Imports');\r\n            for (const [imp, exports] of Object.entries(snapshot.imports)) {\r\n                if (exports && exports.length > 0) {\r\n                    console.log('- `' + imp + '` (exports: ' + exports.join(', ') + ')');\r\n                } else {\r\n                    console.log('- `' + imp + '`');\r\n                }\r\n            }\r\n            console.log();\r\n        }\r\n\r\n        if (snapshot.dependents && snapshot.dependents.length > 0) {\r\n            console.log('## Dependents');\r\n            for (const dep of snapshot.dependents) {\r\n                console.log('- `' + dep + '`');\r\n            }\r\n            console.log();\r\n        }\r\n\r\n        console.log('## Source Code');\r\n        console.log('```javascript\\n' + snapshot.content + '\\n```\\n');\r\n        \r\n    } catch (e) {\r\n        console.error('Failed to read snapshot: ' + e.message);\r\n        process.exit(1);\r\n    }\r\n}\r\n\r\n// ── Main ──────────────────────────────────────────────────\r\nconst { command, flags } = parseArgs(process.argv);\r\n\r\nif (flags.quiet) quiet = true;\r\nif (flags.verbose) verbose = true;\r\n\r\nrunWithUpdateCheck(command, flags);\r\n\r\n// -- Exports (for testing) -- do not remove\r\nif (require.main !== module) {\r\n  module.exports = { parseArgs, compareSemver, copyDir, countDir, isSelfInstall, CORE_AGENTS, CORE_SKILLS, generateIDEBridges };\r\n}\r\n"
+}

package/.agent/history/snapshots/eslint.config.js.json

@@ -0,0 +1,9 @@
+{
+  "file": "eslint.config.js",
+  "hash": "d80785ac22194886311daa5c82c9765de8530876",
+  "riskScore": "Low",
+  "blastRadius": 0,
+  "imports": {},
+  "dependents": [],
+  "content": "module.exports = [\n    {\n        files: [\"**/*.js\"],\n        languageOptions: {\n            ecmaVersion: \"latest\",\n            sourceType: \"commonjs\",\n            globals: {\n                require: \"readonly\",\n                module: \"readonly\",\n                process: \"readonly\",\n                __dirname: \"readonly\",\n                console: \"readonly\",\n                exports: \"readonly\",\n                setTimeout: \"readonly\",\n                clearTimeout: \"readonly\",\n                Buffer: \"readonly\",\n                describe: \"readonly\",\n                test: \"readonly\",\n                it: \"readonly\",\n                expect: \"readonly\",\n                beforeEach: \"readonly\",\n                afterEach: \"readonly\",\n                beforeAll: \"readonly\",\n                afterAll: \"readonly\",\n                jest: \"readonly\"\n            }\n        },\n        rules: {\n            \"no-unused-vars\": [\"warn\", { \"argsIgnorePattern\": \"^_\", \"varsIgnorePattern\": \"^_\", \"caughtErrorsIgnorePattern\": \"^_\" }],\n            \"no-undef\": \"error\"\n        }\n    }\n];\n"
+}

package/.agent/history/snapshots/migrate_refs.js.json

@@ -0,0 +1,11 @@
+{
+  "file": "migrate_refs.js",
+  "hash": "35b39052ff45b0b768fced3417c6245d9637ac18",
+  "riskScore": "Low",
+  "blastRadius": 0,
+  "imports": {
+    "fs": []
+  },
+  "dependents": [],
+  "content": "const fs = require('fs');\r\n\r\nconst filesToUpdate = [\r\n    \".agent/workflows/swarm.md\",\r\n    \".agent/workflows/session.md\",\r\n    \".agent/rules/GEMINI.md\",\r\n    \".agent/ARCHITECTURE.md\",\r\n    \".agent/agents/swarm-worker-contracts.md\",\r\n    \"AGENT_FLOW.md\",\r\n    \"CHANGELOG.md\"\r\n];\r\n\r\nlet totalChanges = 0;\r\n\r\nfor (const filepath of filesToUpdate) {\r\n    if (!fs.existsSync(filepath)) continue;\r\n    let content = fs.readFileSync(filepath, 'utf8');\r\n    \r\n    // Explicit python calls\r\n    content = content.replace(/python \\.agent\\/scripts\\/swarm_dispatcher\\.py/g, 'node .agent/scripts/swarm_dispatcher.js');\r\n    content = content.replace(/python \\.agent\\/scripts\\/session_manager\\.py/g, 'node .agent/scripts/session_manager.js');\r\n    content = content.replace(/python \\.agent\\/scripts\\/minify_context\\.py/g, 'node .agent/scripts/minify_context.js');\r\n    content = content.replace(/python \\.agent\\/scripts\\/test_swarm_dispatcher\\.py/g, 'npx jest test/integration/swarm_dispatcher.test.js');\r\n    \r\n    // General filename references\r\n    content = content.replace(/swarm_dispatcher\\.py/g, 'swarm_dispatcher.js');\r\n    content = content.replace(/session_manager\\.py/g, 'session_manager.js');\r\n    content = content.replace(/minify_context\\.py/g, 'minify_context.js');\r\n    content = content.replace(/test_swarm_dispatcher\\.py/g, 'swarm_dispatcher.test.js');\r\n\r\n    fs.writeFileSync(filepath, content, 'utf8');\r\n    totalChanges++;\r\n}\r\nconsole.log(`Updated ${totalChanges} files.`);\r\n"
+}

package/.agent/history/snapshots/scripts__changelog.js.json

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

package/.agent/history/snapshots/scripts__sync-version.js.json

@@ -0,0 +1,12 @@
+{
+  "file": "scripts/sync-version.js",
+  "hash": "222ce95e5cbce0525359105d277688cfe61c7c6c",
+  "riskScore": "Low",
+  "blastRadius": 0,
+  "imports": {
+    "fs": [],
+    "path": []
+  },
+  "dependents": [],
+  "content": "#!/usr/bin/env node\r\n/**\r\n * sync-version.js — Version Sync for Tribunal Kit\r\n * \r\n * Reads the version and counts from package.json and the .agent/ directory,\r\n * then updates all stale references across documentation files.\r\n * \r\n * Run manually or as a preversion npm script:\r\n *   node scripts/sync-version.js\r\n */\r\n\r\nconst fs = require('fs');\r\nconst path = require('path');\r\n\r\nconst ROOT = path.resolve(__dirname, '..');\r\nconst PKG = JSON.parse(fs.readFileSync(path.join(ROOT, 'package.json'), 'utf8'));\r\n\r\n// Count actual installed items\r\nfunction countItems(dir) {\r\n    const fullPath = path.join(ROOT, '.agent', dir);\r\n    if (!fs.existsSync(fullPath)) return '?';\r\n    return fs.readdirSync(fullPath).filter(f => !f.startsWith('.')).length;\r\n}\r\n\r\nconst version = PKG.version;\r\nconst agents = countItems('agents');\r\nconst skills = countItems('skills');\r\nconst workflows = countItems('workflows');\r\nconst scripts = countItems('scripts');\r\n\r\nconsole.log(`\\n  📊 Tribunal Kit v${version} — Actual Counts`);\r\nconsole.log(`  ──────────────────────────────────────`);\r\nconsole.log(`  Agents:    ${agents}`);\r\nconsole.log(`  Skills:    ${skills}`);\r\nconsole.log(`  Workflows: ${workflows}`);\r\nconsole.log(`  Scripts:   ${scripts}`);\r\nconsole.log();\r\n\r\n// Files to check for stale numbers\r\nconst FILES_TO_CHECK = [\r\n    'README.md',\r\n    'AGENT_FLOW.md',\r\n    '.agent/ARCHITECTURE.md',\r\n];\r\n\r\nlet staleFound = 0;\r\n\r\nfor (const relPath of FILES_TO_CHECK) {\r\n    const filePath = path.join(ROOT, relPath);\r\n    if (!fs.existsSync(filePath)) continue;\r\n\r\n    const content = fs.readFileSync(filePath, 'utf8');\r\n    \r\n    // Check for common stale patterns\r\n    const checks = [\r\n        { regex: /(\\d+)\\s*(specialist\\s+)?agents/gi, expected: agents, label: 'agents' },\r\n        { regex: /(\\d+)\\s*skill\\s*modules/gi, expected: skills, label: 'skills' },\r\n        { regex: /(\\d+)\\s*slash\\s*command/gi, expected: workflows, label: 'workflows' },\r\n    ];\r\n\r\n    for (const check of checks) {\r\n        let match;\r\n        while ((match = check.regex.exec(content)) !== null) {\r\n            const found = parseInt(match[1]);\r\n            if (found !== check.expected && found > 5) { // ignore tiny numbers\r\n                staleFound++;\r\n                const line = content.substring(0, match.index).split('\\n').length;\r\n                console.log(`  ⚠️  ${relPath}:${line} — says ${found} ${check.label}, actual is ${check.expected}`);\r\n            }\r\n        }\r\n    }\r\n}\r\n\r\nif (staleFound === 0) {\r\n    console.log(`  ✅ All counts are in sync across ${FILES_TO_CHECK.length} files.`);\r\n} else {\r\n    console.log(`\\n  ❌ Found ${staleFound} stale reference(s). Update manually or run the sync tool.`);\r\n    process.exit(1);\r\n}\r\n\r\nconsole.log();\r\n"
+}

package/.agent/history/snapshots/scripts__validate-payload.js.json

@@ -0,0 +1,12 @@
+{
+  "file": "scripts/validate-payload.js",
+  "hash": "deefae3cc5c6807b56978fc47c36b85e7db03bc6",
+  "riskScore": "Low",
+  "blastRadius": 0,
+  "imports": {
+    "fs": [],
+    "path": []
+  },
+  "dependents": [],
+  "content": "const fs = require('fs');\r\nconst path = require('path');\r\n\r\n// Simple Markdown frontmatter and Tribunal header validator\r\nfunction validateMarkdownFile(filePath) {\r\n    const content = fs.readFileSync(filePath, 'utf8');\r\n    let errors = [];\r\n\r\n    // Check for frontmatter\r\n    if (content.startsWith('---')) {\r\n        const parts = content.split('---');\r\n        if (parts.length < 3) {\r\n            errors.push('Malformed YAML frontmatter (missing closing ---)');\r\n        }\r\n    }\r\n\r\n    // If it's a skill, check for mandatory headers\r\n    if (filePath.includes('/skills/') || filePath.includes('\\\\skills\\\\')) {\r\n        // Exclude templates and documentation that aren't strict skills\r\n        if (!filePath.includes('SKILL.md')) return errors;\r\n        \r\n        if (!content.includes('Pre-Flight Checklist') && !content.includes('Pre-Flight')) {\r\n            errors.push('Missing mandatory header/section: Pre-Flight Checklist');\r\n        }\r\n        if (!content.includes('VBC Protocol') && !content.includes('VBC')) {\r\n            errors.push('Missing mandatory header/section: VBC Protocol');\r\n        }\r\n    }\r\n\r\n    return errors;\r\n}\r\n\r\nfunction walkDir(dir, callback) {\r\n    fs.readdirSync(dir).forEach(f => {\r\n        let dirPath = path.join(dir, f);\r\n        let isDirectory = fs.statSync(dirPath).isDirectory();\r\n        isDirectory ? walkDir(dirPath, callback) : callback(path.join(dir, f));\r\n    });\r\n}\r\n\r\nfunction run() {\r\n    const agentDir = path.join(__dirname, '..', '.agent');\r\n    if (!fs.existsSync(agentDir)) {\r\n        console.error('No .agent directory found.');\r\n        process.exit(1);\r\n    }\r\n\r\n    let hasErrors = false;\r\n    let checkedCount = 0;\r\n    \r\n    console.log('Validating .agent payload...');\r\n    \r\n    walkDir(agentDir, function(filePath) {\r\n        if (filePath.endsWith('.md')) {\r\n            checkedCount++;\r\n            const errors = validateMarkdownFile(filePath);\r\n            if (errors.length > 0) {\r\n                console.error(`\\x1b[31m[FAIL]\\x1b[0m ${filePath}`);\r\n                errors.forEach(e => console.error(`  - ${e}`));\r\n                hasErrors = true;\r\n            }\r\n        }\r\n    });\r\n\r\n    if (hasErrors) {\r\n        console.error(`\\nPayload validation failed. Checked ${checkedCount} files.`);\r\n        process.exit(1);\r\n    } else {\r\n        console.log(`\\x1b[32mPayload validation passed.\\x1b[0m Checked ${checkedCount} files.`);\r\n    }\r\n}\r\n\r\nrun();\r\n"
+}