@zigrivers/scaffold 3.25.1 → 3.26.0

package/dist/observability/engine/llm-dispatcher.js

@@ -0,0 +1,183 @@
+import { spawn } from 'node:child_process';
+import { StringDecoder } from 'node:string_decoder';
+export function dispatchLlm(input) {
+    return new Promise((resolve) => {
+        let child;
+        try {
+            // detached: true puts the child in its own process group so the timeout
+            // can kill the entire subtree (wrapper scripts + child LLM processes).
+            // On Windows, 'sh' is unavailable; use cmd.exe instead.
+            const shell = process.platform === 'win32' ? 'cmd.exe' : 'sh';
+            const shellArgs = process.platform === 'win32' ? ['/d', '/s', '/c', input.command] : ['-c', input.command];
+            child = spawn(shell, shellArgs, { detached: true, stdio: ['pipe', 'pipe', 'pipe'] });
+        }
+        catch (err) {
+            resolve({ ok: false, reason: `spawn failed: ${err.message}` });
+            return;
+        }
+        let stdout = '';
+        let stderr = '';
+        let resolved = false;
+        const decoder = new StringDecoder('utf8');
+        const stderrDecoder = new StringDecoder('utf8');
+        const timer = setTimeout(() => {
+            if (resolved)
+                return;
+            resolved = true;
+            // Kill the entire process group (negated PID) so wrapper scripts and
+            // child LLM processes are all terminated, not just the sh -c parent.
+            // Negated PID is POSIX-only; Windows does not support process groups.
+            // Guard child.pid — it may be undefined if spawn failed asynchronously.
+            if (process.platform !== 'win32' && child.pid !== undefined) {
+                const pid = child.pid;
+                try {
+                    process.kill(-pid, 'SIGTERM');
+                }
+                catch { /* ignore if already gone */ }
+                setTimeout(() => { try {
+                    process.kill(-pid, 'SIGKILL');
+                }
+                catch { /* ignore */ } }, 500);
+            }
+            else {
+                try {
+                    child.kill('SIGTERM');
+                }
+                catch { /* ignore */ }
+            }
+            resolve({ ok: false, reason: `timed out after ${input.timeoutMs}ms`, raw: stdout });
+        }, input.timeoutMs);
+        child.stdout?.on('data', (chunk) => { stdout += decoder.write(chunk); });
+        child.stderr?.on('data', (chunk) => { stderr += stderrDecoder.write(chunk); });
+        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}`, raw: stdout });
+        });
+        child.on('close', (code, signal) => {
+            if (resolved)
+                return;
+            resolved = true;
+            clearTimeout(timer);
+            stdout += decoder.end();
+            stderr += stderrDecoder.end();
+            if (code !== 0 || code === null) {
+                const codeStr = code !== null ? `exit ${code}` : `signal ${signal ?? 'unknown'}`;
+                const hint = stderr.trim() ? ` — stderr: ${stderr.trim().slice(0, 200)}` : '';
+                resolve({ ok: false, reason: `subprocess ${codeStr}${hint}`, raw: stdout });
+                return;
+            }
+            // Brace-depth extraction — tolerates LLM filler text before/after the JSON block
+            try {
+                const parsed = extractJsonObject(stdout);
+                resolve({ ok: true, parsed, raw: stdout });
+            }
+            catch (err) {
+                resolve({ ok: false, reason: `JSON parse failed: ${err.message}`, raw: stdout });
+            }
+        });
+        try {
+            if (child.stdin) {
+                const flushed = child.stdin.write(input.prompt);
+                if (!flushed) {
+                    child.stdin.once('drain', () => { child.stdin?.end(); });
+                }
+                else {
+                    child.stdin.end();
+                }
+            }
+        }
+        catch (err) {
+            resolved = true;
+            clearTimeout(timer);
+            resolve({ ok: false, reason: `stdin write failed: ${err.message}` });
+        }
+    });
+}
+function extractJsonObject(text) {
+    // Fast path: try parsing the whole trimmed string first (common when LLM outputs
+    // pure JSON with no conversational preamble).
+    try {
+        return JSON.parse(text.trim());
+    }
+    catch { /* fall through to extraction */ }
+    // Extraction path: collect all top-level { or [ positions (not nested), then try
+    // from the LAST one first. This handles preamble examples: if the LLM writes
+    // "Example: { ... }. Results: { ... }", we pick the last block (results), not
+    // the first (example).
+    const starts = [];
+    let inStr = false;
+    let d = 0;
+    for (let i = 0; i < text.length; i++) {
+        const ch = text[i];
+        if (inStr) {
+            if (ch === '\\') {
+                i++;
+            }
+            else if (ch === '"') {
+                inStr = false;
+            }
+            continue;
+        }
+        if (ch === '"') {
+            inStr = true;
+        }
+        else if (ch === '{' || ch === '[') {
+            if (d === 0)
+                starts.push(i);
+            d++;
+        }
+        else if (ch === '}' || ch === ']') {
+            if (d > 0)
+                d--;
+        }
+    }
+    if (starts.length === 0)
+        throw new Error('no JSON object or array found in output');
+    // Try each top-level start from last to first.
+    // Safety: tracking only the matched open/close pair ({} or []) is sufficient.
+    // Nested arrays inside objects (or vice-versa) are balanced sub-content; they
+    // never produce a spurious depth-0 event for the outer pair. Strings are
+    // handled by the inString guard, so delimiters inside string values are skipped.
+    for (let s = starts.length - 1; s >= 0; s--) {
+        const start = starts[s];
+        const open = text[start];
+        const close = open === '{' ? '}' : ']';
+        let depth = 0;
+        let inString = false;
+        for (let i = start; i < text.length; i++) {
+            const ch = text[i];
+            if (inString) {
+                if (ch === '\\') {
+                    i++;
+                }
+                else if (ch === '"') {
+                    inString = false;
+                }
+                continue;
+            }
+            if (ch === '"') {
+                inString = true;
+            }
+            else if (ch === open) {
+                depth++;
+            }
+            else if (ch === close) {
+                depth--;
+                if (depth === 0) {
+                    try {
+                        return JSON.parse(text.slice(start, i + 1));
+                    }
+                    catch {
+                        break;
+                    }
+                }
+            }
+        }
+    }
+    throw new Error('no valid JSON found in output');
+}
+//# sourceMappingURL=llm-dispatcher.js.map

package/dist/observability/engine/llm-dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-dispatcher.js","sourceRoot":"","sources":["../../../src/observability/engine/llm-dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAYnD,MAAM,UAAU,WAAW,CAAC,KAAoB;IAC9C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,KAAK,CAAA;QACT,IAAI,CAAC;YACH,wEAAwE;YACxE,uEAAuE;YACvE,wDAAwD;YACxD,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAA;YAC7D,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;YAC1G,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAA;QACtF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAkB,GAAa,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;YACzE,OAAM;QACR,CAAC;QAED,IAAI,MAAM,GAAG,EAAE,CAAA;QACf,IAAI,MAAM,GAAG,EAAE,CAAA;QACf,IAAI,QAAQ,GAAG,KAAK,CAAA;QACpB,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAA;QACzC,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAA;QAE/C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,QAAQ;gBAAE,OAAM;YACpB,QAAQ,GAAG,IAAI,CAAA;YACf,qEAAqE;YACrE,qEAAqE;YACrE,sEAAsE;YACtE,wEAAwE;YACxE,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;gBAC5D,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAA;gBACrB,IAAI,CAAC;oBAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,4BAA4B,CAAC,CAAC;gBAC5E,UAAU,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;oBAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;YACzF,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC;oBAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YACtD,CAAC;YACD,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,KAAK,CAAC,SAAS,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAA;QACrF,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,CAAA;QAEnB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,GAAG,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;QAC/E,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,GAAG,MAAM,IAAI,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;QAErF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAA0B,EAAE,EAAE;YAC/C,IAAI,QAAQ;gBAAE,OAAM;YACpB,QAAQ,GAAG,IAAI,CAAA;YACf,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,SAAS,CAAA;YAClC,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,IAAI,MAAM,GAAG,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAA;QAC3F,CAAC,CAAC,CAAA;QAEF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YACjC,IAAI,QAAQ;gBAAE,OAAM;YACpB,QAAQ,GAAG,IAAI,CAAA;YACf,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;YACvB,MAAM,IAAI,aAAa,CAAC,GAAG,EAAE,CAAA;YAC7B,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAChC,MAAM,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,MAAM,IAAI,SAAS,EAAE,CAAA;gBAChF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,cAAc,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;gBAC7E,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,OAAO,GAAG,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAA;gBAC3E,OAAM;YACR,CAAC;YACD,iFAAiF;YACjF,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;gBACxC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAA;YAC5C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAuB,GAAa,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAA;YAC7F,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC;YACH,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;gBAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,CAAA,CAAC,CAAC,CAAC,CAAA;gBACzD,CAAC;qBAAM,CAAC;oBACN,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;gBACnB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,GAAG,IAAI,CAAA;YACf,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAwB,GAAa,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;QACjF,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY;IACrC,iFAAiF;IACjF,8CAA8C;IAC9C,IAAI,CAAC;QAAC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,gCAAgC,CAAC,CAAC;IAEjF,iFAAiF;IACjF,6EAA6E;IAC7E,8EAA8E;IAC9E,uBAAuB;IACvB,MAAM,MAAM,GAAkB,EAAE,CAAA;IAChC,IAAI,KAAK,GAAG,KAAK,CAAA;IACjB,IAAI,CAAC,GAAG,CAAC,CAAA;IACT,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QAClB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBAAC,CAAC,EAAE,CAAA;YAAC,CAAC;iBAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBAAC,KAAK,GAAG,KAAK,CAAA;YAAC,CAAC;YAC/D,SAAQ;QACV,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAAC,KAAK,GAAG,IAAI,CAAA;QAAC,CAAC;aAC3B,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAAC,CAAC,EAAE,CAAA;QAAC,CAAC;aAClE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,CAAC,EAAE,CAAA;QAAC,CAAC;IACvD,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAA;IAEnF,+CAA+C;IAC/C,8EAA8E;IAC9E,8EAA8E;IAC9E,yEAAyE;IACzE,iFAAiF;IACjF,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAc,CAAA;QACrC,MAAM,KAAK,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;QACtC,IAAI,KAAK,GAAG,CAAC,CAAA;QACb,IAAI,QAAQ,GAAG,KAAK,CAAA;QACpB,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;YAClB,IAAI,QAAQ,EAAE,CAAC;gBACb,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;oBAAC,CAAC,EAAE,CAAA;gBAAC,CAAC;qBAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;oBAAC,QAAQ,GAAG,KAAK,CAAA;gBAAC,CAAC;gBAClE,SAAQ;YACV,CAAC;YACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBAAC,QAAQ,GAAG,IAAI,CAAA;YAAC,CAAC;iBAC9B,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBAAC,KAAK,EAAE,CAAA;YAAC,CAAC;iBAC5B,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;gBACtB,KAAK,EAAE,CAAA;gBACP,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;oBAChB,IAAI,CAAC;wBAAC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;oBAAC,CAAC;oBAAC,MAAM,CAAC;wBAAC,MAAK;oBAAC,CAAC;gBACrE,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;AAClD,CAAC"}

package/dist/observability/engine/llm-dispatcher.test.d.ts

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

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

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

package/dist/observability/engine/llm-dispatcher.test.js

@@ -0,0 +1,109 @@
+import { describe, it, expect } from 'vitest';
+import { dispatchLlm } from './llm-dispatcher.js';
+describe('dispatchLlm', () => {
+    it('returns ok=true with parsed JSON when subprocess emits valid JSON on stdout', async () => {
+        const result = await dispatchLlm({
+            prompt: 'irrelevant',
+            command: 'cat >/dev/null; printf \'%s\' \'{"answer": "yes", "findings": []}\'',
+            timeoutMs: 5000,
+        });
+        expect(result.ok).toBe(true);
+        if (result.ok)
+            expect(result.parsed).toEqual({ answer: 'yes', findings: [] });
+    });
+    it('returns ok=false with a parse error when stdout is not JSON', async () => {
+        const result = await dispatchLlm({
+            prompt: 'irrelevant',
+            command: 'cat >/dev/null; printf not-json',
+            timeoutMs: 5000,
+        });
+        expect(result.ok).toBe(false);
+        if (!result.ok)
+            expect(result.reason).toMatch(/parse|JSON/i);
+    });
+    it('returns ok=false with timeout when subprocess exceeds timeoutMs', async () => {
+        const result = await dispatchLlm({
+            prompt: 'irrelevant',
+            command: 'sleep 5',
+            timeoutMs: 100,
+        });
+        expect(result.ok).toBe(false);
+        if (!result.ok)
+            expect(result.reason).toMatch(/timeout|timed out/i);
+    });
+    it('passes the prompt to subprocess stdin', async () => {
+        const result = await dispatchLlm({
+            prompt: 'echo back',
+            command: 'read -r line; printf \'{"received":"%s"}\' "$line"',
+            timeoutMs: 5000,
+        });
+        expect(result.ok).toBe(true);
+        if (result.ok)
+            expect(result.parsed.received).toBe('echo back');
+    });
+    it('returns ok=false when the binary is missing', async () => {
+        const result = await dispatchLlm({
+            prompt: 'irrelevant',
+            command: '/no/such/binary',
+            timeoutMs: 5000,
+        });
+        expect(result.ok).toBe(false);
+        if (!result.ok)
+            expect(result.reason).toMatch(/ENOENT|not found|spawn|exit|error/i);
+    });
+    it('handles objects containing nested arrays (mixed delimiters) correctly', async () => {
+        // Verifies that tracking only {/} or [/] per top-level block is sufficient:
+        // inner [1,2] brackets are balanced content and never produce spurious depth=0 events.
+        const json = '{"findings":[[{"id":"x","v":1}],[{"id":"y"}]]}';
+        const result = await dispatchLlm({
+            prompt: 'irrelevant',
+            command: `cat >/dev/null; printf '%s' '${json}'`,
+            timeoutMs: 5000,
+        });
+        expect(result.ok).toBe(true);
+        if (result.ok) {
+            const parsed = result.parsed;
+            expect(parsed.findings).toHaveLength(2);
+        }
+    });
+    it('extracts the LAST JSON block when output has preamble JSON before the real result', async () => {
+        // LLMs sometimes emit an example block before the real answer, e.g.:
+        //   "Example: {"findings":[...fake...]}. Results: {"findings":[...real...]}"
+        // extractJsonObject must return the LAST top-level block, not the first.
+        const preamble = 'Example: {"findings":["fake"]}. Here is the real output:';
+        const real = '{"findings":[],"answer":"real"}';
+        const combined = `${preamble} ${real}`;
+        const result = await dispatchLlm({
+            prompt: 'irrelevant',
+            command: `cat >/dev/null; printf '%s' '${combined}'`,
+            timeoutMs: 5000,
+        });
+        expect(result.ok).toBe(true);
+        if (result.ok)
+            expect(result.parsed).toEqual({ findings: [], answer: 'real' });
+    });
+    it('kills entire process group on timeout — backgrounded child does not outlive timeout', async () => {
+        // The command backgrounds a subshell that writes a marker file after 400ms.
+        // Timeout fires at 100ms. Without process-group kill, only the sh parent dies and
+        // the backgrounded sleep survives to create the file. With process-group kill, the
+        // entire subtree is killed and the file is never created.
+        const os = await import('node:os');
+        const path = await import('node:path');
+        const fs = await import('node:fs');
+        const markerFile = path.join(os.tmpdir(), `disp-pg-${process.pid}.marker`);
+        if (fs.existsSync(markerFile))
+            fs.unlinkSync(markerFile);
+        await dispatchLlm({
+            prompt: 'irrelevant',
+            command: `(sleep 0.4 && touch ${markerFile}) &`,
+            timeoutMs: 100,
+        });
+        // Wait 700ms — enough for the background sleep to have fired if it survived
+        await new Promise((r) => setTimeout(r, 700));
+        const survived = fs.existsSync(markerFile);
+        if (survived)
+            fs.unlinkSync(markerFile);
+        expect(survived).toBe(false);
+    });
+});
+//# sourceMappingURL=llm-dispatcher.test.js.map

package/dist/observability/engine/llm-dispatcher.test.js.map

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

package/dist/observability/engine/phase-audit.d.ts

@@ -0,0 +1,22 @@
+export interface RunPhaseAuditInput {
+    primaryRoot: string;
+    step: string;
+    ghBin?: string;
+    bdBin?: string;
+}
+export interface PhaseAuditResult {
+    ran: boolean;
+    step: string;
+    reason?: string;
+    verdict?: string;
+    findings_count?: number;
+    blocking_count?: number;
+    markdown_path?: string;
+    sidecar_path?: string;
+    timed_out?: boolean;
+    detached?: boolean;
+    elapsed_ms?: number;
+}
+export declare function runPhaseAudit(input: RunPhaseAuditInput): Promise<PhaseAuditResult>;
+export declare function formatPhaseAuditLine(r: PhaseAuditResult): string;
+//# sourceMappingURL=phase-audit.d.ts.map

package/dist/observability/engine/phase-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-audit.d.ts","sourceRoot":"","sources":["../../../src/observability/engine/phase-audit.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,OAAO,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAkCD,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAqDxF;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAMhE"}

package/dist/observability/engine/phase-audit.js

@@ -0,0 +1,98 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { runAudit } from './api.js';
+import { writeSidecar, deriveReportId } from '../renderers/sidecar.js';
+import { renderAuditMarkdown } from '../renderers/markdown.js';
+import { isPhaseBoundary, phaseLabel } from './phase-subsets.js';
+import { loadObservabilityConfig } from './checks/observability-config.js';
+function raceTimeout(promise, ms) {
+    if (ms <= 0) {
+        const timedOut = { value: undefined, timed_out: true };
+        return Promise.resolve(timedOut);
+    }
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => resolve({ value: undefined, timed_out: true }), ms);
+        promise.then((value) => {
+            clearTimeout(timer);
+            resolve({ value, timed_out: false });
+        }).catch(() => {
+            clearTimeout(timer);
+            resolve({ value: undefined, timed_out: true });
+        });
+    });
+}
+async function persistAudit(primaryRoot, out) {
+    const reportId = deriveReportId(out);
+    const sidecarAbs = await writeSidecar(primaryRoot, out);
+    const sidecarRel = sidecarAbs.replace(`${primaryRoot}/`, '');
+    const md = renderAuditMarkdown(out);
+    const mdRel = `docs/audits/${reportId}.md`;
+    const mdAbs = join(primaryRoot, mdRel);
+    mkdirSync(dirname(mdAbs), { recursive: true });
+    writeFileSync(mdAbs, md, { mode: 0o644 });
+    return { mdRel, sidecarRel };
+}
+export async function runPhaseAudit(input) {
+    const config = loadObservabilityConfig(input.primaryRoot);
+    if (!config.phase_audit.enabled) {
+        return { ran: false, step: input.step, reason: 'phase_audit disabled in observability.yaml' };
+    }
+    if (!isPhaseBoundary(input.step)) {
+        return { ran: false, step: input.step, reason: `${input.step} is not a phase boundary` };
+    }
+    const auditArgs = {
+        primaryRoot: input.primaryRoot,
+        profile: 'fast',
+        scope: 'docs',
+        sinceHours: 24,
+        lensIds: ['H-cross-doc'],
+        ghBin: input.ghBin,
+        bdBin: input.bdBin,
+        args: { triggered_by: 'phase-boundary', step: input.step, phase_label: phaseLabel(input.step) },
+    };
+    if (config.phase_audit.detached) {
+        void runAudit(auditArgs).then(async (out) => {
+            try {
+                await persistAudit(input.primaryRoot, out);
+            }
+            catch (err) {
+                if (process.env.PHASE_AUDIT_DEBUG === '1') {
+                    process.stderr.write(`detached phase-audit failed: ${err.message}\n`);
+                }
+            }
+        });
+        return { ran: true, step: input.step, detached: true, elapsed_ms: 0 };
+    }
+    const started = Date.now();
+    const raced = await raceTimeout(runAudit(auditArgs), config.phase_audit.timeout_s * 1000);
+    if (raced.timed_out) {
+        return {
+            ran: true, step: input.step, timed_out: true, elapsed_ms: Date.now() - started,
+            reason: `audit exceeded ${config.phase_audit.timeout_s}s budget`,
+        };
+    }
+    const out = raced.value;
+    const { mdRel, sidecarRel } = await persistAudit(input.primaryRoot, out);
+    return {
+        ran: true,
+        step: input.step,
+        verdict: out.verdict,
+        findings_count: out.summary.total,
+        blocking_count: out.summary.blocking,
+        markdown_path: mdRel,
+        sidecar_path: sidecarRel,
+        timed_out: false,
+        elapsed_ms: Date.now() - started,
+    };
+}
+export function formatPhaseAuditLine(r) {
+    if (!r.ran)
+        return '';
+    if (r.detached)
+        return `[audit] dispatched in background (step: ${r.step})`;
+    if (r.timed_out)
+        return `[audit] timed out after ${r.elapsed_ms}ms — partial findings may not be written`;
+    const summary = `${r.findings_count} findings (${r.blocking_count ?? 0} blocking, verdict=${r.verdict})`;
+    return `[audit] ${summary} — see ${r.markdown_path}`;
+}
+//# sourceMappingURL=phase-audit.js.map

package/dist/observability/engine/phase-audit.js.map

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

package/dist/observability/engine/phase-audit.test.d.ts

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

package/dist/observability/engine/phase-audit.test.d.ts.map

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

package/dist/observability/engine/phase-audit.test.js

@@ -0,0 +1,82 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, rmSync, mkdirSync, writeFileSync, existsSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+import { runPhaseAudit, formatPhaseAuditLine } from './phase-audit.js';
+describe('runPhaseAudit', () => {
+    let proj;
+    beforeEach(() => {
+        proj = mkdtempSync(join(tmpdir(), 'observe-phase-'));
+        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\n### AC 1: t\nGiven X.\n');
+    });
+    afterEach(() => { rmSync(proj, { recursive: true, force: true }); });
+    it('produces a phase-audit result with the count, sidecar path, and verdict', async () => {
+        const result = await runPhaseAudit({ primaryRoot: proj, step: 'user-stories' });
+        expect(result.ran).toBe(true);
+        expect(result.step).toBe('user-stories');
+        expect(typeof result.findings_count).toBe('number');
+        expect(typeof result.verdict).toBe('string');
+        expect(result.markdown_path).toMatch(/docs\/audits\/audit-.*\.md$/);
+        expect(result.sidecar_path).toMatch(/docs\/audits\/audit-.*\.json$/);
+        expect(existsSync(join(proj, result.markdown_path))).toBe(true);
+        expect(existsSync(join(proj, result.sidecar_path))).toBe(true);
+    });
+    it('returns ran=false when phase_audit.enabled=false in observability.yaml', async () => {
+        mkdirSync(join(proj, '.scaffold'), { recursive: true });
+        writeFileSync(join(proj, '.scaffold/observability.yaml'), 'phase_audit:\n  enabled: false\n');
+        const result = await runPhaseAudit({ primaryRoot: proj, step: 'user-stories' });
+        expect(result.ran).toBe(false);
+        expect(result.reason).toMatch(/disabled/i);
+    });
+    it('returns ran=false for steps that are not phase boundaries', async () => {
+        const result = await runPhaseAudit({ primaryRoot: proj, step: 'arbitrary-step' });
+        expect(result.ran).toBe(false);
+        expect(result.reason).toMatch(/not a phase boundary/i);
+    });
+    it('aborts and returns timed_out when the audit exceeds phase_audit.timeout_s', async () => {
+        mkdirSync(join(proj, '.scaffold'), { recursive: true });
+        writeFileSync(join(proj, '.scaffold/observability.yaml'), 'phase_audit:\n  timeout_s: 0\n');
+        const result = await runPhaseAudit({ primaryRoot: proj, step: 'user-stories' });
+        expect(result.ran).toBe(true);
+        expect(result.timed_out).toBe(true);
+    });
+    it('returns immediately with detached=true when phase_audit.detached=true', async () => {
+        mkdirSync(join(proj, '.scaffold'), { recursive: true });
+        writeFileSync(join(proj, '.scaffold/observability.yaml'), 'phase_audit:\n  detached: true\n');
+        const start = Date.now();
+        const result = await runPhaseAudit({ primaryRoot: proj, step: 'user-stories' });
+        const elapsed = Date.now() - start;
+        expect(result.ran).toBe(true);
+        expect(result.detached).toBe(true);
+        expect(elapsed).toBeLessThan(500);
+    });
+});
+describe('formatPhaseAuditLine (Plan 6)', () => {
+    it('returns empty string when ran=false', () => {
+        expect(formatPhaseAuditLine({ ran: false, step: 'user-stories' })).toBe('');
+    });
+    it('prints "[audit] dispatched" for detached results', () => {
+        const line = formatPhaseAuditLine({ ran: true, step: 'user-stories', detached: true });
+        expect(line).toMatch(/dispatched/i);
+    });
+    it('prints timed out message for timed_out results', () => {
+        const line = formatPhaseAuditLine({ ran: true, step: 'user-stories', timed_out: true, elapsed_ms: 5000 });
+        expect(line).toMatch(/timed out/i);
+    });
+    it('prints findings count and path for normal results', () => {
+        const line = formatPhaseAuditLine({
+            ran: true, step: 'user-stories', verdict: 'pass', findings_count: 3, blocking_count: 0,
+            markdown_path: 'docs/audits/audit-x.md', timed_out: false,
+        });
+        expect(line).toContain('[audit]');
+        expect(line).toContain('3 findings');
+        expect(line).toContain('docs/audits/audit-x.md');
+    });
+});
+//# sourceMappingURL=phase-audit.test.js.map

package/dist/observability/engine/phase-audit.test.js.map

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

package/dist/observability/engine/phase-subsets.d.ts

@@ -0,0 +1,5 @@
+export declare const PHASE_BOUNDARY_STEPS: readonly ["user-stories", "tech-stack", "coding-standards", "design-system", "implementation-plan", "implementation-playbook"];
+export type PhaseBoundaryStep = typeof PHASE_BOUNDARY_STEPS[number];
+export declare function isPhaseBoundary(slug: string): slug is PhaseBoundaryStep;
+export declare function phaseLabel(slug: PhaseBoundaryStep): string;
+//# sourceMappingURL=phase-subsets.d.ts.map

package/dist/observability/engine/phase-subsets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-subsets.d.ts","sourceRoot":"","sources":["../../../src/observability/engine/phase-subsets.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,gIAOvB,CAAA;AAEV,MAAM,MAAM,iBAAiB,GAAG,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAA;AAWnE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,iBAAiB,CAEvE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAE1D"}

package/dist/observability/engine/phase-subsets.js

@@ -0,0 +1,23 @@
+export const PHASE_BOUNDARY_STEPS = [
+    'user-stories',
+    'tech-stack',
+    'coding-standards',
+    'design-system',
+    'implementation-plan',
+    'implementation-playbook',
+];
+const PHASE_LABELS = {
+    'user-stories': 'after user stories',
+    'tech-stack': 'after tech stack',
+    'coding-standards': 'after coding standards',
+    'design-system': 'after design system',
+    'implementation-plan': 'after implementation plan',
+    'implementation-playbook': 'after implementation playbook',
+};
+export function isPhaseBoundary(slug) {
+    return PHASE_BOUNDARY_STEPS.includes(slug);
+}
+export function phaseLabel(slug) {
+    return PHASE_LABELS[slug];
+}
+//# sourceMappingURL=phase-subsets.js.map

package/dist/observability/engine/phase-subsets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-subsets.js","sourceRoot":"","sources":["../../../src/observability/engine/phase-subsets.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,cAAc;IACd,YAAY;IACZ,kBAAkB;IAClB,eAAe;IACf,qBAAqB;IACrB,yBAAyB;CACjB,CAAA;AAIV,MAAM,YAAY,GAAsC;IACtD,cAAc,EAAE,oBAAoB;IACpC,YAAY,EAAE,kBAAkB;IAChC,kBAAkB,EAAE,wBAAwB;IAC5C,eAAe,EAAE,qBAAqB;IACtC,qBAAqB,EAAE,2BAA2B;IAClD,yBAAyB,EAAE,+BAA+B;CAC3D,CAAA;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAQ,oBAA0C,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;AACnE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAuB;IAChD,OAAO,YAAY,CAAC,IAAI,CAAC,CAAA;AAC3B,CAAC"}

package/dist/observability/engine/phase-subsets.test.d.ts

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

package/dist/observability/engine/phase-subsets.test.d.ts.map

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

package/dist/observability/engine/phase-subsets.test.js

@@ -0,0 +1,24 @@
+import { describe, it, expect } from 'vitest';
+import { PHASE_BOUNDARY_STEPS, isPhaseBoundary, phaseLabel } from './phase-subsets.js';
+describe('phase-subsets', () => {
+    it('isPhaseBoundary returns true for spec §3.9 boundary steps', () => {
+        const boundarySlugs = [
+            'user-stories', 'tech-stack', 'coding-standards',
+            'design-system', 'implementation-plan', 'implementation-playbook',
+        ];
+        for (const slug of boundarySlugs) {
+            expect(isPhaseBoundary(slug), `slug: ${slug}`).toBe(true);
+        }
+    });
+    it('isPhaseBoundary returns false for non-boundary steps', () => {
+        expect(isPhaseBoundary('create-prd')).toBe(false);
+        expect(isPhaseBoundary('arbitrary-step')).toBe(false);
+    });
+    it('PHASE_BOUNDARY_STEPS includes a label for each entry', () => {
+        for (const slug of PHASE_BOUNDARY_STEPS) {
+            expect(typeof phaseLabel(slug)).toBe('string');
+            expect(phaseLabel(slug).length).toBeGreaterThan(0);
+        }
+    });
+});
+//# sourceMappingURL=phase-subsets.test.js.map

package/dist/observability/engine/phase-subsets.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-subsets.test.js","sourceRoot":"","sources":["../../../src/observability/engine/phase-subsets.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEtF,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,aAAa,GAAG;YACpB,cAAc,EAAE,YAAY,EAAE,kBAAkB;YAChD,eAAe,EAAE,qBAAqB,EAAE,yBAAyB;SAClE,CAAA;QACD,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC3D,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACjD,MAAM,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,KAAK,MAAM,IAAI,IAAI,oBAAoB,EAAE,CAAC;YACxC,MAAM,CAAC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAC9C,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;QACpD,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}