tribunal-kit 4.4.1 → 4.4.2

package/.agent/scripts/graph_visualizer.js

@@ -10,6 +10,8 @@
 const fs = require('fs');
 const path = require('path');
 
+const { RED, GREEN, DIM, RESET } = require('./_colors');
+
 const AGENT_DIR = path.join(process.cwd(), '.agent');
 const HISTORY_DIR = path.join(AGENT_DIR, 'history');
 const CACHE_FILE = path.join(HISTORY_DIR, 'graph-cache.json');
@@ -17,7 +19,7 @@ const HTML_FILE = path.join(HISTORY_DIR, 'architecture-explorer.html');
 
 function main() {
     if (!fs.existsSync(CACHE_FILE)) {
-        console.error('\x1b[31m✖ Error: graph-cache.json not found. Run graph_builder.js first.\x1b[0m');
+        console.error(`${RED}✖ Error: graph-cache.json not found. Run graph_builder.js first.${RESET}`);
         process.exit(1);
     }
 
@@ -377,8 +379,12 @@ function main() {
 </html>`;
 
     fs.writeFileSync(HTML_FILE, htmlContent);
-    console.log(`\x1b[32m✔ Interactive visualizer generated.\x1b[0m`);
-    console.log(`  \x1b[2mSaved to: ${HTML_FILE}\x1b[0m`);
+    console.log(`${GREEN}✔ Interactive visualizer generated.${RESET}`);
+    console.log(`  ${DIM}Saved to: ${HTML_FILE}${RESET}`);
 }
 
-main();
+module.exports = { main };
+
+if (require.main === module) {
+    main();
+}

package/.agent/scripts/graph_zoom.js

@@ -10,6 +10,8 @@
 const fs = require('fs');
 const path = require('path');
 
+const { RED, CYAN, RESET } = require('./_colors');
+
 function getFlag(name) {
     const idx = process.argv.indexOf(name);
     return (idx !== -1 && process.argv[idx + 1]) ? process.argv[idx + 1] : null;
@@ -18,14 +20,14 @@ function getFlag(name) {
 const targetFile = getFlag('--focus');
 
 if (!targetFile) {
-    console.error('\x1b[31m✖ Error: Provide a file to zoom into. Usage: node graph_zoom.js --focus <filepath>\x1b[0m');
+    console.error(`${RED}✖ Error: Provide a file to zoom into. Usage: node graph_zoom.js --focus <filepath>${RESET}`);
     process.exit(1);
 }
 
 const absolutePath = path.resolve(process.cwd(), targetFile);
 
 if (!fs.existsSync(absolutePath)) {
-    console.error(`\x1b[31m✖ Error: File not found at ${absolutePath}\x1b[0m`);
+    console.error(`${RED}✖ Error: File not found at ${absolutePath}${RESET}`);
     process.exit(1);
 }
 
@@ -119,7 +121,7 @@ function extractSkeleton(content) {
 }
 
 function main() {
-    console.log(`\x1b[96m✦ Zooming into: ${targetFile}\x1b[0m`);
+    console.log(`${CYAN}✦ Zooming into: ${targetFile}${RESET}`);
     
     try {
         const content = fs.readFileSync(absolutePath, 'utf8');
@@ -142,7 +144,7 @@ function main() {
         console.log('--- SKELETON END ---\n');
         
     } catch (e) {
-        console.error(`\x1b[31m✖ Error parsing file: ${e.message}\x1b[0m`);
+        console.error(`${RED}✖ Error parsing file: ${e.message}${RESET}`);
         // Fallback Logic: Return truncated raw on hard failure
         const rawContent = fs.readFileSync(absolutePath, 'utf8').split('\n').slice(0, 100).join('\n');
         console.log('\n--- RAW FILE FALLBACK (100 lines) ---');

package/.agent/scripts/inner_loop_validator.js

@@ -120,14 +120,8 @@ const SYNTAX_HEURISTICS = [
     },
 ];
 
-// ── ANSI colors (inline to avoid deps on colors.js path) ─────────────────
-const GREEN  = '\x1b[92m';
-const YELLOW = '\x1b[93m';
-const RED    = '\x1b[91m';
-const CYAN   = '\x1b[96m';
-const BOLD   = '\x1b[1m';
-const DIM    = '\x1b[2m';
-const RESET  = '\x1b[0m';
+// ── ANSI colors (centralized via _colors.js) ─────────────────────────────
+const { GREEN, YELLOW, RED, CYAN, BOLD, DIM, RESET } = require('./_colors');
 
 // ── Core scanning ─────────────────────────────────────────────────────────
 

package/.agent/scripts/lint_runner.js

@@ -1,187 +1,186 @@
-#!/usr/bin/env node
-/**
- * lint_runner.js — Standalone lint runner for the Tribunal Agent Kit.
- *
- * Usage:
- *   node .agent/scripts/lint_runner.js .
- *   node .agent/scripts/lint_runner.js . --fix
- *   node .agent/scripts/lint_runner.js . --files src/index.ts src/utils.ts
- */
-
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { spawnSync } = require('child_process');
-
-const { RED, GREEN, YELLOW, BLUE, BOLD, RESET } = require('./colors.js');
-
-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 skip(msg) {
-    console.log(`  ${YELLOW}⏭️  ${msg}${RESET}`);
-}
-
-function runLinter(label, cmd, cwd) {
-    try {
-        const executable = process.platform === 'win32' && cmd[0] === 'npx' ? 'npx.cmd' : cmd[0];
-        const result = spawnSync(executable, cmd.slice(1), {
-            cwd,
-            encoding: 'utf8',
-            timeout: 120000,
-            shell: process.platform === 'win32'
-        });
-
-        if (result.status === 0) {
-            ok(`${label} — clean`);
-            return true;
-        }
-
-        fail(`${label} — issues found`);
-        if (result.error) {
-            console.log(`    Error: ${result.error.message}`);
-        }
-        const out = result.stdout ? result.stdout.toString() : '';
-        const err = result.stderr ? result.stderr.toString() : '';
-        const output = (out + "\n" + err).trim();
-        if (output) {
-            const lines = output.split('\n');
-            for (const line of lines.slice(0, 15)) {
-                console.log(`    ${line}`);
-            }
-            if (lines.length > 15) {
-                console.log(`    ... and ${lines.length - 15} more lines`);
-            }
-        }
-        return false;
-    } catch {
-        skip(`${label} — tool not installed`);
-        return true;
-    }
-}
-
-function detectLinters(projectRoot) {
-    const available = {};
-    const pkgJson = path.join(projectRoot, "package.json");
-    
-    if (fs.existsSync(pkgJson)) {
-        const eslintFiles = [".eslintrc", ".eslintrc.js", ".eslintrc.json", ".eslintrc.yml", "eslint.config.js", "eslint.config.mjs"];
-        available.eslint = eslintFiles.some(f => fs.existsSync(path.join(projectRoot, f))); 
-        
-        const prettierFiles = [".prettierrc", ".prettierrc.js", ".prettierrc.json", "prettier.config.js"];
-        available.prettier = prettierFiles.some(f => fs.existsSync(path.join(projectRoot, f)));
-    }
-
-    available.ruff = fs.existsSync(path.join(projectRoot, "pyproject.toml")) || fs.existsSync(path.join(projectRoot, "ruff.toml"));
-    available.flake8 = fs.existsSync(path.join(projectRoot, ".flake8")) || fs.existsSync(path.join(projectRoot, "setup.cfg"));
-
-    return available;
-}
-
-function main() {
-    const args = process.argv.slice(2);
-    let targetPath = null;
-    let fixFlag = false;
-    let fileArgs = [];
-
-    let i = 0;
-    while (i < args.length) {
-        if (args[i] === '--fix') fixFlag = true;
-        else if (args[i] === '--files') {
-            i++;
-            while (i < args.length && !args[i].startsWith('--')) {
-                fileArgs.push(args[i++]);
-            }
-            continue;
-        } else if (!targetPath && !args[i].startsWith('-')) {
-            targetPath = args[i];
-        }
-        i++;
-    }
-
-    if (!targetPath) {
-        console.log("Usage: node lint_runner.js <path> [--fix] [--files <file1> <file2> ...]");
-        process.exit(1);
-    }
-
-    const projectRoot = path.resolve(targetPath);
-    if (!fs.existsSync(projectRoot) || !fs.statSync(projectRoot).isDirectory()) {
-        fail(`Directory not found: ${projectRoot}`);
-        process.exit(1);
-    }
-
-    console.log(`${BOLD}Tribunal — lint_runner.js${RESET}`);
-    console.log(`Project: ${projectRoot}`);
-
-    const available = detectLinters(projectRoot);
-    if (!Object.values(available).some(Boolean)) {
-        skip("No linter configuration detected in this project");
-        process.exit(0);
-    }
-
-    let failures = 0;
-
-    if (available.eslint) {
-        header("ESLint");
-        const cmd = ["npx", "eslint"];
-        if (fixFlag) cmd.push("--fix");
-        if (fileArgs.length) cmd.push(...fileArgs);
-        else cmd.push(".", "--max-warnings=0");
-        if (!runLinter("ESLint", cmd, projectRoot)) failures++;
-    }
-
-    if (available.prettier) {
-        header("Prettier");
-        const cmd = ["npx", "prettier"];
-        if (fixFlag) cmd.push("--write");
-        else cmd.push("--check");
-        if (fileArgs.length) cmd.push(...fileArgs);
-        else cmd.push(".");
-        if (!runLinter("Prettier", cmd, projectRoot)) failures++;
-    }
-
-    if (available.ruff) {
-        header("Ruff (Python)");
-        const cmd = ["ruff", "check"];
-        if (fixFlag) cmd.push("--fix");
-        if (fileArgs.length) cmd.push(...fileArgs);
-        else cmd.push(".");
-        if (!runLinter("Ruff", cmd, projectRoot)) failures++;
-    }
-
-    if (available.flake8 && !available.ruff) {
-        header("Flake8 (Python)");
-        const cmd = ["flake8"];
-        if (fileArgs.length) cmd.push(...fileArgs);
-        else cmd.push(".");
-        if (!runLinter("Flake8", cmd, projectRoot)) failures++;
-    }
-
-    if (fs.existsSync(path.join(projectRoot, "tsconfig.json"))) {
-        header("TypeScript");
-        if (!runLinter("TypeScript", ["npx", "tsc", "--noEmit"], projectRoot)) failures++;
-    }
-
-    console.log(`\n${BOLD}━━━ Lint Summary ━━━${RESET}`);
-    if (failures === 0) {
-        ok("All linters passed");
-    } else {
-        fail(`${failures} linter(s) reported issues`);
-    }
-
-    process.exit(failures > 0 ? 1 : 0);
-}
-
-if (require.main === module) {
-    main();
-}
+#!/usr/bin/env node
+/**
+ * lint_runner.js — Standalone lint runner for the Tribunal Agent Kit.
+ *
+ * Usage:
+ *   node .agent/scripts/lint_runner.js .
+ *   node .agent/scripts/lint_runner.js . --fix
+ *   node .agent/scripts/lint_runner.js . --files src/index.ts src/utils.ts
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const {
+    RED, GREEN, YELLOW, BLUE, BOLD, DIM, CYAN, RESET,
+    banner, sectionHeader, summaryTable, timer, formatMs,
+    ok, fail, skip,
+} = require('./_colors');
+
+const RESULTS = [];
+
+function runLinter(label, cmd, cwd) {
+    const elapsed = timer();
+    try {
+        const executable = process.platform === 'win32' && cmd[0] === 'npx' ? 'npx.cmd' : cmd[0];
+        const result = spawnSync(executable, cmd.slice(1), {
+            cwd,
+            encoding: 'utf8',
+            timeout: 120000,
+            shell: process.platform === 'win32'
+        });
+
+        const ms = elapsed();
+        if (result.status === 0) {
+            ok(`${label} — clean ${DIM}(${formatMs(ms)})${RESET}`);
+            RESULTS.push({ name: label, status: 'pass', ms });
+            return true;
+        }
+
+        fail(`${label} — issues found ${DIM}(${formatMs(ms)})${RESET}`);
+        RESULTS.push({ name: label, status: 'fail', ms });
+        if (result.error) {
+            console.log(`    Error: ${result.error.message}`);
+        }
+        const out = result.stdout ? result.stdout.toString() : '';
+        const err = result.stderr ? result.stderr.toString() : '';
+        const output = (out + "\n" + err).trim();
+        if (output) {
+            const lines = output.split('\n');
+            for (const line of lines.slice(0, 15)) {
+                console.log(`    ${line}`);
+            }
+            if (lines.length > 15) {
+                console.log(`    ... and ${lines.length - 15} more lines`);
+            }
+        }
+        return false;
+    } catch {
+        skip(`${label} — tool not installed`);
+        RESULTS.push({ name: label, status: 'skip' });
+        return true;
+    }
+}
+
+function detectLinters(projectRoot) {
+    const available = {};
+    const pkgJson = path.join(projectRoot, "package.json");
+    
+    if (fs.existsSync(pkgJson)) {
+        const eslintFiles = [".eslintrc", ".eslintrc.js", ".eslintrc.json", ".eslintrc.yml", "eslint.config.js", "eslint.config.mjs"];
+        available.eslint = eslintFiles.some(f => fs.existsSync(path.join(projectRoot, f))); 
+        
+        const prettierFiles = [".prettierrc", ".prettierrc.js", ".prettierrc.json", "prettier.config.js"];
+        available.prettier = prettierFiles.some(f => fs.existsSync(path.join(projectRoot, f)));
+    }
+
+    available.ruff = fs.existsSync(path.join(projectRoot, "pyproject.toml")) || fs.existsSync(path.join(projectRoot, "ruff.toml"));
+    available.flake8 = fs.existsSync(path.join(projectRoot, ".flake8")) || fs.existsSync(path.join(projectRoot, "setup.cfg"));
+
+    return available;
+}
+
+function main() {
+    const args = process.argv.slice(2);
+    let targetPath = null;
+    let fixFlag = false;
+    let fileArgs = [];
+
+    let i = 0;
+    while (i < args.length) {
+        if (args[i] === '--fix') fixFlag = true;
+        else if (args[i] === '--files') {
+            i++;
+            while (i < args.length && !args[i].startsWith('--')) {
+                fileArgs.push(args[i++]);
+            }
+            continue;
+        } else if (!targetPath && !args[i].startsWith('-')) {
+            targetPath = args[i];
+        }
+        i++;
+    }
+
+    if (!targetPath) {
+        console.log("Usage: node lint_runner.js <path> [--fix] [--files <file1> <file2> ...]");
+        process.exit(1);
+    }
+
+    const projectRoot = path.resolve(targetPath);
+    if (!fs.existsSync(projectRoot) || !fs.statSync(projectRoot).isDirectory()) {
+        fail(`Directory not found: ${projectRoot}`);
+        process.exit(1);
+    }
+
+    console.log(banner('lint_runner.js', { Project: projectRoot, Mode: fixFlag ? 'fix' : 'check' }));
+
+    const available = detectLinters(projectRoot);
+    if (!Object.values(available).some(Boolean)) {
+        skip("No linter configuration detected in this project");
+        process.exit(0);
+    }
+
+    RESULTS.length = 0;
+    let failures = 0;
+
+    if (available.eslint) {
+        console.log(sectionHeader('ESLint'));
+        const cmd = ["npx", "eslint"];
+        if (fixFlag) cmd.push("--fix");
+        if (fileArgs.length) cmd.push(...fileArgs);
+        else cmd.push(".", "--max-warnings=0");
+        if (!runLinter("ESLint", cmd, projectRoot)) failures++;
+    }
+
+    if (available.prettier) {
+        console.log(sectionHeader('Prettier'));
+        const cmd = ["npx", "prettier"];
+        if (fixFlag) cmd.push("--write");
+        else cmd.push("--check");
+        if (fileArgs.length) cmd.push(...fileArgs);
+        else cmd.push(".");
+        if (!runLinter("Prettier", cmd, projectRoot)) failures++;
+    }
+
+    if (available.ruff) {
+        console.log(sectionHeader('Ruff (Python)'));
+        const cmd = ["ruff", "check"];
+        if (fixFlag) cmd.push("--fix");
+        if (fileArgs.length) cmd.push(...fileArgs);
+        else cmd.push(".");
+        if (!runLinter("Ruff", cmd, projectRoot)) failures++;
+    }
+
+    if (available.flake8 && !available.ruff) {
+        console.log(sectionHeader('Flake8 (Python)'));
+        const cmd = ["flake8"];
+        if (fileArgs.length) cmd.push(...fileArgs);
+        else cmd.push(".");
+        if (!runLinter("Flake8", cmd, projectRoot)) failures++;
+    }
+
+    if (fs.existsSync(path.join(projectRoot, "tsconfig.json"))) {
+        console.log(sectionHeader('TypeScript'));
+        if (!runLinter("TypeScript", ["npx", "tsc", "--noEmit"], projectRoot)) failures++;
+    }
+
+    console.log(`\n${BOLD}${CYAN}━━━ Lint Summary ━━━${RESET}`);
+    if (RESULTS.length > 0) {
+        summaryTable(RESULTS);
+    }
+
+    if (failures === 0) {
+        console.log(`\n${GREEN}${BOLD}  ✔ All linters passed.${RESET}\n`);
+    } else {
+        console.log(`\n${RED}${BOLD}  ✖ ${failures} linter(s) reported issues.${RESET}\n`);
+    }
+
+    process.exit(failures > 0 ? 1 : 0);
+}
+
+if (require.main === module) {
+    main();
+}

package/.agent/scripts/schema_validator.js

@@ -13,27 +13,10 @@
 const fs = require('fs');
 const path = require('path');
 
-const { RED, GREEN, YELLOW, BLUE, BOLD, RESET } = require('./colors.js');
-
-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}`);
-}
+const {
+    RED, GREEN, YELLOW, BLUE, BOLD, DIM, CYAN, RESET,
+    sectionHeader: header, ok, fail, warn, skip,
+} = require('./_colors');
 
 function detectOrm(projectRoot) {
     if (fs.existsSync(path.join(projectRoot, "prisma", "schema.prisma"))) {
@@ -221,7 +204,7 @@ function main() {
     let issuesCount = 0;
 
     if (fileArg) {
-        header(`Validating: ${fileArg}`);
+        console.log(header(`Validating: ${fileArg}`));
         const filepath = path.isAbsolute(fileArg) ? fileArg : path.join(projectRoot, fileArg);
         let issues = [];
         if (filepath.endsWith(".prisma")) issues = validatePrisma(filepath);
@@ -239,7 +222,7 @@ function main() {
     } else if (ormType === "prisma") {
         const schemaPath = path.join(projectRoot, "prisma", "schema.prisma");
         if (fs.existsSync(schemaPath)) {
-            header("Prisma Schema Validation");
+            console.log(header("Prisma Schema Validation"));
             const issues = validatePrisma(schemaPath);
             for (const [severity, message, line] of issues) {
                 if (severity === "error") { fail(`L${line}: ${message}`); issuesCount++; }
@@ -250,7 +233,7 @@ function main() {
             skip(`Prisma schema not found at ${schemaPath}`);
         }
     } else if (ormType === "sql") {
-        header("SQL Migration Validation");
+        console.log(header("SQL Migration Validation"));
         // Very basic recursion for migrations dir
         function findMigrations(dir) {
             let res = [];
@@ -281,7 +264,7 @@ function main() {
             }
         }
     } else if (ormType === "drizzle") {
-        header("Drizzle Schema");
+        console.log(header("Drizzle Schema"));
         skip("Drizzle validation not yet implemented — validate manually");
     }