tribunal-kit 4.4.0 → 4.4.2

package/.agent/history/snapshots/test__unit__context_broker.test.js.json

@@ -0,0 +1,11 @@
+{
+  "file": "test/unit/context_broker.test.js",
+  "hash": "5fa154b5885a89376a937bd4825b1ba5643c92f6",
+  "riskScore": "Low",
+  "blastRadius": 0,
+  "imports": {
+    "../../.agent/scripts/context_broker": []
+  },
+  "dependents": [],
+  "content": "/**\n * context_broker.test.js — Unit tests for the Context Density Broker\n * Tests: tokenize, scoreSkill, selectSkills\n */\n\nconst {\n    scoreSkill,\n    selectSkills,\n    tokenize\n} = require('../../.agent/scripts/context_broker');\n\ndescribe('context_broker.js', () => {\n\n    // ── tokenize ──────────────────────────────────────────────────────────\n\n    describe('tokenize()', () => {\n        it('should extract words 3+ characters, lowercased', () => {\n            const tokens = tokenize('Build a JWT authentication API');\n            expect(tokens).toContain('build');\n            expect(tokens).toContain('jwt');\n            expect(tokens).toContain('authentication');\n            expect(tokens).toContain('api');\n        });\n\n        it('should ignore 1-2 character words', () => {\n            const tokens = tokenize('I am ok to go');\n            // \"ok\" is only 2 chars, \"am\" is 2 chars, \"I\" is 1 char, \"to\" is 2 chars, \"go\" is 2 chars\n            expect(tokens).toEqual([]);\n        });\n\n        it('should handle empty string', () => {\n            expect(tokenize('')).toEqual([]);\n        });\n\n        it('should handle underscored identifiers', () => {\n            const tokens = tokenize('use_case my_component');\n            expect(tokens).toContain('use_case');\n            expect(tokens).toContain('my_component');\n        });\n    });\n\n    // ── scoreSkill ────────────────────────────────────────────────────────\n\n    describe('scoreSkill()', () => {\n        const makeSkill = (name, description = '') => ({\n            name,\n            description,\n            content: ''\n        });\n\n        it('should give higher scores for domain-matched skills', () => {\n            const taskTokens = tokenize('Build a React component with hooks');\n            const reactSkill = makeSkill('react-specialist', 'React 19+ specialist. Components, hooks, state.');\n            const sqlSkill = makeSkill('sql-pro', 'Advanced SQL queries and optimization');\n\n            const reactScore = scoreSkill(reactSkill, 'Build a React component with hooks', [], taskTokens);\n            const sqlScore = scoreSkill(sqlSkill, 'Build a React component with hooks', [], taskTokens);\n\n            expect(reactScore).toBeGreaterThan(sqlScore);\n        });\n\n        it('should boost score for file extension affinity', () => {\n            const taskTokens = tokenize('Fix the login page');\n            const reactSkill = makeSkill('react-specialist', 'React components and hooks');\n\n            const withoutExt = scoreSkill(reactSkill, 'Fix the login page', [], taskTokens);\n            const withExt = scoreSkill(reactSkill, 'Fix the login page', ['.tsx'], taskTokens);\n\n            expect(withExt).toBeGreaterThanOrEqual(withoutExt);\n        });\n\n        it('should return 0 or low score for completely unrelated skills', () => {\n            const taskTokens = tokenize('Deploy to Kubernetes');\n            const gameSkill = makeSkill('game-design-expert', 'Game design and player experience');\n\n            const score = scoreSkill(gameSkill, 'Deploy to Kubernetes', [], taskTokens);\n            expect(score).toBeLessThanOrEqual(1);\n        });\n\n        it('should boost baseline skills', () => {\n            const taskTokens = tokenize('random unrelated task');\n            // clean-code is a baseline skill\n            const cleanCode = makeSkill('clean-code', 'Clean code mastery');\n\n            const score = scoreSkill(cleanCode, 'random unrelated task', [], taskTokens);\n            // Baseline skills get +1 regardless of match\n            expect(score).toBeGreaterThanOrEqual(1);\n        });\n    });\n\n    // ── selectSkills ──────────────────────────────────────────────────────\n\n    describe('selectSkills()', () => {\n        // Create minimal mock skills array for testing\n        const mockSkills = [\n            { name: 'react-specialist', description: 'React 19+ specialist. Components, hooks, state management.', content: '' },\n            { name: 'sql-pro', description: 'SQL queries, PostgreSQL, MySQL, optimization', content: '' },\n            { name: 'clean-code', description: 'Clean code mastery. Naming, SOLID, refactoring.', content: '' },\n            { name: 'testing-patterns', description: 'Testing mastery. Jest, Vitest, Playwright, mocking.', content: '' },\n            { name: 'vulnerability-scanner', description: 'Security vulnerability analysis. OWASP, injection.', content: '' },\n        ];\n\n        it('should return essential, supplementary, and available arrays', () => {\n            const result = selectSkills('Build a React component', [], 'large', mockSkills);\n\n            expect(result).toHaveProperty('essential');\n            expect(result).toHaveProperty('supplementary');\n            expect(result).toHaveProperty('available');\n            expect(result).toHaveProperty('scores');\n            expect(Array.isArray(result.essential)).toBe(true);\n            expect(Array.isArray(result.supplementary)).toBe(true);\n            expect(Array.isArray(result.available)).toBe(true);\n        });\n\n        it('should prioritize relevant skills in essential tier', () => {\n            const result = selectSkills('Write a SQL query for user analytics', [], 'large', mockSkills);\n            const essentialNames = result.essential.map(s => s.name);\n            // sql-pro should be ranked highly for a SQL task\n            if (essentialNames.length > 0) {\n                expect(essentialNames).toContain('sql-pro');\n            }\n        });\n\n        it('should limit essential to 6 for small models', () => {\n            const result = selectSkills('Build something', [], 'small', mockSkills);\n            expect(result.essential.length).toBeLessThanOrEqual(6);\n            // Small model should have empty supplementary\n            expect(result.supplementary).toEqual([]);\n        });\n\n        it('should collapse supplementary into available for small models', () => {\n            const result = selectSkills('Build a full-stack app', [], 'small', mockSkills);\n            expect(result.supplementary).toEqual([]);\n            // Available should contain things that would have been supplementary\n            expect(result.available.length).toBeGreaterThanOrEqual(0);\n        });\n\n        it('should limit essential to 10 for large models', () => {\n            const result = selectSkills('Build everything imaginable', [], 'large', mockSkills);\n            expect(result.essential.length).toBeLessThanOrEqual(10);\n        });\n\n        it('should return a scores Map', () => {\n            const result = selectSkills('Test something', [], 'large', mockSkills);\n            expect(result.scores).toBeInstanceOf(Map);\n            expect(result.scores.size).toBe(mockSkills.length);\n        });\n    });\n});\n"
+}

package/.agent/history/snapshots/test__unit__copyDir.test.js.json

@@ -1,12 +1,22 @@
 {
   "file": "test/unit/copyDir.test.js",
+  "hash": "1f3111ef91650adcb45b728779000c03b9bdcb3f",
   "riskScore": "Low",
   "blastRadius": 0,
   "imports": {
     "fs": [],
     "path": [],
     "os": [],
-    "../../bin/tribunal-kit": []
+    "../../bin/tribunal-kit": [
+      "parseArgs",
+      "compareSemver",
+      "copyDir",
+      "countDir",
+      "isSelfInstall",
+      "CORE_AGENTS",
+      "CORE_SKILLS",
+      "generateIDEBridges"
+    ]
   },
   "dependents": [],
   "content": "'use strict';\r\n\r\nconst fs   = require('fs');\r\nconst path = require('path');\r\nconst os   = require('os');\r\nconst { copyDir, countDir } = require('../../bin/tribunal-kit');\r\n\r\nfunction makeTempDir(prefix = 'tk-test-') {\r\n    return fs.mkdtempSync(path.join(os.tmpdir(), prefix));\r\n}\r\n\r\ndescribe('countDir', () => {\r\n    let tmpDir;\r\n\r\n    beforeEach(() => {\r\n        tmpDir = makeTempDir();\r\n    });\r\n\r\n    afterEach(() => {\r\n        fs.rmSync(tmpDir, { recursive: true, force: true });\r\n    });\r\n\r\n    test('returns 0 for empty directory', () => {\r\n        expect(countDir(tmpDir)).toBe(0);\r\n    });\r\n\r\n    test('counts files at top level', () => {\r\n        fs.writeFileSync(path.join(tmpDir, 'a.txt'), 'a');\r\n        fs.writeFileSync(path.join(tmpDir, 'b.txt'), 'b');\r\n        expect(countDir(tmpDir)).toBe(2);\r\n    });\r\n\r\n    test('counts files recursively in subdirectories', () => {\r\n        const sub = path.join(tmpDir, 'sub');\r\n        fs.mkdirSync(sub);\r\n        fs.writeFileSync(path.join(tmpDir, 'top.txt'), 'top');\r\n        fs.writeFileSync(path.join(sub, 'nested.txt'), 'nested');\r\n        expect(countDir(tmpDir)).toBe(2);\r\n    });\r\n});\r\n\r\ndescribe('copyDir', () => {\r\n    let srcDir;\r\n    let destDir;\r\n\r\n    beforeEach(() => {\r\n        srcDir  = makeTempDir('tk-src-');\r\n        destDir = makeTempDir('tk-dest-');\r\n        // Remove destDir so copyDir can create it fresh\r\n        fs.rmSync(destDir, { recursive: true, force: true });\r\n    });\r\n\r\n    afterEach(() => {\r\n        fs.rmSync(srcDir,  { recursive: true, force: true });\r\n        fs.rmSync(destDir, { recursive: true, force: true });\r\n    });\r\n\r\n    test('copies files to destination', () => {\r\n        fs.writeFileSync(path.join(srcDir, 'hello.txt'), 'hello');\r\n        copyDir(srcDir, destDir);\r\n        expect(fs.existsSync(path.join(destDir, 'hello.txt'))).toBe(true);\r\n        expect(fs.readFileSync(path.join(destDir, 'hello.txt'), 'utf8')).toBe('hello');\r\n    });\r\n\r\n    test('copies nested directories recursively', () => {\r\n        const sub = path.join(srcDir, 'sub');\r\n        fs.mkdirSync(sub);\r\n        fs.writeFileSync(path.join(sub, 'nested.txt'), 'nested');\r\n        copyDir(srcDir, destDir);\r\n        expect(fs.existsSync(path.join(destDir, 'sub', 'nested.txt'))).toBe(true);\r\n    });\r\n\r\n    test('returns total file count copied', () => {\r\n        fs.writeFileSync(path.join(srcDir, 'a.txt'), 'a');\r\n        fs.writeFileSync(path.join(srcDir, 'b.txt'), 'b');\r\n        const count = copyDir(srcDir, destDir);\r\n        expect(count).toBe(2);\r\n    });\r\n\r\n    test('dry-run does NOT create destination files', () => {\r\n        fs.writeFileSync(path.join(srcDir, 'hello.txt'), 'hello');\r\n        const destDryRun = path.join(os.tmpdir(), 'tk-dryrun-' + Date.now());\r\n        copyDir(srcDir, destDryRun, true);\r\n        expect(fs.existsSync(destDryRun)).toBe(false);\r\n    });\r\n\r\n    test('dry-run still returns correct file count', () => {\r\n        fs.writeFileSync(path.join(srcDir, 'a.txt'), 'a');\r\n        fs.writeFileSync(path.join(srcDir, 'b.txt'), 'b');\r\n        const destDryRun = path.join(os.tmpdir(), 'tk-dryrun2-' + Date.now());\r\n        const count = copyDir(srcDir, destDryRun, true);\r\n        expect(count).toBe(2);\r\n    });\r\n});\r\n"

package/.agent/history/snapshots/test__unit__graph_tools.test.js.json

@@ -1,5 +1,6 @@
 {
   "file": "test/unit/graph_tools.test.js",
+  "hash": "08b5b30f66169e34f86a9b8ad9aa842e0917f218",
   "riskScore": "Low",
   "blastRadius": 0,
   "imports": {

package/.agent/history/snapshots/test__unit__inner_loop_validator.test.js.json

@@ -0,0 +1,11 @@
+{
+  "file": "test/unit/inner_loop_validator.test.js",
+  "hash": "48487187be036a1448dcb2089cb17d01258f964f",
+  "riskScore": "Low",
+  "blastRadius": 0,
+  "imports": {
+    "../../.agent/scripts/inner_loop_validator": []
+  },
+  "dependents": [],
+  "content": "/**\n * inner_loop_validator.test.js — Unit tests for the Inner-Loop Validator\n * Tests: scanCode, computeVerdict, buildSelfHealingInstructions, validate\n */\n\nconst {\n    scanCode,\n    computeVerdict,\n    buildSelfHealingInstructions,\n    validate\n} = require('../../.agent/scripts/inner_loop_validator');\n\ndescribe('inner_loop_validator.js', () => {\n\n    // ── scanCode ──────────────────────────────────────────────────────────\n\n    describe('scanCode()', () => {\n        it('should return empty array for clean code', () => {\n            const findings = scanCode('const x = 1;\\nconst y = x + 2;\\n');\n            expect(findings).toEqual([]);\n        });\n\n        it('should detect eval() as high severity', () => {\n            const findings = scanCode('const result = eval(userInput);');\n            const evalFinding = findings.find(f => f.category === 'Code Injection');\n            expect(evalFinding).toBeDefined();\n            expect(evalFinding.severity).toBe('high');\n            expect(evalFinding.line).toBe(1);\n            expect(evalFinding.source).toBe('security_scan');\n        });\n\n        it('should detect innerHTML as high severity XSS', () => {\n            const findings = scanCode('el.innerHTML = userInput;');\n            const xssFinding = findings.find(f => f.category === 'XSS');\n            expect(xssFinding).toBeDefined();\n            expect(xssFinding.severity).toBe('high');\n        });\n\n        it('should detect hardcoded passwords as critical', () => {\n            const findings = scanCode('const password = \"supersecret123\";');\n            const secretFinding = findings.find(f => f.category === 'Hardcoded Secret');\n            expect(secretFinding).toBeDefined();\n            expect(secretFinding.severity).toBe('critical');\n        });\n\n        it('should detect empty catch blocks as medium severity', () => {\n            const findings = scanCode('try { foo(); } catch (e) {}');\n            const catchFinding = findings.find(f => f.category === 'Error Handling');\n            expect(catchFinding).toBeDefined();\n            expect(catchFinding.severity).toBe('medium');\n        });\n\n        it('should detect throw string as low severity', () => {\n            const findings = scanCode('throw \"something went wrong\";');\n            const throwFinding = findings.find(f => f.category === 'Error Quality');\n            expect(throwFinding).toBeDefined();\n            expect(throwFinding.severity).toBe('low');\n        });\n\n        it('should skip lines that are pure comments', () => {\n            const code = '// eval(dangerousInput);\\nconst safe = 1;';\n            const findings = scanCode(code);\n            // eval is in a comment, should not be flagged\n            const evalFinding = findings.find(f => f.category === 'Code Injection');\n            expect(evalFinding).toBeUndefined();\n        });\n\n        it('should report correct line numbers', () => {\n            const code = 'const a = 1;\\nconst b = 2;\\nconst r = eval(\"bad\");';\n            const findings = scanCode(code);\n            const evalFinding = findings.find(f => f.category === 'Code Injection');\n            expect(evalFinding).toBeDefined();\n            expect(evalFinding.line).toBe(3);\n        });\n\n        it('should detect VERIFY flags as low/informational', () => {\n            const findings = scanCode('const x = someApi(); // VERIFY: does this exist?');\n            const verifyFinding = findings.find(f => f.category === 'Verification Flag');\n            expect(verifyFinding).toBeDefined();\n            expect(verifyFinding.severity).toBe('low');\n        });\n\n        it('should detect browser globals in Node context', () => {\n            const findings = scanCode('const w = window.innerWidth;');\n            const browserFinding = findings.find(f => f.category === 'Environment Check');\n            expect(browserFinding).toBeDefined();\n        });\n    });\n\n    // ── computeVerdict ────────────────────────────────────────────────────\n\n    describe('computeVerdict()', () => {\n        it('should return APPROVED for no findings', () => {\n            const result = computeVerdict([]);\n            expect(result.verdict).toBe('APPROVED');\n            expect(result.passed).toBe(true);\n        });\n\n        it('should return APPROVED for low-only findings', () => {\n            const findings = [\n                { severity: 'low', category: 'Error Quality', line: 1, message: 'test' }\n            ];\n            const result = computeVerdict(findings);\n            expect(result.verdict).toBe('APPROVED');\n            expect(result.passed).toBe(true);\n        });\n\n        it('should return WARNING for medium findings', () => {\n            const findings = [\n                { severity: 'medium', category: 'Error Handling', line: 1, message: 'test' }\n            ];\n            const result = computeVerdict(findings);\n            expect(result.verdict).toBe('WARNING');\n            expect(result.passed).toBe(true);\n        });\n\n        it('should return REJECTED for high findings', () => {\n            const findings = [\n                { severity: 'high', category: 'Code Injection', line: 1, message: 'test' }\n            ];\n            const result = computeVerdict(findings);\n            expect(result.verdict).toBe('REJECTED');\n            expect(result.passed).toBe(false);\n        });\n\n        it('should return REJECTED for critical findings', () => {\n            const findings = [\n                { severity: 'critical', category: 'Hardcoded Secret', line: 1, message: 'test' }\n            ];\n            const result = computeVerdict(findings);\n            expect(result.verdict).toBe('REJECTED');\n            expect(result.passed).toBe(false);\n        });\n\n        it('should use worst severity when mixed findings exist', () => {\n            const findings = [\n                { severity: 'low', category: 'Info', line: 1, message: 'ok' },\n                { severity: 'critical', category: 'Secret', line: 2, message: 'bad' },\n            ];\n            const result = computeVerdict(findings);\n            expect(result.verdict).toBe('REJECTED');\n            expect(result.passed).toBe(false);\n        });\n\n        it('should not let Verification Flags block approval', () => {\n            const findings = [\n                { severity: 'low', category: 'Verification Flag', line: 1, message: 'verify' }\n            ];\n            const result = computeVerdict(findings);\n            expect(result.verdict).toBe('APPROVED');\n            expect(result.passed).toBe(true);\n        });\n    });\n\n    // ── buildSelfHealingInstructions ───────────────────────────────────────\n\n    describe('buildSelfHealingInstructions()', () => {\n        it('should return null when no blocking findings', () => {\n            const result = buildSelfHealingInstructions([\n                { severity: 'low', category: 'Info', line: 1, message: 'test', fix: 'do nothing' }\n            ]);\n            expect(result).toBeNull();\n        });\n\n        it('should return null for empty array', () => {\n            expect(buildSelfHealingInstructions([])).toBeNull();\n        });\n\n        it('should generate instructions for critical findings', () => {\n            const result = buildSelfHealingInstructions([\n                { severity: 'critical', category: 'Hardcoded Secret', line: 5, message: 'password hardcoded', fix: 'Use env vars' }\n            ]);\n            expect(result).toContain('CRITICAL');\n            expect(result).toContain('Line 5');\n            expect(result).toContain('Hardcoded Secret');\n            expect(result).toContain('Use env vars');\n        });\n\n        it('should generate instructions for high findings', () => {\n            const result = buildSelfHealingInstructions([\n                { severity: 'high', category: 'Code Injection', line: 3, message: 'eval used', fix: 'Remove eval' }\n            ]);\n            expect(result).toContain('HIGH');\n            expect(result).toContain('Line 3');\n        });\n\n        it('should skip medium findings in instructions', () => {\n            const result = buildSelfHealingInstructions([\n                { severity: 'medium', category: 'Error Handling', line: 1, message: 'empty catch', fix: 'Add handler' }\n            ]);\n            expect(result).toBeNull();\n        });\n    });\n\n    // ── validate (integration of scan + verdict + healing) ────────────────\n\n    describe('validate()', () => {\n        it('should return APPROVED for clean code', () => {\n            const result = validate('const x = 1;\\nconst y = x + 2;');\n            expect(result.verdict).toBe('APPROVED');\n            expect(result.passed).toBe(true);\n            expect(result.issues).toEqual([]);\n            expect(result.self_healing_instructions).toBeNull();\n        });\n\n        it('should return REJECTED for code with eval', () => {\n            const result = validate('const x = eval(input);');\n            expect(result.verdict).toBe('REJECTED');\n            expect(result.passed).toBe(false);\n            expect(result.issues.length).toBeGreaterThan(0);\n            expect(result.self_healing_instructions).not.toBeNull();\n        });\n\n        it('should handle empty/null input gracefully', () => {\n            const result = validate('');\n            expect(result.verdict).toBe('APPROVED');\n            expect(result.passed).toBe(true);\n            expect(result.summary).toContain('No code provided');\n        });\n\n        it('should handle null input', () => {\n            const result = validate(null);\n            expect(result.verdict).toBe('APPROVED');\n            expect(result.passed).toBe(true);\n        });\n\n        it('should include meta with line count and timestamp', () => {\n            const result = validate('const a = 1;\\nconst b = 2;\\nconst c = 3;');\n            expect(result.meta).toBeDefined();\n            expect(result.meta.lines_scanned).toBe(3);\n            expect(result.meta.lang).toBe('js');\n            expect(result.meta.timestamp).toBeDefined();\n        });\n\n        it('should sort issues by severity (critical first)', () => {\n            const code = [\n                'throw \"bad\";',                          // low: Error Quality\n                'const password = \"secret123\";',          // critical: Hardcoded Secret\n                'const x = eval(input);',                 // high: Code Injection\n            ].join('\\n');\n            const result = validate(code);\n            const severities = result.issues.map(i => i.severity);\n            const rankOrder = { critical: 0, high: 1, medium: 2, low: 3 };\n            for (let i = 1; i < severities.length; i++) {\n                expect(rankOrder[severities[i]]).toBeGreaterThanOrEqual(rankOrder[severities[i - 1]]);\n            }\n        });\n\n        it('should generate summary with issue counts', () => {\n            const result = validate('const password = \"secret\";');\n            expect(result.summary).toBeTruthy();\n            expect(result.summary).toContain('critical');\n        });\n    });\n});\n"
+}

package/.agent/history/snapshots/test__unit__selfInstall.test.js.json

@@ -1,12 +1,22 @@
 {
   "file": "test/unit/selfInstall.test.js",
+  "hash": "65b099af8b884c6c1d174f7f70c6d836c27e02ea",
   "riskScore": "Low",
   "blastRadius": 0,
   "imports": {
     "path": [],
     "fs": [],
     "os": [],
-    "../../bin/tribunal-kit": []
+    "../../bin/tribunal-kit": [
+      "parseArgs",
+      "compareSemver",
+      "copyDir",
+      "countDir",
+      "isSelfInstall",
+      "CORE_AGENTS",
+      "CORE_SKILLS",
+      "generateIDEBridges"
+    ]
   },
   "dependents": [],
   "content": "'use strict';\r\n\r\nconst path = require('path');\r\nconst fs   = require('fs');\r\nconst os   = require('os');\r\nconst { isSelfInstall } = require('../../bin/tribunal-kit');\r\n\r\ndescribe('isSelfInstall', () => {\r\n    test('returns true when target is the kit root (package root)', () => {\r\n        // The kit root is one level above bin/\r\n        const kitRoot = path.resolve(__dirname, '../../');\r\n        expect(isSelfInstall(kitRoot)).toBe(true);\r\n    });\r\n\r\n    test('returns false for an unrelated directory', () => {\r\n        expect(isSelfInstall(os.tmpdir())).toBe(false);\r\n    });\r\n\r\n    test('returns true when target package.json has name \"tribunal-kit\"', () => {\r\n        // Create a temp dir with a fake package.json mimicking the kit\r\n        const fakeKitDir = fs.mkdtempSync(path.join(os.tmpdir(), 'fake-tk-'));\r\n        fs.writeFileSync(\r\n            path.join(fakeKitDir, 'package.json'),\r\n            JSON.stringify({ name: 'tribunal-kit', version: '1.0.0' })\r\n        );\r\n        expect(isSelfInstall(fakeKitDir)).toBe(true);\r\n        fs.rmSync(fakeKitDir, { recursive: true, force: true });\r\n    });\r\n\r\n    test('returns false when target package.json has a different name', () => {\r\n        const fakeDir = fs.mkdtempSync(path.join(os.tmpdir(), 'other-pkg-'));\r\n        fs.writeFileSync(\r\n            path.join(fakeDir, 'package.json'),\r\n            JSON.stringify({ name: 'my-other-project', version: '1.0.0' })\r\n        );\r\n        expect(isSelfInstall(fakeDir)).toBe(false);\r\n        fs.rmSync(fakeDir, { recursive: true, force: true });\r\n    });\r\n\r\n    test('returns false when target has no package.json', () => {\r\n        const emptyDir = fs.mkdtempSync(path.join(os.tmpdir(), 'no-pkg-'));\r\n        expect(isSelfInstall(emptyDir)).toBe(false);\r\n        fs.rmSync(emptyDir, { recursive: true, force: true });\r\n    });\r\n});\r\n"

package/.agent/history/snapshots/test__unit__semver.test.js.json

@@ -1,9 +1,19 @@
 {
   "file": "test/unit/semver.test.js",
+  "hash": "d3b4e92656e66f496f034174abd53012ed00b33c",
   "riskScore": "Low",
   "blastRadius": 0,
   "imports": {
-    "../../bin/tribunal-kit": []
+    "../../bin/tribunal-kit": [
+      "parseArgs",
+      "compareSemver",
+      "copyDir",
+      "countDir",
+      "isSelfInstall",
+      "CORE_AGENTS",
+      "CORE_SKILLS",
+      "generateIDEBridges"
+    ]
   },
   "dependents": [],
   "content": "'use strict';\r\n\r\nconst { compareSemver } = require('../../bin/tribunal-kit');\r\n\r\ndescribe('compareSemver', () => {\r\n    test('returns 1 when a > b (patch)', () => {\r\n        expect(compareSemver('2.4.2', '2.4.1')).toBe(1);\r\n    });\r\n\r\n    test('returns 1 when a > b (minor)', () => {\r\n        expect(compareSemver('2.5.0', '2.4.9')).toBe(1);\r\n    });\r\n\r\n    test('returns 1 when a > b (major)', () => {\r\n        expect(compareSemver('3.0.0', '2.9.9')).toBe(1);\r\n    });\r\n\r\n    test('returns 0 when a === b', () => {\r\n        expect(compareSemver('2.4.2', '2.4.2')).toBe(0);\r\n    });\r\n\r\n    test('returns -1 when a < b (patch)', () => {\r\n        expect(compareSemver('2.4.1', '2.4.2')).toBe(-1);\r\n    });\r\n\r\n    test('returns -1 when a < b (minor)', () => {\r\n        expect(compareSemver('2.4.9', '2.5.0')).toBe(-1);\r\n    });\r\n\r\n    test('strips leading \"v\" prefix from a', () => {\r\n        expect(compareSemver('v2.4.2', '2.4.2')).toBe(0);\r\n    });\r\n\r\n    test('strips leading \"v\" prefix from b', () => {\r\n        expect(compareSemver('2.4.2', 'v2.4.2')).toBe(0);\r\n    });\r\n\r\n    test('strips leading \"v\" from both', () => {\r\n        expect(compareSemver('v2.4.3', 'v2.4.2')).toBe(1);\r\n    });\r\n\r\n    test('handles missing patch segment (treats as 0)', () => {\r\n        expect(compareSemver('2.4', '2.4.0')).toBe(0);\r\n    });\r\n});\r\n"

package/.agent/history/snapshots/test__unit__swarm_dispatcher.test.js.json

@@ -1,5 +1,6 @@
 {
   "file": "test/unit/swarm_dispatcher.test.js",
+  "hash": "59ea8d2f8e73dd3a384df1966e55002db2df0947",
   "riskScore": "Low",
   "blastRadius": 0,
   "imports": {

package/.agent/scripts/_colors.js

@@ -1,18 +1,170 @@
 /**
- * Shared ANSI color constants for Tribunal Kit scripts.
+ * _colors.js — Tribunal Kit ANSI Color System
+ * ════════════════════════════════════════════════════════════════
+ * Single source of truth for all terminal color constants.
  * Import this module instead of duplicating color codes.
+ *
+ * Usage:
+ *   const { RED, GREEN, BOLD, RESET } = require('./_colors');
+ *   const C = require('./_colors');   // C.RED, C.banner('Title'), etc.
  */
 
 'use strict';
 
+// ── Core ANSI Escape Codes ──────────────────────────────────────────────────
 const GREEN   = '\x1b[92m';
 const YELLOW  = '\x1b[93m';
 const CYAN    = '\x1b[96m';
 const RED     = '\x1b[91m';
 const BLUE    = '\x1b[94m';
 const MAGENTA = '\x1b[95m';
+const WHITE   = '\x1b[97m';
+const GRAY    = '\x1b[90m';
 const BOLD    = '\x1b[1m';
 const DIM     = '\x1b[2m';
+const ITALIC  = '\x1b[3m';
+const UNDERLINE = '\x1b[4m';
 const RESET   = '\x1b[0m';
 
-module.exports = { GREEN, YELLOW, CYAN, RED, BLUE, MAGENTA, BOLD, DIM, RESET };
+// ── Box Drawing Characters ──────────────────────────────────────────────────
+const BOX = {
+    TL: '╔', TR: '╗', BL: '╚', BR: '╝',
+    H:  '═', V:  '║',
+    tl: '┌', tr: '┐', bl: '└', br: '┘',
+    h:  '─', v:  '│',
+    cross: '┼', teeL: '├', teeR: '┤', teeT: '┬', teeB: '┴',
+    bullet: '●', bulletEmpty: '○',
+    arrow: '→', arrowLeft: '←',
+    check: '✔', cross_mark: '✖',
+};
+
+// ── Branded Output Helpers ──────────────────────────────────────────────────
+
+/**
+ * Generate a branded Tribunal banner box.
+ * @param {string} title - Script title (e.g., "verify_all.js")
+ * @param {object} [meta] - Optional metadata lines { key: value }
+ * @returns {string} Formatted banner string
+ */
+function banner(title, meta = {}) {
+    const timestamp = new Date().toISOString().replace('T', ' ').slice(0, 19);
+    const lines = [
+        `  ${BOLD}${CYAN}⚖️  TRIBUNAL KIT${RESET} ${DIM}— ${title}${RESET}`,
+    ];
+
+    const metaEntries = Object.entries(meta);
+    if (metaEntries.length > 0) {
+        for (const [key, value] of metaEntries) {
+            lines.push(`  ${DIM}${key}:${RESET} ${value}`);
+        }
+    }
+    lines.push(`  ${DIM}${timestamp}${RESET}`);
+
+    const divider = `${CYAN}${'━'.repeat(56)}${RESET}`;
+    return `\n${divider}\n${lines.join('\n')}\n${divider}`;
+}
+
+/**
+ * Generate a section header with optional timing.
+ * @param {string} title - Section title
+ * @param {number} [index] - Step number (1-based)
+ * @param {number} [ms] - Execution time in ms
+ * @returns {string}
+ */
+function sectionHeader(title, index, ms) {
+    const num = index != null ? `${index} — ` : '';
+    const timing = ms != null ? `${DIM} (${formatMs(ms)})${RESET}` : '';
+    return `\n${BOLD}${BLUE}━━━ ${num}${title} ━━━${RESET}${timing}`;
+}
+
+/**
+ * Format milliseconds into a human-readable string.
+ * @param {number} ms
+ * @returns {string}
+ */
+function formatMs(ms) {
+    if (ms < 1000) return `${ms}ms`;
+    if (ms < 60000) return `${(ms / 1000).toFixed(1)}s`;
+    return `${Math.floor(ms / 60000)}m ${Math.round((ms % 60000) / 1000)}s`;
+}
+
+// ── Status Indicator Helpers ────────────────────────────────────────────────
+
+/** @param {string} msg */
+function ok(msg) { console.log(`  ${GREEN}✅ ${msg}${RESET}`); }
+
+/** @param {string} msg */
+function fail(msg) { console.log(`  ${RED}❌ ${msg}${RESET}`); }
+
+/** @param {string} msg */
+function warn(msg) { console.log(`  ${YELLOW}⚠️  ${msg}${RESET}`); }
+
+/** @param {string} msg */
+function skip(msg) { console.log(`  ${YELLOW}⏭️  ${msg}${RESET}`); }
+
+/** @param {string} msg */
+function info(msg) { console.log(`  ${BLUE}ℹ️  ${msg}${RESET}`); }
+
+// ── Summary Table Builder ───────────────────────────────────────────────────
+
+/**
+ * Build and print a box-drawing summary table.
+ * @param {Array<{name: string, status: 'pass'|'fail'|'skip'|'warn', ms?: number}>} rows
+ */
+function summaryTable(rows) {
+    const maxName = Math.max(...rows.map(r => r.name.length), 18);
+    const colW = maxName + 2;
+
+    const statusIcon = (s) => {
+        if (s === 'pass') return `${GREEN} ✅ ${RESET}`;
+        if (s === 'fail') return `${RED} ❌ ${RESET}`;
+        if (s === 'skip') return `${YELLOW} ⏭️  ${RESET}`;
+        if (s === 'warn') return `${YELLOW} ⚠️  ${RESET}`;
+        return `${DIM} — ${RESET}`;
+    };
+
+    const pad = (str, len) => str + ' '.repeat(Math.max(0, len - str.length));
+    const top  = `  ${BOX.tl}${BOX.h.repeat(colW)}${BOX.teeT}${BOX.h.repeat(6)}${BOX.teeT}${BOX.h.repeat(10)}${BOX.tr}`;
+    const mid  = `  ${BOX.teeL}${BOX.h.repeat(colW)}${BOX.cross}${BOX.h.repeat(6)}${BOX.cross}${BOX.h.repeat(10)}${BOX.teeR}`;
+    const bot  = `  ${BOX.bl}${BOX.h.repeat(colW)}${BOX.teeB}${BOX.h.repeat(6)}${BOX.teeB}${BOX.h.repeat(10)}${BOX.br}`;
+    const hdr  = `  ${BOX.v} ${BOLD}${pad('Check', colW - 2)}${RESET} ${BOX.v}${BOLD} Res ${RESET}${BOX.v} ${BOLD}${pad('Time', 8)}${RESET}${BOX.v}`;
+
+    console.log(top);
+    console.log(hdr);
+    console.log(mid);
+
+    for (const row of rows) {
+        const time = row.ms != null ? formatMs(row.ms) : '—';
+        const line = `  ${BOX.v} ${pad(row.name, colW - 2)} ${BOX.v}${statusIcon(row.status)}${BOX.v} ${pad(time, 8)}${BOX.v}`;
+        console.log(line);
+    }
+
+    console.log(bot);
+}
+
+// ── High-Precision Timer ────────────────────────────────────────────────────
+
+/**
+ * Create a timer. Call returned function to get elapsed ms.
+ * @returns {function(): number}
+ */
+function timer() {
+    const start = process.hrtime.bigint();
+    return () => Number(process.hrtime.bigint() - start) / 1e6;
+}
+
+module.exports = {
+    // Core colors
+    GREEN, YELLOW, CYAN, RED, BLUE, MAGENTA, WHITE, GRAY,
+    BOLD, DIM, ITALIC, UNDERLINE, RESET,
+    // Box drawing
+    BOX,
+    // Branded helpers
+    banner, sectionHeader, formatMs,
+    // Status indicators
+    ok, fail, warn, skip, info,
+    // Summary
+    summaryTable,
+    // Timing
+    timer,
+};

package/.agent/scripts/_utils.js

@@ -1,6 +1,11 @@
 /**
- * Shared utilities for Tribunal Kit scripts.
- * Import this module instead of duplicating helper functions.
+ * _utils.js — Tribunal Kit Shared Utilities
+ * ════════════════════════════════════════════════════════════════
+ * Single source of truth for all shared utility functions.
+ * Import this module instead of duplicating helpers.
+ *
+ * Usage:
+ *   const { findAgentDir, walkDir, loadJson } = require('./_utils');
  */
 
 'use strict';
@@ -9,6 +14,22 @@ const fs   = require('fs');
 const path = require('path');
 const { RED, RESET } = require('./_colors');
 
+// ── Default Skip Directories ────────────────────────────────────────────────
+const DEFAULT_SKIP_DIRS = new Set([
+    'node_modules', '.git', 'dist', 'build', '.next', '.agent',
+    '__pycache__', '.venv', 'venv', 'coverage', '.turbo',
+    '.svelte-kit', '.nuxt', '.output',
+]);
+
+// ── Default Source Extensions ───────────────────────────────────────────────
+const SOURCE_EXTENSIONS = new Set([
+    '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
+    '.py', '.rs', '.go', '.java', '.cs', '.rb',
+    '.vue', '.svelte',
+]);
+
+// ── Agent Directory Discovery ───────────────────────────────────────────────
+
 /**
  * Walk up the directory tree to find the nearest .agent/ folder.
  * @param {string} [startDir] - Directory to start searching from (defaults to cwd).
@@ -30,6 +51,8 @@ function findAgentDir(startDir) {
     process.exit(1);
 }
 
+// ── Package.json Helpers ────────────────────────────────────────────────────
+
 /**
  * Check if a package.json exists in the given directory.
  * @param {string} dir - Directory to check.
@@ -39,4 +62,183 @@ function hasNpm(dir) {
     return fs.existsSync(path.join(dir, 'package.json'));
 }
 
-module.exports = { findAgentDir, hasNpm };
+/**
+ * Load and parse a JSON file safely. Returns null on failure.
+ * @param {string} filePath - Absolute path to the JSON file.
+ * @returns {object|null}
+ */
+function loadJson(filePath) {
+    try {
+        return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+    } catch {
+        return null;
+    }
+}
+
+// ── Filesystem Walking ──────────────────────────────────────────────────────
+
+/**
+ * Recursively walk a directory tree, yielding file paths.
+ * This is the consolidated walker used by all scanning scripts.
+ *
+ * @param {string} dir - Root directory to walk.
+ * @param {object} [opts] - Options.
+ * @param {Set<string>} [opts.skipDirs] - Directory names to skip (default: DEFAULT_SKIP_DIRS).
+ * @param {Set<string>} [opts.extensions] - Only yield files with these extensions. Null = all files.
+ * @param {function(string): boolean} [opts.filter] - Custom filter predicate for file paths.
+ * @returns {string[]} Array of absolute file paths.
+ */
+function walkDir(dir, opts = {}) {
+    const skipDirs   = opts.skipDirs   || DEFAULT_SKIP_DIRS;
+    const extensions = opts.extensions || null;
+    const filter     = opts.filter     || null;
+    const results = [];
+
+    function _walk(currentDir) {
+        let entries;
+        try {
+            entries = fs.readdirSync(currentDir, { withFileTypes: true });
+        } catch {
+            return;
+        }
+
+        for (const entry of entries) {
+            const fullPath = path.join(currentDir, entry.name);
+
+            if (entry.isDirectory()) {
+                if (!skipDirs.has(entry.name)) {
+                    _walk(fullPath);
+                }
+            } else if (entry.isFile()) {
+                if (extensions) {
+                    const ext = path.extname(entry.name);
+                    if (!extensions.has(ext)) continue;
+                }
+                if (filter && !filter(fullPath)) continue;
+                results.push(fullPath);
+            }
+        }
+    }
+
+    _walk(dir);
+    return results;
+}
+
+/**
+ * Count files in a directory recursively (fast — no file content reads).
+ * @param {string} dir
+ * @param {Set<string>} [skipDirs]
+ * @returns {number}
+ */
+function countFiles(dir, skipDirs = DEFAULT_SKIP_DIRS) {
+    let count = 0;
+    function _count(d) {
+        let entries;
+        try { entries = fs.readdirSync(d, { withFileTypes: true }); } catch { return; }
+        for (const e of entries) {
+            if (e.isDirectory() && !skipDirs.has(e.name)) _count(path.join(d, e.name));
+            else if (e.isFile()) count++;
+        }
+    }
+    _count(dir);
+    return count;
+}
+
+// ── CLI Argument Parsing ────────────────────────────────────────────────────
+
+/**
+ * Parse command-line arguments into a structured object.
+ * Supports --flag, --key value, and positional arguments.
+ *
+ * @param {string[]} argv - process.argv.slice(2)
+ * @param {object} [schema] - Flag definitions: { flag: { type: 'boolean'|'string'|'number', default: any } }
+ * @returns {{ flags: object, positional: string[] }}
+ */
+function parseArgs(argv, schema = {}) {
+    const flags = {};
+    const positional = [];
+
+    // Set defaults
+    for (const [key, def] of Object.entries(schema)) {
+        flags[key] = def.default ?? (def.type === 'boolean' ? false : null);
+    }
+
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+
+        if (arg === '-h' || arg === '--help') {
+            flags.help = true;
+            continue;
+        }
+
+        if (arg.startsWith('--')) {
+            const flagName = arg.slice(2);
+            const schemaDef = schema[flagName];
+
+            if (schemaDef && schemaDef.type === 'boolean') {
+                flags[flagName] = true;
+            } else if (schemaDef && i + 1 < argv.length) {
+                const val = argv[++i];
+                flags[flagName] = schemaDef.type === 'number' ? Number(val) : val;
+            } else {
+                // Unknown flag, store as boolean
+                flags[flagName] = true;
+            }
+        } else if (arg.startsWith('-') && arg.length === 2) {
+            // Short flag — treat as boolean
+            flags[arg.slice(1)] = true;
+        } else {
+            positional.push(arg);
+        }
+    }
+
+    return { flags, positional };
+}
+
+// ── Command Runner ──────────────────────────────────────────────────────────
+
+/**
+ * Run a command synchronously and return a structured result.
+ * Handles Windows .cmd shims automatically.
+ *
+ * @param {string} cmd - Command to run
+ * @param {string[]} args - Arguments
+ * @param {object} [opts] - spawnSync options (cwd, timeout, etc.)
+ * @returns {{ status: number, stdout: string, stderr: string, ok: boolean }}
+ */
+function runCommand(cmd, args = [], opts = {}) {
+    const { spawnSync } = require('child_process');
+    const executable = process.platform === 'win32' && !cmd.endsWith('.cmd') && !cmd.includes(path.sep)
+        ? `${cmd}.cmd`
+        : cmd;
+
+    const result = spawnSync(executable, args, {
+        encoding: 'utf8',
+        timeout: opts.timeout || 120000,
+        cwd: opts.cwd || process.cwd(),
+        shell: process.platform === 'win32',
+        stdio: opts.stdio || 'pipe',
+        ...opts,
+    });
+
+    return {
+        status: result.status ?? 1,
+        stdout: (result.stdout || '').toString(),
+        stderr: (result.stderr || '').toString(),
+        ok: result.status === 0,
+    };
+}
+
+module.exports = {
+    // Agent discovery
+    findAgentDir,
+    // Package.json
+    hasNpm, loadJson,
+    // Filesystem
+    walkDir, countFiles,
+    DEFAULT_SKIP_DIRS, SOURCE_EXTENSIONS,
+    // CLI
+    parseArgs,
+    // Commands
+    runCommand,
+};