tribunal-kit 4.2.0 → 4.3.1

package/package.json

@@ -1,77 +1,81 @@
-{
-    "name": "tribunal-kit",
-    "version": "4.2.0",
-    "description": "Anti-Hallucination AI Agent Kit — 37 specialist agents, 31 slash commands, Performance Swarm engine, and Supreme Court Tribunal review 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/",
-        ".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"
-    },
-    "devDependencies": {
-        "jest": "^29.7.0"
-    },
-    "jest": {
-        "testMatch": [
-            "**/test/**/*.test.js"
-        ],
-        "testEnvironment": "node",
-        "coverageDirectory": "coverage",
-        "collectCoverageFrom": [
-            "bin/**/*.js"
-        ]
-    },
-    "dependencies": {
-        "tribunal-kit": "^4.0.0"
-    }
-}
+{
+    "name": "tribunal-kit",
+    "version": "4.3.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",
+        "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/changelog.js

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+/**
+ * changelog.js — Auto-generate CHANGELOG from git history
+ * 
+ * Categorizes commits by conventional commit type:
+ *   feat:     → ✨ Features
+ *   fix:      → 🐛 Bug Fixes
+ *   perf:     → ⚡ Performance
+ *   docs:     → 📝 Documentation
+ *   test:     → ✅ Tests
+ *   refactor: → ♻️ Refactors
+ *   chore:    → 🔧 Chores
+ *   BREAKING: → 💥 Breaking Changes
+ * 
+ * Usage:
+ *   node scripts/changelog.js                  → Generate full changelog
+ *   node scripts/changelog.js --preview        → Preview unreleased changes
+ *   node scripts/changelog.js --since v4.1.0   → Changes since a specific tag
+ */
+
+'use strict';
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const PKG = require(path.resolve(__dirname, '..', 'package.json'));
+const CHANGELOG_PATH = path.resolve(__dirname, '..', 'CHANGELOG.md');
+
+// ── Commit Categories ────────────────────────────────────
+const CATEGORIES = {
+    feat:     { emoji: '✨', title: 'Features' },
+    fix:      { emoji: '🐛', title: 'Bug Fixes' },
+    perf:     { emoji: '⚡', title: 'Performance' },
+    docs:     { emoji: '📝', title: 'Documentation' },
+    test:     { emoji: '✅', title: 'Tests' },
+    refactor: { emoji: '♻️', title: 'Refactors' },
+    chore:    { emoji: '🔧', title: 'Chores' },
+    ci:       { emoji: '🏗️', title: 'CI/CD' },
+    style:    { emoji: '🎨', title: 'Style' },
+    breaking: { emoji: '💥', title: 'Breaking Changes' },
+};
+
+// ── Git Helpers ──────────────────────────────────────────
+function git(cmd) {
+    try {
+        return execSync(`git ${cmd}`, { encoding: 'utf8', timeout: 10000 }).trim();
+    } catch {
+        return '';
+    }
+}
+
+function getLatestTag() {
+    return git('describe --tags --abbrev=0 2>nul') || git('describe --tags --abbrev=0 2>/dev/null') || '';
+}
+
+function getCommits(since) {
+    const range = since ? `${since}..HEAD` : 'HEAD';
+    const format = '--format="%H||%s||%an||%ai"';
+    const raw = git(`log ${range} ${format} --no-merges`);
+    if (!raw) return [];
+
+    return raw.split('\n').filter(Boolean).map(line => {
+        const [hash, subject, author, date] = line.split('||');
+        return { hash: hash?.slice(0, 7), subject, author, date: date?.slice(0, 10) };
+    });
+}
+
+function categorize(subject) {
+    const lower = subject.toLowerCase();
+
+    // Check for BREAKING CHANGE
+    if (lower.includes('breaking') || lower.includes('!:')) {
+        return 'breaking';
+    }
+
+    // Match conventional commit prefix
+    const match = subject.match(/^(\w+)(?:\(.+?\))?:\s*/);
+    if (match) {
+        const type = match[1].toLowerCase();
+        if (CATEGORIES[type]) return type;
+    }
+
+    // Heuristic fallback
+    if (lower.includes('fix') || lower.includes('bug')) return 'fix';
+    if (lower.includes('add') || lower.includes('new') || lower.includes('feat')) return 'feat';
+    if (lower.includes('doc') || lower.includes('readme')) return 'docs';
+    if (lower.includes('test')) return 'test';
+    if (lower.includes('refactor') || lower.includes('clean')) return 'refactor';
+    if (lower.includes('perf') || lower.includes('optim')) return 'perf';
+    if (lower.includes('ci') || lower.includes('workflow')) return 'ci';
+
+    return 'chore';
+}
+
+// ── Changelog Generation ─────────────────────────────────
+function generateChangelog(commits, version, date) {
+    const grouped = {};
+    for (const commit of commits) {
+        const cat = categorize(commit.subject);
+        if (!grouped[cat]) grouped[cat] = [];
+        // Strip conventional prefix for cleaner display
+        const clean = commit.subject.replace(/^\w+(\(.+?\))?:\s*/, '');
+        grouped[cat].push({ ...commit, clean });
+    }
+
+    let md = `## [${version}] — ${date}\n\n`;
+
+    // Breaking changes first
+    const order = ['breaking', 'feat', 'fix', 'perf', 'refactor', 'docs', 'test', 'ci', 'style', 'chore'];
+    for (const cat of order) {
+        if (!grouped[cat] || grouped[cat].length === 0) continue;
+        const { emoji, title } = CATEGORIES[cat];
+        md += `### ${emoji} ${title}\n\n`;
+        for (const c of grouped[cat]) {
+            md += `- ${c.clean} (\`${c.hash}\`)\n`;
+        }
+        md += '\n';
+    }
+
+    return md;
+}
+
+// ── Main ─────────────────────────────────────────────────
+function main() {
+    const args = process.argv.slice(2);
+    const isPreview = args.includes('--preview');
+    const sinceIdx = args.indexOf('--since');
+    const sinceTag = sinceIdx !== -1 ? args[sinceIdx + 1] : null;
+
+    const since = sinceTag || getLatestTag();
+    const commits = getCommits(since);
+
+    if (commits.length === 0) {
+        console.log('  ℹ️  No new commits found since', since || 'beginning');
+        process.exit(0);
+    }
+
+    const today = new Date().toISOString().slice(0, 10);
+    const version = isPreview ? 'Unreleased' : PKG.version;
+
+    const changelog = generateChangelog(commits, version, today);
+
+    if (isPreview) {
+        console.log('\n  📋 Changelog Preview\n  ' + '─'.repeat(40) + '\n');
+        console.log(changelog);
+        console.log(`  📊 ${commits.length} commits since ${since || 'initial commit'}`);
+        return;
+    }
+
+    // Write or prepend to CHANGELOG.md
+    const header = `# Changelog\n\nAll notable changes to Tribunal Kit are documented here.\nFormat follows [Keep a Changelog](https://keepachangelog.com/).\n\n`;
+
+    let existing = '';
+    if (fs.existsSync(CHANGELOG_PATH)) {
+        existing = fs.readFileSync(CHANGELOG_PATH, 'utf8');
+        // Remove existing header
+        existing = existing.replace(/^# Changelog[\s\S]*?(?=## )/, '');
+    }
+
+    const full = header + changelog + existing;
+    fs.writeFileSync(CHANGELOG_PATH, full, 'utf8');
+
+    console.log(`  ✔ CHANGELOG.md updated — v${version} (${commits.length} commits)`);
+}
+
+main();

package/scripts/sync-version.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+/**
+ * sync-version.js — Version Sync for Tribunal Kit
+ * 
+ * Reads the version and counts from package.json and the .agent/ directory,
+ * then updates all stale references across documentation files.
+ * 
+ * Run manually or as a preversion npm script:
+ *   node scripts/sync-version.js
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const ROOT = path.resolve(__dirname, '..');
+const PKG = JSON.parse(fs.readFileSync(path.join(ROOT, 'package.json'), 'utf8'));
+
+// Count actual installed items
+function countItems(dir) {
+    const fullPath = path.join(ROOT, '.agent', dir);
+    if (!fs.existsSync(fullPath)) return '?';
+    return fs.readdirSync(fullPath).filter(f => !f.startsWith('.')).length;
+}
+
+const version = PKG.version;
+const agents = countItems('agents');
+const skills = countItems('skills');
+const workflows = countItems('workflows');
+const scripts = countItems('scripts');
+
+console.log(`\n  📊 Tribunal Kit v${version} — Actual Counts`);
+console.log(`  ──────────────────────────────────────`);
+console.log(`  Agents:    ${agents}`);
+console.log(`  Skills:    ${skills}`);
+console.log(`  Workflows: ${workflows}`);
+console.log(`  Scripts:   ${scripts}`);
+console.log();
+
+// Files to check for stale numbers
+const FILES_TO_CHECK = [
+    'README.md',
+    'AGENT_FLOW.md',
+    '.agent/ARCHITECTURE.md',
+];
+
+let staleFound = 0;
+
+for (const relPath of FILES_TO_CHECK) {
+    const filePath = path.join(ROOT, relPath);
+    if (!fs.existsSync(filePath)) continue;
+
+    const content = fs.readFileSync(filePath, 'utf8');
+    
+    // Check for common stale patterns
+    const checks = [
+        { regex: /(\d+)\s*(specialist\s+)?agents/gi, expected: agents, label: 'agents' },
+        { regex: /(\d+)\s*skill\s*modules/gi, expected: skills, label: 'skills' },
+        { regex: /(\d+)\s*slash\s*command/gi, expected: workflows, label: 'workflows' },
+    ];
+
+    for (const check of checks) {
+        let match;
+        while ((match = check.regex.exec(content)) !== null) {
+            const found = parseInt(match[1]);
+            if (found !== check.expected && found > 5) { // ignore tiny numbers
+                staleFound++;
+                const line = content.substring(0, match.index).split('\n').length;
+                console.log(`  ⚠️  ${relPath}:${line} — says ${found} ${check.label}, actual is ${check.expected}`);
+            }
+        }
+    }
+}
+
+if (staleFound === 0) {
+    console.log(`  ✅ All counts are in sync across ${FILES_TO_CHECK.length} files.`);
+} else {
+    console.log(`\n  ❌ Found ${staleFound} stale reference(s). Update manually or run the sync tool.`);
+    process.exit(1);
+}
+
+console.log();

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();