benchforge 0.1.11 → 0.2.4

package/src/heap-sample/HeapSampleReport.ts

@@ -1,269 +0,0 @@
-import pc from "picocolors";
-
-import { formatBytes } from "../table-util/Formatters.ts";
-import type { HeapProfile, HeapSample } from "./HeapSampler.ts";
-import {
-  type ResolvedFrame,
-  type ResolvedProfile,
-  resolveProfile,
-} from "./ResolvedProfile.ts";
-
-export interface CallFrame {
-  fn: string;
-  url: string;
-  line: number; // 1-indexed for display
-  col?: number; // 1-indexed for display
-}
-
-export interface HeapSite {
-  fn: string;
-  url: string;
-  line: number; // 1-indexed for display
-  col?: number;
-  bytes: number;
-  stack?: CallFrame[]; // call stack from root to this frame
-  samples?: HeapSample[]; // individual allocation samples at this site
-  callers?: { stack: CallFrame[]; bytes: number }[]; // distinct caller paths
-}
-
-export type UserCodeFilter = (site: CallFrame) => boolean;
-
-export interface HeapReportOptions {
-  topN: number;
-  stackDepth?: number;
-  verbose?: boolean;
-  raw?: boolean; // dump every raw sample
-  userOnly?: boolean; // filter to user code only (hide node internals)
-  isUserCode?: UserCodeFilter; // predicate for user vs internal code
-  totalAll?: number; // total across all nodes (before filtering)
-  totalUserCode?: number; // total for user code only
-  sampleCount?: number; // number of samples taken
-}
-
-/** Sum selfSize across all nodes in profile (before any filtering) */
-export function totalProfileBytes(profile: HeapProfile): number {
-  return resolveProfile(profile).totalBytes;
-}
-
-/** Flatten resolved profile into sorted list of allocation sites with call stacks.
- *  When raw samples are available, attaches them to corresponding sites. */
-export function flattenProfile(resolved: ResolvedProfile): HeapSite[] {
-  const sites: HeapSite[] = [];
-  const nodeIdToSites = new Map<number, HeapSite[]>();
-
-  for (const node of resolved.allocationNodes) {
-    const frame = toCallFrame(node.frame);
-    const stack = node.stack.map(toCallFrame);
-    const site: HeapSite = { ...frame, bytes: node.selfSize, stack };
-    sites.push(site);
-    const existing = nodeIdToSites.get(node.nodeId);
-    if (existing) existing.push(site);
-    else nodeIdToSites.set(node.nodeId, [site]);
-  }
-
-  // Attach raw samples to their corresponding sites
-  for (const sample of resolved.sortedSamples ?? []) {
-    const matchingSites = nodeIdToSites.get(sample.nodeId);
-    if (!matchingSites) continue;
-    for (const site of matchingSites) {
-      if (!site.samples) site.samples = [];
-      site.samples.push(sample);
-    }
-  }
-
-  return sites.sort((a, b) => b.bytes - a.bytes);
-}
-
-/** Check if site is user code (not node internals) */
-export function isNodeUserCode(site: CallFrame): boolean {
-  if (!site.url) return false;
-  if (site.url.startsWith("node:")) return false;
-  if (site.url.includes("(native)")) return false;
-  if (site.url.includes("internal/")) return false;
-  return true;
-}
-
-/** Check if site is user code (not browser internals) */
-export function isBrowserUserCode(site: CallFrame): boolean {
-  if (!site.url) return false;
-  if (site.url.startsWith("chrome-extension://")) return false;
-  if (site.url.startsWith("devtools://")) return false;
-  if (site.url.includes("(native)")) return false;
-  return true;
-}
-
-/** Filter sites to user code only */
-export function filterSites(
-  sites: HeapSite[],
-  isUser: UserCodeFilter = isNodeUserCode,
-): HeapSite[] {
-  return sites.filter(isUser);
-}
-
-/** Aggregate sites by location (combine same file:line:col).
- *  Tracks distinct caller stacks with byte weights when merging. */
-export function aggregateSites(sites: HeapSite[]): HeapSite[] {
-  const byLocation = new Map<string, HeapSite>();
-
-  for (const site of sites) {
-    // When column is unknown, include fn name to avoid merging distinct sites
-    const key =
-      site.col != null
-        ? `${site.url}:${site.line}:${site.col}`
-        : `${site.url}:${site.line}:?:${site.fn}`;
-    const existing = byLocation.get(key);
-    if (existing) {
-      existing.bytes += site.bytes;
-      addCaller(existing, site);
-    } else {
-      const entry = { ...site };
-      if (site.stack) {
-        entry.callers = [{ stack: site.stack, bytes: site.bytes }];
-      }
-      byLocation.set(key, entry);
-    }
-  }
-
-  // Sort callers by bytes descending, use top caller as primary stack
-  for (const site of byLocation.values()) {
-    if (site.callers && site.callers.length > 1) {
-      site.callers.sort((a, b) => b.bytes - a.bytes);
-      site.stack = site.callers[0].stack;
-    }
-  }
-
-  return [...byLocation.values()].sort((a, b) => b.bytes - a.bytes);
-}
-
-/** Format heap report for console output */
-export function formatHeapReport(
-  sites: HeapSite[],
-  options: HeapReportOptions,
-): string {
-  const { topN, stackDepth = 3, verbose = false } = options;
-  const { totalAll, totalUserCode, sampleCount } = options;
-  const isUser = options.isUserCode ?? isNodeUserCode;
-  const lines: string[] = [];
-  lines.push(`Heap allocation sites (top ${topN}, garbage included):`);
-
-  for (const site of sites.slice(0, topN)) {
-    if (verbose) {
-      formatVerboseSite(lines, site, stackDepth, isUser);
-    } else {
-      formatCompactSite(lines, site, stackDepth, isUser);
-    }
-  }
-
-  lines.push("");
-  if (totalAll !== undefined)
-    lines.push(`Total (all):       ${fmtBytes(totalAll)}`);
-  if (totalUserCode !== undefined)
-    lines.push(`Total (user-code): ${fmtBytes(totalUserCode)}`);
-  if (sampleCount !== undefined)
-    lines.push(`Samples: ${sampleCount.toLocaleString()}`);
-
-  return lines.join("\n");
-}
-
-/** Get total bytes from sites */
-export function totalBytes(sites: HeapSite[]): number {
-  return sites.reduce((sum, s) => sum + s.bytes, 0);
-}
-
-/** Format every raw sample as one line, ordered by ordinal (time).
- *  Output is tab-separated for easy piping/grep/diff. */
-export function formatRawSamples(resolved: ResolvedProfile): string {
-  if (!resolved.sortedSamples || resolved.sortedSamples.length === 0) {
-    return "No raw samples available.";
-  }
-
-  const lines: string[] = ["ordinal\tsize\tfunction\tlocation"];
-  for (const s of resolved.sortedSamples) {
-    const node = resolved.nodeMap.get(s.nodeId);
-    const fn = node?.frame.name || "(unknown)";
-    const url = node?.frame.url || "";
-    const loc = url
-      ? fmtLoc(url, node!.frame.line, node!.frame.col)
-      : "(unknown)";
-    lines.push(`${s.ordinal}\t${s.size}\t${fn}\t${loc}`);
-  }
-  return lines.join("\n");
-}
-
-function toCallFrame(f: ResolvedFrame): CallFrame {
-  return { fn: f.name, url: f.url, line: f.line, col: f.col };
-}
-
-/** Add a caller stack to an aggregated site, merging if the same path exists */
-function addCaller(existing: HeapSite, site: HeapSite): void {
-  if (!site.stack) return;
-  if (!existing.callers) {
-    existing.callers = [];
-  }
-  const key = callerKey(site.stack);
-  const match = existing.callers.find(c => callerKey(c.stack) === key);
-  if (match) {
-    match.bytes += site.bytes;
-  } else {
-    existing.callers.push({ stack: site.stack, bytes: site.bytes });
-  }
-}
-
-/** Verbose multi-line format with file:// paths and line numbers */
-function formatVerboseSite(
-  lines: string[],
-  site: HeapSite,
-  stackDepth: number,
-  isUser: UserCodeFilter,
-): void {
-  const bytes = fmtBytes(site.bytes).padStart(10);
-  const loc = site.url ? fmtLoc(site.url, site.line, site.col) : "(unknown)";
-  const dimFn = isUser(site) ? (s: string) => s : pc.dim;
-
-  lines.push(dimFn(`${bytes}  ${site.fn}  ${loc}`));
-
-  if (site.stack && site.stack.length > 1) {
-    const callers = site.stack.slice(0, -1).reverse().slice(0, stackDepth);
-    for (const frame of callers) {
-      if (!frame.url || !isUser(frame)) continue;
-      const callerLoc = fmtLoc(frame.url, frame.line, frame.col);
-      lines.push(dimFn(`            <- ${frame.fn}  ${callerLoc}`));
-    }
-  }
-}
-
-/** Compact single-line format: `49 MB  fn1 <- fn2 <- fn3` */
-function formatCompactSite(
-  lines: string[],
-  site: HeapSite,
-  stackDepth: number,
-  isUser: UserCodeFilter,
-): void {
-  const bytes = fmtBytes(site.bytes).padStart(10);
-  const fns = [site.fn];
-
-  if (site.stack && site.stack.length > 1) {
-    const callers = site.stack.slice(0, -1).reverse().slice(0, stackDepth);
-    for (const frame of callers) {
-      if (!frame.url || !isUser(frame)) continue;
-      fns.push(frame.fn);
-    }
-  }
-
-  const line = `${bytes}  ${fns.join(" <- ")}`;
-  lines.push(isUser(site) ? line : pc.dim(line));
-}
-
-function fmtBytes(bytes: number): string {
-  return formatBytes(bytes, { space: true }) ?? `${bytes} B`;
-}
-
-/** Format location, omitting column when unknown */
-function fmtLoc(url: string, line: number, col?: number): string {
-  return col != null ? `${url}:${line}:${col}` : `${url}:${line}`;
-}
-
-/** Serialize a call stack for dedup comparison */
-function callerKey(stack: CallFrame[]): string {
-  return stack.map(f => `${f.url}:${f.line}:${f.col}`).join("|");
-}

package/src/html/HtmlReport.ts

@@ -1,131 +0,0 @@
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { createServer, type Server } from "node:http";
-import { dirname, extname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import open from "open";
-import { generateHtmlDocument } from "./HtmlTemplate.ts";
-import type {
-  HtmlReportOptions,
-  HtmlReportResult,
-  ReportData,
-} from "./Types.ts";
-
-/** Generate HTML report from prepared data and optionally open in browser */
-export async function generateHtmlReport(
-  data: ReportData,
-  options: HtmlReportOptions,
-): Promise<HtmlReportResult> {
-  const html = generateHtmlDocument(data);
-
-  const reportDir = options.outputPath || (await createReportDir());
-  await mkdir(reportDir, { recursive: true });
-
-  await writeFile(join(reportDir, "index.html"), html, "utf-8");
-  const plots = await loadPlotsBundle();
-  await writeFile(join(reportDir, "plots.js"), plots, "utf-8");
-  await writeLatestRedirect(reportDir);
-
-  let server: Server | undefined;
-  let closeServer: (() => void) | undefined;
-
-  if (options.openBrowser) {
-    const baseDir = dirname(reportDir);
-    const reportName = reportDir.split("/").pop();
-    const result = await startReportServer(baseDir, 7979, 7978, 7977);
-    server = result.server;
-    closeServer = () => result.server.close();
-    const openUrl = `http://localhost:${result.port}/${reportName}/`;
-    await open(openUrl);
-    console.log(`Report opened in browser: ${openUrl}`);
-  } else {
-    console.log(`Report saved to: ${reportDir}/`);
-  }
-
-  return { reportDir, server, closeServer };
-}
-
-/** Create a timestamped report directory under ./bench-report/ */
-async function createReportDir(): Promise<string> {
-  const base = "./bench-report";
-  await mkdir(base, { recursive: true });
-  const ts = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
-  return join(base, `report-${ts}`);
-}
-
-/** Read the pre-built browser plots bundle from dist/ */
-async function loadPlotsBundle(): Promise<string> {
-  const thisDir = dirname(fileURLToPath(import.meta.url));
-  const builtPath = join(thisDir, "browser/index.js");
-  const devPath = join(thisDir, "../../dist/browser/index.js");
-  try {
-    return await readFile(builtPath, "utf-8");
-  } catch {}
-  return readFile(devPath, "utf-8");
-}
-
-/** Write an index.html in the parent dir that redirects to this report */
-async function writeLatestRedirect(reportDir: string): Promise<void> {
-  const baseDir = dirname(reportDir);
-  const reportName = reportDir.split("/").pop();
-  const html = `<!DOCTYPE html>
-<html><head>
-  <meta http-equiv="refresh" content="0; url=./${reportName}/">
-  <script>location.href = "./${reportName}/";</script>
-</head><body>
-  <a href="./${reportName}/">Latest report</a>
-</body></html>`;
-  await writeFile(join(baseDir, "index.html"), html, "utf-8");
-}
-
-/** Start HTTP server for report directory, trying fallback ports if needed */
-async function startReportServer(
-  baseDir: string,
-  ...ports: number[]
-): Promise<{ server: Server; port: number }> {
-  const mimeTypes: Record<string, string> = {
-    ".html": "text/html",
-    ".js": "application/javascript",
-    ".css": "text/css",
-    ".json": "application/json",
-  };
-
-  const server = createServer(async (req, res) => {
-    const url = req.url || "/";
-    const suffix = url.endsWith("/") ? url + "index.html" : url;
-    const filePath = join(baseDir, suffix);
-    try {
-      const content = await readFile(filePath);
-      const mime = mimeTypes[extname(filePath)] || "application/octet-stream";
-      res.setHeader("Content-Type", mime);
-      res.end(content);
-    } catch {
-      res.statusCode = 404;
-      res.end("Not found");
-    }
-  });
-
-  for (const port of ports) {
-    try {
-      return await tryListen(server, port);
-    } catch {
-      // Port in use, try next
-    }
-  }
-  return tryListen(server, 0);
-}
-
-/** Listen on a port, resolving with the actual port or rejecting on error */
-function tryListen(
-  server: Server,
-  port: number,
-): Promise<{ server: Server; port: number }> {
-  return new Promise((resolve, reject) => {
-    server.once("error", reject);
-    server.listen(port, () => {
-      server.removeListener("error", reject);
-      const addr = server.address();
-      const actualPort = typeof addr === "object" && addr ? addr.port : port;
-      resolve({ server, port: actualPort });
-    });
-  });
-}

package/src/html/HtmlTemplate.ts

@@ -1,284 +0,0 @@
-import type { GitVersion, GroupData, ReportData } from "./Types.ts";
-
-const skipArgs = new Set(["_", "$0", "html", "export-html"]);
-
-const badgeLabels = {
-  faster: "Faster",
-  slower: "Slower",
-  uncertain: "Inconclusive",
-};
-const defaultArgs: Record<string, unknown> = {
-  worker: true,
-  time: 5,
-  warmup: 500,
-  "pause-interval": 0,
-  "pause-duration": 100,
-};
-
-/** Format ISO date as local time with UTC: "Jan 9, 2026, 3:45 PM (2026-01-09T23:45:00Z)" */
-export function formatDateWithTimezone(isoDate: string): string {
-  const date = new Date(isoDate);
-  const local = date.toLocaleString("en-US", {
-    month: "short",
-    day: "numeric",
-    year: "numeric",
-    hour: "numeric",
-    minute: "2-digit",
-  });
-  const utc = date.toISOString().replace(".000Z", "Z");
-  return `${local} (${utc})`;
-}
-
-/** Format relative time: "5m ago", "2h ago", "yesterday", "3 days ago" */
-export function formatRelativeTime(isoDate: string): string {
-  const date = new Date(isoDate);
-  const now = new Date();
-  const diffMs = now.getTime() - date.getTime();
-  const diffMins = Math.floor(diffMs / 60000);
-  const diffHours = Math.floor(diffMs / 3600000);
-  const diffDays = Math.floor(diffMs / 86400000);
-
-  if (diffMins < 1) return "just now";
-  if (diffMins < 60) return `${diffMins}m ago`;
-  if (diffHours < 24) return `${diffHours}h ago`;
-  if (diffDays === 1) return "yesterday";
-  if (diffDays < 30) return `${diffDays} days ago`;
-  return date.toLocaleDateString("en-US", { month: "short", day: "numeric" });
-}
-
-/** Generate complete HTML document with embedded data and visualizations */
-export function generateHtmlDocument(data: ReportData): string {
-  return `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Benchmark Report - ${new Date().toLocaleDateString()}</title>
-  <style>
-    * { margin: 0; padding: 0; box-sizing: border-box; }
-    body {
-      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
-      background: #f5f5f5;
-      padding: 20px;
-      line-height: 1.6;
-    }
-    .header {
-      background: white;
-      padding: 10px 15px;
-      border-radius: 8px;
-      margin-bottom: 20px;
-      box-shadow: 0 2px 4px rgba(0,0,0,0.1);
-      display: flex;
-      justify-content: space-between;
-      align-items: center;
-    }
-    h1 { display: none; }
-    h2 {
-      color: #555;
-      margin: 30px 0 20px;
-      font-size: 20px;
-      border-bottom: 2px solid #e0e0e0;
-      padding-bottom: 10px;
-    }
-    .metadata { color: #666; font-size: 12px; }
-    .cli-args {
-      font-family: "SF Mono", Monaco, "Consolas", monospace;
-      font-size: 11px;
-      color: #555;
-      background: #f0f0f0;
-      padding: 6px 10px;
-      border-radius: 4px;
-      word-break: break-word;
-    }
-    .comparison-mode {
-      background: #fff3cd;
-      color: #856404;
-      padding: 8px 12px;
-      border-radius: 4px;
-      display: inline-block;
-      margin-top: 10px;
-      font-weight: 500;
-    }
-    .plot-grid {
-      display: grid;
-      grid-template-columns: 1fr 1fr;
-      gap: 20px;
-      margin-bottom: 30px;
-    }
-    .plot-grid.second-row { grid-template-columns: 1fr; }
-    .plot-container {
-      background: white;
-      padding: 20px;
-      border-radius: 8px;
-      box-shadow: 0 2px 4px rgba(0,0,0,0.1);
-    }
-    .plot-container.full-width { grid-column: 1 / -1; }
-    .plot-title { font-size: 18px; font-weight: 600; margin-bottom: 8px; color: #333; }
-    .plot-description { font-size: 14px; color: #666; margin-bottom: 15px; }
-    .plot-area {
-      display: flex;
-      justify-content: center;
-      align-items: center;
-      min-height: 300px;
-    }
-    .plot-area svg { overflow: visible; }
-    .plot-area svg g[aria-label="x-axis label"] text { font-size: 14px; }
-    .summary-stats { background: #f8f9fa; padding: 15px; border-radius: 6px; margin-top: 20px; }
-    .stats-grid {
-      display: grid;
-      grid-template-columns: repeat(auto-fit, minmax(150px, 1fr));
-      gap: 10px;
-      margin-top: 10px;
-    }
-    .stat-item { background: white; padding: 10px; border-radius: 4px; text-align: center; }
-    .stat-label { font-size: 12px; color: #666; text-transform: uppercase; letter-spacing: 0.5px; }
-    .stat-value { font-size: 18px; font-weight: 600; color: #333; margin-top: 4px; }
-    .loading { color: #666; font-style: italic; padding: 20px; text-align: center; }
-    .error { color: #d32f2f; background: #ffebee; padding: 15px; border-radius: 4px; margin: 10px 0; }
-    .ci-faster { color: #22c55e; }
-    .ci-slower { color: #ef4444; }
-    .ci-uncertain { color: #6b7280; }
-    .group-header {
-      display: flex;
-      align-items: center;
-      gap: 12px;
-      margin: 30px 0 20px;
-      padding-bottom: 10px;
-      border-bottom: 2px solid #e0e0e0;
-    }
-    .group-header h2 { margin: 0; border: none; padding: 0; }
-    .badge {
-      font-size: 12px;
-      font-weight: 600;
-      padding: 4px 10px;
-      border-radius: 12px;
-      text-transform: uppercase;
-      letter-spacing: 0.5px;
-    }
-    .badge-faster { background: #dcfce7; color: #166534; }
-    .badge-slower { background: #fee2e2; color: #991b1b; }
-    .badge-uncertain { background: #dbeafe; color: #1e40af; }
-    .version-info { font-size: 12px; color: #666; margin-top: 6px; }
-    .header-right { text-align: right; }
-    .ci-plot-container { display: inline-block; vertical-align: middle; margin-left: 8px; }
-    .ci-plot-container svg { display: block; }
-  </style>
-</head>
-<body>
-  <div class="header">
-    <div class="cli-args">${formatCliArgs(data.metadata.cliArgs)}</div>
-    <div class="header-right">
-      <div class="metadata">Generated: ${formatDateWithTimezone(new Date().toISOString())}</div>
-      ${versionInfoHtml(data)}
-    </div>
-  </div>
-
-  ${data.groups
-    .map(
-      (group, i) => `
-    <div id="group-${i}">
-      ${
-        group.benchmarks.length > 0
-          ? `
-        <div class="group-header">
-          <h2>${group.name}</h2>
-          ${comparisonBadge(group, i)}
-        </div>
-
-        <div class="plot-grid">
-          <div class="plot-container">
-            <div class="plot-title">Time per Sample</div>
-            <div class="plot-description">Execution time for each sample in collection order</div>
-            <div id="sample-timeseries-${i}" class="plot-area">
-              <div class="loading">Loading time series...</div>
-            </div>
-          </div>
-
-          <div class="plot-container">
-            <div class="plot-title">Time Distribution</div>
-            <div class="plot-description">Frequency distribution of execution times</div>
-            <div id="histogram-${i}" class="plot-area">
-              <div class="loading">Loading histogram...</div>
-            </div>
-          </div>
-        </div>
-
-        <div id="stats-${i}"></div>
-      `
-          : '<div class="error">No benchmark data available for this group</div>'
-      }
-    </div>
-  `,
-    )
-    .join("")}
-
-  <script type="importmap">
-    {
-      "imports": {
-        "d3": "https://cdn.jsdelivr.net/npm/d3@7/+esm",
-        "@observablehq/plot": "https://cdn.jsdelivr.net/npm/@observablehq/plot@0.6/+esm"
-      }
-    }
-  </script>
-  <script type="module">
-    import { renderPlots } from "./plots.js";
-    const benchmarkData = ${JSON.stringify(data, null, 2)};
-    renderPlots(benchmarkData);
-  </script>
-</body>
-</html>`;
-}
-
-/** Reconstruct the CLI invocation string, omitting default/internal args */
-function formatCliArgs(args?: Record<string, unknown>): string {
-  if (!args) return "bb bench";
-  const parts = ["bb bench"];
-  for (const [key, value] of Object.entries(args)) {
-    if (shouldSkipArg(key, value, args.adaptive)) continue;
-    parts.push(value === true ? `--${key}` : `--${key} ${value}`);
-  }
-  return parts.join(" ");
-}
-
-/** Render current/baseline version info as an HTML div */
-function versionInfoHtml(data: ReportData): string {
-  const { currentVersion, baselineVersion } = data.metadata;
-  if (!currentVersion && !baselineVersion) return "";
-  const parts: string[] = [];
-  if (currentVersion) parts.push(`Current: ${formatVersion(currentVersion)}`);
-  if (baselineVersion)
-    parts.push(`Baseline: ${formatVersion(baselineVersion)}`);
-  return `<div class="version-info">${parts.join(" | ")}</div>`;
-}
-
-/** Render faster/slower/uncertain badge with CI plot container */
-function comparisonBadge(group: GroupData, groupIndex: number): string {
-  const ci = group.benchmarks[0]?.comparisonCI;
-  if (!ci) return "";
-  const label = badgeLabels[ci.direction];
-  return `
-    <span class="badge badge-${ci.direction}">${label}</span>
-    <div id="ci-plot-${groupIndex}" class="ci-plot-container"></div>
-  `;
-}
-
-/** @return true if this CLI arg should be hidden from the report header */
-function shouldSkipArg(
-  key: string,
-  value: unknown,
-  adaptive: unknown,
-): boolean {
-  if (skipArgs.has(key) || value === undefined || value === false) return true;
-  if (defaultArgs[key] === value) return true;
-  if (!key.includes("-") && key !== key.toLowerCase()) return true; // skip yargs camelCase aliases
-  if (key === "convergence" && !adaptive) return true;
-  return false;
-}
-
-/** Format git version for display: "abc1234* (5m ago)" */
-function formatVersion(version?: GitVersion): string {
-  if (!version || version.hash === "unknown") return "unknown";
-  const hashDisplay = version.dirty ? `${version.hash}*` : version.hash;
-  const timeDisplay = version.date ? formatRelativeTime(version.date) : "";
-  return timeDisplay ? `${hashDisplay} (${timeDisplay})` : hashDisplay;
-}