tribunal-kit 6.0.0 → 7.0.0

package/bin/tribunal-kit.js

@@ -26,31 +26,30 @@
  *   tribunal-kit uninstall
  */
 
-"use strict";
+'use strict';
 
-const path = require("path");
+const path = require('path');
 
 // Delegate core execution to the modular dist/ entry point
-const { main } = require("../dist/cli.js");
+const { main } = require('../dist/cli.js');
 
 // Utilities re-exported for backwards compatibility with tests
-const { compareSemver } = require("../dist/utils/version");
-const { copyDir, countDir, isSelfInstall: _isSelfInstall } = require("../dist/utils/fs");
-const { CORE_AGENTS, CORE_SKILLS, generateIDEBridges } = require("../dist/commands/init");
-const { cmdMarathon: _cmdMarathon } = require("../dist/commands/marathon");
+const { compareSemver } = require('../dist/utils/version');
+const { copyDir, countDir, isSelfInstall: _isSelfInstall } = require('../dist/utils/fs');
+const { CORE_AGENTS, CORE_SKILLS, generateIDEBridges } = require('../dist/commands/init');
+const { cmdMarathon: _cmdMarathon } = require('../dist/commands/marathon');
 
 function cmdMarathon(flags, processArgs = process.argv) {
   return _cmdMarathon(flags, processArgs, flags?.quiet || false);
 }
 
-
-const PKG = require(path.resolve(__dirname, "..", "package.json"));
+const PKG = require(path.resolve(__dirname, '..', 'package.json'));
 
 /**
  * Returns true if the target directory IS the tribunal-kit package itself.
  */
 function isSelfInstall(targetDir) {
-  const kitRoot = path.resolve(__dirname, "..");
+  const kitRoot = path.resolve(__dirname, '..');
   return _isSelfInstall(targetDir, PKG.name, kitRoot);
 }
 
@@ -63,31 +62,31 @@ function parseArgs(argv) {
 
   for (let i = 0; i < raw.length; i++) {
     const arg = raw[i];
-    if (!arg.startsWith("--") && !arg.startsWith("-") && !args.command) {
+    if (!arg.startsWith('--') && !arg.startsWith('-') && !args.command) {
       args.command = arg;
       continue;
     }
-    if (arg === "--force") args.flags.force = true;
-    else if (arg === "--quiet") args.flags.quiet = true;
-    else if (arg === "--verbose") args.flags.verbose = true;
-    else if (arg === "--dry-run") args.flags.dryRun = true;
-    else if (arg === "--minimal") args.flags.minimal = true;
-    else if (arg === "--token-optimized") args.flags.tokenOptimized = true;
-    else if (arg === "--skip-update-check") args.flags.skipUpdateCheck = true;
-    else if (arg === "--head") args.flags.head = true;
-    else if (arg.startsWith("--path=")) {
-      args.flags.path = arg.split("=").slice(1).join("=");
-    } else if (arg === "--path" && raw[i + 1] && !raw[i + 1].startsWith("-")) {
+    if (arg === '--force') args.flags.force = true;
+    else if (arg === '--quiet') args.flags.quiet = true;
+    else if (arg === '--verbose') args.flags.verbose = true;
+    else if (arg === '--dry-run') args.flags.dryRun = true;
+    else if (arg === '--minimal') args.flags.minimal = true;
+    else if (arg === '--token-optimized') args.flags.tokenOptimized = true;
+    else if (arg === '--skip-update-check') args.flags.skipUpdateCheck = true;
+    else if (arg === '--head') args.flags.head = true;
+    else if (arg.startsWith('--path=')) {
+      args.flags.path = arg.split('=').slice(1).join('=');
+    } else if (arg === '--path' && raw[i + 1] && !raw[i + 1].startsWith('-')) {
       args.flags.path = raw[++i];
-    } else if (arg.startsWith("--branch=")) {
-      args.flags.branch = arg.split("=").slice(1).join("=");
-    } else if (arg.startsWith("--log=")) {
-      args.flags.log = arg.split("=").slice(1).join("=");
-    } else if (arg === "--log" && raw[i + 1] && !raw[i + 1].startsWith("-")) {
+    } else if (arg.startsWith('--branch=')) {
+      args.flags.branch = arg.split('=').slice(1).join('=');
+    } else if (arg.startsWith('--log=')) {
+      args.flags.log = arg.split('=').slice(1).join('=');
+    } else if (arg === '--log' && raw[i + 1] && !raw[i + 1].startsWith('-')) {
       args.flags.log = raw[++i];
-    } else if (arg.startsWith("--strategy=")) {
-      args.flags.strategy = arg.split("=").slice(1).join("=");
-    } else if (arg === "--strategy" && raw[i + 1] && !raw[i + 1].startsWith("-")) {
+    } else if (arg.startsWith('--strategy=')) {
+      args.flags.strategy = arg.split('=').slice(1).join('=');
+    } else if (arg === '--strategy' && raw[i + 1] && !raw[i + 1].startsWith('-')) {
       args.flags.strategy = raw[++i];
     }
   }

package/bin/wrapper.js

@@ -7,33 +7,33 @@
  * falls back to the original JavaScript implementation.
  */
 
-const fs = require("fs");
-const path = require("path");
-const { spawnSync } = require("child_process");
-const os = require("os");
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+const os = require('os');
 
 // Commands that have been fully ported to Rust so far
 const RUST_COMMANDS = new Set([
-  "init",
-  "validate",
-  "status",
-  "sync",
-  "hook",
-  "uninstall",
-  "memory",
-  "min-context",
-  "dag-schedule",
-  "context-compress",
-  "context-broker",
-  "optimize-step",
+  'init',
+  'validate',
+  'status',
+  'sync',
+  'hook',
+  'uninstall',
+  'memory',
+  'min-context',
+  'dag-schedule',
+  'context-compress',
+  'context-broker',
+  'optimize-step',
+  'impact-tier',
 ]);
 
-
 // Determine the path to the compiled Rust binary
 // In a full production release, this checks optionalDependencies in node_modules
 // For development, it checks the local target/release folder
 function getBinaryPath() {
-  if (process.env.TRIBUNAL_FORCE_JS === "1") {
+  if (process.env.TRIBUNAL_FORCE_JS === '1') {
     return null;
   }
 
@@ -41,8 +41,8 @@ function getBinaryPath() {
     return process.env.TRIBUNAL_CORE_PATH;
   }
 
-  const isWindows = os.platform() === "win32";
-  const ext = isWindows ? ".exe" : "";
+  const isWindows = os.platform() === 'win32';
+  const ext = isWindows ? '.exe' : '';
   const platform = os.platform();
   const arch = os.arch();
 
@@ -65,14 +65,14 @@ function getBinaryPath() {
 
   // Second, try to find the binary in local dev target directories
   const candidatePaths = [
-    path.resolve(__dirname, "..", "target", "release", `tribunal-core${ext}`),
-    path.resolve(__dirname, "..", "target", "debug", `tribunal-core${ext}`),
-    path.resolve(__dirname, "..", "..", "target", "release", `tribunal-core${ext}`),
-    path.resolve(__dirname, "..", "..", "target", "debug", `tribunal-core${ext}`),
-    path.resolve(process.cwd(), "target", "release", `tribunal-core${ext}`),
-    path.resolve(process.cwd(), "target", "debug", `tribunal-core${ext}`),
-    path.resolve(process.cwd(), "tribunal-kit", "target", "release", `tribunal-core${ext}`),
-    path.resolve(process.cwd(), "tribunal-kit", "target", "debug", `tribunal-core${ext}`),
+    path.resolve(__dirname, '..', 'target', 'release', `tribunal-core${ext}`),
+    path.resolve(__dirname, '..', 'target', 'debug', `tribunal-core${ext}`),
+    path.resolve(__dirname, '..', '..', 'target', 'release', `tribunal-core${ext}`),
+    path.resolve(__dirname, '..', '..', 'target', 'debug', `tribunal-core${ext}`),
+    path.resolve(process.cwd(), 'target', 'release', `tribunal-core${ext}`),
+    path.resolve(process.cwd(), 'target', 'debug', `tribunal-core${ext}`),
+    path.resolve(process.cwd(), 'tribunal-kit', 'target', 'release', `tribunal-core${ext}`),
+    path.resolve(process.cwd(), 'tribunal-kit', 'target', 'debug', `tribunal-core${ext}`),
   ];
 
   for (const candidate of candidatePaths) {
@@ -82,12 +82,12 @@ function getBinaryPath() {
   }
 
   // Third, attempt on-demand compilation if Cargo.toml exists locally and cargo is installed
-  const cargoTomlPath = path.resolve(__dirname, "..", "Cargo.toml");
+  const cargoTomlPath = path.resolve(__dirname, '..', 'Cargo.toml');
   if (fs.existsSync(cargoTomlPath)) {
     try {
-      const buildResult = spawnSync("cargo", ["build", "--release"], {
-        cwd: path.resolve(__dirname, ".."),
-        stdio: "ignore",
+      const buildResult = spawnSync('cargo', ['build', '--release'], {
+        cwd: path.resolve(__dirname, '..'),
+        stdio: 'ignore',
         timeout: 60000,
       });
       if (buildResult.status === 0) {
@@ -104,13 +104,8 @@ function getBinaryPath() {
   return null;
 }
 
-
 function runRustBinary(binPath, args) {
-  const stdio = [
-    "inherit",
-    "inherit",
-    "inherit",
-  ];
+  const stdio = ['inherit', 'inherit', 'inherit'];
   const result = spawnSync(binPath, args, {
     stdio: stdio,
     env: process.env,
@@ -132,8 +127,8 @@ function runRustBinary(binPath, args) {
 function runLegacyFallback() {
   // Use the modular dist/ CLI with lazy-loaded commands for faster cold-start.
   // Each command module is require()'d only when invoked (~70% fewer files loaded).
-  const { main } = require("../dist/cli.js");
-  main().catch((err) => {
+  const { main } = require('../dist/cli.js');
+  main().catch(err => {
     console.error(`\x1b[91m✖ Fatal Error:\x1b[0m ${err.message || err}`);
     process.exit(1);
   });
@@ -144,16 +139,16 @@ function main() {
   const args = process.argv.slice(2);
 
   // Extract the command (the first non-flag argument)
-  const command = args.find((a) => !a.startsWith("-"));
+  const command = args.find(a => !a.startsWith('-'));
 
   if (command && RUST_COMMANDS.has(command)) {
     const binPath = getBinaryPath();
 
     if (binPath) {
       // For the init command, Rust needs to know where the .agent template folder is.
-      if (command === "init") {
-        const sourceDir = path.resolve(__dirname, "..", ".agent");
-        args.push("--source-dir", sourceDir);
+      if (command === 'init') {
+        const sourceDir = path.resolve(__dirname, '..', '.agent');
+        args.push('--source-dir', sourceDir);
       }
 
       // Route to Rust engine
@@ -164,10 +159,12 @@ function main() {
       }
       // rustResult === false means spawn error; fall through to JS fallback
     } else {
-      // Warn if Rust command was requested but binary is missing
-      console.warn(
-        "\x1b[93m⚠ Rust binary not found in target/. Falling back to JS engine.\x1b[0m",
-      );
+      // Warn if Rust command was requested but binary is missing (in verbose mode)
+      if (process.env.TK_VERBOSE || process.env.VERBOSE) {
+        console.warn(
+          '\x1b[93m⚠ Rust binary not found in target/. Falling back to JS engine.\x1b[0m',
+        );
+      }
     }
   }
 

package/dist/cli.js

@@ -42,6 +42,15 @@ function parseArgs(argv) {
             args.flags.minimal = true;
             continue;
         }
+        if (arg.startsWith('--profile=')) {
+            args.flags.profile = arg.split('=').slice(1).join('=');
+            continue;
+        }
+        if (arg === '--profile') {
+            const idx = raw.indexOf('--profile');
+            args.flags.profile = raw[idx + 1] || 'full';
+            continue;
+        }
         if (arg === '--skip-update-check') {
             args.flags.skipUpdateCheck = true;
             continue;
@@ -112,6 +121,8 @@ function cmdHelp(quiet = false) {
     (0, logger_1.log)(cmd('context-compress', 'Compress a context file while retaining VERIFY comments'));
     (0, logger_1.log)(cmd('optimize-step', 'Apply bounded SkillOpt edits from a JSON payload'));
     (0, logger_1.log)(cmd('guardrail', 'Validate .agent/ integrity (phantom refs, count mismatches, drift)'));
+    (0, logger_1.log)(cmd('contract', 'AI Agent Behavioral Contract Testing (init, verify, list, trace, replay)'));
+    (0, logger_1.log)(cmd('impact-tier', 'Classify task governance impact tier (0-3)'));
     (0, logger_1.log)(cmd('uninstall', 'Remove .agent/ folder from project'));
     console.log();
     (0, logger_1.log)((0, logger_1.bold)('  Options'));
@@ -126,6 +137,7 @@ function cmdHelp(quiet = false) {
     (0, logger_1.log)(opt('--skip-update-check', 'Skip auto-update version check'));
     (0, logger_1.log)(opt('--head', '(learn) Diff against last commit instead of staged'));
     (0, logger_1.log)(opt('--write', '(align) Write aligned output in-place to the target file'));
+    (0, logger_1.log)(opt('--version, -v', 'Print installed version'));
     console.log();
     (0, logger_1.log)((0, logger_1.bold)('  Aliases'));
     (0, logger_1.log)(`  ${(0, logger_1.c)('gray', '─'.repeat(40))}`);
@@ -277,6 +289,11 @@ async function runWithUpdateCheck(command, flags) {
             await cmdGuardrail(flags, process.argv, quiet);
             break;
         }
+        case 'contract': {
+            const cmdContract = loadCmd('./commands/contract', 'cmdContract');
+            await cmdContract(flags, process.argv, quiet);
+            break;
+        }
         case 'validate': {
             const cmdValidate = loadCmd('./commands/validate', 'cmdValidate');
             cmdValidate(flags, process.argv, quiet);
@@ -302,12 +319,21 @@ async function runWithUpdateCheck(command, flags) {
             cmdOptimizeStep(process.argv, quiet);
             break;
         }
+        case 'impact-tier': {
+            const cmdImpactTier = loadCmd('./commands/native', 'cmdImpactTier');
+            cmdImpactTier(process.argv, quiet);
+            break;
+        }
         case 'help':
         case '--help':
         case '-h':
         case null:
             cmdHelp(quiet);
             break;
+        case '--version':
+        case '-v':
+            (0, logger_1.log)(CURRENT_VERSION);
+            break;
         default:
             (0, logger_1.err)(`Unknown command: "${command}"`);
             console.log();

package/dist/commands/case.js

@@ -59,6 +59,8 @@ async function cmdCase(flags, processArgs, quiet = false) {
                 );
                 if (!quiet) {
                     (0, logger_1.log)(`  ${(0, logger_1.c)('cyan', '\u25b8')} Memory bridge: case law rejection stored to memory index`);
+                    (0, logger_1.log)(`  ${(0, logger_1.c)('gray', '💡')} Tip: Auto-generate a behavioral contract to prevent recurrence:`);
+                    (0, logger_1.log)(`     ${(0, logger_1.c)('cyan', 'tk contract generate --from-case latest')}`);
                 }
             } catch {
                 // Non-critical — case law was still saved, memory bridge is a bonus