tribunal-kit 4.2.0 → 4.3.0

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/.agent/scripts/auto_preview.py

@@ -1,180 +0,0 @@
-#!/usr/bin/env python3
-"""
-auto_preview.py — Start, stop, or check a local development server.
-
-Usage:
-  python .agent/scripts/auto_preview.py start
-  python .agent/scripts/auto_preview.py stop
-  python .agent/scripts/auto_preview.py status
-  python .agent/scripts/auto_preview.py restart
-"""
-
-import os
-import sys
-import json
-import time
-import signal
-import socket
-import subprocess
-from pathlib import Path
-
-PID_FILE = ".preview.pid"
-DEFAULT_PORT = 3000
-TIMEOUT_SECONDS = 30
-
-GREEN  = "\033[92m"
-RED    = "\033[91m"
-YELLOW = "\033[93m"
-BOLD   = "\033[1m"
-RESET  = "\033[0m"
-
-
-def find_start_command() -> tuple[list[str], bool]:
-    """
-    Read package.json for a dev/start script.
-    Returns (command, found) — found=False if no package.json or no scripts.
-    """
-    pkg_path = Path("package.json")
-    if not pkg_path.exists():
-        return [], False
-
-    try:
-        with open(pkg_path) as f:
-            pkg = json.load(f)
-        scripts = pkg.get("scripts", {})
-        if "dev" in scripts:
-            return ["npm", "run", "dev"], True
-        elif "start" in scripts:
-            return ["npm", "run", "start"], True
-        else:
-            return [], False
-    except (json.JSONDecodeError, IOError):
-        return [], False
-
-
-def get_port_from_env() -> int:
-    env_path = Path(".env")
-    if env_path.exists():
-        try:
-            with open(env_path) as f:
-                for line in f:
-                    if line.startswith("PORT="):
-                        return int(line.split("=")[1].strip())
-        except (ValueError, IOError):
-            pass
-    return DEFAULT_PORT
-
-
-def is_port_open(port: int) -> bool:
-    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
-        s.settimeout(1)
-        return s.connect_ex(("localhost", port)) == 0
-
-
-def read_pid() -> int | None:
-    pid_file = Path(PID_FILE)
-    if pid_file.exists():
-        try:
-            return int(pid_file.read_text().strip())
-        except (ValueError, IOError):
-            pass
-    return None
-
-
-def write_pid(pid: int) -> None:
-    Path(PID_FILE).write_text(str(pid))
-
-
-def clear_pid() -> None:
-    pid_file = Path(PID_FILE)
-    if pid_file.exists():
-        pid_file.unlink()
-
-
-def start_server() -> None:
-    port = get_port_from_env()
-
-    if is_port_open(port):
-        print(f"{YELLOW}⚠️  Port {port} is already in use.{RESET}")
-        pid = read_pid()
-        if pid:
-            print(f"   Known PID: {pid}")
-        return
-
-    cmd, found = find_start_command()
-    if not found:
-        print(f"{RED}❌ No dev/start script found.{RESET}")
-        print(f"   This project has no package.json, or its package.json has no 'dev' or 'start' script.")
-        print(f"   Add a script to package.json, or start your server manually.")
-        return
-
-    print(f"{BOLD}Starting: {' '.join(cmd)}{RESET}")
-    proc = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, text=True)
-    write_pid(proc.pid)
-
-    print(f"Waiting for port {port}…", end="", flush=True)
-    for _ in range(TIMEOUT_SECONDS):
-        if is_port_open(port):
-            print()
-            print(f"\n{GREEN}✅ Server started{RESET}")
-            print(f"   URL:     http://localhost:{port}")
-            print(f"   PID:     {proc.pid}")
-            print(f"   Command: {' '.join(cmd)}")
-            print(f"\nStop with: python .agent/scripts/auto_preview.py stop")
-            return
-        print(".", end="", flush=True)
-        time.sleep(1)
-
-    print()
-    print(f"{RED}❌ Server did not start within {TIMEOUT_SECONDS}s{RESET}")
-    proc.terminate()
-    clear_pid()
-
-
-def stop_server() -> None:
-    pid = read_pid()
-    if not pid:
-        print(f"{YELLOW}⚠️  No stored server PID found{RESET}")
-        return
-    try:
-        os.kill(pid, signal.SIGTERM)
-        time.sleep(1)
-        print(f"{GREEN}✅ Server stopped (PID {pid}){RESET}")
-    except ProcessLookupError:
-        print(f"{YELLOW}Process {pid} was not running{RESET}")
-    finally:
-        clear_pid()
-
-
-def show_status() -> None:
-    port = get_port_from_env()
-    pid = read_pid()
-    if is_port_open(port):
-        print(f"{GREEN}🟢 Running — http://localhost:{port}{RESET}")
-        if pid:
-            print(f"   PID: {pid}")
-    else:
-        print(f"{RED}🔴 Not running on port {port}{RESET}")
-
-
-def main() -> None:
-    actions = {"start", "stop", "status", "restart"}
-    if len(sys.argv) < 2 or sys.argv[1] not in actions:
-        print(f"Usage: auto_preview.py [start|stop|status|restart]")
-        sys.exit(1)
-
-    action = sys.argv[1]
-    if action == "start":
-        start_server()
-    elif action == "stop":
-        stop_server()
-    elif action == "status":
-        show_status()
-    elif action == "restart":
-        stop_server()
-        time.sleep(1)
-        start_server()
-
-
-if __name__ == "__main__":
-    main()