tribunal-kit 4.4.1 → 4.4.3

package/.agent/scripts/test_runner.js

@@ -1,193 +1,186 @@
-#!/usr/bin/env node
-/**
- * test_runner.js — Standalone test runner for the Tribunal Agent Kit.
- *
- * Usage:
- *   node .agent/scripts/test_runner.js .
- *   node .agent/scripts/test_runner.js . --coverage
- *   node .agent/scripts/test_runner.js . --watch
- *   node .agent/scripts/test_runner.js . --file src/utils.test.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 runTests(label, cmd, cwd) {
-    try {
-        const executable = process.platform === 'win32' && (cmd[0] === 'npx' || cmd[0] === 'npm') ? `${cmd[0]}.cmd` : cmd[0];
-        const result = spawnSync(executable, cmd.slice(1), {
-            cwd,
-            encoding: 'utf8',
-            timeout: 300000, // 5m
-            shell: process.platform === 'win32'
-        });
-
-        if (result.error && !result.stdout && !result.stderr) {
-            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) {
-            for (const line of output.split("\n")) {
-                console.log(`    ${line}`);
-            }
-        }
-
-        if (result.status === 0) {
-            ok(`${label} — all tests passed`);
-            return true;
-        }
-
-        fail(`${label} — test failures detected`);
-        return false;
-    } catch {
-        skip(`${label} — tool not installed`);
-        return true;
-    }
-}
-
-function detectTestFramework(projectRoot) {
-    const pkgJson = path.join(projectRoot, "package.json");
-    if (fs.existsSync(pkgJson)) {
-        try {
-            const pkg = JSON.parse(fs.readFileSync(pkgJson, 'utf8'));
-            const deps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
-            const scripts = pkg.scripts || {};
-
-            if (deps.vitest) return "vitest";
-            if (deps.jest) return "jest";
-            if (deps.mocha) return "mocha";
-            if (scripts.test) return "npm-test";
-        } catch {
-            if (fs.readFileSync(pkgJson, 'utf8').includes('"test"')) return "npm-test";
-        }
-    }
-
-    if (fs.existsSync(path.join(projectRoot, "pytest.ini")) || 
-        fs.existsSync(path.join(projectRoot, "pyproject.toml")) || 
-        fs.existsSync(path.join(projectRoot, "conftest.py"))) {
-        return "pytest";
-    }
-
-    // Go
-    function hasGoTests(dir) {
-        let items;
-        try { items = fs.readdirSync(dir, { withFileTypes: true }); } catch { return false; }
-        for (const item of items) {
-            if (item.isDirectory() && !["node_modules", ".git"].includes(item.name)) {
-                if (hasGoTests(path.join(dir, item.name))) return true;
-            } else if (item.name.endsWith("_test.go")) {
-                return true;
-            }
-        }
-        return false;
-    }
-
-    if (hasGoTests(projectRoot)) return "go";
-
-    return null;
-}
-
-function main() {
-    const args = process.argv.slice(2);
-    let targetPath = null;
-    let coverageFlag = false;
-    let watchFlag = false;
-    let fileArg = null;
-
-    let i = 0;
-    while (i < args.length) {
-        if (args[i] === '--coverage') coverageFlag = true;
-        else if (args[i] === '--watch') watchFlag = true;
-        else if (args[i] === '--file' && i + 1 < args.length) fileArg = args[++i];
-        else if (!targetPath && !args[i].startsWith('-')) targetPath = args[i];
-        i++;
-    }
-
-    if (!targetPath) {
-        console.log("Usage: node test_runner.js <path> [--coverage] [--watch] [--file <filepath>]");
-        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 — test_runner.js${RESET}`);
-    console.log(`Project: ${projectRoot}`);
-
-    const framework = detectTestFramework(projectRoot);
-    if (!framework) {
-        skip("No test framework detected in this project");
-        process.exit(0);
-    }
-
-    header(`Running tests (${framework})`);
-
-    let cmd = [];
-    let passed = true;
-
-    if (["vitest", "jest", "mocha", "npm-test"].includes(framework)) {
-        if (framework === "vitest") {
-            cmd = ["npx", "vitest", "run"];
-            if (coverageFlag) cmd.push("--coverage");
-            if (watchFlag) cmd = ["npx", "vitest"];
-            if (fileArg) cmd.push(fileArg);
-        } else if (framework === "jest") {
-            cmd = ["npx", "jest"];
-            if (coverageFlag) cmd.push("--coverage");
-            if (watchFlag) cmd.push("--watch");
-            if (fileArg) cmd.push(fileArg);
-        } else {
-            cmd = ["npm", "test", "--", "--passWithNoTests"];
-            if (coverageFlag) cmd.push("--coverage");
-            if (fileArg) cmd.push(fileArg);
-        }
-        passed = runTests(framework, cmd, projectRoot);
-    } else if (framework === "pytest") {
-        cmd = ["python", "-m", "pytest", "-v"];
-        if (coverageFlag) cmd.push("--cov", "--cov-report=term-missing");
-        if (watchFlag) cmd = ["python", "-m", "pytest-watch", "--", "-v"];
-        if (fileArg) cmd.push(fileArg);
-        passed = runTests("pytest", cmd, projectRoot);
-    } else if (framework === "go") {
-        cmd = ["go", "test", "./...", "-v"];
-        if (coverageFlag) cmd.push("-cover");
-        if (fileArg) cmd = ["go", "test", "-v", "-run", fileArg];
-        passed = runTests("go test", cmd, projectRoot);
-    }
-
-    console.log(`\n${BOLD}━━━ Test Summary ━━━${RESET}`);
-    if (passed) ok(`Tests passed (${framework})`);
-    else fail(`Tests failed (${framework})`);
-
-    process.exit(passed ? 0 : 1);
-}
-
-if (require.main === module) {
-    main();
-}
+#!/usr/bin/env node
+/**
+ * test_runner.js — Standalone test runner for the Tribunal Agent Kit.
+ *
+ * Usage:
+ *   node .agent/scripts/test_runner.js .
+ *   node .agent/scripts/test_runner.js . --coverage
+ *   node .agent/scripts/test_runner.js . --watch
+ *   node .agent/scripts/test_runner.js . --file src/utils.test.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, timer, formatMs,
+    ok, fail, skip,
+} = require('./_colors');
+
+const { loadJson } = require('./_utils');
+
+function runTests(label, cmd, cwd) {
+    const elapsed = timer();
+    try {
+        const executable = process.platform === 'win32' && (cmd[0] === 'npx' || cmd[0] === 'npm') ? `${cmd[0]}.cmd` : cmd[0];
+        const result = spawnSync(executable, cmd.slice(1), {
+            cwd,
+            encoding: 'utf8',
+            timeout: 300000, // 5m
+            shell: process.platform === 'win32'
+        });
+
+        const ms = elapsed();
+
+        if (result.error && !result.stdout && !result.stderr) {
+            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) {
+            for (const line of output.split("\n")) {
+                console.log(`    ${line}`);
+            }
+        }
+
+        if (result.status === 0) {
+            ok(`${label} — all tests passed ${DIM}(${formatMs(ms)})${RESET}`);
+            return true;
+        }
+
+        fail(`${label} — test failures detected ${DIM}(${formatMs(ms)})${RESET}`);
+        return false;
+    } catch {
+        skip(`${label} — tool not installed`);
+        return true;
+    }
+}
+
+function detectTestFramework(projectRoot) {
+    const pkg = loadJson(path.join(projectRoot, "package.json"));
+    if (pkg) {
+        const deps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
+        const scripts = pkg.scripts || {};
+
+        if (deps.vitest) return "vitest";
+        if (deps.jest) return "jest";
+        if (deps.mocha) return "mocha";
+        if (scripts.test) return "npm-test";
+    }
+
+    if (fs.existsSync(path.join(projectRoot, "pytest.ini")) || 
+        fs.existsSync(path.join(projectRoot, "pyproject.toml")) || 
+        fs.existsSync(path.join(projectRoot, "conftest.py"))) {
+        return "pytest";
+    }
+
+    // Go
+    function hasGoTests(dir) {
+        let items;
+        try { items = fs.readdirSync(dir, { withFileTypes: true }); } catch { return false; }
+        for (const item of items) {
+            if (item.isDirectory() && !["node_modules", ".git"].includes(item.name)) {
+                if (hasGoTests(path.join(dir, item.name))) return true;
+            } else if (item.name.endsWith("_test.go")) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    if (hasGoTests(projectRoot)) return "go";
+
+    return null;
+}
+
+function main() {
+    const args = process.argv.slice(2);
+    let targetPath = null;
+    let coverageFlag = false;
+    let watchFlag = false;
+    let fileArg = null;
+
+    let i = 0;
+    while (i < args.length) {
+        if (args[i] === '--coverage') coverageFlag = true;
+        else if (args[i] === '--watch') watchFlag = true;
+        else if (args[i] === '--file' && i + 1 < args.length) fileArg = args[++i];
+        else if (!targetPath && !args[i].startsWith('-')) targetPath = args[i];
+        i++;
+    }
+
+    if (!targetPath) {
+        console.log("Usage: node test_runner.js <path> [--coverage] [--watch] [--file <filepath>]");
+        process.exit(1);
+    }
+
+    const projectRoot = path.resolve(targetPath);
+    if (!fs.existsSync(projectRoot) || !fs.statSync(projectRoot).isDirectory()) {
+        fail(`Directory not found: ${projectRoot}`);
+        process.exit(1);
+    }
+
+    const framework = detectTestFramework(projectRoot);
+    console.log(banner('test_runner.js', {
+        Project: projectRoot,
+        Framework: framework || 'none detected',
+    }));
+
+    if (!framework) {
+        skip("No test framework detected in this project");
+        process.exit(0);
+    }
+
+    console.log(sectionHeader(`Running tests (${framework})`));
+
+    let cmd = [];
+    let passed = true;
+
+    if (["vitest", "jest", "mocha", "npm-test"].includes(framework)) {
+        if (framework === "vitest") {
+            cmd = ["npx", "vitest", "run"];
+            if (coverageFlag) cmd.push("--coverage");
+            if (watchFlag) cmd = ["npx", "vitest"];
+            if (fileArg) cmd.push(fileArg);
+        } else if (framework === "jest") {
+            cmd = ["npx", "jest"];
+            if (coverageFlag) cmd.push("--coverage");
+            if (watchFlag) cmd.push("--watch");
+            if (fileArg) cmd.push(fileArg);
+        } else {
+            cmd = ["npm", "test", "--", "--passWithNoTests"];
+            if (coverageFlag) cmd.push("--coverage");
+            if (fileArg) cmd.push(fileArg);
+        }
+        passed = runTests(framework, cmd, projectRoot);
+    } else if (framework === "pytest") {
+        cmd = ["python", "-m", "pytest", "-v"];
+        if (coverageFlag) cmd.push("--cov", "--cov-report=term-missing");
+        if (watchFlag) cmd = ["python", "-m", "pytest-watch", "--", "-v"];
+        if (fileArg) cmd.push(fileArg);
+        passed = runTests("pytest", cmd, projectRoot);
+    } else if (framework === "go") {
+        cmd = ["go", "test", "./...", "-v"];
+        if (coverageFlag) cmd.push("-cover");
+        if (fileArg) cmd = ["go", "test", "-v", "-run", fileArg];
+        passed = runTests("go test", cmd, projectRoot);
+    }
+
+    console.log(`\n${BOLD}${CYAN}━━━ Test Summary ━━━${RESET}`);
+    if (passed) {
+        console.log(`\n${GREEN}${BOLD}  ✔ Tests passed (${framework}).${RESET}\n`);
+    } else {
+        console.log(`\n${RED}${BOLD}  ✖ Tests failed (${framework}).${RESET}\n`);
+    }
+
+    process.exit(passed ? 0 : 1);
+}
+
+if (require.main === module) {
+    main();
+}

package/.agent/scripts/utils.js

@@ -1,32 +1,17 @@
-/**
- * utils.js
- * Shared utilities for Tribunal Kit Node scripts.
- */
-'use strict';
-
-const path = require('path');
-const fs = require('fs');
-
-function findAgentDir() {
-    let current = path.resolve(process.cwd());
-    const root = path.parse(current).root;
-    while (current !== root) {
-        const candidate = path.join(current, '.agent');
-        if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) {
-            return candidate;
-        }
-        current = path.dirname(current);
-    }
-    console.error("\x1b[91m✖ Error: '.agent' directory not found. Please run 'npx tribunal-kit init' first.\x1b[0m");
-    process.exit(1);
-}
-
-function ensureUtf8Stdout() {
-    // In Node.js, process.stdout is typically already UTF-8 capable,
-    // but this exists for compatibility with legacy python workflows.
-}
-
-module.exports = {
-    findAgentDir,
-    ensureUtf8Stdout
-};
+/**
+ * utils.js — Backward-compatible re-export of _utils.js
+ * ══════════════════════════════════════════════════════
+ * All utilities are defined in _utils.js.
+ * This file re-exports them for scripts that import from './utils.js'.
+ *
+ * New scripts should import from './_utils' directly.
+ */
+'use strict';
+
+const _utils = require('./_utils');
+
+module.exports = {
+    ..._utils,
+    // Legacy export for compatibility
+    ensureUtf8Stdout: function() {},
+};