gsd-pi 2.33.1 → 2.34.0-dev.6769913

package/dist/resources/extensions/gsd/repo-identity.js

@@ -0,0 +1,187 @@
+/**
+ * GSD Repo Identity — external state directory primitives.
+ *
+ * Computes a stable per-repo identity hash, resolves the external
+ * `~/.gsd/projects/<hash>/` state directory, and manages the
+ * `<project>/.gsd → external` symlink.
+ */
+import { createHash } from "node:crypto";
+import { execFileSync } from "node:child_process";
+import { existsSync, lstatSync, mkdirSync, readFileSync, realpathSync, rmSync, symlinkSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+// ─── Repo Identity ──────────────────────────────────────────────────────────
+/**
+ * Get the git remote URL for "origin", or "" if no remote is configured.
+ * Uses `git config` rather than `git remote get-url` for broader compat.
+ */
+function getRemoteUrl(basePath) {
+    try {
+        return execFileSync("git", ["config", "--get", "remote.origin.url"], {
+            cwd: basePath,
+            encoding: "utf-8",
+            stdio: ["ignore", "pipe", "ignore"],
+            timeout: 5_000,
+        }).trim();
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Resolve the git toplevel (real root) for the given path.
+ * For worktrees this returns the main repo root, not the worktree path.
+ */
+function canonicalizeExistingPath(path) {
+    try {
+        return realpathSync(path);
+    }
+    catch {
+        return resolve(path);
+    }
+}
+function resolveGitCommonDir(basePath) {
+    try {
+        return execFileSync("git", ["rev-parse", "--path-format=absolute", "--git-common-dir"], {
+            cwd: basePath,
+            encoding: "utf-8",
+            stdio: ["ignore", "pipe", "ignore"],
+            timeout: 5_000,
+        }).trim();
+    }
+    catch {
+        const raw = execFileSync("git", ["rev-parse", "--git-common-dir"], {
+            cwd: basePath,
+            encoding: "utf-8",
+            stdio: ["ignore", "pipe", "ignore"],
+            timeout: 5_000,
+        }).trim();
+        return resolve(basePath, raw);
+    }
+}
+function resolveGitRoot(basePath) {
+    try {
+        const commonDir = resolveGitCommonDir(basePath);
+        const normalizedCommonDir = commonDir.replaceAll("\\", "/");
+        // Normal repo or worktree with shared common dir pointing at <repo>/.git.
+        if (normalizedCommonDir.endsWith("/.git")) {
+            return canonicalizeExistingPath(resolve(commonDir, ".."));
+        }
+        // Some git setups may still expose <repo>/.git/worktrees/<name>.
+        const worktreeMarker = "/.git/worktrees/";
+        if (normalizedCommonDir.includes(worktreeMarker)) {
+            return canonicalizeExistingPath(resolve(commonDir, "..", ".."));
+        }
+        // Fallback for unusual layouts.
+        return canonicalizeExistingPath(execFileSync("git", ["rev-parse", "--show-toplevel"], {
+            cwd: basePath,
+            encoding: "utf-8",
+            stdio: ["ignore", "pipe", "ignore"],
+            timeout: 5_000,
+        }).trim());
+    }
+    catch {
+        return resolve(basePath);
+    }
+}
+/**
+ * Compute a stable identity for a repository.
+ *
+ * SHA-256 of `${remoteUrl}\n${resolvedRoot}`, truncated to 12 hex chars.
+ * Deterministic: same repo always produces the same hash regardless of
+ * which worktree the caller is inside.
+ */
+export function repoIdentity(basePath) {
+    const remoteUrl = getRemoteUrl(basePath);
+    const root = resolveGitRoot(basePath);
+    const input = `${remoteUrl}\n${root}`;
+    return createHash("sha256").update(input).digest("hex").slice(0, 12);
+}
+// ─── External State Directory ───────────────────────────────────────────────
+/**
+ * Compute the external GSD state directory for a repository.
+ *
+ * Returns `$GSD_STATE_DIR/projects/<hash>` if `GSD_STATE_DIR` is set,
+ * otherwise `~/.gsd/projects/<hash>`.
+ */
+export function externalGsdRoot(basePath) {
+    const base = process.env.GSD_STATE_DIR || join(homedir(), ".gsd");
+    return join(base, "projects", repoIdentity(basePath));
+}
+// ─── Symlink Management ─────────────────────────────────────────────────────
+/**
+ * Ensure the `<project>/.gsd` symlink points to the external state directory.
+ *
+ * 1. mkdir -p the external dir
+ * 2. If `<project>/.gsd` doesn't exist → create symlink
+ * 3. If `<project>/.gsd` is already the correct symlink → no-op
+ * 4. If `<project>/.gsd` is a real directory → return as-is (migration handles later)
+ *
+ * Returns the resolved external path.
+ */
+export function ensureGsdSymlink(projectPath) {
+    const externalPath = externalGsdRoot(projectPath);
+    const localGsd = join(projectPath, ".gsd");
+    const inWorktree = isInsideWorktree(projectPath);
+    // Ensure external directory exists
+    mkdirSync(externalPath, { recursive: true });
+    const replaceWithSymlink = () => {
+        rmSync(localGsd, { recursive: true, force: true });
+        symlinkSync(externalPath, localGsd, "junction");
+        return externalPath;
+    };
+    if (!existsSync(localGsd)) {
+        // Nothing exists yet — create symlink
+        symlinkSync(externalPath, localGsd, "junction");
+        return externalPath;
+    }
+    try {
+        const stat = lstatSync(localGsd);
+        if (stat.isSymbolicLink()) {
+            // Already a symlink — verify it points to the right place
+            const target = realpathSync(localGsd);
+            if (target === externalPath) {
+                return externalPath; // correct symlink, no-op
+            }
+            // In a worktree, mismatched symlinks are always stale. Heal them so
+            // the worktree points at the same external state dir as the main repo.
+            if (inWorktree) {
+                return replaceWithSymlink();
+            }
+            // Outside worktrees, preserve custom overrides or legacy symlinks.
+            return target;
+        }
+        if (stat.isDirectory()) {
+            // Real directory in the main repo — migration will handle this later.
+            // In worktrees, keep the directory in place and let syncGsdStateToWorktree
+            // refresh its contents. Replacing a git-tracked .gsd directory with a
+            // symlink makes git think tracked planning files were deleted.
+            return localGsd;
+        }
+    }
+    catch {
+        // lstat failed — path exists but we can't stat it
+    }
+    return localGsd;
+}
+// ─── Worktree Detection ─────────────────────────────────────────────────────
+/**
+ * Check if the given directory is a git worktree (not the main repo).
+ *
+ * Git worktrees have a `.git` *file* (not directory) containing a
+ * `gitdir:` pointer. This is git's native worktree indicator — no
+ * string marker parsing needed.
+ */
+export function isInsideWorktree(cwd) {
+    const gitPath = join(cwd, ".git");
+    try {
+        const stat = lstatSync(gitPath);
+        if (!stat.isFile())
+            return false;
+        const content = readFileSync(gitPath, "utf-8").trim();
+        return content.startsWith("gitdir:");
+    }
+    catch {
+        return false;
+    }
+}

package/dist/resources/extensions/gsd/{reports.ts → reports.js}

@@ -13,224 +13,142 @@
  * Auto-triggered: after each milestone completion (when auto_report: true).
  * Manual: /gsd export --html
  */
-
 import { writeFileSync, readFileSync, mkdirSync, existsSync } from 'node:fs';
-import { join, basename } from 'node:path';
+import { join } from 'node:path';
 import { gsdRoot } from './paths.js';
 import { formatCost, formatTokenCount } from './metrics.js';
 import { formatDateShort, formatDuration } from '../shared/format-utils.js';
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-export interface ReportEntry {
-  /** Filename relative to the reports/ dir, e.g. "M001-20260101T120000.html" */
-  filename: string;
-  /** ISO timestamp when this report was generated */
-  generatedAt: string;
-  /** Milestone ID this snapshot covers, or "final" for a full-project snapshot */
-  milestoneId: string | 'final';
-  /** Milestone title at snapshot time */
-  milestoneTitle: string;
-  /** Human-readable label shown in the index */
-  label: string;
-  /** Snapshot kind */
-  kind: 'milestone' | 'manual' | 'final';
-  // Metrics at snapshot time — for the index progression view
-  totalCost: number;
-  totalTokens: number;
-  totalDuration: number;
-  doneSlices: number;
-  totalSlices: number;
-  doneMilestones: number;
-  totalMilestones: number;
-  phase: string;
-}
-
-export interface ReportsIndex {
-  version: 1;
-  projectName: string;
-  projectPath: string;
-  gsdVersion: string;
-  entries: ReportEntry[];
-}
-
 // ─── Paths ────────────────────────────────────────────────────────────────────
-
-export function reportsDir(basePath: string): string {
-  return join(gsdRoot(basePath), 'reports');
+export function reportsDir(basePath) {
+    return join(gsdRoot(basePath), 'reports');
 }
-
-function reportsIndexPath(basePath: string): string {
-  return join(reportsDir(basePath), 'reports.json');
+function reportsIndexPath(basePath) {
+    return join(reportsDir(basePath), 'reports.json');
 }
-
-function reportsHtmlIndexPath(basePath: string): string {
-  return join(reportsDir(basePath), 'index.html');
+function reportsHtmlIndexPath(basePath) {
+    return join(reportsDir(basePath), 'index.html');
 }
-
 // ─── Registry ─────────────────────────────────────────────────────────────────
-
-export function loadReportsIndex(basePath: string): ReportsIndex | null {
-  const p = reportsIndexPath(basePath);
-  if (!existsSync(p)) return null;
-  try {
-    return JSON.parse(readFileSync(p, 'utf-8')) as ReportsIndex;
-  } catch {
-    return null;
-  }
-}
-
-function saveReportsIndex(basePath: string, index: ReportsIndex): void {
-  const dir = reportsDir(basePath);
-  mkdirSync(dir, { recursive: true });
-  writeFileSync(reportsIndexPath(basePath), JSON.stringify(index, null, 2) + '\n', 'utf-8');
+export function loadReportsIndex(basePath) {
+    const p = reportsIndexPath(basePath);
+    if (!existsSync(p))
+        return null;
+    try {
+        return JSON.parse(readFileSync(p, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
 }
-
-// ─── Write a report snapshot ──────────────────────────────────────────────────
-
-export interface WriteReportSnapshotArgs {
-  basePath: string;
-  html: string;
-  milestoneId: string | 'final';
-  milestoneTitle: string;
-  kind: 'milestone' | 'manual' | 'final';
-  projectName: string;
-  projectPath: string;
-  gsdVersion: string;
-  // metrics
-  totalCost: number;
-  totalTokens: number;
-  totalDuration: number;
-  doneSlices: number;
-  totalSlices: number;
-  doneMilestones: number;
-  totalMilestones: number;
-  phase: string;
+function saveReportsIndex(basePath, index) {
+    const dir = reportsDir(basePath);
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(reportsIndexPath(basePath), JSON.stringify(index, null, 2) + '\n', 'utf-8');
 }
-
 /**
  * Write a report snapshot to .gsd/reports/, update reports.json, regenerate index.html.
  * Returns the path of the written report file.
  */
-export function writeReportSnapshot(args: WriteReportSnapshotArgs): string {
-  const dir = reportsDir(args.basePath);
-  mkdirSync(dir, { recursive: true });
-
-  const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
-  const prefix = args.milestoneId === 'final' ? 'final' : args.milestoneId;
-  const filename = `${prefix}-${timestamp}.html`;
-  const filePath = join(dir, filename);
-
-  writeFileSync(filePath, args.html, 'utf-8');
-
-  // Load or init registry
-  const existing = loadReportsIndex(args.basePath);
-  const index: ReportsIndex = existing ?? {
-    version: 1,
-    projectName: args.projectName,
-    projectPath: args.projectPath,
-    gsdVersion: args.gsdVersion,
-    entries: [],
-  };
-
-  // Keep metadata fresh
-  index.projectName = args.projectName;
-  index.projectPath = args.projectPath;
-  index.gsdVersion = args.gsdVersion;
-
-  const label = args.milestoneId === 'final'
-    ? 'Final Report'
-    : `${args.milestoneId}: ${args.milestoneTitle}`;
-
-  const entry: ReportEntry = {
-    filename,
-    generatedAt: new Date().toISOString(),
-    milestoneId: args.milestoneId,
-    milestoneTitle: args.milestoneTitle,
-    label,
-    kind: args.kind,
-    totalCost: args.totalCost,
-    totalTokens: args.totalTokens,
-    totalDuration: args.totalDuration,
-    doneSlices: args.doneSlices,
-    totalSlices: args.totalSlices,
-    doneMilestones: args.doneMilestones,
-    totalMilestones: args.totalMilestones,
-    phase: args.phase,
-  };
-
-  index.entries.push(entry);
-  saveReportsIndex(args.basePath, index);
-  regenerateHtmlIndex(args.basePath, index);
-
-  return filePath;
+export function writeReportSnapshot(args) {
+    const dir = reportsDir(args.basePath);
+    mkdirSync(dir, { recursive: true });
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+    const prefix = args.milestoneId === 'final' ? 'final' : args.milestoneId;
+    const filename = `${prefix}-${timestamp}.html`;
+    const filePath = join(dir, filename);
+    writeFileSync(filePath, args.html, 'utf-8');
+    // Load or init registry
+    const existing = loadReportsIndex(args.basePath);
+    const index = existing ?? {
+        version: 1,
+        projectName: args.projectName,
+        projectPath: args.projectPath,
+        gsdVersion: args.gsdVersion,
+        entries: [],
+    };
+    // Keep metadata fresh
+    index.projectName = args.projectName;
+    index.projectPath = args.projectPath;
+    index.gsdVersion = args.gsdVersion;
+    const label = args.milestoneId === 'final'
+        ? 'Final Report'
+        : `${args.milestoneId}: ${args.milestoneTitle}`;
+    const entry = {
+        filename,
+        generatedAt: new Date().toISOString(),
+        milestoneId: args.milestoneId,
+        milestoneTitle: args.milestoneTitle,
+        label,
+        kind: args.kind,
+        totalCost: args.totalCost,
+        totalTokens: args.totalTokens,
+        totalDuration: args.totalDuration,
+        doneSlices: args.doneSlices,
+        totalSlices: args.totalSlices,
+        doneMilestones: args.doneMilestones,
+        totalMilestones: args.totalMilestones,
+        phase: args.phase,
+    };
+    index.entries.push(entry);
+    saveReportsIndex(args.basePath, index);
+    regenerateHtmlIndex(args.basePath, index);
+    return filePath;
 }
-
 // ─── HTML Index Generator ─────────────────────────────────────────────────────
-
-export function regenerateHtmlIndex(basePath: string, index: ReportsIndex): void {
-  const html = buildIndexHtml(index);
-  writeFileSync(reportsHtmlIndexPath(basePath), html, 'utf-8');
+export function regenerateHtmlIndex(basePath, index) {
+    const html = buildIndexHtml(index);
+    writeFileSync(reportsHtmlIndexPath(basePath), html, 'utf-8');
 }
-
-function buildIndexHtml(index: ReportsIndex): string {
-  const { projectName, projectPath, gsdVersion, entries } = index;
-  const generated = new Date().toISOString();
-
-  // Sort oldest → newest for the progression timeline
-  const sorted = [...entries].sort(
-    (a, b) => new Date(a.generatedAt).getTime() - new Date(b.generatedAt).getTime()
-  );
-
-  const latestEntry = sorted[sorted.length - 1];
-  const overallPct = latestEntry
-    ? (latestEntry.totalSlices > 0
-        ? Math.round((latestEntry.doneSlices / latestEntry.totalSlices) * 100)
-        : 0)
-    : 0;
-
-  // TOC: group by milestone
-  const milestoneGroups = new Map<string, ReportEntry[]>();
-  for (const e of sorted) {
-    const key = e.milestoneId;
-    const arr = milestoneGroups.get(key) ?? [];
-    arr.push(e);
-    milestoneGroups.set(key, arr);
-  }
-
-  const tocHtml = [...milestoneGroups.entries()].map(([mid, group]) => {
-    const links = group.map(e =>
-      `<li><a href="${esc(e.filename)}">${formatDateShort(e.generatedAt)}</a> <span class="toc-kind toc-${e.kind}">${e.kind}</span></li>`
-    ).join('');
-    return `
+function buildIndexHtml(index) {
+    const { projectName, projectPath, gsdVersion, entries } = index;
+    const generated = new Date().toISOString();
+    // Sort oldest → newest for the progression timeline
+    const sorted = [...entries].sort((a, b) => new Date(a.generatedAt).getTime() - new Date(b.generatedAt).getTime());
+    const latestEntry = sorted[sorted.length - 1];
+    const overallPct = latestEntry
+        ? (latestEntry.totalSlices > 0
+            ? Math.round((latestEntry.doneSlices / latestEntry.totalSlices) * 100)
+            : 0)
+        : 0;
+    // TOC: group by milestone
+    const milestoneGroups = new Map();
+    for (const e of sorted) {
+        const key = e.milestoneId;
+        const arr = milestoneGroups.get(key) ?? [];
+        arr.push(e);
+        milestoneGroups.set(key, arr);
+    }
+    const tocHtml = [...milestoneGroups.entries()].map(([mid, group]) => {
+        const links = group.map(e => `<li><a href="${esc(e.filename)}">${formatDateShort(e.generatedAt)}</a> <span class="toc-kind toc-${e.kind}">${e.kind}</span></li>`).join('');
+        return `
       <div class="toc-group">
         <div class="toc-group-label">${esc(mid === 'final' ? 'Final' : mid)}</div>
         <ul>${links}</ul>
       </div>`;
-  }).join('');
-
-  // Progression cards
-  const cardHtml = sorted.map((e, i) => {
-    const pct = e.totalSlices > 0 ? Math.round((e.doneSlices / e.totalSlices) * 100) : 0;
-    const isLatest = i === sorted.length - 1;
-
-    // Delta vs previous
-    let deltaHtml = '';
-    if (i > 0) {
-      const prev = sorted[i - 1];
-      const dCost = e.totalCost - prev.totalCost;
-      const dSlices = e.doneSlices - prev.doneSlices;
-      const dMillestones = e.doneMilestones - prev.doneMilestones;
-      const parts: string[] = [];
-      if (dCost > 0) parts.push(`+${formatCost(dCost)}`);
-      if (dSlices > 0) parts.push(`+${dSlices} slice${dSlices !== 1 ? 's' : ''}`);
-      if (dMillestones > 0) parts.push(`+${dMillestones} milestone${dMillestones !== 1 ? 's' : ''}`);
-      if (parts.length > 0) {
-        deltaHtml = `<div class="card-delta">${parts.map(p => `<span>${esc(p)}</span>`).join('')}</div>`;
-      }
-    }
-
-    return `
+    }).join('');
+    // Progression cards
+    const cardHtml = sorted.map((e, i) => {
+        const pct = e.totalSlices > 0 ? Math.round((e.doneSlices / e.totalSlices) * 100) : 0;
+        const isLatest = i === sorted.length - 1;
+        // Delta vs previous
+        let deltaHtml = '';
+        if (i > 0) {
+            const prev = sorted[i - 1];
+            const dCost = e.totalCost - prev.totalCost;
+            const dSlices = e.doneSlices - prev.doneSlices;
+            const dMillestones = e.doneMilestones - prev.doneMilestones;
+            const parts = [];
+            if (dCost > 0)
+                parts.push(`+${formatCost(dCost)}`);
+            if (dSlices > 0)
+                parts.push(`+${dSlices} slice${dSlices !== 1 ? 's' : ''}`);
+            if (dMillestones > 0)
+                parts.push(`+${dMillestones} milestone${dMillestones !== 1 ? 's' : ''}`);
+            if (parts.length > 0) {
+                deltaHtml = `<div class="card-delta">${parts.map(p => `<span>${esc(p)}</span>`).join('')}</div>`;
+            }
+        }
+        return `
       <a class="report-card${isLatest ? ' card-latest' : ''}" href="${esc(e.filename)}">
         <div class="card-top">
           <span class="card-label">${esc(e.label)}</span>
@@ -252,13 +170,11 @@ function buildIndexHtml(index: ReportsIndex): string {
         ${deltaHtml}
         ${isLatest ? '<div class="card-latest-badge">Latest</div>' : ''}
       </a>`;
-  }).join('');
-
-  // Cost progression mini-chart (inline SVG sparkline)
-  const sparklineSvg = sorted.length > 1 ? buildCostSparkline(sorted) : '';
-
-  // Summary of latest state
-  const summaryHtml = latestEntry ? `
+    }).join('');
+    // Cost progression mini-chart (inline SVG sparkline)
+    const sparklineSvg = sorted.length > 1 ? buildCostSparkline(sorted) : '';
+    // Summary of latest state
+    const summaryHtml = latestEntry ? `
     <div class="idx-summary">
       <div class="idx-stat"><span class="idx-val">${formatCost(latestEntry.totalCost)}</span><span class="idx-lbl">Total Cost</span></div>
       <div class="idx-stat"><span class="idx-val">${formatTokenCount(latestEntry.totalTokens)}</span><span class="idx-lbl">Total Tokens</span></div>
@@ -271,8 +187,7 @@ function buildIndexHtml(index: ReportsIndex): string {
       <div class="idx-bar-track"><div class="idx-bar-fill" style="width:${overallPct}%"></div></div>
       <span class="idx-pct">${overallPct}% complete</span>
     </div>` : '<p class="empty">No reports generated yet.</p>';
-
-  return `<!DOCTYPE html>
+    return `<!DOCTYPE html>
 <html lang="en">
 <head>
 <meta charset="UTF-8">
@@ -336,34 +251,28 @@ function buildIndexHtml(index: ReportsIndex): string {
 </body>
 </html>`;
 }
-
 // ─── Cost sparkline (inline SVG) ──────────────────────────────────────────────
-
-function buildCostSparkline(entries: ReportEntry[]): string {
-  const costs = entries.map(e => e.totalCost);
-  const maxCost = Math.max(...costs, 0.001);
-  const W = 600, H = 60, PAD = 12;
-  const xStep = entries.length > 1 ? (W - PAD * 2) / (entries.length - 1) : W - PAD * 2;
-
-  const points = costs.map((c, i) => {
-    const x = PAD + i * xStep;
-    const y = PAD + (1 - c / maxCost) * (H - PAD * 2);
-    return `${x.toFixed(1)},${y.toFixed(1)}`;
-  }).join(' ');
-
-  const dots = costs.map((c, i) => {
-    const x = PAD + i * xStep;
-    const y = PAD + (1 - c / maxCost) * (H - PAD * 2);
-    return `<circle cx="${x.toFixed(1)}" cy="${y.toFixed(1)}" r="3" class="spark-dot">
+function buildCostSparkline(entries) {
+    const costs = entries.map(e => e.totalCost);
+    const maxCost = Math.max(...costs, 0.001);
+    const W = 600, H = 60, PAD = 12;
+    const xStep = entries.length > 1 ? (W - PAD * 2) / (entries.length - 1) : W - PAD * 2;
+    const points = costs.map((c, i) => {
+        const x = PAD + i * xStep;
+        const y = PAD + (1 - c / maxCost) * (H - PAD * 2);
+        return `${x.toFixed(1)},${y.toFixed(1)}`;
+    }).join(' ');
+    const dots = costs.map((c, i) => {
+        const x = PAD + i * xStep;
+        const y = PAD + (1 - c / maxCost) * (H - PAD * 2);
+        return `<circle cx="${x.toFixed(1)}" cy="${y.toFixed(1)}" r="3" class="spark-dot">
       <title>${esc(entries[i].label)} — ${formatCost(c)}</title>
     </circle>`;
-  }).join('');
-
-  // Labels at start and end
-  const startLabel = formatCost(costs[0]);
-  const endLabel   = formatCost(costs[costs.length - 1]);
-
-  return `
+    }).join('');
+    // Labels at start and end
+    const startLabel = formatCost(costs[0]);
+    const endLabel = formatCost(costs[costs.length - 1]);
+    return `
     <div class="sparkline">
       <svg viewBox="0 0 ${W} ${H}" width="${W}" height="${H}" class="spark-svg">
         <polyline points="${esc(points)}" class="spark-line" fill="none"/>
@@ -373,23 +282,19 @@ function buildCostSparkline(entries: ReportEntry[]): string {
       </svg>
       <div class="spark-axis">
         ${entries.map((e, i) => {
-          const x = (PAD + i * xStep) / W * 100;
-          return `<span class="spark-tick" style="left:${x.toFixed(1)}%" title="${esc(e.generatedAt)}">${esc(e.milestoneId === 'final' ? 'final' : e.milestoneId)}</span>`;
-        }).join('')}
+        const x = (PAD + i * xStep) / W * 100;
+        return `<span class="spark-tick" style="left:${x.toFixed(1)}%" title="${esc(e.generatedAt)}">${esc(e.milestoneId === 'final' ? 'final' : e.milestoneId)}</span>`;
+    }).join('')}
       </div>
     </div>`;
 }
-
 // ─── Helpers ──────────────────────────────────────────────────────────────────
-
-
-function esc(s: string | number | undefined | null): string {
-  if (s == null) return '';
-  return String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#39;');
+function esc(s) {
+    if (s == null)
+        return '';
+    return String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#39;');
 }
-
 // ─── Index CSS ────────────────────────────────────────────────────────────────
-
 const INDEX_CSS = `
 *,*::before,*::after{box-sizing:border-box;margin:0;padding:0}
 :root{