@zigrivers/scaffold 3.25.1 → 3.27.0

package/dist/observability/engine/fix-agent-dispatcher.d.ts

@@ -0,0 +1,19 @@
+export interface DispatchFixInput {
+    prompt: string;
+    command: string;
+    timeoutMs: number;
+    cwd?: string;
+}
+export type DispatchFixResult = {
+    ok: true;
+    exit_code: 0;
+    elapsed_ms: number;
+} | {
+    ok: false;
+    reason: string;
+    exit_code?: number;
+    timed_out?: boolean;
+    elapsed_ms?: number;
+};
+export declare function dispatchFixAgent(input: DispatchFixInput): Promise<DispatchFixResult>;
+//# sourceMappingURL=fix-agent-dispatcher.d.ts.map

package/dist/observability/engine/fix-agent-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-agent-dispatcher.d.ts","sourceRoot":"","sources":["../../../src/observability/engine/fix-agent-dispatcher.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAqB/F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAiDpF"}

package/dist/observability/engine/fix-agent-dispatcher.js

@@ -0,0 +1,88 @@
+import { spawn } from 'node:child_process';
+function parseShell(cmd) {
+    const args = [];
+    let current = '';
+    let inSingle = false;
+    let inDouble = false;
+    for (let i = 0; i < cmd.length; i++) {
+        const ch = cmd[i];
+        if (ch === '\'' && !inDouble) {
+            inSingle = !inSingle;
+        }
+        else if (ch === '"' && !inSingle) {
+            inDouble = !inDouble;
+        }
+        else if (ch === ' ' && !inSingle && !inDouble) {
+            if (current) {
+                args.push(current);
+                current = '';
+            }
+        }
+        else {
+            current += ch;
+        }
+    }
+    if (current)
+        args.push(current);
+    return args;
+}
+// dispatcher_command is maintainer-controlled (.scaffold/observability.yaml in the user's own repo).
+// spawn() without shell:true limits injection to the argv array, but `sh -c "..."` is a valid config.
+// This is intentional: the fix dispatcher is project-local, not run against untrusted third-party repos.
+export function dispatchFixAgent(input) {
+    return new Promise((resolve) => {
+        const started = Date.now();
+        const [bin, ...args] = parseShell(input.command);
+        let child;
+        try {
+            child = spawn(bin, args, { stdio: ['pipe', 'inherit', 'inherit'], cwd: input.cwd });
+        }
+        catch (err) {
+            resolve({ ok: false, reason: `spawn failed: ${err.message}` });
+            return;
+        }
+        let resolved = false;
+        const timer = setTimeout(() => {
+            if (resolved)
+                return;
+            resolved = true;
+            try {
+                child.kill('SIGTERM');
+            }
+            catch { /* ignore */ }
+            resolve({
+                ok: false, reason: `timed out after ${input.timeoutMs}ms`,
+                timed_out: true, elapsed_ms: Date.now() - started,
+            });
+        }, input.timeoutMs);
+        child.on('error', (err) => {
+            if (resolved)
+                return;
+            resolved = true;
+            clearTimeout(timer);
+            const code = err.code ?? 'unknown';
+            resolve({ ok: false, reason: `subprocess error (${code}): ${err.message}`, elapsed_ms: Date.now() - started });
+        });
+        child.on('close', (code) => {
+            if (resolved)
+                return;
+            resolved = true;
+            clearTimeout(timer);
+            const elapsed = Date.now() - started;
+            if (code === 0)
+                resolve({ ok: true, exit_code: 0, elapsed_ms: elapsed });
+            else
+                resolve({ ok: false, reason: `subprocess exit ${code}`, exit_code: code ?? -1, elapsed_ms: elapsed });
+        });
+        try {
+            child.stdin?.write(input.prompt);
+            child.stdin?.end();
+        }
+        catch (err) {
+            resolved = true;
+            clearTimeout(timer);
+            resolve({ ok: false, reason: `stdin write failed: ${err.message}` });
+        }
+    });
+}
+//# sourceMappingURL=fix-agent-dispatcher.js.map

package/dist/observability/engine/fix-agent-dispatcher.js.map

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

package/dist/observability/engine/fix-agent-dispatcher.test.d.ts

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

package/dist/observability/engine/fix-agent-dispatcher.test.d.ts.map

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

package/dist/observability/engine/fix-agent-dispatcher.test.js

@@ -0,0 +1,54 @@
+import { describe, it, expect } from 'vitest';
+import { dispatchFixAgent } from './fix-agent-dispatcher.js';
+describe('dispatchFixAgent', () => {
+    it('returns ok=true when subprocess exits 0', async () => {
+        const result = await dispatchFixAgent({
+            prompt: 'edit something',
+            command: 'sh -c "cat >/dev/null; exit 0"',
+            timeoutMs: 5000,
+        });
+        expect(result.ok).toBe(true);
+    });
+    it('returns ok=false when subprocess exits non-zero', async () => {
+        const result = await dispatchFixAgent({
+            prompt: 'edit something',
+            command: 'sh -c "cat >/dev/null; exit 1"',
+            timeoutMs: 5000,
+        });
+        expect(result.ok).toBe(false);
+        if (!result.ok) {
+            expect(result.exit_code).toBe(1);
+        }
+    });
+    it('returns ok=false with timeout when subprocess exceeds timeoutMs', async () => {
+        const result = await dispatchFixAgent({
+            prompt: 'long task',
+            command: 'sh -c "sleep 5"',
+            timeoutMs: 100,
+        });
+        expect(result.ok).toBe(false);
+        if (!result.ok)
+            expect(result.timed_out).toBe(true);
+    });
+    it('passes the prompt to subprocess stdin', async () => {
+        const tmpfile = '/tmp/observe-fix-test-' + Date.now();
+        const result = await dispatchFixAgent({
+            prompt: 'EXPECTED-PROMPT',
+            command: `sh -c "cat > ${tmpfile}"`,
+            timeoutMs: 5000,
+        });
+        expect(result.ok).toBe(true);
+        const { readFileSync, unlinkSync } = await import('node:fs');
+        expect(readFileSync(tmpfile, 'utf8')).toBe('EXPECTED-PROMPT');
+        unlinkSync(tmpfile);
+    });
+    it('returns ok=false with reason ENOENT when binary is missing', async () => {
+        const result = await dispatchFixAgent({
+            prompt: '', command: '/no/such/binary', timeoutMs: 5000,
+        });
+        expect(result.ok).toBe(false);
+        if (!result.ok)
+            expect(result.reason).toMatch(/ENOENT|not found|spawn/i);
+    });
+});
+//# sourceMappingURL=fix-agent-dispatcher.test.js.map

package/dist/observability/engine/fix-agent-dispatcher.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-agent-dispatcher.test.js","sourceRoot":"","sources":["../../../src/observability/engine/fix-agent-dispatcher.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAE5D,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC;YACpC,MAAM,EAAE,gBAAgB;YACxB,OAAO,EAAE,gCAAgC;YACzC,SAAS,EAAE,IAAI;SAChB,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC;YACpC,MAAM,EAAE,gBAAgB;YACxB,OAAO,EAAE,gCAAgC;YACzC,SAAS,EAAE,IAAI;SAChB,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC7B,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAClC,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC;YACpC,MAAM,EAAE,WAAW;YACnB,OAAO,EAAE,iBAAiB;YAC1B,SAAS,EAAE,GAAG;SACf,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC7B,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,OAAO,GAAG,wBAAwB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACrD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC;YACpC,MAAM,EAAE,iBAAiB;YACzB,OAAO,EAAE,gBAAgB,OAAO,GAAG;YACnC,SAAS,EAAE,IAAI;SAChB,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5B,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAA;QAC5D,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;QAC7D,UAAU,CAAC,OAAO,CAAC,CAAA;IACrB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC;YACpC,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,IAAI;SACxD,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC7B,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAA;IAC1E,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/observability/engine/fix-flow.d.ts

@@ -0,0 +1,30 @@
+import type { EngineOutput, Finding } from './types.js';
+import { type DispatchFixResult } from './fix-agent-dispatcher.js';
+import { type AbortSnapshot } from './abort-snapshot.js';
+export type FixDispatcher = (input: {
+    prompt: string;
+    command: string;
+    timeoutMs: number;
+    cwd: string;
+}) => Promise<DispatchFixResult>;
+export type FixVerifier = (cwd: string, finding: Finding) => Promise<{
+    stillPresent: boolean;
+}>;
+export interface RunFixFlowInput {
+    primaryRoot: string;
+    initial: EngineOutput;
+    dispatcher?: FixDispatcher;
+    verifier?: FixVerifier;
+    ghBin?: string;
+    bdBin?: string;
+    abortSnapshot?: AbortSnapshot;
+}
+export interface FixFlowResult {
+    fixed: string[];
+    failed: string[];
+    postfix_markdown_path?: string;
+    postfix_sidecar_path?: string;
+    aborted?: boolean;
+}
+export declare function runFixFlow(input: RunFixFlowInput): Promise<FixFlowResult>;
+//# sourceMappingURL=fix-flow.d.ts.map

package/dist/observability/engine/fix-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-flow.d.ts","sourceRoot":"","sources":["../../../src/observability/engine/fix-flow.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEvD,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAIpF,OAAO,EAAiC,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGvF,MAAM,MAAM,aAAa,GAAG,CAC1B,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,KACvE,OAAO,CAAC,iBAAiB,CAAC,CAAA;AAE/B,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;IAAE,YAAY,EAAE,OAAO,CAAA;CAAE,CAAC,CAAA;AAE/F,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,YAAY,CAAA;IACrB,UAAU,CAAC,EAAE,aAAa,CAAA;IAC1B,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,aAAa,CAAC,EAAE,aAAa,CAAA;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAsED,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,CA0C/E"}

package/dist/observability/engine/fix-flow.js

@@ -0,0 +1,105 @@
+import { execFileSync } from 'node:child_process';
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { buildFixPlan } from './fix-plan.js';
+import { dispatchFixAgent } from './fix-agent-dispatcher.js';
+import { runAudit } from './api.js';
+import { renderAuditMarkdown } from '../renderers/markdown.js';
+import { writeSidecar, deriveReportId } from '../renderers/sidecar.js';
+import { captureSnapshot, recordStaged } from './abort-snapshot.js';
+import { loadObservabilityConfig } from './checks/observability-config.js';
+function buildFindingPrompt(finding) {
+    return [
+        `# Fix request for finding ${finding.id.slice(0, 8)}`,
+        '',
+        `Lens: ${finding.lens_id}`,
+        `Severity: ${finding.severity}`,
+        `Title: ${finding.title}`,
+        `Source doc: ${finding.source_doc || '(none)'}`,
+        '',
+        '## Description',
+        finding.description,
+        '',
+        '## Evidence',
+        '```json',
+        JSON.stringify(finding.evidence, null, 2),
+        '```',
+        '',
+        finding.fix_hint
+            ? `## Fix hint\n${finding.fix_hint.prompt ?? '(target only)'}\nTarget: ${finding.fix_hint.target ?? '(none)'}\n`
+            : '',
+        '## Instructions',
+        '',
+        'Fix this specific finding only. Do not do unrelated work.',
+        'Stage your changes with `git add` when finished. Exit when done.',
+    ].filter(Boolean).join('\n');
+}
+function defaultVerifier(cwd, finding) {
+    return runAudit({
+        primaryRoot: cwd, profile: 'fast', scope: 'all',
+        sinceHours: 24, lensIds: [finding.lens_id],
+        args: { profile: 'fast', scope: 'all', lensIds: [finding.lens_id], verifying: finding.id },
+    }).then((out) => ({ stillPresent: out.findings.some((f) => f.id === finding.id) }));
+}
+function listStagedSince(cwd, baselineStaged) {
+    try {
+        const current = new Set(execFileSync('git', ['diff', '--cached', '--name-only'], { cwd, encoding: 'utf8' })
+            .trim().split('\n').filter(Boolean));
+        return [...current].filter((p) => !baselineStaged.has(p));
+    }
+    catch {
+        return [];
+    }
+}
+async function tryFixFinding(finding, cwd, dispatcher, verifier, command, timeoutMs, maxAttempts, snapshot) {
+    const prompt = buildFindingPrompt(finding);
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        const baselineStaged = new Set([...snapshot.pre_existing_staged, ...snapshot.staged_paths]);
+        const result = await dispatcher({ prompt, command, timeoutMs, cwd });
+        if (!result.ok)
+            continue;
+        const newlyStaged = listStagedSince(cwd, baselineStaged);
+        recordStaged(snapshot, newlyStaged);
+        const { stillPresent } = await verifier(cwd, finding);
+        if (!stillPresent)
+            return { fixed: true, attempts: attempt };
+    }
+    return { fixed: false, attempts: maxAttempts };
+}
+export async function runFixFlow(input) {
+    const config = loadObservabilityConfig(input.primaryRoot);
+    const command = config.fix.dispatcher_command ?? 'claude -p';
+    const timeoutMs = (config.fix.timeout_s ?? 300) * 1000;
+    const maxAttempts = config.fix.per_finding_max_attempts ?? 3;
+    const dispatcher = input.dispatcher ?? dispatchFixAgent;
+    const verifier = input.verifier ?? defaultVerifier;
+    const snapshot = input.abortSnapshot ?? captureSnapshot(input.primaryRoot);
+    const plan = buildFixPlan(input.initial.findings, input.initial.fix_threshold);
+    const fixed = [];
+    const failed = [];
+    for (const finding of plan) {
+        const res = await tryFixFinding(finding, input.primaryRoot, dispatcher, verifier, command, timeoutMs, maxAttempts, snapshot);
+        if (res.fixed)
+            fixed.push(finding.id);
+        else
+            failed.push(finding.id);
+    }
+    const postfix = await runAudit({
+        primaryRoot: input.primaryRoot,
+        profile: 'fast', scope: 'all', sinceHours: 24,
+        ghBin: input.ghBin, bdBin: input.bdBin,
+        args: { profile: 'fast', scope: 'all', postfix: true },
+    });
+    const postfixId = `${deriveReportId(postfix)}-postfix`;
+    const postfixSidecarAbs = await writeSidecar(input.primaryRoot, postfix, `docs/audits/${postfixId}.json`);
+    const postfixMd = renderAuditMarkdown(postfix);
+    const postfixMdAbs = join(input.primaryRoot, `docs/audits/${postfixId}.md`);
+    mkdirSync(dirname(postfixMdAbs), { recursive: true });
+    writeFileSync(postfixMdAbs, postfixMd, { mode: 0o644 });
+    return {
+        fixed, failed,
+        postfix_markdown_path: `docs/audits/${postfixId}.md`,
+        postfix_sidecar_path: postfixSidecarAbs.replace(`${input.primaryRoot}/`, ''),
+    };
+}
+//# sourceMappingURL=fix-flow.js.map

package/dist/observability/engine/fix-flow.js.map

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

package/dist/observability/engine/fix-flow.test.d.ts

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

package/dist/observability/engine/fix-flow.test.d.ts.map

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

package/dist/observability/engine/fix-flow.test.js

@@ -0,0 +1,127 @@
+import { describe, it, expect, beforeEach, afterEach, vi } 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 { runFixFlow } from './fix-flow.js';
+function f(id, severity, lens_id) {
+    return {
+        id, lens_id, severity,
+        title: `${lens_id} finding`, description: 'd', source_doc: '',
+        evidence: { kind: 'orphan_node', graph_query: '', node_id: 'x' },
+        confidence: 'high', first_seen: '', last_seen: '', status: 'open',
+        fix_hint: { kind: 'edit_doc', target: 'docs/x.md', prompt: 'fix it' },
+    };
+}
+function makeFixtureWithFindings(findings) {
+    return {
+        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, 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: 'blocked',
+        summary: {
+            total: findings.length,
+            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: findings.length, acknowledged: 0, skipped_lenses: 0,
+        },
+    };
+}
+describe('runFixFlow', () => {
+    let proj;
+    beforeEach(() => {
+        proj = mkdtempSync(join(tmpdir(), 'observe-fix-'));
+        execSync('git init -q', { cwd: proj });
+        execSync('git config user.email t@e.com && git config user.name T', { cwd: proj, shell: '/bin/sh' });
+        mkdirSync(join(proj, 'docs'), { recursive: true });
+        writeFileSync(join(proj, 'package.json'), '{}');
+        writeFileSync(join(proj, 'docs/plan.md'), '# PRD\n## Features\n### F [priority: must]\n');
+        writeFileSync(join(proj, 'docs/user-stories.md'), '## Story s-1: T [priority: must]\n');
+        writeFileSync(join(proj, 'docs/tdd-standards.md'), '# TDD\n');
+        execSync('git add . && git commit -q -m initial', { cwd: proj, shell: '/bin/sh' });
+    });
+    afterEach(() => { rmSync(proj, { recursive: true, force: true }); });
+    it('fixes a finding when the agent succeeds and verification passes', async () => {
+        const attemptedFor = [];
+        const stubDispatcher = vi.fn(async () => ({ ok: true, exit_code: 0, elapsed_ms: 50 }));
+        const stubVerify = vi.fn(async (_proj, finding) => {
+            attemptedFor.push(finding.id);
+            return { stillPresent: false };
+        });
+        const initial = makeFixtureWithFindings([f('a', 'P0', 'A-tdd')]);
+        const result = await runFixFlow({
+            primaryRoot: proj, initial,
+            dispatcher: stubDispatcher,
+            verifier: stubVerify,
+        });
+        expect(result.fixed).toEqual(['a']);
+        expect(result.failed).toEqual([]);
+        expect(stubDispatcher).toHaveBeenCalledTimes(1);
+        expect(attemptedFor).toEqual(['a']);
+    });
+    it('retries up to 3 times per finding before declaring failure', async () => {
+        const stubDispatcher = vi.fn(async () => ({ ok: true, exit_code: 0, elapsed_ms: 50 }));
+        let verifyCalls = 0;
+        const stubVerify = vi.fn(async () => {
+            verifyCalls++;
+            return { stillPresent: true };
+        });
+        const initial = makeFixtureWithFindings([f('a', 'P0', 'A-tdd')]);
+        const result = await runFixFlow({
+            primaryRoot: proj, initial,
+            dispatcher: stubDispatcher,
+            verifier: stubVerify,
+        });
+        expect(result.fixed).toEqual([]);
+        expect(result.failed).toEqual(['a']);
+        expect(stubDispatcher).toHaveBeenCalledTimes(3);
+        expect(verifyCalls).toBe(3);
+    });
+    it('continues to the next finding after a per-finding failure', async () => {
+        const stubDispatcher = vi.fn(async () => ({ ok: true, exit_code: 0, elapsed_ms: 50 }));
+        const stubVerify = vi.fn(async (_p, fnd) => ({ stillPresent: fnd.id === 'a' }));
+        const initial = makeFixtureWithFindings([f('a', 'P0', 'A-tdd'), f('b', 'P1', 'B-ac-coverage')]);
+        const result = await runFixFlow({
+            primaryRoot: proj, initial,
+            dispatcher: stubDispatcher,
+            verifier: stubVerify,
+        });
+        expect(result.failed).toEqual(['a']);
+        expect(result.fixed).toEqual(['b']);
+    });
+    it('writes a post-fix report at docs/audits/<id>-postfix.md after the run', async () => {
+        const stubDispatcher = vi.fn(async () => ({ ok: true, exit_code: 0, elapsed_ms: 50 }));
+        const stubVerify = vi.fn(async () => ({ stillPresent: false }));
+        const initial = makeFixtureWithFindings([f('a', 'P0', 'A-tdd')]);
+        const result = await runFixFlow({
+            primaryRoot: proj, initial,
+            dispatcher: stubDispatcher,
+            verifier: stubVerify,
+        });
+        expect(result.postfix_markdown_path).toMatch(/-postfix\.md$/);
+        expect(result.postfix_sidecar_path).toMatch(/-postfix\.json$/);
+    });
+});
+//# sourceMappingURL=fix-flow.test.js.map

package/dist/observability/engine/fix-flow.test.js.map

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

package/dist/observability/engine/fix-plan.d.ts

@@ -0,0 +1,3 @@
+import type { Finding, Severity } from './types.js';
+export declare function buildFixPlan(findings: Finding[], fixThreshold: Severity): Finding[];
+//# sourceMappingURL=fix-plan.d.ts.map

package/dist/observability/engine/fix-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-plan.d.ts","sourceRoot":"","sources":["../../../src/observability/engine/fix-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAGnD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,QAAQ,GAAG,OAAO,EAAE,CASnF"}

package/dist/observability/engine/fix-plan.js

@@ -0,0 +1,13 @@
+import { severityRank } from './types.js';
+export function buildFixPlan(findings, fixThreshold) {
+    const thresholdRank = severityRank(fixThreshold);
+    return findings
+        .filter((f) => f.status === 'open' && severityRank(f.severity) <= thresholdRank)
+        .sort((a, b) => {
+        const sevDiff = severityRank(a.severity) - severityRank(b.severity);
+        if (sevDiff !== 0)
+            return sevDiff;
+        return a.lens_id < b.lens_id ? -1 : a.lens_id > b.lens_id ? 1 : 0;
+    });
+}
+//# sourceMappingURL=fix-plan.js.map

package/dist/observability/engine/fix-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-plan.js","sourceRoot":"","sources":["../../../src/observability/engine/fix-plan.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEzC,MAAM,UAAU,YAAY,CAAC,QAAmB,EAAE,YAAsB;IACtE,MAAM,aAAa,GAAG,YAAY,CAAC,YAAY,CAAC,CAAA;IAChD,OAAO,QAAQ;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC;SAC/E,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;QACnE,IAAI,OAAO,KAAK,CAAC;YAAE,OAAO,OAAO,CAAA;QACjC,OAAO,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACnE,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/observability/engine/fix-plan.test.d.ts

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

package/dist/observability/engine/fix-plan.test.d.ts.map

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

package/dist/observability/engine/fix-plan.test.js

@@ -0,0 +1,44 @@
+import { describe, it, expect } from 'vitest';
+import { buildFixPlan } from './fix-plan.js';
+function f(id, severity, lens_id, status = 'open') {
+    return {
+        id, lens_id, severity,
+        title: '', description: '', source_doc: '',
+        evidence: { kind: 'orphan_node', graph_query: '', node_id: 'x' },
+        confidence: 'high', first_seen: '', last_seen: '', status,
+    };
+}
+describe('buildFixPlan', () => {
+    it('includes blocking open findings (severityRank <= threshold)', () => {
+        const findings = [
+            f('a', 'P0', 'A-tdd'),
+            f('b', 'P1', 'B-ac-coverage'),
+            f('c', 'P2', 'C-standards'),
+            f('d', 'P3', 'D-stack'),
+        ];
+        const plan = buildFixPlan(findings, 'P2');
+        expect(plan.map((fnd) => fnd.id)).toEqual(['a', 'b', 'c']);
+    });
+    it('orders by severity (P0 first), tiebreak by lens_id', () => {
+        const findings = [
+            f('z-p1', 'P1', 'Z-zzz'),
+            f('a-p1', 'P1', 'A-tdd'),
+            f('a-p0', 'P0', 'A-tdd'),
+        ];
+        const plan = buildFixPlan(findings, 'P2');
+        expect(plan.map((fnd) => fnd.id)).toEqual(['a-p0', 'a-p1', 'z-p1']);
+    });
+    it('excludes acknowledged + skipped findings', () => {
+        const findings = [
+            f('a', 'P0', 'A-tdd', 'acknowledged'),
+            f('b', 'P1', 'B-ac-coverage', 'skipped'),
+            f('c', 'P2', 'C-standards', 'open'),
+        ];
+        const plan = buildFixPlan(findings, 'P2');
+        expect(plan.map((fnd) => fnd.id)).toEqual(['c']);
+    });
+    it('returns [] when no blocking findings exist', () => {
+        expect(buildFixPlan([f('x', 'P3', 'X')], 'P2')).toEqual([]);
+    });
+});
+//# sourceMappingURL=fix-plan.test.js.map

package/dist/observability/engine/fix-plan.test.js.map

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

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

@@ -0,0 +1,16 @@
+export interface HarvestInput {
+    primaryRoot: string;
+    worktreeRoot: string;
+}
+export declare function archiveDir(primaryRoot: string): string;
+export declare function activeArchiveFile(primaryRoot: string, worktreeId: string): string;
+export declare function harvestWorktree(input: HarvestInput): Promise<void>;
+export interface RecoverInput {
+    primaryRoot: string;
+    listWorktrees?: () => string[];
+}
+export interface RecoverResult {
+    rotated: string[];
+}
+export declare function recoverStaleArchives(input: RecoverInput): Promise<RecoverResult>;
+//# sourceMappingURL=harvester.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harvester.d.ts","sourceRoot":"","sources":["../../../src/observability/engine/harvester.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAsCxE;AAID,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,MAAM,EAAE,CAAA;CAC/B;AACD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAkBD,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CA2BtF"}