tribunal-kit 4.3.1 → 4.4.1

package/scripts/changelog.js

@@ -1,167 +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();
+#!/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

@@ -1,81 +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();
+#!/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();