@zigrivers/scaffold 3.25.0 → 3.26.0

package/dist/observability/engine/abort-snapshot.test.js

@@ -0,0 +1,66 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { execFileSync } from 'node:child_process';
+import { mkdtempSync, rmSync, writeFileSync, readFileSync, existsSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { captureSnapshot, restoreSnapshot, recordStaged } from './abort-snapshot.js';
+function git(cwd, args) {
+    return execFileSync('git', args, { cwd, encoding: 'utf8' });
+}
+describe('abort-snapshot', () => {
+    let proj;
+    beforeEach(() => {
+        proj = mkdtempSync(join(tmpdir(), 'observe-abort-'));
+        git(proj, ['init', '-q']);
+        git(proj, ['config', 'user.email', 't@e.com']);
+        git(proj, ['config', 'user.name', 'T']);
+        writeFileSync(join(proj, 'a.txt'), 'original\n');
+        git(proj, ['add', 'a.txt']);
+        git(proj, ['commit', '-q', '-m', 'initial']);
+    });
+    afterEach(() => { rmSync(proj, { recursive: true, force: true }); });
+    it('captureSnapshot records a stash hash even when working tree is clean', () => {
+        const snap = captureSnapshot(proj);
+        expect(typeof snap.stash_sha).toBe('string');
+        expect(snap.staged_paths).toEqual(new Set());
+        expect(snap.cwd).toBe(proj);
+    });
+    it('restoreSnapshot un-stages only the paths recorded by recordStaged', () => {
+        const snap = captureSnapshot(proj);
+        // User had `b.txt` already staged before the fix flow
+        writeFileSync(join(proj, 'b.txt'), 'pre-existing-stage\n');
+        git(proj, ['add', 'b.txt']);
+        // Fix flow stages a NEW path
+        writeFileSync(join(proj, 'fixed.txt'), 'fix\n');
+        git(proj, ['add', 'fixed.txt']);
+        recordStaged(snap, ['fixed.txt']);
+        restoreSnapshot(snap);
+        // fixed.txt is unstaged + worktree-restored
+        expect(existsSync(join(proj, 'fixed.txt'))).toBe(false);
+        // b.txt remains staged (user's pre-existing work)
+        const status = git(proj, ['status', '--short']);
+        expect(status).toMatch(/^A {2}b\.txt/mu);
+    });
+    it('restoreSnapshot is idempotent', () => {
+        const snap = captureSnapshot(proj);
+        writeFileSync(join(proj, 'fixed.txt'), 'fix\n');
+        git(proj, ['add', 'fixed.txt']);
+        recordStaged(snap, ['fixed.txt']);
+        restoreSnapshot(snap);
+        restoreSnapshot(snap); // second call should not throw
+        expect(existsSync(join(proj, 'fixed.txt'))).toBe(false);
+    });
+    it('captureSnapshot includes WIP edits in stash so they can be re-applied', () => {
+        writeFileSync(join(proj, 'a.txt'), 'WIP modification\n');
+        const snap = captureSnapshot(proj);
+        expect(snap.stash_sha.length).toBeGreaterThan(0);
+        // Fix flow makes its own edit on top
+        writeFileSync(join(proj, 'a.txt'), 'fix-edit\n');
+        git(proj, ['add', 'a.txt']);
+        recordStaged(snap, ['a.txt']);
+        restoreSnapshot(snap);
+        // After restore, the WIP edit should be present (not the fix edit, not the original)
+        expect(readFileSync(join(proj, 'a.txt'), 'utf8')).toBe('WIP modification\n');
+    });
+});
+//# sourceMappingURL=abort-snapshot.test.js.map

package/dist/observability/engine/abort-snapshot.test.js.map

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

package/dist/observability/engine/api.d.ts

@@ -0,0 +1,24 @@
+import type { EngineOutput } from './types.js';
+export interface RunProgressInput {
+    primaryRoot: string;
+    sinceHours: number;
+    replay?: boolean;
+    noStallCheck?: boolean;
+    ghBin?: string;
+    bdBin?: string;
+    args?: Record<string, unknown>;
+}
+export interface RunAuditInput {
+    primaryRoot: string;
+    profile: 'fast' | 'full';
+    scope: 'docs' | 'code' | 'all';
+    sinceHours?: number;
+    lensIds?: string[];
+    fixThresholdOverride?: string;
+    ghBin?: string;
+    bdBin?: string;
+    args?: Record<string, unknown>;
+}
+export declare function runAudit(input: RunAuditInput): Promise<EngineOutput>;
+export declare function runProgress(input: RunProgressInput): Promise<EngineOutput>;
+//# sourceMappingURL=api.d.ts.map

package/dist/observability/engine/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/observability/engine/api.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAmD,MAAM,YAAY,CAAA;AAgB/F,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AA2BD,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAA;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAoBD,wBAAsB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAyD1E;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CA6FhF"}

package/dist/observability/engine/api.js

@@ -0,0 +1,203 @@
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { composeAvailability, readMergedLedger, composeSnapshot, composeReplay } from './synthesizer.js';
+import { evaluateStall } from './stall.js';
+import { buildDocGraph } from './doc-graph/index.js';
+import { runChecks } from './checks/runner.js';
+import { LENS_REGISTRY, makeLensImplementations } from './checks/registry.js';
+import { aggregate } from './checks/findings-aggregator.js';
+import { resolveFixThreshold } from './checks/fix-threshold.js';
+import { loadObservabilityConfig } from './checks/observability-config.js';
+import { gitAdapter } from '../adapters/git.js';
+import { ghAdapter } from '../adapters/gh.js';
+import { mmrAdapter } from '../adapters/mmr.js';
+import { stateAdapter } from '../adapters/state.js';
+import { testsAdapter } from '../adapters/tests.js';
+import { auditHistoryAdapter } from '../adapters/audit-history.js';
+const EMPTY_SUMMARY = {
+    total: 0,
+    by_severity: { P0: 0, P1: 0, P2: 0, P3: 0 },
+    by_severity_status: {
+        P0: { open: 0, acknowledged: 0, skipped: 0 },
+        P1: { open: 0, acknowledged: 0, skipped: 0 },
+        P2: { open: 0, acknowledged: 0, skipped: 0 },
+        P3: { open: 0, acknowledged: 0, skipped: 0 },
+    },
+    blocking: 0,
+    acknowledged: 0,
+    skipped_lenses: 0,
+};
+function scaffoldVersion() {
+    try {
+        const pkg = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), '../../../package.json'), 'utf8'));
+        return pkg.version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+const SCOPE_DOC_LENSES = new Set(['H-cross-doc']);
+const SCOPE_CODE_LENSES = new Set([
+    'A-tdd', 'B-ac-coverage', 'C-standards', 'D-stack', 'E-design', 'F-scope', 'G-decisions',
+]);
+function pickEnabledIds(scope, explicit) {
+    if (explicit && explicit.length > 0)
+        return new Set(explicit);
+    if (scope === 'docs')
+        return SCOPE_DOC_LENSES;
+    if (scope === 'code')
+        return SCOPE_CODE_LENSES;
+    return new Set([...SCOPE_DOC_LENSES, ...SCOPE_CODE_LENSES]);
+}
+function deriveVerdict(blocking, skippedLenses) {
+    if (blocking > 0)
+        return 'blocked';
+    if (skippedLenses > 0)
+        return 'degraded-pass';
+    return 'pass';
+}
+export async function runAudit(input) {
+    const started_at = new Date().toISOString();
+    const merged = await readMergedLedger(input.primaryRoot);
+    const availability = await composeAvailability(input.primaryRoot, { ghBin: input.ghBin, bdBin: input.bdBin });
+    availability.ledger = merged.summary;
+    const graph = await buildDocGraph(input.primaryRoot);
+    const enabledIds = pickEnabledIds(input.scope, input.lensIds);
+    const config = loadObservabilityConfig(input.primaryRoot);
+    for (const disabled of config.disabled_lenses)
+        enabledIds.delete(disabled);
+    const fix_threshold = resolveFixThreshold(input.primaryRoot, input.fixThresholdOverride);
+    const rawFindings = await runChecks({
+        registry: LENS_REGISTRY,
+        lenses: makeLensImplementations(input.primaryRoot),
+        graph,
+        ledger: { events: merged.events },
+        availability,
+        profile: input.profile,
+        cwd: input.primaryRoot,
+        enabledIds,
+    });
+    const { findings, summary } = aggregate(rawFindings, merged.events, fix_threshold);
+    const verdict = deriveVerdict(summary.blocking, summary.skipped_lenses);
+    return {
+        schema_version: '1.0',
+        invocation: {
+            command: 'audit',
+            args: input.args ?? {},
+            started_at,
+            completed_at: new Date().toISOString(),
+            scaffold_version: scaffoldVersion(),
+        },
+        availability,
+        snapshot: null,
+        replay: null,
+        findings,
+        needs_attention: [],
+        graph_stats: {
+            nodes_by_kind: {
+                feature: graph.features.length, story: graph.stories.length, ac: graph.acceptance_criteria.length,
+                plan_task: graph.plan_tasks.length, playbook_task: graph.playbook_tasks.length,
+                test: graph.tests.length, file: graph.files.length, decision: graph.decisions.length,
+            },
+            edges_by_kind: graph.edges.reduce((acc, e) => {
+                acc[e.kind] = (acc[e.kind] ?? 0) + 1;
+                return acc;
+            }, {}),
+            orphans_by_kind: {},
+            unsanctioned_uses: 0,
+            ad_hoc_token_uses: 0,
+        },
+        fix_threshold,
+        verdict,
+        summary,
+    };
+}
+export async function runProgress(input) {
+    const started_at = new Date().toISOString();
+    const merged = await readMergedLedger(input.primaryRoot);
+    const availability = await composeAvailability(input.primaryRoot, { ghBin: input.ghBin, bdBin: input.bdBin });
+    availability.ledger = merged.summary;
+    const snapshot = composeSnapshot({
+        events: merged.events,
+        sinceHours: input.sinceHours,
+        currentPhase: 'build',
+    });
+    // Stall detection needs a wider window than the display window; fetch once and filter in-memory.
+    const stallSinceHours = Math.max(input.sinceHours, 7 * 24);
+    const displayFrom = new Date(Date.now() - input.sinceHours * 3_600_000).toISOString();
+    // ---- Pre-fetch shared adapter events (git/gh/mmr) with the wider stall window ----
+    const needsAdapters = input.replay || !input.noStallCheck;
+    const [sharedGitEvents, sharedGhEvents, sharedMmrEvents] = needsAdapters
+        ? await Promise.all([
+            gitAdapter.replayEvents(input.primaryRoot, { sinceHours: stallSinceHours }),
+            ghAdapter.replayEvents(input.primaryRoot, { sinceHours: stallSinceHours, ghBin: input.ghBin }),
+            mmrAdapter.replayEvents(input.primaryRoot, { sinceHours: stallSinceHours }),
+        ])
+        : [[], [], []];
+    // ---- Replay ----
+    let replay = null;
+    if (input.replay) {
+        const [stateEvents, testsEvents] = await Promise.all([
+            stateAdapter.replayEvents(input.primaryRoot, { sinceHours: input.sinceHours }),
+            testsAdapter.replayEvents(input.primaryRoot, { sinceHours: input.sinceHours }),
+        ]);
+        // Filter shared events to the display window; state+tests are already scoped to sinceHours.
+        const adapterEvents = [
+            ...sharedGitEvents.filter((e) => e.ts >= displayFrom),
+            ...sharedGhEvents.filter((e) => e.ts >= displayFrom),
+            ...sharedMmrEvents.filter((e) => e.ts >= displayFrom),
+            ...stateEvents,
+            ...testsEvents,
+        ];
+        replay = composeReplay({
+            ledgerEvents: merged.events, adapterEvents, window: { from: displayFrom, to: started_at },
+        });
+    }
+    // ---- Stall ----
+    let needs_attention = [];
+    if (!input.noStallCheck) {
+        const config = loadObservabilityConfig(input.primaryRoot);
+        const [skippedStreaks, latestFindings] = await Promise.all([
+            auditHistoryAdapter.lensSkippedStreaks(input.primaryRoot),
+            auditHistoryAdapter.latestFindings(input.primaryRoot),
+        ]);
+        const adapterEventsForStall = [...sharedGitEvents, ...sharedGhEvents, ...sharedMmrEvents];
+        needs_attention = evaluateStall({
+            now: started_at,
+            ledgerEvents: merged.events,
+            replayEvents: adapterEventsForStall,
+            findings: latestFindings,
+            config,
+            lensSkippedStreaks: skippedStreaks,
+        });
+    }
+    const fix_threshold = 'P2';
+    const verdict = needs_attention.length > 0 ? 'degraded-pass' : 'pass';
+    return {
+        schema_version: '1.0',
+        invocation: {
+            command: 'progress',
+            args: input.args ?? {},
+            started_at,
+            completed_at: new Date().toISOString(),
+            scaffold_version: scaffoldVersion(),
+        },
+        availability,
+        snapshot,
+        replay,
+        findings: [],
+        needs_attention,
+        graph_stats: {
+            nodes_by_kind: {},
+            edges_by_kind: {},
+            orphans_by_kind: {},
+            unsanctioned_uses: 0,
+            ad_hoc_token_uses: 0,
+        },
+        fix_threshold,
+        verdict,
+        summary: EMPTY_SUMMARY,
+    };
+}
+//# sourceMappingURL=api.js.map

package/dist/observability/engine/api.js.map

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

package/dist/observability/engine/api.test.d.ts

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

package/dist/observability/engine/api.test.d.ts.map

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

package/dist/observability/engine/api.test.js

@@ -0,0 +1,174 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, rmSync, mkdirSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+import { runProgress, runAudit } from './api.js';
+import { ensureIdentity } from './identity.js';
+import { writeEvent } from './ledger-writer.js';
+import { harvestWorktree } from './harvester.js';
+describe('api.runProgress', () => {
+    let primary;
+    let wt;
+    beforeEach(async () => {
+        primary = mkdtempSync(join(tmpdir(), 'observe-api-pri-'));
+        wt = mkdtempSync(join(tmpdir(), 'observe-api-wt-'));
+        execSync('git init -q', { cwd: primary });
+        execSync('git config user.email t@e.com && git config user.name T', { cwd: primary, shell: '/bin/sh' });
+        ensureIdentity(wt, 'agent-alice');
+        await writeEvent(wt, { type: 'task_claimed', branch: 'a', task_id: 'T-1', payload: { task_title: 'A' } });
+        await harvestWorktree({ primaryRoot: primary, worktreeRoot: wt });
+    });
+    afterEach(() => {
+        rmSync(primary, { recursive: true, force: true });
+        rmSync(wt, { recursive: true, force: true });
+    });
+    it('produces an EngineOutput with availability + snapshot + ledger summary', async () => {
+        const out = await runProgress({
+            primaryRoot: primary,
+            sinceHours: 24,
+            ghBin: '/no/such/gh',
+            bdBin: '/no/such/bd',
+        });
+        expect(out.schema_version).toBe('1.0');
+        expect(out.invocation.command).toBe('progress');
+        expect(out.availability.git.status).toBe('available');
+        expect(out.availability.ledger.events_read).toBe(1);
+        expect(out.snapshot?.in_flight[0].task_id).toBe('T-1');
+        expect(out.findings).toEqual([]);
+        expect(out.summary.total).toBe(0);
+        expect(out.verdict).toBe('pass');
+        expect(out.fix_threshold).toBe('P2');
+    });
+});
+describe('api.runAudit', () => {
+    let project;
+    beforeEach(() => {
+        project = mkdtempSync(join(tmpdir(), 'observe-aud-'));
+        execSync('git init -q', { cwd: project });
+        execSync('git config user.email t@e.com && git config user.name T', { cwd: project, shell: '/bin/sh' });
+        mkdirSync(join(project, 'docs'), { recursive: true });
+        writeFileSync(join(project, 'package.json'), JSON.stringify({ scripts: { test: 'vitest run' } }));
+        writeFileSync(join(project, 'docs/plan.md'), '# PRD\n## Features\n### F [priority: must]\n');
+        writeFileSync(join(project, 'docs/user-stories.md'), '## Story s-1: T [priority: must]\n\n### AC 1: t\nGiven X.\n');
+        writeFileSync(join(project, 'docs/tdd-standards.md'), '# TDD\n');
+    });
+    afterEach(() => { rmSync(project, { recursive: true, force: true }); });
+    it('produces an audit EngineOutput with findings + verdict + summary', async () => {
+        const out = await runAudit({
+            primaryRoot: project, profile: 'fast', scope: 'all', sinceHours: 24, ghBin: '/no/such/gh', bdBin: '/no/such/bd',
+        });
+        expect(out.invocation.command).toBe('audit');
+        expect(out.findings.length).toBeGreaterThan(0);
+        expect(out.verdict).toBe('blocked');
+        expect(out.summary.total).toBe(out.findings.length);
+        expect(out.summary.blocking).toBeGreaterThan(0);
+    });
+    it('honors --lens to scope a single-lens run', async () => {
+        const out = await runAudit({
+            primaryRoot: project, profile: 'fast', scope: 'all', sinceHours: 24,
+            lensIds: ['H-cross-doc'], ghBin: '/no/such/gh', bdBin: '/no/such/bd',
+        });
+        expect(out.findings.every((f) => f.lens_id === 'H-cross-doc')).toBe(true);
+    });
+    it('respects --fix-threshold for verdict + summary.blocking', async () => {
+        const tight = await runAudit({
+            primaryRoot: project, profile: 'fast', scope: 'all', sinceHours: 24,
+            fixThresholdOverride: 'P0', ghBin: '/no/such/gh', bdBin: '/no/such/bd',
+        });
+        const lax = await runAudit({
+            primaryRoot: project, profile: 'fast', scope: 'all', sinceHours: 24,
+            fixThresholdOverride: 'P3', ghBin: '/no/such/gh', bdBin: '/no/such/bd',
+        });
+        expect(tight.summary.blocking).toBeLessThanOrEqual(lax.summary.blocking);
+    });
+});
+describe('api.runAudit (Plan 3 — eight lenses)', () => {
+    let project;
+    beforeEach(() => {
+        project = mkdtempSync(join(tmpdir(), 'observe-aud8-'));
+        execSync('git init -q', { cwd: project });
+        execSync('git config user.email t@e.com && git config user.name T', { cwd: project, shell: '/bin/sh' });
+        mkdirSync(join(project, 'docs'), { recursive: true });
+        mkdirSync(join(project, 'src/lib'), { recursive: true });
+        writeFileSync(join(project, 'package.json'), JSON.stringify({ scripts: { test: 'vitest run' } }));
+        writeFileSync(join(project, 'docs/plan.md'), '# PRD\n## Features\n### F [priority: must]\n');
+        writeFileSync(join(project, 'docs/user-stories.md'), '## Story s-1: T [priority: must]\n\n### AC 1: t\nGiven X.\n');
+        writeFileSync(join(project, 'docs/tech-stack.md'), '## Frontend\n\n### React\n\npackage_or_url: react@18\n');
+        writeFileSync(join(project, 'docs/coding-standards.md'), '### Rule: no-eval\n- forbidden: eval\n- match: src/**/*.ts\n- severity: P1\n');
+        writeFileSync(join(project, 'src/lib/x.ts'), 'import { uniq } from \'lodash\'\neval(\'1+1\')\n');
+    });
+    afterEach(() => { rmSync(project, { recursive: true, force: true }); });
+    it('--scope=code runs A/B/C/D/E/F/G but not H', async () => {
+        const out = await runAudit({
+            primaryRoot: project, profile: 'fast', scope: 'code', sinceHours: 24,
+            ghBin: '/no/such/gh', bdBin: '/no/such/bd',
+        });
+        const lensIds = new Set(out.findings.map((f) => f.lens_id));
+        expect(lensIds.has('H-cross-doc')).toBe(false);
+        expect(lensIds.has('C-standards')).toBe(true);
+        expect(lensIds.has('D-stack')).toBe(true);
+        expect(lensIds.has('G-decisions')).toBe(true);
+    });
+    it('--scope=docs runs only H', async () => {
+        const out = await runAudit({
+            primaryRoot: project, profile: 'fast', scope: 'docs', sinceHours: 24,
+            ghBin: '/no/such/gh', bdBin: '/no/such/bd',
+        });
+        const lensIds = new Set(out.findings.map((f) => f.lens_id));
+        expect(lensIds.has('H-cross-doc')).toBe(true);
+        for (const id of ['A-tdd', 'B-ac-coverage', 'C-standards', 'D-stack', 'E-design', 'F-scope', 'G-decisions']) {
+            expect(lensIds.has(id)).toBe(false);
+        }
+    });
+});
+describe('api.runProgress (Plan 5 — replay + stall)', () => {
+    let project, wt;
+    beforeEach(async () => {
+        project = mkdtempSync(join(tmpdir(), 'observe-prog5-pri-'));
+        wt = mkdtempSync(join(tmpdir(), 'observe-prog5-wt-'));
+        execSync('git init -q', { cwd: project });
+        execSync('git config user.email t@e.com && git config user.name T', { cwd: project, shell: '/bin/sh' });
+        ensureIdentity(wt, 'agent-alice');
+        await writeEvent(wt, { type: 'task_claimed', branch: 'a', task_id: 'T-1', payload: { task_title: 'A' } });
+        await harvestWorktree({ primaryRoot: project, worktreeRoot: wt });
+    });
+    afterEach(() => {
+        rmSync(project, { recursive: true, force: true });
+        rmSync(wt, { recursive: true, force: true });
+    });
+    it('runProgress with replay=true populates EngineOutput.replay with the ledger event', async () => {
+        const out = await runProgress({
+            primaryRoot: project, sinceHours: 24, replay: true, ghBin: '/no/such/gh', bdBin: '/no/such/bd',
+        });
+        expect(out.replay).not.toBeNull();
+        expect(out.replay.events.length).toBeGreaterThanOrEqual(1);
+        expect(out.replay.events[0].source).toBe('ledger');
+        expect(out.replay.events[0].kind).toBe('task_claimed');
+    });
+    it('runProgress without replay leaves replay null', async () => {
+        const out = await runProgress({ primaryRoot: project, sinceHours: 24, ghBin: '/no/such/gh', bdBin: '/no/such/bd' });
+        expect(out.replay).toBeNull();
+    });
+    it('runProgress with stall check populates needs_attention when stall conditions trip', async () => {
+        const { readFileSync: readFS } = await import('node:fs');
+        const identity = JSON.parse(readFS(join(wt, '.scaffold/identity.json'), 'utf8'));
+        const archived = join(project, '.scaffold/activity-archive/active', identity.worktree_id + '.jsonl');
+        writeFileSync(archived, JSON.stringify({
+            event_id: 'ulid-old', worktree_id: 'wid', actor_label: 'agent-alice', branch: 'a',
+            task_id: 'T-OLD', type: 'task_claimed',
+            ts: new Date(Date.now() - 6 * 3_600_000).toISOString(),
+            payload: { task_title: 'old' },
+        }) + '\n', { flag: 'a' });
+        const out = await runProgress({ primaryRoot: project, sinceHours: 24, ghBin: '/no/such/gh', bdBin: '/no/such/bd' });
+        const stale = out.needs_attention.find((n) => n.signal === 'task_stale' && n.ref.id === 'T-OLD');
+        expect(stale).toBeDefined();
+    });
+    it('--no-stall-check leaves needs_attention empty', async () => {
+        const out = await runProgress({
+            primaryRoot: project, sinceHours: 24, noStallCheck: true, ghBin: '/no/such/gh', bdBin: '/no/such/bd',
+        });
+        expect(out.needs_attention).toEqual([]);
+    });
+});
+//# sourceMappingURL=api.test.js.map

package/dist/observability/engine/api.test.js.map

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

package/dist/observability/engine/checks/findings-aggregator.d.ts

@@ -0,0 +1,6 @@
+import type { Finding, FindingsSummary, Event, Severity } from '../types.js';
+export declare function aggregate(rawFindings: Finding[], events: Event[], fixThreshold: Severity): {
+    findings: Finding[];
+    summary: FindingsSummary;
+};
+//# sourceMappingURL=findings-aggregator.d.ts.map

package/dist/observability/engine/checks/findings-aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings-aggregator.d.ts","sourceRoot":"","sources":["../../../../src/observability/engine/checks/findings-aggregator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAoB5E,wBAAgB,SAAS,CACvB,WAAW,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,QAAQ,GAC9D;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,CAqCnD"}

package/dist/observability/engine/checks/findings-aggregator.js

@@ -0,0 +1,56 @@
+import { severityRank } from '../types.js';
+function buildAckMap(events) {
+    const out = new Map();
+    for (const e of events) {
+        if (e.type !== 'finding_acknowledged')
+            continue;
+        const p = e.payload;
+        const prev = out.get(p.finding_id);
+        if (!prev || prev.ts < e.ts)
+            out.set(p.finding_id, { status: p.status, ts: e.ts, note: p.note });
+    }
+    return out;
+}
+function emptyByStatus() {
+    return { open: 0, acknowledged: 0, skipped: 0 };
+}
+export function aggregate(rawFindings, events, fixThreshold) {
+    const acks = buildAckMap(events);
+    const findings = rawFindings.map((f) => {
+        if (f.status === 'skipped')
+            return f;
+        const ack = acks.get(f.id);
+        if (!ack)
+            return { ...f };
+        return { ...f, status: ack.status, ack_note: ack.note };
+    });
+    const by_severity = { P0: 0, P1: 0, P2: 0, P3: 0 };
+    const by_severity_status = {
+        P0: emptyByStatus(), P1: emptyByStatus(), P2: emptyByStatus(), P3: emptyByStatus(),
+    };
+    let blocking = 0;
+    let acknowledged = 0;
+    const skippedLensIds = new Set();
+    for (const f of findings) {
+        by_severity[f.severity]++;
+        by_severity_status[f.severity][f.status]++;
+        if (f.status === 'open' && severityRank(f.severity) <= severityRank(fixThreshold))
+            blocking++;
+        if (f.status === 'skipped')
+            skippedLensIds.add(f.lens_id);
+        // Count acknowledged only when driven by a ledger event (not pre-existing status)
+        const ack = acks.get(f.id);
+        if (ack && ack.status === 'acknowledged' && f.status === 'acknowledged')
+            acknowledged++;
+    }
+    const summary = {
+        total: findings.length,
+        by_severity,
+        by_severity_status,
+        blocking,
+        acknowledged,
+        skipped_lenses: skippedLensIds.size,
+    };
+    return { findings, summary };
+}
+//# sourceMappingURL=findings-aggregator.js.map

package/dist/observability/engine/checks/findings-aggregator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings-aggregator.js","sourceRoot":"","sources":["../../../../src/observability/engine/checks/findings-aggregator.ts"],"names":[],"mappings":"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"}

package/dist/observability/engine/checks/findings-aggregator.test.d.ts

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

package/dist/observability/engine/checks/findings-aggregator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings-aggregator.test.d.ts","sourceRoot":"","sources":["../../../../src/observability/engine/checks/findings-aggregator.test.ts"],"names":[],"mappings":""}