tribunal-kit 9.2.5 → 9.2.6

package/src/commands/case.js

@@ -1,71 +1,98 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
+'use strict';
+const __importDefault =
+  (this && this.__importDefault) ||
+  function (mod) {
+    return mod && mod.__esModule ? mod : { default: mod };
+  };
+Object.defineProperty(exports, '__esModule', { value: true });
 exports.cmdCase = cmdCase;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const logger_1 = require("../utils/logger");
-const helpers_1 = require("../utils/helpers");
+const fs_1 = __importDefault(require('fs'));
+const path_1 = __importDefault(require('path'));
+const logger_1 = require('../utils/logger');
+const helpers_1 = require('../utils/helpers');
 async function cmdCase(flags, processArgs, quiet = false) {
-    const targetDir = flags.path ? path_1.default.resolve(flags.path) : process.cwd();
-    const agentDest = path_1.default.join(targetDir, '.agent');
-    if (!fs_1.default.existsSync(agentDest)) {
-        (0, logger_1.err)('.agent/ not found. Run: npx tribunal-kit init');
-        process.exit(1);
-    }
-    const args = processArgs.slice(3).join(' ');
-    if (!args || args === 'help' || args === '--help' || args === '-h') {
-        (0, helpers_1.banner)(quiet);
-        (0, logger_1.log)(`  ${(0, logger_1.c)('cyan', '\u2554' + '\u2550'.repeat(60) + '\u2557')}`);
-        (0, logger_1.log)(`  ${(0, logger_1.c)('cyan', '\u2551')}${(0, logger_1.bold)((0, logger_1.c)('white', '  Tribunal Case Law Engine \u2014 Supreme Court             '))}${(0, logger_1.c)('cyan', '\u2551')}`);
-        (0, logger_1.log)(`  ${(0, logger_1.c)('cyan', '\u255a' + '\u2550'.repeat(60) + '\u255d')}`);
-        console.log();
-        (0, logger_1.log)(`  ${(0, logger_1.c)('cyan', 'add'.padEnd(10))}  ${(0, logger_1.c)('gray', 'Record a new Case Law rejection pattern')}`);
-        (0, logger_1.log)(`  ${(0, logger_1.c)('cyan', 'search'.padEnd(10))}  ${(0, logger_1.c)('gray', 'Search existing cases (e.g., search "query")')}`);
-        (0, logger_1.log)(`  ${(0, logger_1.c)('cyan', 'list'.padEnd(10))}  ${(0, logger_1.c)('gray', 'List all recorded case law')}`);
-        (0, logger_1.log)(`  ${(0, logger_1.c)('cyan', 'show'.padEnd(10))}  ${(0, logger_1.c)('gray', 'Show full diff for a case (e.g., show --id 1)')}`);
-        (0, logger_1.log)(`  ${(0, logger_1.c)('cyan', 'stats'.padEnd(10))}  ${(0, logger_1.c)('gray', 'Show case law stats by domain/verdict')}`);
-        (0, logger_1.log)(`  ${(0, logger_1.c)('cyan', 'export'.padEnd(10))}  ${(0, logger_1.c)('gray', 'Export all cases to Markdown')}`);
-        (0, logger_1.log)(`  ${(0, logger_1.c)('cyan', 'overrule'.padEnd(10))}  ${(0, logger_1.c)('gray', 'Overrule a past precedent (e.g., overrule --id 1)')}`);
-        console.log();
-        process.exit(1);
-    }
-    const caseLawScript = path_1.default.join(agentDest, 'scripts', 'case_law_manager.js');
-    // Make shorthand aliases
-    let pyArgs = processArgs.slice(3);
-    if (pyArgs[0] === 'add') pyArgs[0] = 'add-case';
-    if (pyArgs[0] === 'search') pyArgs[0] = 'search-cases';
-    try {
-        await (0, helpers_1.runShellAsync)('node', [caseLawScript, ...pyArgs], { stdio: 'inherit', cwd: targetDir });
-        // Memory Bridge: When a case is added, auto-store a SEMANTIC memory
-        if (args.startsWith('add')) {
-            try {
-                const { _memoryStore } = require('./memory');
-                // Extract a summary from the add-case args (best effort)
-                const contentMatch = args.match(/--violation\s+"([^"]+)"/i) || args.match(/--violation\s+(\S+)/i);
-                const domainMatch = args.match(/--domain\s+"([^"]+)"/i) || args.match(/--domain\s+(\S+)/i);
-                const violation = contentMatch ? contentMatch[1] : 'Unknown violation';
-                const domain = domainMatch ? domainMatch[1] : 'general';
-                _memoryStore(
-                    agentDest,
-                    'semantic',
-                    `CASE LAW REJECTION: ${violation} (domain: ${domain})`,
-                    ['case-law', domain, 'rejection'],
-                    null
-                );
-                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
-            }
+  const targetDir = flags.path ? path_1.default.resolve(flags.path) : process.cwd();
+  const agentDest = path_1.default.join(targetDir, '.agent');
+  if (!fs_1.default.existsSync(agentDest)) {
+    (0, logger_1.err)('.agent/ not found. Run: npx tribunal-kit init');
+    process.exit(1);
+  }
+  const args = processArgs.slice(3).join(' ');
+  if (!args || args === 'help' || args === '--help' || args === '-h') {
+    (0, helpers_1.banner)(quiet);
+    (0, logger_1.log)(`  ${(0, logger_1.c)('cyan', '\u2554' + '\u2550'.repeat(60) + '\u2557')}`);
+    (0, logger_1.log)(
+      `  ${(0, logger_1.c)('cyan', '\u2551')}${(0, logger_1.bold)((0, logger_1.c)('white', '  Tribunal Case Law Engine \u2014 Supreme Court             '))}${(0, logger_1.c)('cyan', '\u2551')}`,
+    );
+    (0, logger_1.log)(`  ${(0, logger_1.c)('cyan', '\u255a' + '\u2550'.repeat(60) + '\u255d')}`);
+    console.log();
+    (0, logger_1.log)(
+      `  ${(0, logger_1.c)('cyan', 'add'.padEnd(10))}  ${(0, logger_1.c)('gray', 'Record a new Case Law rejection pattern')}`,
+    );
+    (0, logger_1.log)(
+      `  ${(0, logger_1.c)('cyan', 'search'.padEnd(10))}  ${(0, logger_1.c)('gray', 'Search existing cases (e.g., search "query")')}`,
+    );
+    (0, logger_1.log)(
+      `  ${(0, logger_1.c)('cyan', 'list'.padEnd(10))}  ${(0, logger_1.c)('gray', 'List all recorded case law')}`,
+    );
+    (0, logger_1.log)(
+      `  ${(0, logger_1.c)('cyan', 'show'.padEnd(10))}  ${(0, logger_1.c)('gray', 'Show full diff for a case (e.g., show --id 1)')}`,
+    );
+    (0, logger_1.log)(
+      `  ${(0, logger_1.c)('cyan', 'stats'.padEnd(10))}  ${(0, logger_1.c)('gray', 'Show case law stats by domain/verdict')}`,
+    );
+    (0, logger_1.log)(
+      `  ${(0, logger_1.c)('cyan', 'export'.padEnd(10))}  ${(0, logger_1.c)('gray', 'Export all cases to Markdown')}`,
+    );
+    (0, logger_1.log)(
+      `  ${(0, logger_1.c)('cyan', 'overrule'.padEnd(10))}  ${(0, logger_1.c)('gray', 'Overrule a past precedent (e.g., overrule --id 1)')}`,
+    );
+    console.log();
+    process.exit(1);
+  }
+  const caseLawScript = path_1.default.join(agentDest, 'scripts', 'case_law_manager.js');
+  // Make shorthand aliases
+  const pyArgs = processArgs.slice(3);
+  if (pyArgs[0] === 'add') pyArgs[0] = 'add-case';
+  if (pyArgs[0] === 'search') pyArgs[0] = 'search-cases';
+  try {
+    await (0, helpers_1.runShellAsync)('node', [caseLawScript, ...pyArgs], {
+      stdio: 'inherit',
+      cwd: targetDir,
+    });
+    // Memory Bridge: When a case is added, auto-store a SEMANTIC memory
+    if (args.startsWith('add')) {
+      try {
+        const { _memoryStore } = require('./memory');
+        // Extract a summary from the add-case args (best effort)
+        const contentMatch =
+          args.match(/--violation\s+"([^"]+)"/i) || args.match(/--violation\s+(\S+)/i);
+        const domainMatch = args.match(/--domain\s+"([^"]+)"/i) || args.match(/--domain\s+(\S+)/i);
+        const violation = contentMatch ? contentMatch[1] : 'Unknown violation';
+        const domain = domainMatch ? domainMatch[1] : 'general';
+        _memoryStore(
+          agentDest,
+          'semantic',
+          `CASE LAW REJECTION: ${violation} (domain: ${domain})`,
+          ['case-law', domain, 'rejection'],
+          null,
+        );
+        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
+      }
     }
-    catch {
-        process.exit(1); // Script already prints errors
-    }
+  } catch {
+    process.exit(1); // Script already prints errors
+  }
 }

package/src/commands/compare-web.js

@@ -17,7 +17,9 @@ async function cmdCompareWeb(flags, processArgs, quiet = false) {
   const url2 = processArgs[4] || flags.url2;
 
   if (!url1 || !url2) {
-    console.error(`  ${c('red', '✖ Error:')} Missing target URLs. Usage: tk compare-web <url1> <url2>`);
+    console.error(
+      `  ${c('red', '✖ Error:')} Missing target URLs. Usage: tk compare-web <url1> <url2>`,
+    );
     process.exit(1);
   }
 
@@ -40,14 +42,20 @@ async function cmdCompareWeb(flags, processArgs, quiet = false) {
 
     const diffColor = result.passed ? 'green' : 'red';
 
-    console.log(`  Visual Mismatch: ${c(diffColor, `${result.diffPercentage}%`)} (Allowed Threshold: ${maxDiff}%)`);
+    console.log(
+      `  Visual Mismatch: ${c(diffColor, `${result.diffPercentage}%`)} (Allowed Threshold: ${maxDiff}%)`,
+    );
     console.log(`  Compared Bytes:  ${result.totalPixelsCompared}`);
 
     if (result.passed) {
-      console.log(`\n  ${c('green', '✔ Visual comparison passed')} — Difference is within acceptable threshold.\n`);
+      console.log(
+        `\n  ${c('green', '✔ Visual comparison passed')} — Difference is within acceptable threshold.\n`,
+      );
       process.exit(0);
     } else {
-      console.log(`\n  ${c('red', '✖ Visual regression detected!')} Diff ${result.diffPercentage}% exceeds max allowed ${maxDiff}%.\n`);
+      console.log(
+        `\n  ${c('red', '✖ Visual regression detected!')} Diff ${result.diffPercentage}% exceeds max allowed ${maxDiff}%.\n`,
+      );
       process.exit(1);
     }
   } catch (err) {

package/src/commands/compile.js

@@ -1,91 +1,97 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+'use strict';
+Object.defineProperty(exports, '__esModule', { value: true });
 exports.cmdCompile = cmdCompile;
 
-const fs = require("fs");
-const path = require("path");
-const { log, err, ok, c, bold, _dbg } = require("../utils/logger");
+const fs = require('fs');
+const path = require('path');
+const { log, err, ok, c, bold, _dbg } = require('../utils/logger');
 
 async function cmdCompile(flags, quiet) {
-    const cwd = process.cwd();
-    const agentDir = path.join(cwd, ".agent");
-    
-    if (!fs.existsSync(agentDir)) {
-        err("Tribunal Kit is not installed in this directory (.agent folder missing). Run 'tk init' first.");
-        process.exit(1);
-    }
+  const cwd = process.cwd();
+  const agentDir = path.join(cwd, '.agent');
 
-    log(bold("Compiling Tribunal Kit rules..."));
-    
-    let compiledContext = "# Tribunal Kit Context\n\n";
-    compiledContext += "The following are rules, agents, and skills from the Tribunal Kit.\n\n";
+  if (!fs.existsSync(agentDir)) {
+    err(
+      "Tribunal Kit is not installed in this directory (.agent folder missing). Run 'tk init' first.",
+    );
+    process.exit(1);
+  }
 
-    // 1. Read GEMINI.md
-    const geminiPath = path.join(agentDir, "rules", "GEMINI.md");
-    if (fs.existsSync(geminiPath)) {
-        compiledContext += "## Global Rules (GEMINI.md)\n\n";
-        compiledContext += fs.readFileSync(geminiPath, "utf-8") + "\n\n";
-    }
+  log(bold('Compiling Tribunal Kit rules...'));
 
-    // 2. Read Agents
-    const agentsDir = path.join(agentDir, "agents");
-    if (fs.existsSync(agentsDir)) {
-        compiledContext += "## Agents\n\n";
-        const agents = fs.readdirSync(agentsDir).filter(f => f.endsWith('.md'));
-        for (const file of agents) {
-            const content = fs.readFileSync(path.join(agentsDir, file), "utf-8");
-            compiledContext += `### Agent: ${file}\n\n`;
-            compiledContext += content + "\n\n";
-        }
-    }
+  let compiledContext = '# Tribunal Kit Context\n\n';
+  compiledContext += 'The following are rules, agents, and skills from the Tribunal Kit.\n\n';
 
-    // 3. Read Skills
-    const skillsDir = path.join(agentDir, "skills");
-    if (fs.existsSync(skillsDir)) {
-        compiledContext += "## Skills\n\n";
-        const skills = fs.readdirSync(skillsDir, { withFileTypes: true });
-        for (const dirent of skills) {
-            if (dirent.isDirectory()) {
-                const skillPath = path.join(skillsDir, dirent.name, "SKILL.md");
-                if (fs.existsSync(skillPath)) {
-                    const content = fs.readFileSync(skillPath, "utf-8");
-                    compiledContext += `### Skill: ${dirent.name}\n\n`;
-                    compiledContext += content + "\n\n";
-                }
-            }
-        }
+  // 1. Read GEMINI.md
+  const geminiPath = path.join(agentDir, 'rules', 'GEMINI.md');
+  if (fs.existsSync(geminiPath)) {
+    compiledContext += '## Global Rules (GEMINI.md)\n\n';
+    compiledContext += fs.readFileSync(geminiPath, 'utf-8') + '\n\n';
+  }
+
+  // 2. Read Agents
+  const agentsDir = path.join(agentDir, 'agents');
+  if (fs.existsSync(agentsDir)) {
+    compiledContext += '## Agents\n\n';
+    const agents = fs.readdirSync(agentsDir).filter(f => f.endsWith('.md'));
+    for (const file of agents) {
+      const content = fs.readFileSync(path.join(agentsDir, file), 'utf-8');
+      compiledContext += `### Agent: ${file}\n\n`;
+      compiledContext += content + '\n\n';
     }
+  }
 
-    // 4. Read Workflows
-    const workflowsDir = path.join(agentDir, "workflows");
-    if (fs.existsSync(workflowsDir)) {
-        compiledContext += "## Workflows\n\n";
-        const workflows = fs.readdirSync(workflowsDir).filter(f => f.endsWith('.md'));
-        for (const file of workflows) {
-            const content = fs.readFileSync(path.join(workflowsDir, file), "utf-8");
-            compiledContext += `### Workflow: ${file}\n\n`;
-            compiledContext += content + "\n\n";
+  // 3. Read Skills
+  const skillsDir = path.join(agentDir, 'skills');
+  if (fs.existsSync(skillsDir)) {
+    compiledContext += '## Skills\n\n';
+    const skills = fs.readdirSync(skillsDir, { withFileTypes: true });
+    for (const dirent of skills) {
+      if (dirent.isDirectory()) {
+        const skillPath = path.join(skillsDir, dirent.name, 'SKILL.md');
+        if (fs.existsSync(skillPath)) {
+          const content = fs.readFileSync(skillPath, 'utf-8');
+          compiledContext += `### Skill: ${dirent.name}\n\n`;
+          compiledContext += content + '\n\n';
         }
+      }
     }
+  }
 
-    let targetFile = ".tribunal-compiled.md";
-    if (flags.target) {
-        if (flags.target === "aider") targetFile = ".aider.conf.yml";
-        if (flags.target === "claude") targetFile = ".claude.json";
-    }
-    
-    const byteLength = Buffer.byteLength(compiledContext, "utf-8");
-    const mbSize = byteLength / (1024 * 1024);
-    if (mbSize > 5.0 && !quiet) {
-        const { warn } = require("../utils/logger");
-        warn(`Compiled context is very large (~${mbSize.toFixed(2)} MB). This might overload some LLM context windows.`);
+  // 4. Read Workflows
+  const workflowsDir = path.join(agentDir, 'workflows');
+  if (fs.existsSync(workflowsDir)) {
+    compiledContext += '## Workflows\n\n';
+    const workflows = fs.readdirSync(workflowsDir).filter(f => f.endsWith('.md'));
+    for (const file of workflows) {
+      const content = fs.readFileSync(path.join(workflowsDir, file), 'utf-8');
+      compiledContext += `### Workflow: ${file}\n\n`;
+      compiledContext += content + '\n\n';
     }
+  }
 
-    const outputPath = path.join(cwd, targetFile);
-    fs.writeFileSync(outputPath, compiledContext, "utf-8");
-    
-    ok(`Compiled rules written to ${c('cyan', targetFile)}`);
-    if (!quiet) {
-        log(`  ${c('gray', 'Load this file into your terminal agent (e.g. Claude Code, Aider, OpenCode)')}`);
-    }
+  let targetFile = '.tribunal-compiled.md';
+  if (flags.target) {
+    if (flags.target === 'aider') targetFile = '.aider.conf.yml';
+    if (flags.target === 'claude') targetFile = '.claude.json';
+  }
+
+  const byteLength = Buffer.byteLength(compiledContext, 'utf-8');
+  const mbSize = byteLength / (1024 * 1024);
+  if (mbSize > 5.0 && !quiet) {
+    const { warn } = require('../utils/logger');
+    warn(
+      `Compiled context is very large (~${mbSize.toFixed(2)} MB). This might overload some LLM context windows.`,
+    );
+  }
+
+  const outputPath = path.join(cwd, targetFile);
+  fs.writeFileSync(outputPath, compiledContext, 'utf-8');
+
+  ok(`Compiled rules written to ${c('cyan', targetFile)}`);
+  if (!quiet) {
+    log(
+      `  ${c('gray', 'Load this file into your terminal agent (e.g. Claude Code, Aider, OpenCode)')}`,
+    );
+  }
 }

package/src/commands/context.js

@@ -1,71 +1,156 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
+'use strict';
+const __importDefault =
+  (this && this.__importDefault) ||
+  function (mod) {
+    return mod && mod.__esModule ? mod : { default: mod };
+  };
+Object.defineProperty(exports, '__esModule', { value: true });
 exports.cmdContext = cmdContext;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const logger_1 = require("../utils/logger");
-function cmdContext(flags, processArgs) {
-    const targetDir = flags.path ? path_1.default.resolve(flags.path) : process.cwd();
-    const agentDest = path_1.default.join(targetDir, '.agent');
-    if (!fs_1.default.existsSync(agentDest)) {
-        (0, logger_1.err)('.agent/ not found. Run: npx tribunal-kit init');
-        process.exit(1);
-    }
-    const args = processArgs.slice(3);
-    if (args.length === 0 || args[0] === 'help' || args[0] === '--help') {
-        console.error('Usage: npx tribunal-kit context <target_file>');
-        process.exit(1);
+exports.cmdContextRank = cmdContextRank;
+const fs_1 = __importDefault(require('fs'));
+const path_1 = __importDefault(require('path'));
+const logger_1 = require('../utils/logger');
+const { rankContext } = require('../context/ranker');
+
+function cmdContextRank(flags, processArgs, quiet = false) {
+  const targetDir = flags.path ? path_1.default.resolve(flags.path) : process.cwd();
+  const args = processArgs.slice(3);
+
+  let targetFiles = [];
+  let candidateFiles = [];
+  let maxTokens = flags.maxTokens ? parseInt(flags.maxTokens, 10) : undefined;
+  let maxItems = flags.maxItems ? parseInt(flags.maxItems, 10) : undefined;
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === '--target' && args[i + 1]) {
+      targetFiles = args[++i].split(',').map(f => f.trim()).filter(Boolean);
+    } else if (arg.startsWith('--target=')) {
+      targetFiles = arg.split('=')[1].split(',').map(f => f.trim()).filter(Boolean);
+    } else if (arg === '--candidates' && args[i + 1]) {
+      candidateFiles = args[++i].split(',').map(f => f.trim()).filter(Boolean);
+    } else if (arg.startsWith('--candidates=')) {
+      candidateFiles = arg.split('=')[1].split(',').map(f => f.trim()).filter(Boolean);
+    } else if (arg === '--max-tokens' && args[i + 1]) {
+      maxTokens = parseInt(args[++i], 10);
+    } else if (arg.startsWith('--max-tokens=')) {
+      maxTokens = parseInt(arg.split('=')[1], 10);
+    } else if (arg === '--max-items' && args[i + 1]) {
+      maxItems = parseInt(args[++i], 10);
+    } else if (arg.startsWith('--max-items=')) {
+      maxItems = parseInt(arg.split('=')[1], 10);
+    } else if (!arg.startsWith('-') && targetFiles.length === 0) {
+      targetFiles = [arg];
     }
-    const resolvedTarget = path_1.default.resolve(targetDir, args[0]);
-    const relativePath = path_1.default.relative(targetDir, resolvedTarget).replace(/\\/g, '/');
-    if (relativePath.startsWith('../') || relativePath === '..' || path_1.default.isAbsolute(relativePath)) {
-        console.error('  \x1b[91m✖\x1b[0m File must be within the project directory: ' + args[0]);
-        process.exit(1);
+  }
+
+  const result = rankContext({
+    repoRoot: targetDir,
+    targetFiles,
+    candidateFiles: candidateFiles.length > 0 ? candidateFiles : undefined,
+    maxTokens,
+    maxItems,
+  });
+
+  if (flags.json || args.includes('--json')) {
+    console.log(JSON.stringify(result, null, 2));
+    return result;
+  }
+
+  if (!quiet) {
+    console.log(`\n━━━ Deterministic Context Ranking ━━━━━━━━━━━━━━━━━━━━━━━━`);
+    console.log(`  Items Evaluated:  ${result.metrics.context_items_before} -> ${result.metrics.context_items_after} retained`);
+    console.log(`  Token Budget:     ~${result.metrics.estimated_tokens_before} -> ~${result.metrics.estimated_tokens_after} tokens`);
+    console.log(`  Critical Evidence: ${result.metrics.critical_evidence_retained} mandatory file(s) retained\n`);
+
+    console.log(`  Ranked Evidence Items:`);
+    for (const item of result.ranked_items) {
+      const tag = item.is_mandatory ? ' [MANDATORY]' : '';
+      console.log(`  - \x1b[96m${item.path}\x1b[0m (score: \x1b[93m${item.score}\x1b[0m${tag})`);
+      for (const reason of item.reasons) {
+        console.log(`      * ${reason}`);
+      }
     }
-    const snapshotName = relativePath.replace(/[\\\/]/g, '__') + '.json';
-    const snapshotPath = path_1.default.join(agentDest, 'history', 'snapshots', snapshotName);
-    if (!fs_1.default.existsSync(snapshotPath)) {
-        console.error('  \x1b[91m✖\x1b[0m Context Snapshot not found for: ' + args[0]);
-        console.log('    Run: npx tribunal-kit graph  (to generate snapshots)');
-        process.exit(1);
+
+    if (result.truncated_items.length > 0) {
+      console.log(`\n  Truncated from Context Budget (${result.truncated_items.length}):`);
+      for (const item of result.truncated_items) {
+        console.log(`  - \x1b[90m${item.path} (score: ${item.score})\x1b[0m`);
+      }
     }
-    try {
-        const snapshot = JSON.parse(fs_1.default.readFileSync(snapshotPath, 'utf8'));
-        console.log('\n# Context Snapshot: ' + snapshot.file);
-        process.stdout.write('> Size Estimate: ' + (snapshot['estimatedTokens'] || 'Unknown') + '\n');
-        console.log('> Risk Score: ' + snapshot.riskScore + ' (Blast Radius: ' + snapshot.blastRadius + ')\n');
-        if (Object.keys(snapshot.imports).length > 0) {
-            console.log('## Imports');
-            for (const [imp, exports] of Object.entries(snapshot.imports)) {
-                if (Array.isArray(exports) && exports.length > 0) {
-                    console.log('- `' + imp + '` (exports: ' + exports.join(', ') + ')');
-                }
-                else {
-                    console.log('- `' + imp + '`');
-                }
-            }
-            console.log();
-        }
-        if (snapshot.dependents && snapshot.dependents.length > 0) {
-            console.log('## Dependents');
-            for (const dep of snapshot.dependents) {
-                console.log('- `' + dep + '`');
-            }
-            console.log();
+    console.log(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`);
+  }
+
+  return result;
+}
+
+function cmdContext(flags, processArgs) {
+  if (flags.rank || processArgs.includes('--rank')) {
+    return cmdContextRank(flags, processArgs);
+  }
+
+  const targetDir = flags.path ? path_1.default.resolve(flags.path) : process.cwd();
+  const agentDest = path_1.default.join(targetDir, '.agent');
+  if (!fs_1.default.existsSync(agentDest)) {
+    (0, logger_1.err)('.agent/ not found. Run: npx tribunal-kit init');
+    process.exit(1);
+  }
+  const args = processArgs.slice(3);
+  if (args.length === 0 || args[0] === 'help' || args[0] === '--help') {
+    console.error('Usage: npx tribunal-kit context <target_file>');
+    process.exit(1);
+  }
+  const resolvedTarget = path_1.default.resolve(targetDir, args[0]);
+  const relativePath = path_1.default.relative(targetDir, resolvedTarget).replace(/\\/g, '/');
+  if (
+    relativePath.startsWith('../') ||
+    relativePath === '..' ||
+    path_1.default.isAbsolute(relativePath)
+  ) {
+    console.error('  \x1b[91m✖\x1b[0m File must be within the project directory: ' + args[0]);
+    process.exit(1);
+  }
+  const snapshotName = relativePath.replace(/[\\\/]/g, '__') + '.json';
+  const snapshotPath = path_1.default.join(agentDest, 'history', 'snapshots', snapshotName);
+  if (!fs_1.default.existsSync(snapshotPath)) {
+    console.error('  \x1b[91m✖\x1b[0m Context Snapshot not found for: ' + args[0]);
+    console.log('    Run: npx tribunal-kit graph  (to generate snapshots)');
+    process.exit(1);
+  }
+  try {
+    const snapshot = JSON.parse(fs_1.default.readFileSync(snapshotPath, 'utf8'));
+    console.log('\n# Context Snapshot: ' + snapshot.file);
+    process.stdout.write('> Size Estimate: ' + (snapshot['estimatedTokens'] || 'Unknown') + '\n');
+    console.log(
+      '> Risk Score: ' + snapshot.riskScore + ' (Blast Radius: ' + snapshot.blastRadius + ')\n',
+    );
+    if (Object.keys(snapshot.imports).length > 0) {
+      console.log('## Imports');
+      for (const [imp, exports] of Object.entries(snapshot.imports)) {
+        if (Array.isArray(exports) && exports.length > 0) {
+          console.log('- `' + imp + '` (exports: ' + exports.join(', ') + ')');
+        } else {
+          console.log('- `' + imp + '`');
         }
-        console.log('## Source Code');
-        console.log('```javascript\n' + snapshot.content + '\n```\n');
+      }
+      console.log();
     }
-    catch (e) {
-        if (e instanceof Error) {
-            console.error('Failed to read snapshot: ' + e.message);
-        }
-        else {
-            console.error('Failed to read snapshot: ' + String(e));
-        }
-        process.exit(1);
+    if (snapshot.dependents && snapshot.dependents.length > 0) {
+      console.log('## Dependents');
+      for (const dep of snapshot.dependents) {
+        console.log('- `' + dep + '`');
+      }
+      console.log();
+    }
+    console.log('## Source Code');
+    console.log('```javascript\n' + snapshot.content + '\n```\n');
+  } catch (e) {
+    if (e instanceof Error) {
+      console.error('Failed to read snapshot: ' + e.message);
+    } else {
+      console.error('Failed to read snapshot: ' + String(e));
     }
+    process.exit(1);
+  }
 }
+