gsd-pi 2.33.1-dev.29a8268 → 2.33.1-dev.c0b2610

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{

package/dist/resources/extensions/gsd/{resource-version.ts → resource-version.js}

@@ -4,47 +4,42 @@
  * Staleness detection for managed GSD resources and utilities
  * for escaping stale worktree cwd after milestone teardown.
  */
-
 import { existsSync, readdirSync, unlinkSync } from "node:fs";
 import { loadJsonFileOrNull } from "./json-persistence.js";
 import { join } from "node:path";
 import { homedir } from "node:os";
 import { resolveProjectRoot } from "./worktree.js";
-
 // ─── Resource Staleness ───────────────────────────────────────────────────
-
 /**
  * Read the resource version (semver) from the managed-resources manifest.
  * Uses gsdVersion instead of syncedAt so that launching a second session
  * doesn't falsely trigger staleness (#804).
  */
-function isManifestWithVersion(data: unknown): data is { gsdVersion: string } {
-  return data !== null && typeof data === "object" && "gsdVersion" in data! && typeof (data as Record<string, unknown>).gsdVersion === "string";
+function isManifestWithVersion(data) {
+    return data !== null && typeof data === "object" && "gsdVersion" in data && typeof data.gsdVersion === "string";
 }
-
-export function readResourceVersion(): string | null {
-  const agentDir = process.env.GSD_CODING_AGENT_DIR || join(homedir(), ".gsd", "agent");
-  const manifestPath = join(agentDir, "managed-resources.json");
-  const manifest = loadJsonFileOrNull(manifestPath, isManifestWithVersion);
-  return manifest?.gsdVersion ?? null;
+export function readResourceVersion() {
+    const agentDir = process.env.GSD_CODING_AGENT_DIR || join(homedir(), ".gsd", "agent");
+    const manifestPath = join(agentDir, "managed-resources.json");
+    const manifest = loadJsonFileOrNull(manifestPath, isManifestWithVersion);
+    return manifest?.gsdVersion ?? null;
 }
-
 /**
  * Check if managed resources have been updated since session start.
  * Returns a warning message if stale, null otherwise.
  */
-export function checkResourcesStale(versionOnStart: string | null): string | null {
-  if (versionOnStart === null) return null;
-  const current = readResourceVersion();
-  if (current === null) return null;
-  if (current !== versionOnStart) {
-    return "GSD resources were updated since this session started. Restart gsd to load the new code.";
-  }
-  return null;
+export function checkResourcesStale(versionOnStart) {
+    if (versionOnStart === null)
+        return null;
+    const current = readResourceVersion();
+    if (current === null)
+        return null;
+    if (current !== versionOnStart) {
+        return "GSD resources were updated since this session started. Restart gsd to load the new code.";
+    }
+    return null;
 }
-
 // ─── Stale Worktree Escape ────────────────────────────────────────────────
-
 /**
  * Detect and escape a stale worktree cwd (#608).
  *
@@ -56,17 +51,18 @@ export function checkResourcesStale(versionOnStart: string | null): string | nul
  *
  * Returns the corrected base path.
  */
-export function escapeStaleWorktree(base: string): string {
-  const projectRoot = resolveProjectRoot(base);
-  if (projectRoot === base) return base;
-  try {
-    process.chdir(projectRoot);
-  } catch {
-    return base;
-  }
-  return projectRoot;
+export function escapeStaleWorktree(base) {
+    const projectRoot = resolveProjectRoot(base);
+    if (projectRoot === base)
+        return base;
+    try {
+        process.chdir(projectRoot);
+    }
+    catch {
+        return base;
+    }
+    return projectRoot;
 }
-
 /**
  * Clean stale runtime unit files for completed milestones.
  *
@@ -74,26 +70,27 @@ export function escapeStaleWorktree(base: string): string {
  * cause deriveState to resume the wrong milestone (#887). Removes files
  * for milestones that have a SUMMARY (fully complete).
  */
-export function cleanStaleRuntimeUnits(
-  gsdRootPath: string,
-  hasMilestoneSummary: (mid: string) => boolean,
-): number {
-  const runtimeUnitsDir = join(gsdRootPath, "runtime", "units");
-  if (!existsSync(runtimeUnitsDir)) return 0;
-
-  let cleaned = 0;
-  try {
-    for (const file of readdirSync(runtimeUnitsDir)) {
-      if (!file.endsWith(".json")) continue;
-      const midMatch = file.match(/(M\d+(?:-[a-z0-9]{6})?)/);
-      if (!midMatch) continue;
-      if (hasMilestoneSummary(midMatch[1])) {
-        try {
-          unlinkSync(join(runtimeUnitsDir, file));
-          cleaned++;
-        } catch { /* non-fatal */ }
-      }
+export function cleanStaleRuntimeUnits(gsdRootPath, hasMilestoneSummary) {
+    const runtimeUnitsDir = join(gsdRootPath, "runtime", "units");
+    if (!existsSync(runtimeUnitsDir))
+        return 0;
+    let cleaned = 0;
+    try {
+        for (const file of readdirSync(runtimeUnitsDir)) {
+            if (!file.endsWith(".json"))
+                continue;
+            const midMatch = file.match(/(M\d+(?:-[a-z0-9]{6})?)/);
+            if (!midMatch)
+                continue;
+            if (hasMilestoneSummary(midMatch[1])) {
+                try {
+                    unlinkSync(join(runtimeUnitsDir, file));
+                    cleaned++;
+                }
+                catch { /* non-fatal */ }
+            }
+        }
     }
-  } catch { /* non-fatal */ }
-  return cleaned;
+    catch { /* non-fatal */ }
+    return cleaned;
 }