@zigrivers/scaffold 3.18.1 → 3.20.0

package/dist/dashboard/template.js

@@ -828,4 +828,404 @@ body.modal-open { overflow: hidden; }
 </html>`;
 }
 /* eslint-enable max-len */
+/* eslint-disable max-len */
+export function buildMultiServiceTemplate(dataJson, data) {
+    const generatedAt = new Date(data.generatedAt);
+    const ageMs = Date.now() - generatedAt.getTime();
+    const staleNotice = ageMs > 3600000
+        ? '<div id="stale-notice" class="stale-notice">&#9888; Data may be stale (generated more than 1 hour ago)</div>'
+        : '';
+    const methodology = escapeHtml(data.methodology);
+    const avgPct = data.aggregate.averagePercentage;
+    const serviceCards = data.services.map(svc => {
+        const name = escapeHtml(svc.name);
+        const projectType = escapeHtml(svc.projectType);
+        const pct = svc.percentage;
+        // "Complete" badge requires pipeline steps to have existed AND all to be done.
+        // total=0 (skeleton for missing state.json) renders "Not started" instead.
+        const isNotStarted = svc.total === 0;
+        const isComplete = !isNotStarted && svc.currentPhaseNumber === null;
+        const phaseLine = isComplete
+            ? '<span class="service-complete-badge">Complete</span>'
+            : isNotStarted
+                ? '<span class="service-not-started-badge">Not started</span>'
+                : `<span class="service-phase">Phase ${svc.currentPhaseNumber ?? ''}: ${escapeHtml(svc.currentPhaseName ?? '')}</span>`;
+        const nextLine = svc.nextEligibleSlug
+            ? `<div class="service-next"><span class="service-next-label">Next:</span> <span class="service-next-slug">${escapeHtml(svc.nextEligibleSlug)}</span>${svc.nextEligibleSummary ? ` <span class="service-next-summary">${escapeHtml(svc.nextEligibleSummary)}</span>` : ''}</div>`
+            : '';
+        // Command copy uses data-copy attribute + JS event listener (see script below).
+        // Avoids inline onclick XSS vectors where attacker-controlled svc.name could
+        // escape the single-quoted JS string (Codex MMR P1 — v3.20.0 PR #292).
+        const cmdRaw = `scaffold dashboard --service ${svc.name}`;
+        const cmdAttr = escapeHtml(cmdRaw);
+        return [
+            `<div class="service-card" data-service="${name}" data-copy="${cmdAttr}">`,
+            '  <div class="service-card-head">',
+            `    <div class="service-name">${name}</div>`,
+            `    <span class="service-type-pill">${projectType}</span>`,
+            '  </div>',
+            '  <div class="service-progress-row">',
+            `    <div class="service-progress-bar"><div class="service-progress-fill" style="width:${pct}%"></div></div>`,
+            `    <span class="service-pct">${pct}%</span>`,
+            '  </div>',
+            '  <div class="service-counts">',
+            `    <span class="count-pill count-completed">${svc.completed} done</span>`,
+            svc.skipped > 0 ? `    <span class="count-pill count-skipped">${svc.skipped} skipped</span>` : '',
+            svc.inProgress > 0 ? `    <span class="count-pill count-in-progress">${svc.inProgress} active</span>` : '',
+            svc.pending > 0 ? `    <span class="count-pill count-pending">${svc.pending} pending</span>` : '',
+            '  </div>',
+            `  <div class="service-phase-line">${phaseLine}</div>`,
+            nextLine,
+            `  <div class="service-cmd-hint"><code>${escapeHtml(cmdRaw)}</code><span class="service-cmd-copy">Click to copy</span></div>`,
+            '</div>',
+        ].filter(Boolean).join('\n');
+    }).join('\n');
+    const servicesByPhase = data.aggregate.servicesByPhase
+        .filter(p => p.reachedCount > 0)
+        .map(p => [
+        '<div class="phase-indicator">',
+        `  <div class="phase-indicator-num">P${p.phaseNumber}</div>`,
+        `  <div class="phase-indicator-name">${escapeHtml(p.phaseName)}</div>`,
+        `  <div class="phase-indicator-count">${p.reachedCount} / ${data.aggregate.totalServices}</div>`,
+        '</div>',
+    ].join('\n')).join('\n');
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Scaffold Multi-Service Dashboard</title>
+<script id="scaffold-data" type="application/json">
+${dataJson}
+</script>
+<style>
+[data-theme="dark"] {
+  --bg: #0f172a;
+  --card-bg: #1e293b;
+  --border: #334155;
+  --text: #e2e8f0;
+  --muted: #94a3b8;
+  --faint: #64748b;
+  --status-completed: #4ade80;
+  --status-skipped: #818cf8;
+  --status-in-progress: #fbbf24;
+  --status-pending: #64748b;
+  --accent: #6366f1;
+  --accent-light: #818cf8;
+  --stale-bg: #451a03;
+  --stale-text: #fef3c7;
+}
+[data-theme="light"] {
+  --bg: #f8fafc;
+  --card-bg: #ffffff;
+  --border: #e2e8f0;
+  --text: #1e293b;
+  --muted: #64748b;
+  --faint: #94a3b8;
+  --status-completed: #4ade80;
+  --status-skipped: #818cf8;
+  --status-in-progress: #fbbf24;
+  --status-pending: #64748b;
+  --accent: #6366f1;
+  --accent-light: #818cf8;
+  --stale-bg: #fef3c7;
+  --stale-text: #92400e;
+}
+*, *::before, *::after { box-sizing: border-box; }
+body {
+  font-family: system-ui, -apple-system, sans-serif;
+  background: var(--bg);
+  color: var(--text);
+  margin: 0;
+  padding: 24px;
+  line-height: 1.5;
+}
+.container { max-width: 1120px; margin: 0 auto; }
+.header {
+  display: flex;
+  justify-content: space-between;
+  align-items: flex-start;
+  margin-bottom: 24px;
+  flex-wrap: wrap;
+  gap: 12px;
+}
+.header h1 { margin: 0 0 4px; font-size: 1.5rem; }
+.header-meta { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
+.methodology-badge {
+  background: var(--accent);
+  color: #fff;
+  padding: 2px 10px;
+  border-radius: 12px;
+  font-size: 0.8rem;
+  font-weight: 600;
+  text-transform: uppercase;
+}
+.pct-label { color: var(--muted); font-size: 0.9rem; }
+.theme-toggle {
+  cursor: pointer;
+  background: var(--card-bg);
+  border: 1px solid var(--border);
+  padding: 6px 14px;
+  border-radius: 6px;
+  color: var(--text);
+  font-size: 0.85rem;
+}
+.theme-toggle:hover { border-color: var(--accent); }
+.stale-notice {
+  background: var(--stale-bg);
+  color: var(--stale-text);
+  padding: 10px 16px;
+  border-radius: 6px;
+  margin-bottom: 16px;
+  font-size: 0.9rem;
+}
+.aggregate-block {
+  background: var(--card-bg);
+  border: 1px solid var(--border);
+  border-radius: 10px;
+  padding: 20px 24px;
+  margin-bottom: 28px;
+}
+.aggregate-row {
+  display: flex;
+  align-items: center;
+  gap: 16px;
+  margin-bottom: 14px;
+  flex-wrap: wrap;
+}
+.aggregate-progress-bar {
+  flex: 1;
+  min-width: 200px;
+  height: 10px;
+  background: var(--border);
+  border-radius: 5px;
+  overflow: hidden;
+}
+.aggregate-progress-fill {
+  height: 100%;
+  background: var(--status-completed);
+}
+.aggregate-pct { font-size: 1.1rem; font-weight: 700; min-width: 48px; text-align: right; }
+.aggregate-stat { color: var(--muted); font-size: 0.9rem; }
+.aggregate-stat strong { color: var(--text); font-weight: 700; }
+.phase-indicators {
+  display: flex;
+  gap: 10px;
+  flex-wrap: wrap;
+  padding-top: 8px;
+  border-top: 1px solid var(--border);
+  margin-top: 8px;
+}
+.phase-indicator {
+  background: var(--bg);
+  border: 1px solid var(--border);
+  border-radius: 6px;
+  padding: 6px 10px;
+  min-width: 90px;
+}
+.phase-indicator-num { font-size: 0.7rem; color: var(--faint); font-weight: 700; }
+.phase-indicator-name { font-size: 0.8rem; font-weight: 600; }
+.phase-indicator-count { font-size: 0.75rem; color: var(--muted); }
+.services-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(320px, 1fr));
+  gap: 16px;
+}
+.service-card {
+  background: var(--card-bg);
+  border: 1px solid var(--border);
+  border-radius: 10px;
+  padding: 16px 18px;
+  cursor: pointer;
+  transition: border-color 0.15s, transform 0.1s;
+}
+.service-card:hover { border-color: var(--accent); transform: translateY(-1px); }
+.service-card-head {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  gap: 8px;
+  margin-bottom: 10px;
+}
+.service-name { font-size: 1.1rem; font-weight: 700; }
+.service-type-pill {
+  background: var(--border);
+  color: var(--muted);
+  padding: 2px 8px;
+  border-radius: 10px;
+  font-size: 0.7rem;
+  font-weight: 600;
+  text-transform: lowercase;
+}
+.service-progress-row { display: flex; align-items: center; gap: 10px; margin-bottom: 8px; }
+.service-progress-bar { flex: 1; height: 8px; background: var(--border); border-radius: 4px; overflow: hidden; }
+.service-progress-fill { height: 100%; background: var(--status-completed); }
+.service-pct { font-size: 0.85rem; font-weight: 600; min-width: 42px; text-align: right; }
+.service-counts { display: flex; gap: 6px; flex-wrap: wrap; margin-bottom: 10px; }
+.count-pill {
+  font-size: 0.7rem;
+  padding: 2px 8px;
+  border-radius: 10px;
+  font-weight: 600;
+}
+.count-completed { background: var(--status-completed); color: #064e3b; }
+.count-skipped { background: var(--status-skipped); color: #1e1b4b; }
+.count-in-progress { background: var(--status-in-progress); color: #451a03; }
+.count-pending { background: var(--border); color: var(--muted); }
+.service-phase-line { font-size: 0.85rem; color: var(--muted); margin-bottom: 6px; }
+.service-phase { color: var(--text); font-weight: 500; }
+.service-complete-badge {
+  background: var(--status-completed);
+  color: #064e3b;
+  padding: 2px 10px;
+  border-radius: 10px;
+  font-size: 0.75rem;
+  font-weight: 700;
+  text-transform: uppercase;
+}
+.service-not-started-badge {
+  background: var(--border);
+  color: var(--muted);
+  padding: 2px 10px;
+  border-radius: 10px;
+  font-size: 0.75rem;
+  font-weight: 700;
+  text-transform: uppercase;
+}
+.service-next { font-size: 0.8rem; color: var(--muted); margin-bottom: 10px; }
+.service-next-label { color: var(--faint); text-transform: uppercase; font-size: 0.7rem; font-weight: 600; letter-spacing: 0.04em; }
+.service-next-slug { color: var(--accent-light); font-weight: 600; }
+.service-next-summary { color: var(--muted); }
+.service-cmd-hint {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  gap: 8px;
+  padding: 8px 10px;
+  background: var(--bg);
+  border: 1px solid var(--border);
+  border-radius: 6px;
+  font-size: 0.75rem;
+}
+.service-cmd-hint code { color: var(--text); }
+.service-cmd-copy { color: var(--faint); }
+.service-card.copied { border-color: var(--status-completed); }
+.service-card.copied .service-cmd-copy { color: var(--status-completed); font-weight: 600; }
+.footer {
+  margin-top: 40px;
+  padding-top: 16px;
+  border-top: 1px solid var(--border);
+  color: var(--faint);
+  font-size: 0.75rem;
+  display: flex;
+  justify-content: space-between;
+  flex-wrap: wrap;
+  gap: 8px;
+}
+@media (max-width: 480px) {
+  body { padding: 16px; }
+  .header { flex-direction: column; }
+  .services-grid { grid-template-columns: 1fr; }
+}
+</style>
+</head>
+<body>
+<script>
+  var stored = localStorage.getItem('scaffold-theme');
+  var prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+  var theme = stored || (prefersDark ? 'dark' : 'light');
+  document.documentElement.setAttribute('data-theme', theme);
+</script>
+<div class="container">
+  <div class="header">
+    <div>
+      <h1>Multi-Service Pipeline</h1>
+      <div class="header-meta">
+        <span class="methodology-badge">${methodology}</span>
+        <span class="pct-label">${avgPct}% average</span>
+      </div>
+    </div>
+    <button class="theme-toggle" onclick="toggleTheme()">Toggle theme</button>
+  </div>
+  ${staleNotice}
+  <div class="aggregate-block">
+    <div class="aggregate-row">
+      <div class="aggregate-progress-bar"><div class="aggregate-progress-fill" style="width:${avgPct}%"></div></div>
+      <span class="aggregate-pct">${avgPct}%</span>
+    </div>
+    <div class="aggregate-stat"><strong>${data.aggregate.servicesComplete}</strong> of <strong>${data.aggregate.totalServices}</strong> services complete</div>
+    ${servicesByPhase ? `<div class="phase-indicators">${servicesByPhase}</div>` : ''}
+  </div>
+  <div class="services-grid">
+${serviceCards}
+  </div>
+  <div class="footer">
+    <span>Generated ${escapeHtml(data.generatedAt)}</span>
+    <span>Scaffold v${escapeHtml(data.scaffoldVersion)}</span>
+  </div>
+</div>
+<script>
+(function() {
+  function toggleTheme() {
+    var current = document.documentElement.getAttribute('data-theme');
+    var next = current === 'dark' ? 'light' : 'dark';
+    document.documentElement.setAttribute('data-theme', next);
+    localStorage.setItem('scaffold-theme', next);
+  }
+  window.toggleTheme = toggleTheme;
+
+  function copyCommand(text, card) {
+    if (navigator.clipboard && navigator.clipboard.writeText) {
+      navigator.clipboard.writeText(text).then(function() {
+        if (card) {
+          card.classList.add('copied');
+          var label = card.querySelector('.service-cmd-copy');
+          if (label) {
+            var orig = label.textContent;
+            label.textContent = 'Copied!';
+            setTimeout(function() {
+              label.textContent = orig;
+              card.classList.remove('copied');
+            }, 1500);
+          }
+        }
+      });
+    }
+  }
+  window.copyCommand = copyCommand;
+
+  // Wire up service-card clicks via data-copy (no inline onclick — XSS-safe).
+  var cards = document.querySelectorAll('.service-card[data-copy]');
+  for (var i = 0; i < cards.length; i++) {
+    (function(card) {
+      var cmd = card.getAttribute('data-copy') || '';
+      card.addEventListener('click', function() { copyCommand(cmd, card); });
+    })(cards[i]);
+  }
+
+  (function() {
+    var dataEl = document.getElementById('scaffold-data');
+    if (!dataEl) return;
+    var data = JSON.parse(dataEl.textContent || '{}');
+    if (data.generatedAt) {
+      var age = Date.now() - new Date(data.generatedAt).getTime();
+      if (age > 3600000) {
+        var existing = document.getElementById('stale-notice');
+        if (!existing) {
+          var notice = document.createElement('div');
+          notice.id = 'stale-notice';
+          notice.className = 'stale-notice';
+          notice.textContent = '\u26A0 Data may be stale (generated more than 1 hour ago)';
+          var container = document.querySelector('.container');
+          if (container) container.insertBefore(notice, container.children[1]);
+        }
+      }
+    }
+  })();
+})();
+</script>
+</body>
+</html>`;
+}
+/* eslint-enable max-len */
 //# sourceMappingURL=template.js.map

package/dist/dashboard/template.js.map

@@ -1 +1 @@
-{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/dashboard/template.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/dashboard/template.ts"],"names":[],"mappings":"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"}

package/dist/e2e/eligible-cache.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=eligible-cache.test.d.ts.map

package/dist/e2e/eligible-cache.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eligible-cache.test.d.ts","sourceRoot":"","sources":["../../src/e2e/eligible-cache.test.ts"],"names":[],"mappings":""}

package/dist/e2e/eligible-cache.test.js

@@ -0,0 +1,104 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { loadPipelineContext } from '../core/pipeline/context.js';
+import { resolvePipeline } from '../core/pipeline/resolver.js';
+import { StateManager } from '../state/state-manager.js';
+import { StatePathResolver } from '../state/state-path-resolver.js';
+import { readEligible } from '../core/pipeline/read-eligible.js';
+import { readRootSaveCounter } from '../state/root-counter-reader.js';
+import { createOutputContext } from '../cli/output/context.js';
+describe('Eligible-Step Cache v2 — E2E', () => {
+    let tmpRoot;
+    beforeEach(() => {
+        tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'ec2-e2e-'));
+        fs.mkdirSync(path.join(tmpRoot, '.scaffold', 'services', 'api'), { recursive: true });
+        fs.writeFileSync(path.join(tmpRoot, '.scaffold', 'config.yml'), `version: 2
+methodology: deep
+platforms: [claude-code]
+project:
+  services:
+    - name: api
+      projectType: backend
+      backendConfig:
+        apiStyle: rest
+`);
+        const baseState = {
+            'schema-version': 3,
+            'scaffold-version': '1.0.0',
+            init_methodology: 'deep',
+            config_methodology: 'deep',
+            'init-mode': 'greenfield',
+            created: '2026-04-20T00:00:00.000Z',
+            in_progress: null,
+            steps: {},
+            next_eligible: [],
+            'extra-steps': [],
+        };
+        fs.writeFileSync(path.join(tmpRoot, '.scaffold', 'state.json'), JSON.stringify(baseState));
+        fs.writeFileSync(path.join(tmpRoot, '.scaffold', 'services', 'api', 'state.json'), JSON.stringify(baseState));
+    });
+    afterEach(() => {
+        fs.rmSync(tmpRoot, { recursive: true, force: true });
+    });
+    it('AC2: service cache is invalidated by root state mutation (cross-file)', () => {
+        const context = loadPipelineContext(tmpRoot);
+        const output = createOutputContext('auto');
+        const rootPipeline = resolvePipeline(context, { output });
+        const rootPathResolver = new StatePathResolver(tmpRoot);
+        const rootSm = new StateManager(tmpRoot, rootPipeline.computeEligible, () => context.config ?? undefined, rootPathResolver, rootPipeline.globalSteps, rootPipeline.getPipelineHash('global'));
+        // Seed root counter by doing an initial root save
+        rootSm.saveState(rootSm.loadState());
+        const svcPipeline = resolvePipeline(context, { output, serviceId: 'api' });
+        const pathResolver = new StatePathResolver(tmpRoot, 'api');
+        const sm = new StateManager(tmpRoot, svcPipeline.computeEligible, () => context.config ?? undefined, pathResolver, svcPipeline.globalSteps, svcPipeline.getPipelineHash('service'));
+        const state = sm.loadState();
+        state.steps['some-step'] = { status: 'pending', source: 'pipeline', produces: [] };
+        sm.saveState(state);
+        const svcDisk = JSON.parse(fs.readFileSync(path.join(tmpRoot, '.scaffold', 'services', 'api', 'state.json'), 'utf8'));
+        expect(svcDisk.next_eligible_root_counter).toBe(1);
+        expect(typeof svcDisk.next_eligible_hash).toBe('string');
+        // Mutate root — bumps save_counter from 1 to 2
+        rootSm.saveState(rootSm.loadState());
+        expect(readRootSaveCounter(tmpRoot)).toBe(2);
+        // readEligible must fall back because next_eligible_root_counter (1) !== current root counter (2)
+        const liveCalls = [];
+        const sentinelPipeline = {
+            ...svcPipeline,
+            computeEligible: ((steps, opts) => {
+                liveCalls.push('live-recompute-fired');
+                return svcPipeline.computeEligible(steps, opts);
+            }),
+        };
+        readEligible(sm.loadState(), sentinelPipeline, { scope: 'service', globalSteps: svcPipeline.globalSteps }, () => readRootSaveCounter(tmpRoot));
+        expect(liveCalls).toContain('live-recompute-fired');
+    });
+    it('AC3: pipeline-graph change (different hash on re-resolution) invalidates cache on read', () => {
+        const context = loadPipelineContext(tmpRoot);
+        const output = createOutputContext('auto');
+        const pipelineA = resolvePipeline(context, { output });
+        const pathResolver = new StatePathResolver(tmpRoot);
+        const sm = new StateManager(tmpRoot, pipelineA.computeEligible, () => context.config ?? undefined, pathResolver, pipelineA.globalSteps, pipelineA.getPipelineHash('global'));
+        sm.saveState(sm.loadState());
+        // Build a new context whose metaPrompts differs — delete first slug
+        const firstSlug = [...context.metaPrompts.keys()][0];
+        expect(firstSlug).toBeDefined();
+        const mutatedMetaPrompts = new Map(context.metaPrompts);
+        mutatedMetaPrompts.delete(firstSlug);
+        const mutatedContext = { ...context, metaPrompts: mutatedMetaPrompts };
+        const pipelineB = resolvePipeline(mutatedContext, { output });
+        expect(pipelineB.getPipelineHash('global')).not.toBe(pipelineA.getPipelineHash('global'));
+        const liveCalls = [];
+        const sentinelPipeline = {
+            ...pipelineB,
+            computeEligible: ((steps, opts) => {
+                liveCalls.push('live-fired');
+                return pipelineB.computeEligible(steps, opts);
+            }),
+        };
+        readEligible(sm.loadState(), sentinelPipeline, undefined, undefined);
+        expect(liveCalls).toContain('live-fired');
+    });
+});
+//# sourceMappingURL=eligible-cache.test.js.map

package/dist/e2e/eligible-cache.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eligible-cache.test.js","sourceRoot":"","sources":["../../src/e2e/eligible-cache.test.ts"],"names":[],"mappings":"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"}

package/dist/state/root-counter-reader.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Reads `.scaffold/state.json` and returns the `save_counter` field.
+ * Returns null on any failure (missing file, invalid JSON, missing field).
+ *
+ * Used by service-scope cache readers (readEligible) to verify that the
+ * service's cached next_eligible was written against the current root state
+ * (spec §6). Not used at cache WRITE time — StateManager captures the counter
+ * internally during loadState to avoid TOCTOU.
+ */
+export declare function readRootSaveCounter(projectRoot: string): number | null;
+//# sourceMappingURL=root-counter-reader.d.ts.map

package/dist/state/root-counter-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-counter-reader.d.ts","sourceRoot":"","sources":["../../src/state/root-counter-reader.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUtE"}

package/dist/state/root-counter-reader.js

@@ -0,0 +1,25 @@
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Reads `.scaffold/state.json` and returns the `save_counter` field.
+ * Returns null on any failure (missing file, invalid JSON, missing field).
+ *
+ * Used by service-scope cache readers (readEligible) to verify that the
+ * service's cached next_eligible was written against the current root state
+ * (spec §6). Not used at cache WRITE time — StateManager captures the counter
+ * internally during loadState to avoid TOCTOU.
+ */
+export function readRootSaveCounter(projectRoot) {
+    const rootStatePath = path.join(projectRoot, '.scaffold', 'state.json');
+    try {
+        if (!fs.existsSync(rootStatePath))
+            return null;
+        const raw = JSON.parse(fs.readFileSync(rootStatePath, 'utf8'));
+        const counter = raw['save_counter'];
+        return typeof counter === 'number' ? counter : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=root-counter-reader.js.map

package/dist/state/root-counter-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-counter-reader.js","sourceRoot":"","sources":["../../src/state/root-counter-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC,CAAA;IACvE,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC;YAAE,OAAO,IAAI,CAAA;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAA4B,CAAA;QACzF,MAAM,OAAO,GAAG,GAAG,CAAC,cAAc,CAAC,CAAA;QACnC,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC"}

package/dist/state/root-counter-reader.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=root-counter-reader.test.d.ts.map

package/dist/state/root-counter-reader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-counter-reader.test.d.ts","sourceRoot":"","sources":["../../src/state/root-counter-reader.test.ts"],"names":[],"mappings":""}

package/dist/state/root-counter-reader.test.js

@@ -0,0 +1,43 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { readRootSaveCounter } from './root-counter-reader.js';
+describe('readRootSaveCounter', () => {
+    let tmpRoot;
+    beforeEach(() => {
+        tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'rcr-'));
+        fs.mkdirSync(path.join(tmpRoot, '.scaffold'), { recursive: true });
+    });
+    afterEach(() => {
+        fs.rmSync(tmpRoot, { recursive: true, force: true });
+    });
+    it('returns null when root state file is missing', () => {
+        expect(readRootSaveCounter(tmpRoot)).toBeNull();
+    });
+    it('returns the counter when state file has a valid save_counter', () => {
+        fs.writeFileSync(path.join(tmpRoot, '.scaffold', 'state.json'), JSON.stringify({ save_counter: 42, 'schema-version': 3 }));
+        expect(readRootSaveCounter(tmpRoot)).toBe(42);
+    });
+    it('returns null when state file has invalid JSON', () => {
+        fs.writeFileSync(path.join(tmpRoot, '.scaffold', 'state.json'), '{ not valid json');
+        expect(readRootSaveCounter(tmpRoot)).toBeNull();
+    });
+    it('returns null when state file lacks save_counter (legacy file)', () => {
+        fs.writeFileSync(path.join(tmpRoot, '.scaffold', 'state.json'), JSON.stringify({ 'schema-version': 3 }));
+        expect(readRootSaveCounter(tmpRoot)).toBeNull();
+    });
+    it('returns null when save_counter is non-number (Codex + Gemini MMR coverage lock)', () => {
+        // Coverage lock: regression guard against a future change that forgets
+        // the typeof check and coerces with Number() or String().
+        fs.writeFileSync(path.join(tmpRoot, '.scaffold', 'state.json'), JSON.stringify({ save_counter: '42', 'schema-version': 3 }));
+        expect(readRootSaveCounter(tmpRoot)).toBeNull();
+    });
+    it('returns 0 (not null) when save_counter is the number zero', () => {
+        // Coverage lock: 0 is a valid counter value (truthy-confusing). A future
+        // refactor from `typeof === "number"` to `if (counter)` would regress.
+        fs.writeFileSync(path.join(tmpRoot, '.scaffold', 'state.json'), JSON.stringify({ save_counter: 0, 'schema-version': 3 }));
+        expect(readRootSaveCounter(tmpRoot)).toBe(0);
+    });
+});
+//# sourceMappingURL=root-counter-reader.test.js.map

package/dist/state/root-counter-reader.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-counter-reader.test.js","sourceRoot":"","sources":["../../src/state/root-counter-reader.test.ts"],"names":[],"mappings":"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"}