tribunal-kit 6.0.0 → 7.0.0

package/.agent/scripts/auto_preview.js

@@ -9,28 +9,28 @@
  *   node .agent/scripts/auto_preview.js restart
  */
 
-"use strict";
+'use strict';
 
-const fs = require("fs");
-const path = require("path");
-const { spawn } = require("child_process");
-const net = require("net");
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+const net = require('net');
 
-const PID_FILE = ".preview.pid";
+const PID_FILE = '.preview.pid';
 const DEFAULT_PORT = 3000;
 const TIMEOUT_SECONDS = 30;
 
-const { GREEN, RED, YELLOW, BOLD, RESET } = require("./colors.js");
+const { GREEN, RED, YELLOW, BOLD, RESET } = require('./colors.js');
 
 function findStartCommand() {
-  const pkgPath = path.resolve("package.json");
+  const pkgPath = path.resolve('package.json');
   if (!fs.existsSync(pkgPath)) return { cmd: [], found: false };
 
   try {
-    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
     const scripts = pkg.scripts || {};
-    if (scripts.dev) return { cmd: ["npm", "run", "dev"], found: true };
-    if (scripts.start) return { cmd: ["npm", "run", "start"], found: true };
+    if (scripts.dev) return { cmd: ['npm', 'run', 'dev'], found: true };
+    if (scripts.start) return { cmd: ['npm', 'run', 'start'], found: true };
   } catch {
     // Ignore
   }
@@ -38,13 +38,13 @@ function findStartCommand() {
 }
 
 function getPortFromEnv() {
-  const envPath = path.resolve(".env");
+  const envPath = path.resolve('.env');
   if (fs.existsSync(envPath)) {
     try {
-      const data = fs.readFileSync(envPath, "utf8");
-      for (const line of data.split("\n")) {
-        if (line.trim().startsWith("PORT=")) {
-          return parseInt(line.split("=")[1].trim(), 10);
+      const data = fs.readFileSync(envPath, 'utf8');
+      for (const line of data.split('\n')) {
+        if (line.trim().startsWith('PORT=')) {
+          return parseInt(line.split('=')[1].trim(), 10);
         }
       }
     } catch {}
@@ -53,36 +53,36 @@ function getPortFromEnv() {
 }
 
 function isPortOpen(port) {
-  return new Promise((resolve) => {
+  return new Promise(resolve => {
     const client = new net.Socket();
     client.setTimeout(1000);
     client
-      .once("connect", () => {
+      .once('connect', () => {
         client.destroy();
         resolve(true);
       })
-      .once("timeout", () => {
+      .once('timeout', () => {
         client.destroy();
         resolve(false);
       })
-      .once("error", () => {
+      .once('error', () => {
         resolve(false);
       })
-      .connect(port, "localhost");
+      .connect(port, 'localhost');
   });
 }
 
 function readPid() {
   if (fs.existsSync(PID_FILE)) {
     try {
-      return parseInt(fs.readFileSync(PID_FILE, "utf8").trim(), 10);
+      return parseInt(fs.readFileSync(PID_FILE, 'utf8').trim(), 10);
     } catch {}
   }
   return null;
 }
 
 function writePid(pid) {
-  fs.writeFileSync(PID_FILE, String(pid), "utf8");
+  fs.writeFileSync(PID_FILE, String(pid), 'utf8');
 }
 
 function clearPid() {
@@ -107,18 +107,16 @@ async function startServer() {
     console.log(
       `   This project has no package.json, or its package.json has no 'dev' or 'start' script.`,
     );
-    console.log(
-      `   Add a script to package.json, or start your server manually.`,
-    );
+    console.log(`   Add a script to package.json, or start your server manually.`);
     return;
   }
 
-  console.log(`${BOLD}Starting: ${cmd.join(" ")}${RESET}`);
+  console.log(`${BOLD}Starting: ${cmd.join(' ')}${RESET}`);
   // Adjust command for windows (npm.cmd instead of npm)
-  const executable = process.platform === "win32" ? `${cmd[0]}.cmd` : cmd[0];
+  const executable = process.platform === 'win32' ? `${cmd[0]}.cmd` : cmd[0];
 
   const proc = spawn(executable, cmd.slice(1), {
-    stdio: "pipe",
+    stdio: 'pipe',
     detached: true,
   });
 
@@ -135,19 +133,17 @@ async function startServer() {
       console.log(`\n${GREEN}✅ Server started${RESET}`);
       console.log(`   URL:     http://localhost:${port}`);
       console.log(`   PID:     ${proc.pid}`);
-      console.log(`   Command: ${cmd.join(" ")}`);
+      console.log(`   Command: ${cmd.join(' ')}`);
       console.log(`\nStop with: node .agent/scripts/auto_preview.js stop`);
       return;
     }
-    process.stdout.write(".");
-    await new Promise((r) => setTimeout(r, 1000));
+    process.stdout.write('.');
+    await new Promise(r => setTimeout(r, 1000));
   }
 
-  console.log(
-    `\n${RED}❌ Server did not start within ${TIMEOUT_SECONDS}s${RESET}`,
-  );
+  console.log(`\n${RED}❌ Server did not start within ${TIMEOUT_SECONDS}s${RESET}`);
   try {
-    process.kill(proc.pid, "SIGTERM");
+    process.kill(proc.pid, 'SIGTERM');
   } catch {}
   clearPid();
 }
@@ -159,7 +155,7 @@ function stopServer() {
     return;
   }
   try {
-    process.kill(pid, "SIGTERM");
+    process.kill(pid, 'SIGTERM');
     console.log(`${GREEN}✅ Server stopped (PID ${pid})${RESET}`);
   } catch {
     console.log(`${YELLOW}Process ${pid} was not running${RESET}`);
@@ -181,7 +177,7 @@ async function showStatus() {
 
 async function main() {
   const args = process.argv.slice(2);
-  const actions = new Set(["start", "stop", "status", "restart"]);
+  const actions = new Set(['start', 'stop', 'status', 'restart']);
 
   if (args.length < 1 || !actions.has(args[0])) {
     console.log(`Usage: node auto_preview.js [start|stop|status|restart]`);
@@ -189,15 +185,15 @@ async function main() {
   }
 
   const action = args[0];
-  if (action === "start") {
+  if (action === 'start') {
     await startServer();
-  } else if (action === "stop") {
+  } else if (action === 'stop') {
     stopServer();
-  } else if (action === "status") {
+  } else if (action === 'status') {
     await showStatus();
-  } else if (action === "restart") {
+  } else if (action === 'restart') {
     stopServer();
-    await new Promise((r) => setTimeout(r, 1000));
+    await new Promise(r => setTimeout(r, 1000));
     await startServer();
   }
 }

package/.agent/scripts/bundle_analyzer.js

@@ -14,10 +14,10 @@
  *   node .agent/scripts/bundle_analyzer.js . --threshold 500
  */
 
-"use strict";
+'use strict';
 
-const fs = require("fs");
-const path = require("path");
+const fs = require('fs');
+const path = require('path');
 
 const {
   YELLOW,
@@ -33,21 +33,21 @@ const {
   fail,
   warn,
   skip,
-} = require("./_colors");
+} = require('./_colors');
 
-const { loadJson, runCommand } = require("./_utils");
+const { loadJson, runCommand } = require('./_utils');
 
 const HEAVY_PACKAGES = {
-  moment: "Use date-fns or dayjs instead (~2KB vs ~230KB)",
-  lodash: "Import specific functions: lodash/debounce instead of full lodash",
-  rxjs: "Import specific operators to enable tree-shaking",
-  "aws-sdk": "Use @aws-sdk/client-* v3 modular imports",
-  firebase: "Use modular imports: firebase/auth, firebase/firestore",
-  "chart.js": "Register only needed components",
-  three: "Import specific modules from three/examples/jsm/",
-  "@mui/material": "Ensure babel-plugin-import or modular imports",
-  "@mui/icons-material": "Import specific icons, never the barrel",
-  antd: "Use modular imports with babel-plugin-import",
+  moment: 'Use date-fns or dayjs instead (~2KB vs ~230KB)',
+  lodash: 'Import specific functions: lodash/debounce instead of full lodash',
+  rxjs: 'Import specific operators to enable tree-shaking',
+  'aws-sdk': 'Use @aws-sdk/client-* v3 modular imports',
+  firebase: 'Use modular imports: firebase/auth, firebase/firestore',
+  'chart.js': 'Register only needed components',
+  three: 'Import specific modules from three/examples/jsm/',
+  '@mui/material': 'Ensure babel-plugin-import or modular imports',
+  '@mui/icons-material': 'Import specific icons, never the barrel',
+  antd: 'Use modular imports with babel-plugin-import',
 };
 
 function formatSize(sizeBytes) {
@@ -57,27 +57,27 @@ function formatSize(sizeBytes) {
 }
 
 function detectBundler(projectRoot) {
-  const pkg = loadJson(path.join(projectRoot, "package.json"));
+  const pkg = loadJson(path.join(projectRoot, 'package.json'));
   if (!pkg) return null;
 
   const deps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
 
-  if (deps.vite) return "vite";
-  if (deps.next) return "next";
-  if (deps.webpack) return "webpack";
+  if (deps.vite) return 'vite';
+  if (deps.next) return 'next';
+  if (deps.webpack) return 'webpack';
 
   if (
-    fs.existsSync(path.join(projectRoot, "webpack.config.js")) ||
-    fs.existsSync(path.join(projectRoot, "webpack.config.ts"))
+    fs.existsSync(path.join(projectRoot, 'webpack.config.js')) ||
+    fs.existsSync(path.join(projectRoot, 'webpack.config.ts'))
   ) {
-    return "webpack";
+    return 'webpack';
   }
 
   return null;
 }
 
 function findDistDir(projectRoot) {
-  const candidates = ["dist", "build", ".next", "out", "public/build"];
+  const candidates = ['dist', 'build', '.next', 'out', 'public/build'];
   for (const c of candidates) {
     const d = path.join(projectRoot, c);
     if (fs.existsSync(d) && fs.statSync(d).isDirectory()) return d;
@@ -118,7 +118,7 @@ function analyzeDist(distDir) {
 }
 
 function checkHeavyDependencies(projectRoot) {
-  const pkg = loadJson(path.join(projectRoot, "package.json"));
+  const pkg = loadJson(path.join(projectRoot, 'package.json'));
   if (!pkg) return [];
 
   const deps = Object.keys(pkg.dependencies || {});
@@ -133,14 +133,14 @@ function checkHeavyDependencies(projectRoot) {
 }
 
 function runBuild(projectRoot) {
-  const pkg = loadJson(path.join(projectRoot, "package.json"));
+  const pkg = loadJson(path.join(projectRoot, 'package.json'));
   if (pkg && (!pkg.scripts || !pkg.scripts.build)) {
     skip("No 'build' script found in package.json");
     return true;
   }
 
   const elapsed = timer();
-  const result = runCommand("npm", ["run", "build"], {
+  const result = runCommand('npm', ['run', 'build'], {
     cwd: projectRoot,
     timeout: 300000,
   });
@@ -152,9 +152,9 @@ function runBuild(projectRoot) {
   }
 
   fail(`Build failed ${DIM}(${formatMs(ms)})${RESET}`);
-  const output = (result.stdout + "\n" + result.stderr).trim();
+  const output = (result.stdout + '\n' + result.stderr).trim();
   if (output) {
-    for (const line of output.split("\n").slice(0, 10)) {
+    for (const line of output.split('\n').slice(0, 10)) {
       console.log(`    ${line}`);
     }
   }
@@ -169,18 +169,14 @@ function main() {
   let threshold = 250;
 
   for (let i = 0; i < args.length; i++) {
-    if (args[i] === "--build") buildFlag = true;
-    else if (args[i] === "--threshold" && i + 1 < args.length) {
+    if (args[i] === '--build') buildFlag = true;
+    else if (args[i] === '--threshold' && i + 1 < args.length) {
       threshold = parseInt(args[++i], 10);
-    } else if (args[i] === "-h" || args[i] === "--help") {
-      console.log(
-        "Usage: node bundle_analyzer.js <path> [--build] [--threshold <kb>]",
-      );
+    } else if (args[i] === '-h' || args[i] === '--help') {
+      console.log('Usage: node bundle_analyzer.js <path> [--build] [--threshold <kb>]');
       process.exit(0);
-    } else if (args[i].startsWith("-")) {
-      console.log(
-        "Usage: node bundle_analyzer.js <path> [--build] [--threshold <kb>]",
-      );
+    } else if (args[i].startsWith('-')) {
+      console.log('Usage: node bundle_analyzer.js <path> [--build] [--threshold <kb>]');
       process.exit(1);
     } else if (!targetPath) {
       targetPath = args[i];
@@ -188,9 +184,7 @@ function main() {
   }
 
   if (!targetPath) {
-    console.log(
-      "Usage: node bundle_analyzer.js <path> [--build] [--threshold <kb>]",
-    );
+    console.log('Usage: node bundle_analyzer.js <path> [--build] [--threshold <kb>]');
     process.exit(1);
   }
 
@@ -202,15 +196,15 @@ function main() {
 
   const bundler = detectBundler(projectRoot);
   console.log(
-    banner("bundle_analyzer.js", {
+    banner('bundle_analyzer.js', {
       Project: projectRoot,
-      Bundler: bundler || "auto-detect",
+      Bundler: bundler || 'auto-detect',
       Threshold: `${threshold}KB`,
     }),
   );
 
   if (buildFlag) {
-    console.log(sectionHeader("Building Project"));
+    console.log(sectionHeader('Building Project'));
     if (!runBuild(projectRoot)) {
       process.exit(1);
     }
@@ -223,25 +217,19 @@ function main() {
   let distResult = null;
 
   if (!distDir) {
-    skip("No build output directory found (dist/, build/, .next/, out/)");
-    skip("Run with --build to create a build first, or build manually");
+    skip('No build output directory found (dist/, build/, .next/, out/)');
+    skip('Run with --build to create a build first, or build manually');
   } else {
-    console.log(
-      sectionHeader(
-        `Bundle Size Analysis (${path.relative(projectRoot, distDir)}/)`,
-      ),
-    );
+    console.log(sectionHeader(`Bundle Size Analysis (${path.relative(projectRoot, distDir)}/)`));
     distResult = analyzeDist(distDir);
-    console.log(
-      `\n  Total bundle size: ${BOLD}${formatSize(distResult.total)}${RESET}`,
-    );
+    console.log(`\n  Total bundle size: ${BOLD}${formatSize(distResult.total)}${RESET}`);
 
     const thresholdBytes = threshold * 1024;
     console.log(`\n  ${BOLD}Top files by size:${RESET}`);
     let count = 0;
     for (const [filepath, size] of distResult.files) {
       if (count++ >= 10) break;
-      const sizeStr = formatSize(size).padStart(10, " ");
+      const sizeStr = formatSize(size).padStart(10, ' ');
       if (size > thresholdBytes) {
         warn(`${sizeStr}  ${filepath}`);
       } else {
@@ -250,8 +238,7 @@ function main() {
     }
 
     const largeJs = distResult.files.filter(
-      ([f, s]) =>
-        (f.endsWith(".js") || f.endsWith(".mjs")) && s > thresholdBytes,
+      ([f, s]) => (f.endsWith('.js') || f.endsWith('.mjs')) && s > thresholdBytes,
     );
     if (largeJs.length > 0) {
       console.log(
@@ -260,14 +247,14 @@ function main() {
     }
   }
 
-  console.log(sectionHeader("Dependency Weight Check"));
+  console.log(sectionHeader('Dependency Weight Check'));
   if (heavy.length > 0) {
     for (const [pkgName, suggestion] of heavy) {
       warn(`'${pkgName}' is a heavy dependency`);
       console.log(`      → ${suggestion}`);
     }
   } else {
-    ok("No known-heavy packages detected");
+    ok('No known-heavy packages detected');
   }
 
   // ━━━ Summary ━━━ (reuses cached distResult instead of re-scanning)
@@ -286,7 +273,7 @@ function main() {
   if (heavy.length > 0) {
     warn(`${heavy.length} heavy dependency suggestion(s) — see above`);
   } else if (distResult && heavy.length === 0) {
-    ok("No optimization suggestions");
+    ok('No optimization suggestions');
   }
   console.log();
 }