tribunal-kit 4.3.0 → 4.4.0

package/bin/tribunal-kit.js

@@ -373,6 +373,35 @@ function cmdInit(flags) {
     }
     // ────────────────────────────────────────────────────────
 
+    // ── Backup / Cleanup ────────────────────────────────────
+    if (!dryRun && fs.existsSync(agentDest) && flags.force) {
+        // Backup the existing subdirectories before overwriting
+        const backupDir = path.join(agentDest, '.backups', `backup-${Date.now()}`);
+        fs.mkdirSync(backupDir, { recursive: true });
+
+        // PRESERVE_DIRS: user-generated content that must survive updates
+        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);
+            if (fs.existsSync(subPath)) {
+                // Copy to backup dir
+                copyDir(subPath, path.join(backupDir, sub), false);
+                fs.rmSync(subPath, { recursive: true, force: true });
+            }
+        }
+        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
+            }
+        }
+    }
+    // ────────────────────────────────────────────────────────
+
     banner();
 
     if (dryRun) {
@@ -395,25 +424,6 @@ function cmdInit(flags) {
         process.exit(0);
     }
 
-    if (!dryRun && fs.existsSync(agentDest) && flags.force) {
-        // PRESERVE_DIRS: user-generated content that must survive updates
-        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);
-            if (fs.existsSync(subPath)) {
-                fs.rmSync(subPath, { recursive: true, force: true });
-            }
-        }
-        // 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
-            }
-        }
-    }
-
     // Ensure history dirs exist (Case Law + Skill Evolution)
     if (!dryRun) {
         const caseDir = path.join(agentDest, 'history', 'case-law', 'cases');
@@ -671,7 +681,6 @@ function cmdLearn(flags) {
 
     const dryRun  = flags.dryRun ? '--dry-run' : '';
     const useHead = flags.head   ? '--head'    : '';
-    const python  = process.platform === 'win32' ? 'python' : 'python3';
     const { execSync } = require('child_process');
 
     // Phase 1: Skill Evolution
@@ -736,6 +745,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;
@@ -780,7 +798,6 @@ function cmdCase(flags) {
         process.exit(1);
     }
 
-    const python  = process.platform === 'win32' ? 'python' : 'python3';
     const caseLawScript = path.join(agentDest, 'scripts', 'case_law_manager.js');
 
     // Make shorthand aliases
@@ -796,6 +813,34 @@ function cmdCase(flags) {
     }
 }
 
+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');
@@ -821,6 +866,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 (e) {
+        process.exit(1);
+    }
+}
+
 function cmdUninstall(flags) {
     const targetDir = flags.path ? path.resolve(flags.path) : process.cwd();
     const agentDest = path.join(targetDir, '.agent');
@@ -895,6 +964,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();
@@ -931,11 +1003,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 ? require('path').resolve(flags.path) : process.cwd();
+    const agentDest = require('path').join(targetDir, '.agent');
+    
+    if (!require('fs').existsSync(agentDest)) {
+        console.error('  \x1b[91m✖\x1b[0m .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,80 +1,81 @@
-{
-    "name": "tribunal-kit",
-    "version": "4.3.0",
-    "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",
-        "ai-agent",
-        "agent",
-        "agents",
-        "multi-agent",
-        "agentic",
-        "swarm",
-        "orchestration",
-        "llm",
-        "anti-hallucination",
-        "hallucination",
-        "code-review",
-        "code-quality",
-        "cursor",
-        "cursor-rules",
-        "cursorrules",
-        "windsurf",
-        "copilot",
-        "cline",
-        "gemini",
-        "antigravity",
-        "tribunal",
-        "mcp",
-        "model-context-protocol",
-        "cli",
-        "devtools",
-        "ai-coding",
-        "autonomous-agents",
-        "coding-assistant",
-        "automation"
-    ],
-    "homepage": "https://github.com/Harmitx7/tribunal-kit",
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/Harmitx7/tribunal-kit.git"
-    },
-    "license": "MIT",
-    "bin": {
-        "tribunal-kit": "bin/tribunal-kit.js",
-        "tk": "bin/tribunal-kit.js"
-    },
-    "files": [
-        "bin/",
-        "scripts/",
-        ".agent/",
-        "README.md",
-        "LICENSE"
-    ],
-    "engines": {
-        "node": ">=18.0.0"
-    },
-    "scripts": {
-        "test": "jest --coverage",
-        "test:unit": "jest test/unit --coverage",
-        "test:integration": "jest test/integration --coverage",
-        "preversion": "node scripts/sync-version.js",
-        "version": "node scripts/changelog.js && git add CHANGELOG.md",
-        "changelog": "node scripts/changelog.js",
-        "changelog:preview": "node scripts/changelog.js --preview",
-        "sync": "node scripts/sync-version.js"
-    },
-    "devDependencies": {
-        "jest": "^29.7.0"
-    },
-    "jest": {
-        "testMatch": [
-            "**/test/**/*.test.js"
-        ],
-        "testEnvironment": "node",
-        "coverageDirectory": "coverage",
-        "collectCoverageFrom": [
-            "bin/**/*.js"
-        ]
-    }
-}
+{
+    "name": "tribunal-kit",
+    "version": "4.4.0",
+    "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",
+        "ai-agent",
+        "agent",
+        "agents",
+        "multi-agent",
+        "agentic",
+        "swarm",
+        "orchestration",
+        "llm",
+        "anti-hallucination",
+        "hallucination",
+        "code-review",
+        "code-quality",
+        "cursor",
+        "cursor-rules",
+        "cursorrules",
+        "windsurf",
+        "copilot",
+        "cline",
+        "gemini",
+        "antigravity",
+        "tribunal",
+        "mcp",
+        "model-context-protocol",
+        "cli",
+        "devtools",
+        "ai-coding",
+        "autonomous-agents",
+        "coding-assistant",
+        "automation"
+    ],
+    "homepage": "https://github.com/Harmitx7/tribunal-kit",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/Harmitx7/tribunal-kit.git"
+    },
+    "license": "MIT",
+    "bin": {
+        "tribunal-kit": "bin/tribunal-kit.js",
+        "tk": "bin/tribunal-kit.js"
+    },
+    "files": [
+        "bin/",
+        "scripts/",
+        ".agent/",
+        "README.md",
+        "LICENSE"
+    ],
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "scripts": {
+        "test": "npm run validate-payload && jest --coverage",
+        "test:unit": "jest test/unit --coverage",
+        "test:integration": "jest test/integration --coverage",
+        "preversion": "node scripts/sync-version.js",
+        "version": "node scripts/changelog.js && git add CHANGELOG.md",
+        "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"
+    },
+    "devDependencies": {
+        "jest": "^29.7.0"
+    },
+    "jest": {
+        "testMatch": [
+            "**/test/**/*.test.js"
+        ],
+        "testEnvironment": "node",
+        "coverageDirectory": "coverage",
+        "collectCoverageFrom": [
+            "bin/**/*.js"
+        ]
+    }
+}

package/scripts/validate-payload.js

@@ -0,0 +1,73 @@
+const fs = require('fs');
+const path = require('path');
+
+// Simple Markdown frontmatter and Tribunal header validator
+function validateMarkdownFile(filePath) {
+    const content = fs.readFileSync(filePath, 'utf8');
+    let errors = [];
+
+    // Check for frontmatter
+    if (content.startsWith('---')) {
+        const parts = content.split('---');
+        if (parts.length < 3) {
+            errors.push('Malformed YAML frontmatter (missing closing ---)');
+        }
+    }
+
+    // If it's a skill, check for mandatory headers
+    if (filePath.includes('/skills/') || filePath.includes('\\skills\\')) {
+        // Exclude templates and documentation that aren't strict skills
+        if (!filePath.includes('SKILL.md')) return errors;
+        
+        if (!content.includes('Pre-Flight Checklist') && !content.includes('Pre-Flight')) {
+            errors.push('Missing mandatory header/section: Pre-Flight Checklist');
+        }
+        if (!content.includes('VBC Protocol') && !content.includes('VBC')) {
+            errors.push('Missing mandatory header/section: VBC Protocol');
+        }
+    }
+
+    return errors;
+}
+
+function walkDir(dir, callback) {
+    fs.readdirSync(dir).forEach(f => {
+        let dirPath = path.join(dir, f);
+        let isDirectory = fs.statSync(dirPath).isDirectory();
+        isDirectory ? walkDir(dirPath, callback) : callback(path.join(dir, f));
+    });
+}
+
+function run() {
+    const agentDir = path.join(__dirname, '..', '.agent');
+    if (!fs.existsSync(agentDir)) {
+        console.error('No .agent directory found.');
+        process.exit(1);
+    }
+
+    let hasErrors = false;
+    let checkedCount = 0;
+    
+    console.log('Validating .agent payload...');
+    
+    walkDir(agentDir, function(filePath) {
+        if (filePath.endsWith('.md')) {
+            checkedCount++;
+            const errors = validateMarkdownFile(filePath);
+            if (errors.length > 0) {
+                console.error(`\x1b[31m[FAIL]\x1b[0m ${filePath}`);
+                errors.forEach(e => console.error(`  - ${e}`));
+                hasErrors = true;
+            }
+        }
+    });
+
+    if (hasErrors) {
+        console.error(`\nPayload validation failed. Checked ${checkedCount} files.`);
+        process.exit(1);
+    } else {
+        console.log(`\x1b[32mPayload validation passed.\x1b[0m Checked ${checkedCount} files.`);
+    }
+}
+
+run();