@zigrivers/scaffold 3.25.1 → 3.26.0

package/dist/observability/renderers/markdown.test.js

@@ -0,0 +1,169 @@
+import { describe, it, expect } from 'vitest';
+import { renderProgressMarkdown, renderAuditMarkdown } from './markdown.js';
+const fixture = {
+    schema_version: '1.0',
+    invocation: {
+        command: 'progress', args: { sinceHours: 24 },
+        started_at: '2026-05-04T14:00:00Z', completed_at: '2026-05-04T14:00:01Z', scaffold_version: '3.25.1',
+    },
+    availability: {
+        git: { status: 'available' }, gh: { status: 'unavailable', reason: 'gh not installed' },
+        pipeline_docs: { status: 'available' }, tests: { status: 'available' },
+        state: { status: 'available' }, beads: { status: 'unavailable' },
+        mmr: { status: 'available' }, audit_history: { status: 'unavailable' },
+        ledger: { events_read: 4, malformed_lines: 0, sources: [{ worktree_id: 'wid-a', events: 4 }] },
+    },
+    snapshot: {
+        current_phase: 'build',
+        active_agents: [{
+                worktree_id: 'wid-a', actor_label: 'agent-alice', branch: 'feat-auth',
+                current_task: { id: 'T-031', title: 'refresh token rotation', claimed_at: '2026-05-04T13:55:00Z' },
+                open_pr: null,
+            }],
+        completed_in_window: [{
+                task_id: 'T-029', task_title: 'login bug', outcome: 'pr_submitted', pr_number: 40, by: 'agent-alice',
+            }],
+        in_flight: [{
+                task_id: 'T-031', task_title: 'refresh token rotation', by: 'agent-alice',
+                claimed_at: '2026-05-04T13:55:00Z', age_hours: 0.1, branch: 'feat-auth',
+            }],
+        blocked: [], upcoming: [],
+        recent_decisions: [{
+                decision_id: 'decision:foo', key: 'foo', summary: 'bar',
+                recorded_at: '2026-05-04T13:00:00Z', affects: ['src/foo/**'],
+            }],
+        story_coverage: [],
+    },
+    replay: null, findings: [], needs_attention: [],
+    graph_stats: {
+        nodes_by_kind: {}, edges_by_kind: {}, orphans_by_kind: {}, unsanctioned_uses: 0, ad_hoc_token_uses: 0,
+    },
+    fix_threshold: 'P2', verdict: 'pass',
+    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,
+    },
+};
+describe('renderProgressMarkdown', () => {
+    it('produces a heading + sections + availability table', () => {
+        const md = renderProgressMarkdown(fixture);
+        expect(md).toMatch(/^# Build Observability — Progress/m);
+        expect(md).toContain('**Window:**');
+        expect(md).toContain('## Active Agents');
+        expect(md).toContain('agent-alice');
+        expect(md).toContain('## Completed in Window');
+        expect(md).toContain('PR #40');
+        expect(md).toContain('## Recent Decisions');
+        expect(md).toContain('## Availability');
+        expect(md).toMatch(/\| git \|/);
+        expect(md).toMatch(/\| gh \| .*unavailable/);
+    });
+    it('omits empty sections', () => {
+        const empty = {
+            ...fixture,
+            snapshot: {
+                ...fixture.snapshot, active_agents: [], in_flight: [], completed_in_window: [], recent_decisions: [],
+            },
+        };
+        const md = renderProgressMarkdown(empty);
+        expect(md).not.toContain('## Active Agents');
+        expect(md).not.toContain('## Completed in Window');
+    });
+    it('redacts secrets in narrative content', () => {
+        const tainted = JSON.parse(JSON.stringify(fixture));
+        tainted.snapshot.recent_decisions[0].summary = 'token=ghp_1234567890abcdefABCDEF1234567890abcdef';
+        const md = renderProgressMarkdown(tainted);
+        expect(md).not.toContain('ghp_1234567890abcdefABCDEF1234567890abcdef');
+        expect(md).toContain('[REDACTED:');
+    });
+});
+describe('renderAuditMarkdown', () => {
+    const auditFixture = {
+        ...fixture,
+        invocation: { ...fixture.invocation, command: 'audit', args: { profile: 'fast', scope: 'all' } },
+        snapshot: null,
+        findings: [
+            { id: '3a8c1f0211223344', lens_id: 'B-ac-coverage', severity: 'P0',
+                title: 'AC has failing test', description: 'src/auth/test.spec.ts is failing.',
+                source_doc: 'docs/user-stories.md#user-auth-1',
+                evidence: { kind: 'rule_violation', rule_id: 'ac-test-failing', file: 'file:src/auth/test.spec.ts' },
+                confidence: 'high', first_seen: '2026-05-04T00:00:00Z', last_seen: '2026-05-04T00:00:00Z', status: 'open',
+                fix_hint: { kind: 'add_test', target: 'src/auth/test.spec.ts', prompt: 'Re-enable test' } },
+            { id: '9d1e02f455667788', lens_id: 'A-tdd', severity: 'P1',
+                title: 'AC without test', description: 'AC has no test.', source_doc: 'docs/user-stories.md#story-s-1',
+                evidence: { kind: 'ac_not_covered', story_id: 'story:s-1', ac_id: 'ac:s-1.1', missing_tests: [] },
+                confidence: 'medium', first_seen: '2026-05-04T00:00:00Z', last_seen: '2026-05-04T00:00:00Z',
+                status: 'acknowledged', ack_note: 'tracked separately' },
+        ],
+        fix_threshold: 'P1', verdict: 'blocked',
+        summary: {
+            total: 2, by_severity: { P0: 1, P1: 1, P2: 0, P3: 0 },
+            by_severity_status: {
+                P0: { open: 1, acknowledged: 0, skipped: 0 }, P1: { open: 0, acknowledged: 1, skipped: 0 },
+                P2: { open: 0, acknowledged: 0, skipped: 0 }, P3: { open: 0, acknowledged: 0, skipped: 0 },
+            },
+            blocking: 1, acknowledged: 1, skipped_lenses: 0,
+        },
+    };
+    it('renders verdict, threshold, summary table, and one section per finding', () => {
+        const md = renderAuditMarkdown(auditFixture);
+        expect(md).toMatch(/^# Build Observability — Audit/m);
+        expect(md).toContain('**Verdict:** blocked');
+        expect(md).toContain('**Profile:** fast');
+        expect(md).toContain('**Scope:** all');
+        expect(md).toContain('**Fix threshold:** P1');
+        expect(md).toContain('## Summary');
+        expect(md).toMatch(/\| P0 \| 1 \| 1 \| 0 \|/);
+        expect(md).toContain('## Findings');
+        expect(md).toContain('### [P0] B-ac-coverage — AC has failing test');
+        expect(md).toContain('`3a8c1f02');
+        expect(md).toContain('## Acknowledged');
+        expect(md).toContain('tracked separately');
+    });
+    it('omits Acknowledged section when there are none', () => {
+        const out = JSON.parse(JSON.stringify(auditFixture));
+        out.findings = out.findings.filter((f) => f.status !== 'acknowledged');
+        out.summary.acknowledged = 0;
+        out.summary.by_severity_status.P1 = { open: 1, acknowledged: 0, skipped: 0 };
+        const md = renderAuditMarkdown(out);
+        expect(md).not.toContain('## Acknowledged');
+    });
+    it('emits a Skipped Lenses section when any lens skipped', () => {
+        const out = JSON.parse(JSON.stringify(auditFixture));
+        out.findings.push({
+            id: 'ffeeddccbbaa9988', lens_id: 'D-stack', severity: 'P3',
+            title: 'D-stack: skipped', description: 'pipeline_docs unavailable',
+            source_doc: '', evidence: { kind: 'lens_skipped', reason: 'adapter_unavailable', needed: ['pipeline_docs'] },
+            confidence: 'high', first_seen: '', last_seen: '', status: 'skipped',
+        });
+        out.summary.skipped_lenses = 1;
+        const md = renderAuditMarkdown(out);
+        expect(md).toContain('## Skipped Lenses');
+        expect(md).toContain('D-stack');
+    });
+});
+describe('renderProgressMarkdown — replay + needs_attention', () => {
+    it('prepends a "Needs Attention" table when needs_attention is non-empty', () => {
+        const out = JSON.parse(JSON.stringify(fixture));
+        out.needs_attention = [{ signal: 'pr_stale', ref: { kind: 'pr', id: '42' },
+                age_hours: 67, threshold_hours: 48, summary: 'PR #42 opened 67h ago, not merged or closed' }];
+        const md = renderProgressMarkdown(out);
+        expect(md).toContain('## Needs Attention');
+        expect(md).toMatch(/\| pr_stale \| .*PR #42/);
+    });
+    it('appends a "Timeline" section when replay is populated', () => {
+        const out = JSON.parse(JSON.stringify(fixture));
+        out.replay = { window: { from: '2026-05-04T13:00:00Z', to: '2026-05-04T14:00:00Z' },
+            events: [{ sort_id: 'ledger:ulid-A', correlation_id: null, ts: '2026-05-04T13:55:00Z',
+                    source: 'ledger', kind: 'task_claimed', actor_label: 'agent-alice',
+                    task_id: 'T-031', summary: 'T-031 claimed' }] };
+        const md = renderProgressMarkdown(out);
+        expect(md).toContain('## Timeline');
+        expect(md).toMatch(/\| .*ledger.* \| .*task_claimed.* \|/);
+    });
+});
+//# sourceMappingURL=markdown.test.js.map

package/dist/observability/renderers/markdown.test.js.map

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

package/dist/observability/renderers/mmr-findings.d.ts

@@ -0,0 +1,10 @@
+import type { EngineOutput } from '../engine/types.js';
+export interface MmrFindingShape {
+    severity: 'P0' | 'P1' | 'P2' | 'P3';
+    location: string;
+    description: string;
+    suggestion: string;
+    category: string;
+}
+export declare function renderMmrFindings(out: EngineOutput): string;
+//# sourceMappingURL=mmr-findings.d.ts.map

package/dist/observability/renderers/mmr-findings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mmr-findings.d.ts","sourceRoot":"","sources":["../../../src/observability/renderers/mmr-findings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAW,MAAM,oBAAoB,CAAA;AAG/D,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACnC,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAgBD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAK3D"}

package/dist/observability/renderers/mmr-findings.js

@@ -0,0 +1,21 @@
+import { redactRendered } from '../engine/redact.js';
+function findingToMmr(f) {
+    const shortId = f.id.slice(0, 8);
+    const location = `${f.source_doc || '(no-source-doc)'}::${f.lens_id}::${shortId}`;
+    const description = `[doc-conformance/${f.lens_id}] ${f.title}${f.description ? ` — ${f.description}` : ''}`;
+    const suggestion = f.fix_hint?.prompt ?? f.fix_hint?.target ?? '';
+    return {
+        severity: f.severity,
+        location,
+        description,
+        suggestion,
+        category: 'doc-conformance',
+    };
+}
+export function renderMmrFindings(out) {
+    const findings = out.findings
+        .filter((f) => f.status === 'open')
+        .map(findingToMmr);
+    return redactRendered(JSON.stringify(findings));
+}
+//# sourceMappingURL=mmr-findings.js.map

package/dist/observability/renderers/mmr-findings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mmr-findings.js","sourceRoot":"","sources":["../../../src/observability/renderers/mmr-findings.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAUpD,SAAS,YAAY,CAAC,CAAU;IAC9B,MAAM,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAChC,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,UAAU,IAAI,iBAAiB,KAAK,CAAC,CAAC,OAAO,KAAK,OAAO,EAAE,CAAA;IACjF,MAAM,WAAW,GAAG,oBAAoB,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;IAC5G,MAAM,UAAU,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,CAAA;IACjE,OAAO;QACL,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,QAAQ;QACR,WAAW;QACX,UAAU;QACV,QAAQ,EAAE,iBAAiB;KAC5B,CAAA;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAiB;IACjD,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ;SAC1B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC;SAClC,GAAG,CAAC,YAAY,CAAC,CAAA;IACpB,OAAO,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAA;AACjD,CAAC"}

package/dist/observability/renderers/mmr-findings.test.d.ts

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

package/dist/observability/renderers/mmr-findings.test.d.ts.map

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

package/dist/observability/renderers/mmr-findings.test.js

@@ -0,0 +1,86 @@
+import { describe, it, expect } from 'vitest';
+import { renderMmrFindings } from './mmr-findings.js';
+const baseOut = {
+    schema_version: '1.0',
+    invocation: {
+        command: 'audit',
+        args: { profile: 'fast', scope: 'all' },
+        started_at: '2026-05-04T14:00:00Z',
+        completed_at: '2026-05-04T14:00:01Z',
+        scaffold_version: '3.25.1',
+    },
+    availability: {
+        git: { status: 'available' }, gh: { status: 'unavailable' },
+        pipeline_docs: { status: 'available' }, tests: { status: 'available' },
+        state: { status: 'available' }, beads: { status: 'unavailable' },
+        mmr: { status: 'available' }, audit_history: { status: 'unavailable' },
+        ledger: { events_read: 0, malformed_lines: 0, sources: [] },
+    },
+    snapshot: null, replay: null,
+    findings: [
+        {
+            id: '3a8c1f0211223344', lens_id: 'B-ac-coverage', severity: 'P0',
+            title: 'AC has failing test', description: 'Test refresh.spec.ts is failing.',
+            source_doc: 'docs/user-stories.md#user-auth-1',
+            evidence: { kind: 'rule_violation', rule_id: 'ac-test-failing', file: 'file:src/auth/test.spec.ts' },
+            confidence: 'high', first_seen: '', last_seen: '', status: 'open',
+            fix_hint: { kind: 'add_test', target: 'src/auth/test.spec.ts', prompt: 'Re-enable the test' },
+        },
+        {
+            id: '9d1e02f455667788', lens_id: 'A-tdd', severity: 'P1',
+            title: 'AC without test', description: 'AC has no test.',
+            source_doc: 'docs/user-stories.md#story-s-1',
+            evidence: { kind: 'ac_not_covered', story_id: 'story:s-1', ac_id: 'ac:s-1.1', missing_tests: [] },
+            confidence: 'medium', first_seen: '', last_seen: '', status: 'acknowledged',
+        },
+        {
+            id: 'ffeeddccbbaa9988', lens_id: 'D-stack', severity: 'P3',
+            title: 'D-stack: skipped', description: 'pipeline_docs unavailable',
+            source_doc: '',
+            evidence: { kind: 'lens_skipped', reason: 'adapter_unavailable', needed: ['pipeline_docs'] },
+            confidence: 'high', first_seen: '', last_seen: '', status: 'skipped',
+        },
+    ],
+    needs_attention: [],
+    graph_stats: {
+        nodes_by_kind: {}, edges_by_kind: {}, orphans_by_kind: {},
+        unsanctioned_uses: 0, ad_hoc_token_uses: 0,
+    },
+    fix_threshold: 'P1', verdict: 'blocked',
+    summary: {
+        total: 3,
+        by_severity: { P0: 1, P1: 1, P2: 0, P3: 1 },
+        by_severity_status: {
+            P0: { open: 1, acknowledged: 0, skipped: 0 },
+            P1: { open: 0, acknowledged: 1, skipped: 0 },
+            P2: { open: 0, acknowledged: 0, skipped: 0 },
+            P3: { open: 0, acknowledged: 0, skipped: 1 },
+        },
+        blocking: 1, acknowledged: 1, skipped_lenses: 1,
+    },
+};
+describe('renderMmrFindings', () => {
+    it('emits a JSON array — only open findings (acknowledged and skipped excluded)', () => {
+        const out = renderMmrFindings(baseOut);
+        const parsed = JSON.parse(out);
+        expect(parsed).toHaveLength(1);
+        expect(parsed[0].severity).toBe('P0');
+    });
+    it('builds composite location <source_doc>::<lens_id>::<short_id> for stable cross-run identity', () => {
+        const arr = JSON.parse(renderMmrFindings(baseOut));
+        expect(arr[0].location).toBe('docs/user-stories.md#user-auth-1::B-ac-coverage::3a8c1f02');
+    });
+    it('description prefixes lens_id and includes the engine title', () => {
+        const arr = JSON.parse(renderMmrFindings(baseOut));
+        expect(arr[0].description).toMatch(/^\[doc-conformance\/B-ac-coverage\]/);
+        expect(arr[0].description).toContain('AC has failing test');
+    });
+    it('suggestion is fix_hint.prompt when present, else fix_hint.target, else empty string', () => {
+        const arr = JSON.parse(renderMmrFindings(baseOut));
+        expect(arr[0].suggestion).toBe('Re-enable the test');
+    });
+    it('emits a stable JSON shape that is valid JSON.parse-able', () => {
+        expect(() => JSON.parse(renderMmrFindings(baseOut))).not.toThrow();
+    });
+});
+//# sourceMappingURL=mmr-findings.test.js.map

package/dist/observability/renderers/mmr-findings.test.js.map

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

package/dist/observability/renderers/sidecar.d.ts

@@ -0,0 +1,5 @@
+import type { EngineOutput } from '../engine/types.js';
+export declare function deriveReportId(out: EngineOutput): string;
+export declare function sidecarPath(reportId: string, command: 'progress' | 'audit'): string;
+export declare function writeSidecar(cwd: string, out: EngineOutput, overridePath?: string, reportId?: string): Promise<string>;
+//# sourceMappingURL=sidecar.d.ts.map

package/dist/observability/renderers/sidecar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../../../src/observability/renderers/sidecar.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAsBtD,wBAAgB,cAAc,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAYxD;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,GAAG,MAAM,CAGnF;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GACvE,OAAO,CAAC,MAAM,CAAC,CAWjB"}

package/dist/observability/renderers/sidecar.js

@@ -0,0 +1,51 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, isAbsolute, join } from 'node:path';
+import { redactEngineOutput } from '../engine/redact.js';
+function dateStamp(iso) {
+    const d = new Date(iso);
+    if (isNaN(d.valueOf())) {
+        return `unknown-${Date.now()}`;
+    }
+    const pad2 = (n) => String(n).padStart(2, '0');
+    const pad3 = (n) => String(n).padStart(3, '0');
+    return `${d.getUTCFullYear()}-${pad2(d.getUTCMonth() + 1)}-${pad2(d.getUTCDate())}` +
+        `-${pad2(d.getUTCHours())}${pad2(d.getUTCMinutes())}${pad2(d.getUTCSeconds())}${pad3(d.getUTCMilliseconds())}`;
+}
+function safeLensId(raw) {
+    return raw.replace(/[^a-zA-Z0-9_-]/g, '_');
+}
+function shortId() {
+    return Math.floor(Math.random() * 0xffffff).toString(16).padStart(6, '0');
+}
+export function deriveReportId(out) {
+    const stamp = dateStamp(out.invocation.started_at);
+    const suffix = shortId();
+    if (out.invocation.command === 'progress')
+        return `progress-${stamp}-${suffix}`;
+    const args = out.invocation.args;
+    const profile = args.profile ?? 'fast';
+    if (Array.isArray(args.lensIds) && args.lensIds.length > 0) {
+        const sorted = [...args.lensIds].map(safeLensId).sort();
+        if (sorted.length === 1)
+            return `audit-${stamp}-${profile}-lens-${sorted[0]}-${suffix}`;
+        return `audit-${stamp}-${profile}-lenses-${sorted.join('+')}-${suffix}`;
+    }
+    return `audit-${stamp}-${profile}-${args.scope ?? 'all'}-${suffix}`;
+}
+export function sidecarPath(reportId, command) {
+    const dir = command === 'progress' ? 'docs/build-status' : 'docs/audits';
+    return `${dir}/${reportId}.json`;
+}
+export async function writeSidecar(cwd, out, overridePath, reportId) {
+    const id = reportId ?? deriveReportId(out);
+    const defaultPath = sidecarPath(id, out.invocation.command);
+    const absPath = overridePath
+        ? (isAbsolute(overridePath) ? overridePath : join(cwd, overridePath))
+        : join(cwd, defaultPath);
+    await mkdir(dirname(absPath), { recursive: true });
+    const redacted = redactEngineOutput(out);
+    const wrapper = { report_id: id, engine_output: redacted };
+    await writeFile(absPath, JSON.stringify(wrapper, null, 2) + '\n', { mode: 0o644 });
+    return absPath;
+}
+//# sourceMappingURL=sidecar.js.map

package/dist/observability/renderers/sidecar.js.map

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

package/dist/observability/renderers/sidecar.test.d.ts

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

package/dist/observability/renderers/sidecar.test.d.ts.map

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

package/dist/observability/renderers/sidecar.test.js

@@ -0,0 +1,77 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, rmSync, readFileSync, existsSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { writeSidecar, sidecarPath, deriveReportId } from './sidecar.js';
+const baseOut = {
+    schema_version: '1.0',
+    invocation: {
+        command: 'audit', args: { profile: 'fast', scope: 'all' },
+        started_at: '2026-05-04T14:22:00Z', completed_at: '2026-05-04T14:22:01Z', scaffold_version: '3.25.1',
+    },
+    availability: {
+        git: { status: 'available' }, gh: { status: 'unavailable' },
+        pipeline_docs: { status: 'available' }, tests: { status: 'available' },
+        state: { status: 'available' }, beads: { status: 'unavailable' },
+        mmr: { status: 'available' }, audit_history: { status: 'unavailable' },
+        ledger: { events_read: 0, malformed_lines: 0, sources: [] },
+    },
+    snapshot: null, replay: null, findings: [], needs_attention: [],
+    graph_stats: {
+        nodes_by_kind: {}, edges_by_kind: {}, orphans_by_kind: {}, unsanctioned_uses: 0, ad_hoc_token_uses: 0,
+    },
+    fix_threshold: 'P2', verdict: 'pass',
+    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 },
+};
+describe('sidecar', () => {
+    let dir;
+    beforeEach(() => { dir = mkdtempSync(join(tmpdir(), 'observe-sc-')); });
+    afterEach(() => { rmSync(dir, { recursive: true, force: true }); });
+    it('deriveReportId formats audit ids by date + profile + scope', () => {
+        expect(deriveReportId(baseOut)).toMatch(/^audit-\d{4}-\d{2}-\d{2}-\d{9}-fast-all-[a-f0-9]{6}$/);
+    });
+    it('deriveReportId formats single-lens audits as audit-<date>-<profile>-lens-<id>', () => {
+        const out = {
+            ...baseOut,
+            invocation: { ...baseOut.invocation, args: { profile: 'fast', scope: 'all', lensIds: ['B-ac-coverage'] } },
+        };
+        expect(deriveReportId(out)).toMatch(/^audit-\d{4}-\d{2}-\d{2}-\d{9}-fast-lens-B-ac-coverage-[a-f0-9]{6}$/);
+    });
+    it('deriveReportId formats multi-lens audits with sorted lens IDs joined by +', () => {
+        const lensArgs = { profile: 'fast', scope: 'all', lensIds: ['B-ac-coverage', 'A-tdd'] };
+        const out = { ...baseOut, invocation: { ...baseOut.invocation, args: lensArgs } };
+        expect(deriveReportId(out)).toMatch(/^audit-\d{4}-\d{2}-\d{2}-\d{9}-fast-lenses-A-tdd\+B-ac-coverage-[a-f0-9]{6}$/);
+    });
+    it('deriveReportId formats progress reports as progress-<date>', () => {
+        const out = { ...baseOut, invocation: { ...baseOut.invocation, command: 'progress', args: {} } };
+        expect(deriveReportId(out)).toMatch(/^progress-\d{4}-\d{2}-\d{2}-\d{9}-[a-f0-9]{6}$/);
+    });
+    it('sidecarPath returns docs/audits/<id>.json for audit, docs/build-status/<id>.json for progress', () => {
+        expect(sidecarPath(deriveReportId(baseOut), 'audit')).toMatch(/^docs\/audits\/audit-/);
+        const pOut = { ...baseOut, invocation: { ...baseOut.invocation, command: 'progress', args: {} } };
+        const progressPattern = /^docs\/build-status\/progress-\d{4}-\d{2}-\d{2}-\d{9}-[a-f0-9]{6}\.json$/;
+        expect(sidecarPath(deriveReportId(pOut), 'progress')).toMatch(progressPattern);
+    });
+    it('writeSidecar writes a redacted EngineOutput wrapped under engine_output', async () => {
+        const path = await writeSidecar(dir, baseOut);
+        expect(existsSync(path)).toBe(true);
+        const obj = JSON.parse(readFileSync(path, 'utf8'));
+        expect(obj.report_id).toMatch(/^audit-\d{4}-\d{2}-\d{2}-\d{9}-fast-all-[a-f0-9]{6}$/);
+        expect(obj.engine_output.schema_version).toBe('1.0');
+        expect(obj.engine_output.verdict).toBe('pass');
+    });
+    it('writeSidecar redacts paths/secrets in the persisted file', async () => {
+        const tainted = JSON.parse(JSON.stringify(baseOut));
+        tainted.invocation.args = { ...tainted.invocation.args, dirty: '/Users/alice/Documents/repo/file.ts' };
+        const path = await writeSidecar(dir, tainted);
+        const text = readFileSync(path, 'utf8');
+        expect(text).not.toContain('/Users/alice');
+        expect(text).toContain('~');
+    });
+});
+//# sourceMappingURL=sidecar.test.js.map

package/dist/observability/renderers/sidecar.test.js.map

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

package/dist/observability/renderers/terminal.d.ts

@@ -0,0 +1,7 @@
+import type { EngineOutput } from '../engine/types.js';
+export declare function renderProgressTerminal(out: EngineOutput): string;
+export interface RenderAuditOptions {
+    showAcknowledged?: boolean;
+}
+export declare function renderAuditTerminal(out: EngineOutput, opts?: RenderAuditOptions): string;
+//# sourceMappingURL=terminal.d.ts.map

package/dist/observability/renderers/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../../src/observability/renderers/terminal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,oBAAoB,CAAA;AAIzE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CA+DhE;AAID,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,GAAE,kBAAuB,GAAG,MAAM,CAiC5F"}

package/dist/observability/renderers/terminal.js

@@ -0,0 +1,96 @@
+import { availabilityLine, needsAttentionLines } from './_lib.js';
+import { scrubSecrets } from '../engine/redact.js';
+export function renderProgressTerminal(out) {
+    const lines = [];
+    const sinceHours = Number(out.invocation.args.sinceHours ?? 24);
+    lines.push(`build observability — progress (last ${sinceHours}h · phase: ${out.snapshot?.current_phase ?? 'unknown'})`);
+    lines.push('');
+    const banner = needsAttentionLines(out.needs_attention);
+    if (banner.length > 0) {
+        lines.push(...banner);
+        lines.push('');
+    }
+    const snap = out.snapshot;
+    if (snap && snap.active_agents.length > 0) {
+        lines.push(`active agents (${snap.active_agents.length})`);
+        for (const a of snap.active_agents) {
+            const taskBit = a.current_task
+                ? ` · ${a.current_task.id ?? '(unplanned)'} ${a.current_task.title}`
+                : ' · idle';
+            const prBit = a.open_pr ? ` · PR #${a.open_pr.number}` : '';
+            lines.push(`  ${a.actor_label}${taskBit}  branch ${a.branch}${prBit}`);
+        }
+        lines.push('');
+    }
+    if (snap && snap.in_flight.length > 0) {
+        lines.push(`in flight (${snap.in_flight.length})`);
+        for (const t of snap.in_flight) {
+            const tid = t.task_id ?? '(unplanned)';
+            lines.push(`  ${tid} ${t.task_title}  by ${t.by} · age ${t.age_hours}h · branch ${t.branch}`);
+        }
+        lines.push('');
+    }
+    if (snap && snap.completed_in_window.length > 0) {
+        lines.push(`completed in window (${snap.completed_in_window.length})`);
+        for (const c of snap.completed_in_window) {
+            const pr = c.pr_number ? ` PR #${c.pr_number}` : '';
+            lines.push(`  ✓ ${c.task_id ?? '(unplanned)'} ${c.task_title}${pr}  by ${c.by}`);
+        }
+        lines.push('');
+    }
+    if (snap && snap.recent_decisions.length > 0) {
+        lines.push(`recent decisions (${snap.recent_decisions.length})`);
+        for (const d of snap.recent_decisions.slice(0, 5)) {
+            lines.push(`  ${d.key.padEnd(24).slice(0, 24)} ${d.summary}`);
+        }
+        lines.push('');
+    }
+    if (out.replay && out.replay.events.length > 0) {
+        lines.push(`timeline (${out.replay.events.length} events · ${out.replay.window.from} – ${out.replay.window.to})`);
+        for (const e of out.replay.events.slice(0, 50)) {
+            const ts = e.ts.replace('T', ' ').replace(/:\d{2}\.\d+Z$/, '').replace(/Z$/, '');
+            const actor = e.actor_label ? ` · ${e.actor_label}` : '';
+            lines.push(`  ${ts}  ${e.source.padEnd(7)} ${e.kind.padEnd(20).slice(0, 20)} ${e.summary}${actor}`);
+        }
+        lines.push('');
+    }
+    lines.push(`availability: ${availabilityLine(out.availability)}`);
+    lines.push('                              (✓ available  · ~ degraded  · — unavailable)');
+    return scrubSecrets(lines.join('\n'));
+}
+const SEVERITY_LABEL = { P0: '[P0]', P1: '[P1]', P2: '[P2]', P3: '[P3]' };
+export function renderAuditTerminal(out, opts = {}) {
+    const lines = [];
+    const profile = out.invocation.args.profile ?? 'fast';
+    const scope = out.invocation.args.scope ?? 'all';
+    lines.push(`build observability — audit (profile: ${profile} · scope: ${scope})`);
+    lines.push('');
+    const visibleFindings = out.findings.filter((f) => {
+        if (f.status === 'skipped')
+            return false;
+        if (f.status === 'acknowledged' && !opts.showAcknowledged)
+            return false;
+        return true;
+    });
+    if (visibleFindings.length === 0) {
+        lines.push('  no findings');
+    }
+    else {
+        for (const f of visibleFindings) {
+            const sev = SEVERITY_LABEL[f.severity] ?? `[${f.severity}]`;
+            const status = f.status !== 'open' ? ` (${f.status})` : '';
+            lines.push(`  ${sev} ${f.title}${status}`);
+            if (f.lens_id)
+                lines.push(`       lens: ${f.lens_id}`);
+            if (f.fix_hint) {
+                lines.push(`       fix:  ${f.fix_hint.prompt}`);
+            }
+        }
+    }
+    lines.push('');
+    const s = out.summary;
+    lines.push(`verdict: ${out.verdict}  (blocking: ${s.blocking}  acknowledged: ${s.acknowledged}  total: ${s.total})`);
+    lines.push(`availability: ${availabilityLine(out.availability)}`);
+    return scrubSecrets(lines.join('\n'));
+}
+//# sourceMappingURL=terminal.js.map

package/dist/observability/renderers/terminal.js.map

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