tribunal-kit 4.4.0 → 4.4.2

package/.agent/scripts/deep_compress.js

@@ -1,150 +1,150 @@
-#!/usr/bin/env node
-/**
- * deep_compress.js - Deep surgical compression for .agent/ markdown files (skills, agents, workflows).
- */
-
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-
-const BASE_DIRS = ['.agent/skills', '.agent/agents', '.agent/workflows'];
-
-const REMOVE_SECTIONS = [
-    /^## 🏛️ Tribunal Integration[\s\S]*?(?=\n## |$)/gm,
-    /^## Tribunal Integration[\s\S]*?(?=\n## |$)/gm,
-    /^### ✅ Pre-Flight Self-Audit[\s\S]*?(?=\n### |\n## |$)/gm,
-    /^## Pre-Flight Self-Audit[\s\S]*?(?=\n## |$)/gm,
-    /^## Cross-Workflow Navigation[\s\S]*?(?=\n## |$)/gm,
-    /^## LLM Traps[\s\S]*?(?=\n## |$)/gm,
-    /^## VBC Protocol[\s\S]*?(?=\n## |$)/gm,
-    /^## Output Format\n```[\s\S]*?```\n/gm,
-    /^## 🤖 LLM-Specific Traps[\s\S]*?(?=\n## |$)/gm,
-];
-
-const VERBOSE_COMMENT_PATTERNS = [
-    /^(\s*)\/\/\s*(?:Any HTML or SVG element|motion\.div, motion\.span|The MAGIC of|This is the key performance|The pattern that|Compound components share|Note that children|The action receives|Children inherit the|Import first|Parent controls when|It's always motion)\b[^\n]*\n/gm,
-    /^(\s*)#\s*(?:TypedDict gives you|Usage:|Note:|Return user|Return None|Automatically)\b[^\n]*\n/gm,
-    /^\s*\/\/\s*Usage:\s*\n(?=\s*[<{])/gm,
-    /^\s*#\s*Usage:\s*\n(?=\s*[{])/gm,
-    /^\s*\/\/\s*When (?:server responds|a component|React can interrupt|the React Compiler)[^\n]*\n/gm,
-];
-
-function stripChattyOpeners(content) {
-    return content.replace(/(^# .+\n)\n.{60,}\n.{30,}\n(?:\n---)/gm, '$1\n---');
-}
-
-function compressLegacyModernBlocks(content) {
-    const pattern = /```(\w+)\n((?:.*\n)*?.*(?:\/\/|#) ❌ LEGACY[^\n]*\n(?:.*\n)*?)```\n\n```\w+\n((?:.*\n)*?.*(?:\/\/|#) ✅ MODERN[^\n]*\n(?:.*\n)*?)```/gm;
-    return content.replace(pattern, (match, lang, legacy, modern) => {
-        const totalLines = (legacy.match(/\n/g) || []).length + (modern.match(/\n/g) || []).length;
-        if (totalLines > 28) return match;
-        return `\`\`\`${lang}\n// ❌ LEGACY\n${legacy.trim()}\n\n// ✅ MODERN\n${modern.trim()}\n\`\`\``;
-    });
-}
-
-function stripEmptyComments(content) {
-    content = content.replace(/^\s*\/\/\s*$\n/gm, '');
-    content = content.replace(/^\s*#\s*$\n/gm, '');
-    return content;
-}
-
-function dedupBulletPoints(content) {
-    const lines = content.split('\n');
-    const seenBullets = {};
-    const output = [];
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        const stripped = line.trim();
-        if (/^(✅|❌|- ✅|- ❌)/.test(stripped)) {
-            if (seenBullets[stripped] !== undefined && (i - seenBullets[stripped]) < 80) {
-                continue;
-            }
-            seenBullets[stripped] = i;
-        }
-        output.push(line);
-    }
-    return output.join('\n');
-}
-
-function collapseBlanks(content) {
-    return content.replace(/\n{3,}/g, '\n\n');
-}
-
-function compressFile(filePath) {
-    const original = fs.readFileSync(filePath, 'utf8');
-    let content = original;
-
-    for (const pattern of REMOVE_SECTIONS) {
-        content = content.replace(pattern, '');
-    }
-
-    content = stripChattyOpeners(content);
-    content = compressLegacyModernBlocks(content);
-
-    for (const pattern of VERBOSE_COMMENT_PATTERNS) {
-        content = content.replace(pattern, '');
-    }
-
-    content = stripEmptyComments(content);
-    content = dedupBulletPoints(content);
-    content = collapseBlanks(content);
-
-    if (content.trim() !== original.trim()) {
-        fs.writeFileSync(filePath, content.trim() + '\n', 'utf8');
-    }
-
-    return [Buffer.byteLength(original, 'utf8'), Buffer.byteLength(content, 'utf8')];
-}
-
-function main() {
-    let totalOrig = 0;
-    let totalNew = 0;
-    const fileResults = [];
-
-    function walkDir(dir) {
-        let items;
-        try { items = fs.readdirSync(dir, { withFileTypes: true }); } catch { return; }
-        for (const item of items) {
-            const fpath = path.join(dir, item.name);
-            if (item.isDirectory()) walkDir(fpath);
-            else if (item.name.endsWith('.md')) {
-                const [orig, newL] = compressFile(fpath);
-                totalOrig += orig;
-                totalNew += newL;
-                const saved = orig - newL;
-                if (saved > 200) {
-                    fileResults.push([saved, fpath]);
-                }
-            }
-        }
-    }
-
-    for (const base of BASE_DIRS) {
-        if (fs.existsSync(base)) walkDir(base);
-    }
-
-    fileResults.sort((a, b) => b[0] - a[0]);
-
-    const savedTotal = totalOrig - totalNew;
-    const pct = totalOrig ? (savedTotal / totalOrig * 100) : 0;
-
-    console.log(`\n${'='.repeat(58)}`);
-    console.log(`  Deep Compression Complete`);
-    console.log(`${'='.repeat(58)}`);
-    console.log(`  Original : ${totalOrig} bytes (${Math.floor(totalOrig / 1024)}KB)`);
-    console.log(`  After    : ${totalNew} bytes (${Math.floor(totalNew / 1024)}KB)`);
-    console.log(`  Saved    : ${savedTotal} bytes (${Math.floor(savedTotal / 1024)}KB) — ${pct.toFixed(1)}%`);
-    console.log(`\n  Top savings:`);
-    
-    for (const [saved, filePath] of fileResults.slice(0, 20)) {
-        const parts = filePath.split(path.sep);
-        const skill = parts.length >= 2 ? `${parts[parts.length - 2]}/${parts[parts.length - 1]}` : filePath;
-        console.log(`    -${Math.floor(saved / 1024).toString().padStart(2, ' ')}KB  ${skill}`);
-    }
-    console.log();
-}
-
-if (require.main === module) {
-    main();
-}
+#!/usr/bin/env node
+/**
+ * deep_compress.js - Deep surgical compression for .agent/ markdown files (skills, agents, workflows).
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const BASE_DIRS = ['.agent/skills', '.agent/agents', '.agent/workflows'];
+
+const REMOVE_SECTIONS = [
+    /^## 🏛️ Tribunal Integration[\s\S]*?(?=\n## |$)/gm,
+    /^## Tribunal Integration[\s\S]*?(?=\n## |$)/gm,
+    /^### ✅ Pre-Flight Self-Audit[\s\S]*?(?=\n### |\n## |$)/gm,
+    /^## Pre-Flight Self-Audit[\s\S]*?(?=\n## |$)/gm,
+    /^## Cross-Workflow Navigation[\s\S]*?(?=\n## |$)/gm,
+    /^## LLM Traps[\s\S]*?(?=\n## |$)/gm,
+    /^## VBC Protocol[\s\S]*?(?=\n## |$)/gm,
+    /^## Output Format\n```[\s\S]*?```\n/gm,
+    /^## 🤖 LLM-Specific Traps[\s\S]*?(?=\n## |$)/gm,
+];
+
+const VERBOSE_COMMENT_PATTERNS = [
+    /^(\s*)\/\/\s*(?:Any HTML or SVG element|motion\.div, motion\.span|The MAGIC of|This is the key performance|The pattern that|Compound components share|Note that children|The action receives|Children inherit the|Import first|Parent controls when|It's always motion)\b[^\n]*\n/gm,
+    /^(\s*)#\s*(?:TypedDict gives you|Usage:|Note:|Return user|Return None|Automatically)\b[^\n]*\n/gm,
+    /^\s*\/\/\s*Usage:\s*\n(?=\s*[<{])/gm,
+    /^\s*#\s*Usage:\s*\n(?=\s*[{])/gm,
+    /^\s*\/\/\s*When (?:server responds|a component|React can interrupt|the React Compiler)[^\n]*\n/gm,
+];
+
+function stripChattyOpeners(content) {
+    return content.replace(/(^# .+\n)\n.{60,}\n.{30,}\n(?:\n---)/gm, '$1\n---');
+}
+
+function compressLegacyModernBlocks(content) {
+    const pattern = /```(\w+)\n((?:.*\n)*?.*(?:\/\/|#) ❌ LEGACY[^\n]*\n(?:.*\n)*?)```\n\n```\w+\n((?:.*\n)*?.*(?:\/\/|#) ✅ MODERN[^\n]*\n(?:.*\n)*?)```/gm;
+    return content.replace(pattern, (match, lang, legacy, modern) => {
+        const totalLines = (legacy.match(/\n/g) || []).length + (modern.match(/\n/g) || []).length;
+        if (totalLines > 28) return match;
+        return `\`\`\`${lang}\n// ❌ LEGACY\n${legacy.trim()}\n\n// ✅ MODERN\n${modern.trim()}\n\`\`\``;
+    });
+}
+
+function stripEmptyComments(content) {
+    content = content.replace(/^\s*\/\/\s*$\n/gm, '');
+    content = content.replace(/^\s*#\s*$\n/gm, '');
+    return content;
+}
+
+function dedupBulletPoints(content) {
+    const lines = content.split('\n');
+    const seenBullets = {};
+    const output = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const stripped = line.trim();
+        if (/^(✅|❌|- ✅|- ❌)/.test(stripped)) {
+            if (seenBullets[stripped] !== undefined && (i - seenBullets[stripped]) < 80) {
+                continue;
+            }
+            seenBullets[stripped] = i;
+        }
+        output.push(line);
+    }
+    return output.join('\n');
+}
+
+function collapseBlanks(content) {
+    return content.replace(/\n{3,}/g, '\n\n');
+}
+
+function compressFile(filePath) {
+    const original = fs.readFileSync(filePath, 'utf8');
+    let content = original;
+
+    for (const pattern of REMOVE_SECTIONS) {
+        content = content.replace(pattern, '');
+    }
+
+    content = stripChattyOpeners(content);
+    content = compressLegacyModernBlocks(content);
+
+    for (const pattern of VERBOSE_COMMENT_PATTERNS) {
+        content = content.replace(pattern, '');
+    }
+
+    content = stripEmptyComments(content);
+    content = dedupBulletPoints(content);
+    content = collapseBlanks(content);
+
+    if (content.trim() !== original.trim()) {
+        fs.writeFileSync(filePath, content.trim() + '\n', 'utf8');
+    }
+
+    return [Buffer.byteLength(original, 'utf8'), Buffer.byteLength(content, 'utf8')];
+}
+
+function main() {
+    let totalOrig = 0;
+    let totalNew = 0;
+    const fileResults = [];
+
+    function walkDir(dir) {
+        let items;
+        try { items = fs.readdirSync(dir, { withFileTypes: true }); } catch { return; }
+        for (const item of items) {
+            const fpath = path.join(dir, item.name);
+            if (item.isDirectory()) walkDir(fpath);
+            else if (item.name.endsWith('.md')) {
+                const [orig, newL] = compressFile(fpath);
+                totalOrig += orig;
+                totalNew += newL;
+                const saved = orig - newL;
+                if (saved > 200) {
+                    fileResults.push([saved, fpath]);
+                }
+            }
+        }
+    }
+
+    for (const base of BASE_DIRS) {
+        if (fs.existsSync(base)) walkDir(base);
+    }
+
+    fileResults.sort((a, b) => b[0] - a[0]);
+
+    const savedTotal = totalOrig - totalNew;
+    const pct = totalOrig ? (savedTotal / totalOrig * 100) : 0;
+
+    console.log(`\n${'='.repeat(58)}`);
+    console.log(`  Deep Compression Complete`);
+    console.log(`${'='.repeat(58)}`);
+    console.log(`  Original : ${totalOrig} bytes (${Math.floor(totalOrig / 1024)}KB)`);
+    console.log(`  After    : ${totalNew} bytes (${Math.floor(totalNew / 1024)}KB)`);
+    console.log(`  Saved    : ${savedTotal} bytes (${Math.floor(savedTotal / 1024)}KB) — ${pct.toFixed(1)}%`);
+    console.log(`\n  Top savings:`);
+    
+    for (const [saved, filePath] of fileResults.slice(0, 20)) {
+        const parts = filePath.split(path.sep);
+        const skill = parts.length >= 2 ? `${parts[parts.length - 2]}/${parts[parts.length - 1]}` : filePath;
+        console.log(`    -${Math.floor(saved / 1024).toString().padStart(2, ' ')}KB  ${skill}`);
+    }
+    console.log();
+}
+
+if (require.main === module) {
+    main();
+}

package/.agent/scripts/dependency_analyzer.js

@@ -18,12 +18,16 @@
 
 const fs = require('fs');
 const path = require('path');
-const { spawnSync } = require('child_process');
 
-const { RED, GREEN, YELLOW, BLUE, BOLD, RESET } = require('./colors.js');
+const {
+    RED, GREEN, YELLOW, BLUE, BOLD, DIM, CYAN, RESET,
+    banner, sectionHeader, timer, formatMs,
+    ok, fail, warn, skip,
+} = require('./_colors');
+
+const { walkDir, loadJson, runCommand } = require('./_utils');
 
 const SOURCE_EXTENSIONS = new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]);
-const SKIP_DIRS = new Set(["node_modules", ".git", "dist", "build", ".next", ".agent", "__pycache__", "test", "tests", "__tests__"]);
 
 const NODE_BUILTINS = new Set([
     "fs", "path", "os", "crypto", "http", "https", "url", "util",
@@ -37,36 +41,6 @@ const NODE_BUILTINS = new Set([
     "node:perf_hooks", "node:worker_threads", "node:timers"
 ]);
 
-function header(title) {
-    console.log(`\n${BOLD}${BLUE}━━━ ${title} ━━━${RESET}`);
-}
-
-function ok(msg) {
-    console.log(`  ${GREEN}✅ ${msg}${RESET}`);
-}
-
-function fail(msg) {
-    console.log(`  ${RED}❌ ${msg}${RESET}`);
-}
-
-function warn(msg) {
-    console.log(`  ${YELLOW}⚠️  ${msg}${RESET}`);
-}
-
-function skip(msg) {
-    console.log(`  ${YELLOW}⏭️  ${msg}${RESET}`);
-}
-
-function loadPackageJson(projectRoot) {
-    const pkgPath = path.resolve(projectRoot, "package.json");
-    if (!fs.existsSync(pkgPath)) return null;
-    try {
-        return JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
-    } catch {
-        return null;
-    }
-}
-
 function extractImports(projectRoot) {
     const imports = new Set();
     const importPatterns = [
@@ -75,42 +49,30 @@ function extractImports(projectRoot) {
         /import\s*\(\s*["']([^"'.][^"']*)["']/g
     ];
 
-    function walk(dir) {
-        let items;
-        try {
-            items = fs.readdirSync(dir, { withFileTypes: true });
-        } catch {
-            return;
-        }
-
-        for (const item of items) {
-            if (item.isDirectory()) {
-                if (!SKIP_DIRS.has(item.name)) walk(path.join(dir, item.name));
-            } else {
-                const ext = path.extname(item.name);
-                if (SOURCE_EXTENSIONS.has(ext)) {
-                    try {
-                        const content = fs.readFileSync(path.join(dir, item.name), 'utf8');
-                        for (const pattern of importPatterns) {
-                            let match;
-                            while ((match = pattern.exec(content)) !== null) {
-                                let pkg = match[1];
-                                if (pkg.startsWith("@")) {
-                                    const parts = pkg.split("/");
-                                    pkg = parts.length >= 2 ? `${parts[0]}/${parts[1]}` : pkg;
-                                } else {
-                                    pkg = pkg.split("/")[0];
-                                }
-                                imports.add(pkg);
-                            }
-                        }
-                    } catch {}
+    // Use shared walkDir from _utils.js
+    const files = walkDir(projectRoot, { extensions: SOURCE_EXTENSIONS });
+
+    for (const fullPath of files) {
+        let content;
+        try { content = fs.readFileSync(fullPath, 'utf8'); } catch { continue; }
+
+        for (const pattern of importPatterns) {
+            // Reset regex state for each file
+            pattern.lastIndex = 0;
+            let match;
+            while ((match = pattern.exec(content)) !== null) {
+                let pkg = match[1];
+                if (pkg.startsWith("@")) {
+                    const parts = pkg.split("/");
+                    pkg = parts.length >= 2 ? `${parts[0]}/${parts[1]}` : pkg;
+                } else {
+                    pkg = pkg.split("/")[0];
                 }
+                imports.add(pkg);
             }
         }
     }
 
-    walk(projectRoot);
     return imports;
 }
 
@@ -151,44 +113,41 @@ function checkPhantom(pkg, usedImports) {
 }
 
 function runNpmAudit(projectRoot) {
+    const result = runCommand('npm', ['audit', '--json'], {
+        cwd: projectRoot,
+        timeout: 60000,
+    });
+
+    if (result.status === null && !result.stdout) {
+        skip("npm not installed — skipping audit");
+        return true;
+    }
+
     try {
-        const executable = process.platform === 'win32' ? 'npm.cmd' : 'npm';
-        const result = spawnSync(executable, ["audit", "--json"], {
-            cwd: projectRoot,
-            encoding: 'utf8',
-            timeout: 60000,
-            shell: process.platform === 'win32'
-        });
-
-        try {
-            const auditData = JSON.parse(result.stdout);
-            const vulns = (auditData.metadata && auditData.metadata.vulnerabilities) || {};
-            const critical = vulns.critical || 0;
-            const high = vulns.high || 0;
-            const moderate = vulns.moderate || 0;
-            const low = vulns.low || 0;
-
-            if (critical + high > 0) {
-                fail(`npm audit: ${critical} critical, ${high} high, ${moderate} moderate, ${low} low`);
-                return false;
-            } else if (moderate + low > 0) {
-                warn(`npm audit: ${moderate} moderate, ${low} low vulnerabilities`);
-                return true;
-            } else {
-                ok("npm audit — no known vulnerabilities");
-                return true;
-            }
-        } catch {
-            if (result.status === 0) {
-                ok("npm audit — clean");
-                return true;
-            }
-            fail("npm audit returned errors");
+        const auditData = JSON.parse(result.stdout);
+        const vulns = (auditData.metadata && auditData.metadata.vulnerabilities) || {};
+        const critical = vulns.critical || 0;
+        const high = vulns.high || 0;
+        const moderate = vulns.moderate || 0;
+        const low = vulns.low || 0;
+
+        if (critical + high > 0) {
+            fail(`npm audit: ${critical} critical, ${high} high, ${moderate} moderate, ${low} low`);
             return false;
+        } else if (moderate + low > 0) {
+            warn(`npm audit: ${moderate} moderate, ${low} low vulnerabilities`);
+            return true;
+        } else {
+            ok("npm audit — no known vulnerabilities");
+            return true;
         }
     } catch {
-        skip("npm not installed — skipping audit");
-        return true;
+        if (result.ok) {
+            ok("npm audit — clean");
+            return true;
+        }
+        fail("npm audit returned errors");
+        return false;
     }
 }
 
@@ -220,21 +179,23 @@ function main() {
         process.exit(1);
     }
 
-    console.log(`${BOLD}Tribunal — dependency_analyzer.js${RESET}`);
-    console.log(`Project: ${projectRoot}`);
+    console.log(banner('dependency_analyzer.js', { Project: projectRoot }));
 
-    const pkg = loadPackageJson(projectRoot);
+    const pkg = loadJson(path.join(projectRoot, 'package.json'));
     if (!pkg) {
         skip("No package.json found — dependency analysis requires a Node.js project");
         process.exit(0);
     }
 
     let issues = 0;
+    const elapsed = timer();
     const usedImports = extractImports(projectRoot);
-    console.log(`\n  Found ${usedImports.size} unique external imports in source code`);
+    const scanMs = elapsed();
+
+    console.log(`\n  ${DIM}Found ${usedImports.size} unique external imports in ${formatMs(scanMs)}${RESET}`);
 
     if (!checkUnusedFlag) {
-        header("Phantom Imports (not in package.json)");
+        console.log(sectionHeader('Phantom Imports (not in package.json)'));
         const phantom = checkPhantom(pkg, usedImports);
         if (phantom.length > 0) {
             for (const p of phantom) fail(`'${p}' is imported but not in package.json — possible hallucination`);
@@ -244,7 +205,7 @@ function main() {
         }
     }
 
-    header("Unused Dependencies");
+    console.log(sectionHeader('Unused Dependencies'));
     const unused = checkUnused(pkg, usedImports);
     if (unused.length > 0) {
         for (const u of unused) warn(`'${u}' is in package.json but never imported — may be unused`);
@@ -253,16 +214,17 @@ function main() {
     }
 
     if (auditFlag) {
-        header("Vulnerability Audit");
+        console.log(sectionHeader('Vulnerability Audit'));
         if (!runNpmAudit(projectRoot)) issues += 1;
     }
 
-    console.log(`\n${BOLD}━━━ Dependency Analysis Summary ━━━${RESET}`);
+    console.log(`\n${BOLD}${CYAN}━━━ Dependency Analysis Summary ━━━${RESET}`);
     if (issues === 0) {
         ok("All dependency checks passed");
     } else {
         fail(`${issues} issue(s) found — review above`);
     }
+    console.log();
 
     process.exit(issues > 0 ? 1 : 0);
 }