tribunal-kit 4.6.1 → 5.8.0

package/scripts/benchmark.js

@@ -0,0 +1,197 @@
+#!/usr/bin/env node
+/**
+ * Tribunal-Kit Performance Benchmark
+ *
+ * Measures and reports performance metrics for key operations.
+ * Run: node scripts/benchmark.js
+ */
+
+const { spawnSync } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+const os = require("os");
+
+// ANSI colors
+const C = {
+  reset: "\x1b[0m",
+  bold: "\x1b[1m",
+  dim: "\x1b[2m",
+  red: "\x1b[91m",
+  green: "\x1b[92m",
+  yellow: "\x1b[93m",
+  cyan: "\x1b[96m",
+  white: "\x1b[97m",
+  gray: "\x1b[90m",
+};
+
+function c(color, text) {
+  return `${C[color]}${text}${C.reset}`;
+}
+function bold(text) {
+  return `${C.bold}${text}${C.reset}`;
+}
+
+/**
+ * Time a command execution in milliseconds.
+ * @param {string} label - Description of the benchmark
+ * @param {function} fn - Function to benchmark
+ * @param {number} [runs=3] - Number of runs for averaging
+ * @returns {{ label: string, avg: number, min: number, max: number, runs: number }}
+ */
+async function benchmark(label, fn, runs = 3) {
+  const times = [];
+  for (let i = 0; i < runs; i++) {
+    const start = performance.now();
+    await fn();
+    const end = performance.now();
+    times.push(end - start);
+  }
+  const avg = times.reduce((a, b) => a + b, 0) / times.length;
+  const min = Math.min(...times);
+  const max = Math.max(...times);
+  return { label, avg, min, max, runs };
+}
+
+/**
+ * Time a shell command.
+ */
+function benchmarkCommand(label, command, runs = 3) {
+  return benchmark(
+    label,
+    () => {
+      spawnSync("node", command.split(" "), {
+        stdio: "pipe",
+        encoding: "utf8",
+        env: { ...process.env, TK_SKIP_UPDATE_CHECK: "1" },
+      });
+    },
+    runs,
+  );
+}
+
+async function main() {
+  console.log();
+  console.log(bold(`  ⚡ Tribunal-Kit Performance Benchmark`));
+  console.log(c("gray", `  ─────────────────────────────────────────`));
+  console.log(c("gray", `  Platform: ${os.platform()} ${os.arch()}`));
+  console.log(c("gray", `  Node: ${process.version}`));
+  console.log(
+    c(
+      "gray",
+      `  CPUs: ${os.cpus().length}x ${os.cpus()[0]?.model || "unknown"}`,
+    ),
+  );
+  console.log(c("gray", `  ─────────────────────────────────────────`));
+  console.log();
+
+  const cliPath = path.resolve(__dirname, "../bin/wrapper.js");
+  const tempDir = path.join(os.tmpdir(), `tribunal-bench-${Date.now()}`);
+  fs.mkdirSync(tempDir, { recursive: true });
+
+  const results = [];
+
+  // 1. Cold start (help)
+  console.log(c("cyan", "  ▸ Benchmarking: CLI cold-start (--help)"));
+  const helpResult = await benchmarkCommand(
+    "CLI cold-start (--help)",
+    `${cliPath} --help`,
+    5,
+  );
+  results.push(helpResult);
+
+  // 2. Status check
+  console.log(c("cyan", "  ▸ Benchmarking: tk status"));
+  const statusResult = await benchmarkCommand(
+    "Status check",
+    `${cliPath} status --quiet`,
+    5,
+  );
+  results.push(statusResult);
+
+  // 3. Init (dry-run)
+  console.log(c("cyan", "  ▸ Benchmarking: tk init --dry-run"));
+  const initResult = await benchmarkCommand(
+    "Init (dry-run)",
+    `${cliPath} init --dry-run --quiet --skip-update-check --path=${tempDir}`,
+    3,
+  );
+  results.push(initResult);
+
+  // 4. Init (real, to temp dir)
+  console.log(c("cyan", "  ▸ Benchmarking: tk init (real copy)"));
+  const initRealResult = await benchmark(
+    "Init (full copy)",
+    () => {
+      const runDir = path.join(tempDir, `run-${Date.now()}`);
+      fs.mkdirSync(runDir, { recursive: true });
+      spawnSync(
+        "node",
+        [cliPath, "init", "--quiet", "--skip-update-check", `--path=${runDir}`],
+        {
+          stdio: "pipe",
+          encoding: "utf8",
+          env: { ...process.env, TK_SKIP_UPDATE_CHECK: "1" },
+        },
+      );
+      // Cleanup
+      try {
+        fs.rmSync(runDir, { recursive: true, force: true });
+      } catch {}
+    },
+    3,
+  );
+  results.push(initRealResult);
+
+  // Print results table
+  console.log();
+  console.log(bold(`  Results`));
+  console.log(
+    c("gray", `  ─────────────────────────────────────────────────────────`),
+  );
+  console.log(
+    `  ${c("white", "Operation".padEnd(30))} ${c("white", "Avg (ms)".padStart(10))} ${c("white", "Min".padStart(8))} ${c("white", "Max".padStart(8))}`,
+  );
+  console.log(
+    c("gray", `  ─────────────────────────────────────────────────────────`),
+  );
+
+  for (const r of results) {
+    const avgColor = r.avg < 100 ? "green" : r.avg < 500 ? "yellow" : "red";
+    console.log(
+      `  ${c("white", r.label.padEnd(30))} ${c(avgColor, String(Math.round(r.avg)).padStart(10))} ${c("gray", String(Math.round(r.min)).padStart(8))} ${c("gray", String(Math.round(r.max)).padStart(8))}`,
+    );
+  }
+
+  console.log(
+    c("gray", `  ─────────────────────────────────────────────────────────`),
+  );
+  console.log();
+
+  // Write results to JSON for CI/comparison
+  const outputPath = path.resolve(__dirname, "../benchmark-results.json");
+  const outputData = {
+    timestamp: new Date().toISOString(),
+    platform: `${os.platform()}-${os.arch()}`,
+    node: process.version,
+    results: results.map((r) => ({
+      label: r.label,
+      avg_ms: Math.round(r.avg),
+      min_ms: Math.round(r.min),
+      max_ms: Math.round(r.max),
+      runs: r.runs,
+    })),
+  };
+  fs.writeFileSync(outputPath, JSON.stringify(outputData, null, 2));
+  console.log(c("green", `  ✔ Results saved to benchmark-results.json`));
+
+  // Cleanup temp
+  try {
+    fs.rmSync(tempDir, { recursive: true, force: true });
+  } catch {}
+  console.log();
+}
+
+main().catch((err) => {
+  console.error(`Benchmark failed: ${err.message}`);
+  process.exit(1);
+});

package/scripts/changelog.js

@@ -1,168 +1,196 @@
-#!/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 MAX_COMMITS = 500;
-    const format = '--format=%H||%s||%an||%ai';
-    const raw = git(`log ${range} ${format} --no-merges -n ${MAX_COMMITS}`);
-    if (!raw) return [];
-
-    return raw.split('\n').filter(Boolean).map(line => {
-        const [hash, subject, author, date] = line.split('||');
-        return { hash: hash?.replace(/^"/, '').slice(0, 7), subject, author, date: date?.replace(/"$/, '').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 MAX_COMMITS = 500;
+  const format = "--format=%H||%s||%an||%ai";
+  const raw = git(`log ${range} ${format} --no-merges -n ${MAX_COMMITS}`);
+  if (!raw) return [];
+
+  return raw
+    .split("\n")
+    .filter(Boolean)
+    .map((line) => {
+      const [hash, subject, author, date] = line.split("||");
+      return {
+        hash: hash?.replace(/^"/, "").slice(0, 7),
+        subject,
+        author,
+        date: date?.replace(/"$/, "").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();