tribunal-kit 4.3.1 → 4.4.1

package/.agent/workflows/tribunal-speed.md

@@ -1,183 +1,183 @@
----
-description: Full-stack parallel performance audit. Runs 3 scoped specialists simultaneously — vitals-reviewer (Frontend CWV), db-latency-auditor (SQL/ORM), throughput-optimizer (Node.js server) — then synthesizes a single ranked report. Maximum 5 AI calls regardless of project size. Use when full-stack performance profiling is needed.
----
-
-# /tribunal-speed — Full-Stack Performance Swarm
-
-$ARGUMENTS
-
----
-
-## When to Use /tribunal-speed
-
-|Use `/tribunal-speed` when...|Use something else when...|
-|:---|:---|
-|Full-stack performance audit needed|Frontend only → `/tribunal-performance`|
-|Changes span UI + DB + Server layers|Single file review → `/review`|
-|Pre-deploy performance validation|Security-focused → `/tribunal-full`|
-|Investigating end-to-end latency|Architecture planning → `/plan`|
-|Need scoped specialist depth (not generic)|Quick generic check → `/tribunal-performance`|
-
----
-
-## Architecture: 3-Phase Fan-Out (5 AI Calls Max)
-
-```
-Phase 1 — File Classification (1 call)
-│
-│  Classify all submitted files into:
-│  ├── Frontend  (.tsx, .jsx, .css, .module.css)
-│  ├── Database  (.sql, schema.prisma, files with prisma./db./drizzle(/knex()
-│  └── Server    (.ts/.js in /api, /server, /lib, /utils, /routes, /middleware)
-│
-│  Files that don't match any category → skip (not performance-relevant)
-│
-▼
-Phase 2 — Parallel Specialist Audit (3 concurrent calls)
-│
-│  ┌──────────────────────┬──────────────────────┬───────────────────────┐
-│  │  vitals-reviewer     │  db-latency-auditor  │  throughput-optimizer │
-│  │                      │                      │                      │
-│  │  Receives ONLY       │  Receives ONLY       │  Receives ONLY       │
-│  │  Frontend files      │  Database files      │  Server files        │
-│  │                      │                      │                      │
-│  │  Checks:             │  Checks:             │  Checks:             │
-│  │  - LCP blockers      │  - N+1 queries       │  - Event-loop blocks │
-│  │  - INP violations    │  - Missing LIMIT     │  - Serialized awaits │
-│  │  - CLS triggers      │  - Unindexed WHERE   │  - Memory leaks      │
-│  │  - Suspense waterfalls│  - SELECT * abuse   │  - Missing Workers   │
-│  │  - Paint jank        │  - Pool config       │  - Streaming gaps    │
-│  │  - Animation leaks   │  - Wide transactions │  - No keep-alive     │
-│  └──────────────────────┴──────────────────────┴───────────────────────┘
-│
-│  Each specialist returns findings in its verdict format.
-│  allSettled — one specialist failure does NOT block siblings.
-│
-▼
-Phase 3 — Synthesis (1 call)
-│
-│  Merges 3 specialist reports into a single ranked issue list.
-│  Priority: Critical → High → Medium → Low
-│  Each issue tagged with: [AGENT] [FILE:LINE] [IMPACT METRIC] [FIX]
-│
-▼
-Human Gate — Final report shown
-Y = acknowledge | N = discard | R = re-audit with different scope
-```
-
-**Total cost: 5 AI calls maximum** — predictable, repeatable, project-size-independent.
-
----
-
-## Token Discipline Rules
-
-```
-Rule 1: Each specialist reads ONLY its scoped files — never the full project
-Rule 2: If a category has zero files, that specialist is skipped (saves 1 call)
-Rule 3: File contents are trimmed to relevant sections via targeted grep
-Rule 4: Synthesis call receives only verdict summaries, not full file contents
-```
-
----
-
-## 3 Specialist Agents
-
-### vitals-reviewer (Frontend)
-- **Scope:** `.tsx`, `.jsx`, `.css`, `.module.css`
-- **Metrics:** INP, LCP, CLS, FCP
-- **Key patterns:** React 19 `use()` waterfalls, non-passive listeners, missing `content-visibility`, `useGSAP` leaks, View Transitions jank, Suspense placement
-
-### db-latency-auditor (Database)
-- **Scope:** `.sql`, `schema.prisma`, files with `prisma.`, `db.`, `drizzle(`, `knex(`
-- **Metrics:** Query count, query latency, connection overhead
-- **Key patterns:** N+1 queries, missing LIMIT, unindexed WHERE, SELECT *, no connection pooling, over-scoped transactions, mass assignment
-
-### throughput-optimizer (Server)
-- **Scope:** `.ts/.js` in `/api`, `/server`, `/lib`, `/utils`, `/routes`, `/middleware`
-- **Metrics:** RPS, p95 latency, memory usage
-- **Key patterns:** Sync `fs.*`, serialized `await` loops, global Map without TTL, no Worker Threads for CPU ops, buffer bloat, missing keep-alive
-
----
-
-## Synthesis Output Format
-
-```
-━━━ Tribunal Speed: Full-Stack Performance Audit ━━━━━━━━━━━━━━
-
-Specialists dispatched: 3 | Completed: 3 | Skipped: 0
-
-━━━ Critical Issues ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-[CRITICAL] throughput-optimizer | api/orders.ts:47
-Pattern: SERIALIZED-AWAIT
-Issue:   await inside for-loop serializes 5 DB calls (1500ms vs 300ms parallel)
-Fix:     const results = await Promise.all(ids.map(id => fetchOrder(id)));
-Impact:  -1200ms p95 API latency
-
-[CRITICAL] db-latency-auditor | lib/users.ts:23
-Pattern: N+1
-Issue:   findMany in loop generates 101 queries for 100 users
-Fix:     Use prisma.user.findMany({ include: { posts: true } })
-Impact:  101 queries → 1 query
-
-━━━ High Issues ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-[HIGH] vitals-reviewer | components/Hero.tsx:12
-Pattern: LCP
-Issue:   Hero image without priority prop — browser discovers it late
-Fix:     Add priority={true} to next/image component
-Impact:  LCP improvement ~500ms
-
-━━━ Medium Issues ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-[MEDIUM] vitals-reviewer | app/feed/page.tsx:89
-Pattern: CLS
-Issue:   Feed items missing content-visibility: auto
-Fix:     Add content-visibility: auto; contain-intrinsic-size: auto 200px;
-Impact:  Reduced off-screen rendering cost
-
-━━━ Summary ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Total issues:  7 (2 Critical, 2 High, 3 Medium)
-AI calls used: 5
-Token budget:  Within scope (specialists read only categorized files)
-
-━━━ Human Gate ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-Acknowledged?  Y = close | R = re-audit different scope
-```
-
----
-
-## Specialist Failure Handling
-
-```
-If a specialist fails after 3 retries:
-  → Log failure with agent name + error
-  → Continue with remaining specialists
-  → Include "[SPECIALIST FAILED]" in synthesis report
-  → Never silently skip — always visible in output
-```
-
----
-
-## Versus Other Commands
-
-|Command|Agents|Depth|When to Use|
-|:---|:---|:---|:---|
-|`/tribunal-performance`|logic + performance-reviewer|Generic CWV check|Quick single-file perf scan|
-|`/tribunal-speed`|vitals + db-latency + throughput|Deep 3-domain parallel|Full-stack perf audit|
-|`/tribunal-full`|All 14 agents|Everything|Maximum coverage (security + perf + all)|
-|`/performance-benchmarker`|Lighthouse + bundle|Measurement only|Get actual scores, not code review|
-
----
-
-## Usage Examples
-
-```
-/tribunal-speed the entire checkout flow (UI + API + DB queries)
-/tribunal-speed all files changed in this PR for performance regression
-/tribunal-speed the dashboard page end-to-end (data fetch + render + DB)
-/tribunal-speed the search feature: autocomplete UI + search API + query plan
-```
-
----
+---
+description: Full-stack parallel performance audit. Runs 3 scoped specialists simultaneously — vitals-reviewer (Frontend CWV), db-latency-auditor (SQL/ORM), throughput-optimizer (Node.js server) — then synthesizes a single ranked report. Maximum 5 AI calls regardless of project size. Use when full-stack performance profiling is needed.
+---
+
+# /tribunal-speed — Full-Stack Performance Swarm
+
+$ARGUMENTS
+
+---
+
+## When to Use /tribunal-speed
+
+|Use `/tribunal-speed` when...|Use something else when...|
+|:---|:---|
+|Full-stack performance audit needed|Frontend only → `/tribunal-performance`|
+|Changes span UI + DB + Server layers|Single file review → `/review`|
+|Pre-deploy performance validation|Security-focused → `/tribunal-full`|
+|Investigating end-to-end latency|Architecture planning → `/plan`|
+|Need scoped specialist depth (not generic)|Quick generic check → `/tribunal-performance`|
+
+---
+
+## Architecture: 3-Phase Fan-Out (5 AI Calls Max)
+
+```
+Phase 1 — File Classification (1 call)
+│
+│  Classify all submitted files into:
+│  ├── Frontend  (.tsx, .jsx, .css, .module.css)
+│  ├── Database  (.sql, schema.prisma, files with prisma./db./drizzle(/knex()
+│  └── Server    (.ts/.js in /api, /server, /lib, /utils, /routes, /middleware)
+│
+│  Files that don't match any category → skip (not performance-relevant)
+│
+▼
+Phase 2 — Parallel Specialist Audit (3 concurrent calls)
+│
+│  ┌──────────────────────┬──────────────────────┬───────────────────────┐
+│  │  vitals-reviewer     │  db-latency-auditor  │  throughput-optimizer │
+│  │                      │                      │                      │
+│  │  Receives ONLY       │  Receives ONLY       │  Receives ONLY       │
+│  │  Frontend files      │  Database files      │  Server files        │
+│  │                      │                      │                      │
+│  │  Checks:             │  Checks:             │  Checks:             │
+│  │  - LCP blockers      │  - N+1 queries       │  - Event-loop blocks │
+│  │  - INP violations    │  - Missing LIMIT     │  - Serialized awaits │
+│  │  - CLS triggers      │  - Unindexed WHERE   │  - Memory leaks      │
+│  │  - Suspense waterfalls│  - SELECT * abuse   │  - Missing Workers   │
+│  │  - Paint jank        │  - Pool config       │  - Streaming gaps    │
+│  │  - Animation leaks   │  - Wide transactions │  - No keep-alive     │
+│  └──────────────────────┴──────────────────────┴───────────────────────┘
+│
+│  Each specialist returns findings in its verdict format.
+│  allSettled — one specialist failure does NOT block siblings.
+│
+▼
+Phase 3 — Synthesis (1 call)
+│
+│  Merges 3 specialist reports into a single ranked issue list.
+│  Priority: Critical → High → Medium → Low
+│  Each issue tagged with: [AGENT] [FILE:LINE] [IMPACT METRIC] [FIX]
+│
+▼
+Human Gate — Final report shown
+Y = acknowledge | N = discard | R = re-audit with different scope
+```
+
+**Total cost: 5 AI calls maximum** — predictable, repeatable, project-size-independent.
+
+---
+
+## Token Discipline Rules
+
+```
+Rule 1: Each specialist reads ONLY its scoped files — never the full project
+Rule 2: If a category has zero files, that specialist is skipped (saves 1 call)
+Rule 3: File contents are trimmed to relevant sections via targeted grep
+Rule 4: Synthesis call receives only verdict summaries, not full file contents
+```
+
+---
+
+## 3 Specialist Agents
+
+### vitals-reviewer (Frontend)
+- **Scope:** `.tsx`, `.jsx`, `.css`, `.module.css`
+- **Metrics:** INP, LCP, CLS, FCP
+- **Key patterns:** React 19 `use()` waterfalls, non-passive listeners, missing `content-visibility`, `useGSAP` leaks, View Transitions jank, Suspense placement
+
+### db-latency-auditor (Database)
+- **Scope:** `.sql`, `schema.prisma`, files with `prisma.`, `db.`, `drizzle(`, `knex(`
+- **Metrics:** Query count, query latency, connection overhead
+- **Key patterns:** N+1 queries, missing LIMIT, unindexed WHERE, SELECT *, no connection pooling, over-scoped transactions, mass assignment
+
+### throughput-optimizer (Server)
+- **Scope:** `.ts/.js` in `/api`, `/server`, `/lib`, `/utils`, `/routes`, `/middleware`
+- **Metrics:** RPS, p95 latency, memory usage
+- **Key patterns:** Sync `fs.*`, serialized `await` loops, global Map without TTL, no Worker Threads for CPU ops, buffer bloat, missing keep-alive
+
+---
+
+## Synthesis Output Format
+
+```
+━━━ Tribunal Speed: Full-Stack Performance Audit ━━━━━━━━━━━━━━
+
+Specialists dispatched: 3 | Completed: 3 | Skipped: 0
+
+━━━ Critical Issues ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+[CRITICAL] throughput-optimizer | api/orders.ts:47
+Pattern: SERIALIZED-AWAIT
+Issue:   await inside for-loop serializes 5 DB calls (1500ms vs 300ms parallel)
+Fix:     const results = await Promise.all(ids.map(id => fetchOrder(id)));
+Impact:  -1200ms p95 API latency
+
+[CRITICAL] db-latency-auditor | lib/users.ts:23
+Pattern: N+1
+Issue:   findMany in loop generates 101 queries for 100 users
+Fix:     Use prisma.user.findMany({ include: { posts: true } })
+Impact:  101 queries → 1 query
+
+━━━ High Issues ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+[HIGH] vitals-reviewer | components/Hero.tsx:12
+Pattern: LCP
+Issue:   Hero image without priority prop — browser discovers it late
+Fix:     Add priority={true} to next/image component
+Impact:  LCP improvement ~500ms
+
+━━━ Medium Issues ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+[MEDIUM] vitals-reviewer | app/feed/page.tsx:89
+Pattern: CLS
+Issue:   Feed items missing content-visibility: auto
+Fix:     Add content-visibility: auto; contain-intrinsic-size: auto 200px;
+Impact:  Reduced off-screen rendering cost
+
+━━━ Summary ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Total issues:  7 (2 Critical, 2 High, 3 Medium)
+AI calls used: 5
+Token budget:  Within scope (specialists read only categorized files)
+
+━━━ Human Gate ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Acknowledged?  Y = close | R = re-audit different scope
+```
+
+---
+
+## Specialist Failure Handling
+
+```
+If a specialist fails after 3 retries:
+  → Log failure with agent name + error
+  → Continue with remaining specialists
+  → Include "[SPECIALIST FAILED]" in synthesis report
+  → Never silently skip — always visible in output
+```
+
+---
+
+## Versus Other Commands
+
+|Command|Agents|Depth|When to Use|
+|:---|:---|:---|:---|
+|`/tribunal-performance`|logic + performance-reviewer|Generic CWV check|Quick single-file perf scan|
+|`/tribunal-speed`|vitals + db-latency + throughput|Deep 3-domain parallel|Full-stack perf audit|
+|`/tribunal-full`|All 14 agents|Everything|Maximum coverage (security + perf + all)|
+|`/performance-benchmarker`|Lighthouse + bundle|Measurement only|Get actual scores, not code review|
+
+---
+
+## Usage Examples
+
+```
+/tribunal-speed the entire checkout flow (UI + API + DB queries)
+/tribunal-speed all files changed in this PR for performance regression
+/tribunal-speed the dashboard page end-to-end (data fetch + render + DB)
+/tribunal-speed the search feature: autocomplete UI + search API + query plan
+```
+
+---

package/README.md

@@ -14,7 +14,7 @@
 <br><br>
 
 > 🚨 **AI GENERATES CODE. TRIBUNAL ENSURES IT WORKS.**  
-> A plug-in `.agent/` intelligence payload that upgrades your IDE with **41 specialist agents**, **32 slash commands**, **16 parallel Tribunal reviewers**, and a core **Swarm/Supervisor** engine.
+> A plug-in `.agent/` intelligence payload that upgrades your IDE with **41 specialist agents**, **31 slash commands**, **91 hardened skills**, and a **16-reviewer Tribunal pipeline** — zero hallucinations, zero configuration.
 
 ---
 

package/bin/tribunal-kit.js

@@ -324,16 +324,11 @@ function banner() {
    ██║   ██║  ██║██║██████╔╝╚██████╔╝██║ ╚████║██║  ██║███████╗ ██║  ██╗██║   ██║   
    ╚═╝   ╚═╝  ╚═╝╚═╝╚═════╝  ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝╚══════╝ ╚═╝  ╚═╝╚═╝   ╚═╝   `.split('\n').filter(Boolean);
     console.log();
-    const maxLen = Math.max(...art.map(line => line.length));
+    const _maxLen = Math.max(...art.map(line => line.length));
     for (const line of art) {
         let gradientLine = '  ' + C.bold;
         for (let i = 0; i < line.length; i++) {
-            const p = maxLen > 1 ? i / (maxLen - 1) : 0;
-            // Solid #ff1637 (R: 255, G: 22, B: 55)
-            const r = 255;
-            const g = 22;
-            const b = 55;
-            gradientLine += `\x1b[38;2;${r};${g};${b}m${line[i]}`;
+            gradientLine += `\x1b[38;2;255;22;55m${line[i]}`;
         }
         gradientLine += C.reset;
         log(gradientLine);
@@ -380,7 +375,7 @@ function cmdInit(flags) {
         fs.mkdirSync(backupDir, { recursive: true });
 
         // PRESERVE_DIRS: user-generated content that must survive updates
-        const PRESERVE_DIRS = ['history', 'patterns', 'mcp_config.json'];
+        const _PRESERVE_DIRS = ['history', 'patterns', 'mcp_config.json'];
         const subdirs = ['agents', 'workflows', 'skills', 'scripts', '.shared', 'rules'];
         for (const sub of subdirs) {
             const subPath = path.join(agentDest, sub);
@@ -392,13 +387,7 @@ function cmdInit(flags) {
         }
         log(`  ${c('gray', '✦ Backed up existing configurations to .agent/.backups/')}`);
 
-        // Verify preserved dirs still exist after cleanup
-        for (const kept of PRESERVE_DIRS) {
-            const keptPath = path.join(agentDest, kept);
-            if (kept.includes('.') ? false : !fs.existsSync(keptPath)) {
-                // It's okay if it doesn't exist yet — it'll be created below
-            }
-        }
+
     }
     // ────────────────────────────────────────────────────────
 
@@ -681,7 +670,7 @@ function cmdLearn(flags) {
 
     const dryRun  = flags.dryRun ? '--dry-run' : '';
     const useHead = flags.head   ? '--head'    : '';
-    const { execSync } = require('child_process');
+
 
     // Phase 1: Skill Evolution
     log(`  ${c('cyan', '\u229b')} ${bold('Phase 1')} \u2014 Skill Evolution Forge (auto-generating project idioms)`);
@@ -745,6 +734,15 @@ async function runWithUpdateCheck(command, flags) {
         case 'hook':
             cmdHook(flags);
             break;
+        case 'graph':
+            cmdGraph(flags);
+            break;
+        case 'mutate':
+            cmdMutate(flags);
+            break;
+        case 'context':
+            cmdContext(flags);
+            break;
         case 'uninstall':
             cmdUninstall(flags);
             break;
@@ -799,11 +797,39 @@ function cmdCase(flags) {
     try {
         const { execSync } = require('child_process');
         execSync(`node "${caseLawScript}" ${pyArgs}`, { stdio: 'inherit', cwd: targetDir });
-    } catch (e) {
+    } catch {
         process.exit(1); // Script already prints errors
     }
 }
 
+function cmdGraph(flags) {
+    const targetDir = flags.path ? path.resolve(flags.path) : process.cwd();
+    const agentDest = path.join(targetDir, '.agent');
+
+    if (!fs.existsSync(agentDest)) {
+        err('.agent/ not found. Run: npx tribunal-kit init');
+        process.exit(1);
+    }
+
+    banner();
+    const { execSync } = require('child_process');
+    const builderScript = path.join(agentDest, 'scripts', 'graph_builder.js');
+    const visualizerScript = path.join(agentDest, 'scripts', 'graph_visualizer.js');
+    const htmlFile = path.join(agentDest, 'history', 'architecture-explorer.html');
+
+    try {
+        execSync(`node "${builderScript}"`, { stdio: 'inherit', cwd: targetDir });
+        execSync(`node "${visualizerScript}"`, { stdio: 'inherit', cwd: targetDir });
+        
+        log(`  ${c('cyan', '▸')} Opening visualizer in browser...`);
+        const opener = process.platform === 'win32' ? 'start' : process.platform === 'darwin' ? 'open' : 'xdg-open';
+        execSync(`${opener} "${htmlFile}"`);
+    } catch (e) {
+        err(`Graph generation failed: ${e.message}`);
+        process.exit(1);
+    }
+}
+
 function cmdHook(flags) {
     const targetDir = flags.path ? path.resolve(flags.path) : process.cwd();
     const gitDir = path.join(targetDir, '.git');
@@ -829,6 +855,30 @@ function cmdHook(flags) {
     console.log();
 }
 
+function cmdMutate(flags) {
+    const targetDir = flags.path ? path.resolve(flags.path) : process.cwd();
+    const agentDest = path.join(targetDir, '.agent');
+
+    if (!fs.existsSync(agentDest)) {
+        err('.agent/ not found. Run: npx tribunal-kit init');
+        process.exit(1);
+    }
+
+    const args = process.argv.slice(3);
+    if (args.length < 2) {
+        err('Usage: npx tribunal-kit mutate <target_file> <test_command>');
+        process.exit(1);
+    }
+
+    const mutateScript = path.join(agentDest, 'scripts', 'mutation_runner.js');
+    const { execSync } = require('child_process');
+    try {
+        execSync(`node "${mutateScript}" ${args.join(' ')}`, { stdio: 'inherit', cwd: targetDir });
+    } catch {
+        process.exit(1);
+    }
+}
+
 function cmdUninstall(flags) {
     const targetDir = flags.path ? path.resolve(flags.path) : process.cwd();
     const agentDest = path.join(targetDir, '.agent');
@@ -903,6 +953,9 @@ function cmdHelp() {
     log(cmd('status',   'Check if .agent/ is installed'));
     log(cmd('learn',    'Evolve project idioms based on git diffs'));
     log(cmd('case',     'Manage Case Law precedents (add, search, list, show, stats, overrule)'));
+    log(cmd('graph',    'Build and visualize the architecture graph'));
+    log(cmd('mutate',   'Run the Mutation Engine to test test-suite reliability'));
+    log(cmd('context',  'Retrieve a highly-optimized Context Snapshot for a file'));
     log(cmd('hook',     'Install pre-push git hook for auto-learning'));
     log(cmd('uninstall','Remove .agent/ folder from project'));
     console.log();
@@ -939,11 +992,75 @@ function cmdHelp() {
     log(ex('tk case stats'));
     log(ex('tk case export'));
     log(ex('tk case overrule --id 1'));
+    log(ex('tk graph'));
+    log(ex('tk mutate src/utils.js "npm test"'));
     log(ex('tk hook'));
     log(ex('tk uninstall'));
     console.log();
 }
 
+
+function cmdContext(flags) {
+    const targetDir = flags.path ? path.resolve(flags.path) : process.cwd();
+    const agentDest = path.join(targetDir, '.agent');
+    
+    if (!fs.existsSync(agentDest)) {
+        err('.agent/ not found. Run: npx tribunal-kit init');
+        process.exit(1);
+    }
+
+    const args = process.argv.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 targetFile = args[0].replace(/\\/g, '/');
+    const snapshotName = targetFile.replace(/[\\\/]/g, '__') + '.json';
+    const snapshotPath = require('path').join(agentDest, 'history', 'snapshots', snapshotName);
+
+    if (!require('fs').existsSync(snapshotPath)) {
+        console.error('  \x1b[91m✖\x1b[0m Context Snapshot not found for: ' + targetFile);
+        console.log('    Run: npx tribunal-kit graph  (to generate snapshots)');
+        process.exit(1);
+    }
+
+    try {
+        const snapshot = JSON.parse(require('fs').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 (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('## Source Code');
+        console.log('```javascript\n' + snapshot.content + '\n```\n');
+        
+    } catch (e) {
+        console.error('Failed to read snapshot: ' + e.message);
+        process.exit(1);
+    }
+}
+
 // ── Main ──────────────────────────────────────────────────
 const { command, flags } = parseArgs(process.argv);
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "tribunal-kit",
-    "version": "4.3.1",
+    "version": "4.4.1",
     "description": "Anti-Hallucination AI Agent Kit — 40 specialist agents, 31 slash commands, 16 parallel Tribunal reviewers, Performance Swarm engine, and Supreme Court case law pipeline.",
     "keywords": [
         "ai",
@@ -63,10 +63,13 @@
         "changelog": "node scripts/changelog.js",
         "changelog:preview": "node scripts/changelog.js --preview",
         "sync": "node scripts/sync-version.js",
-        "validate-payload": "node scripts/validate-payload.js"
+        "validate-payload": "node scripts/validate-payload.js",
+        "build": "echo 'No build step required for this project'"
     },
     "devDependencies": {
-        "jest": "^29.7.0"
+        "jest": "^29.7.0",
+        "typescript": "^5.4.5",
+        "eslint": "^9.1.1"
     },
     "jest": {
         "testMatch": [