gsd-pi 2.79.0 → 2.80.0

package/dist/resources/extensions/gsd/uok/loop-adapter.js

@@ -1,3 +1,5 @@
+// GSD2 UOK Turn Observer and DB-Backed Lifecycle Emission
+import { CURRENT_UOK_CONTRACT_VERSION, validateTurnResult } from "./contracts.js";
 import { buildAuditEnvelope, emitUokAuditEvent } from "./audit.js";
 import { writeTurnCloseoutGitRecord, writeTurnGitTransaction } from "./gitops.js";
 import { acquireWriterToken, nextWriteRecord, releaseWriterToken } from "./writer.js";
@@ -115,46 +117,59 @@ export function createTurnObserver(options) {
             }
         },
         onTurnResult(result) {
-            const merged = {
-                ...result,
-                phaseResults: result.phaseResults.length > 0 ? result.phaseResults : [...phaseResults],
+            const cleanup = () => {
+                if (writerToken) {
+                    releaseWriterToken(options.basePath, writerToken);
+                }
+                writerToken = null;
+                current = null;
+                phaseResults.length = 0;
             };
-            if (options.enableAudit) {
-                emitUokAuditEvent(options.basePath, buildAuditEnvelope({
-                    traceId: merged.traceId,
-                    turnId: merged.turnId,
-                    category: "orchestration",
-                    type: "turn-result",
-                    payload: nextSequenceMetadata("audit", "append", {
+            try {
+                const merged = {
+                    ...result,
+                    version: CURRENT_UOK_CONTRACT_VERSION,
+                    phaseResults: Array.isArray(result.phaseResults) && result.phaseResults.length > 0 ? result.phaseResults : [...phaseResults],
+                };
+                const validation = validateTurnResult(merged);
+                if (!validation.ok) {
+                    throw new Error(`Invalid UOK turn result: ${validation.issues.map((issue) => `${issue.path}: ${issue.message}`).join("; ")}`);
+                }
+                if (options.enableAudit) {
+                    emitUokAuditEvent(options.basePath, buildAuditEnvelope({
+                        traceId: validation.value.traceId,
+                        turnId: validation.value.turnId,
+                        category: "orchestration",
+                        type: "turn-result",
+                        payload: nextSequenceMetadata("audit", "append", {
+                            contractVersion: validation.value.version,
+                            unitType: validation.value.unitType,
+                            unitId: validation.value.unitId,
+                            status: validation.value.status,
+                            failureClass: validation.value.failureClass,
+                            error: validation.value.error,
+                            phaseCount: validation.value.phaseResults.length,
+                        }),
+                    }));
+                }
+                if (options.enableGitops) {
+                    const closeout = merged.closeout ?? {
+                        traceId: merged.traceId,
+                        turnId: merged.turnId,
                         unitType: merged.unitType,
                         unitId: merged.unitId,
                         status: merged.status,
                         failureClass: merged.failureClass,
-                        error: merged.error,
-                        phaseCount: merged.phaseResults.length,
-                    }),
-                }));
+                        gitAction: options.gitAction,
+                        gitPushed: options.gitPush,
+                        finishedAt: merged.finishedAt,
+                    };
+                    writeTurnCloseoutGitRecord(options.basePath, closeout, nextSequenceMetadata("gitops", "update", { action: "record" }));
+                }
             }
-            if (options.enableGitops) {
-                const closeout = merged.closeout ?? {
-                    traceId: merged.traceId,
-                    turnId: merged.turnId,
-                    unitType: merged.unitType,
-                    unitId: merged.unitId,
-                    status: merged.status,
-                    failureClass: merged.failureClass,
-                    gitAction: options.gitAction,
-                    gitPushed: options.gitPush,
-                    finishedAt: merged.finishedAt,
-                };
-                writeTurnCloseoutGitRecord(options.basePath, closeout, nextSequenceMetadata("gitops", "update", { action: "record" }));
+            finally {
+                cleanup();
             }
-            if (writerToken) {
-                releaseWriterToken(options.basePath, writerToken);
-            }
-            writerToken = null;
-            current = null;
-            phaseResults.length = 0;
         },
     };
 }

package/dist/resources/extensions/gsd/uok/timeline.js

@@ -0,0 +1,125 @@
+// GSD2 UOK Timeline Reconstruction from Authoritative DB Records
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { _getAdapter, isDbAvailable } from "../gsd-db.js";
+import { gsdRoot } from "../paths.js";
+function parseJsonRecord(value) {
+    if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+        return value;
+    }
+    if (typeof value !== "string" || value.trim() === "")
+        return {};
+    try {
+        const parsed = JSON.parse(value);
+        return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)
+            ? parsed
+            : {};
+    }
+    catch {
+        return {};
+    }
+}
+function matchesFilter(entry, filter) {
+    if (filter.traceId && entry.traceId !== filter.traceId)
+        return false;
+    if (filter.turnId && entry.turnId !== filter.turnId)
+        return false;
+    return true;
+}
+function byTimestamp(a, b) {
+    return a.ts.localeCompare(b.ts);
+}
+function readDbTimeline(filter) {
+    const db = _getAdapter();
+    if (!db)
+        return [];
+    const entries = [];
+    const where = [];
+    const params = {};
+    if (filter.traceId) {
+        where.push("trace_id = :trace_id");
+        params[":trace_id"] = filter.traceId;
+    }
+    if (filter.turnId) {
+        where.push("turn_id = :turn_id");
+        params[":turn_id"] = filter.turnId;
+    }
+    const suffix = where.length > 0 ? ` WHERE ${where.join(" AND ")}` : "";
+    const auditRows = db.prepare(`SELECT trace_id, turn_id, type, ts, payload_json FROM audit_events${suffix}`).all(params);
+    for (const row of auditRows) {
+        entries.push({
+            source: "audit_events",
+            ts: row.ts,
+            traceId: row.trace_id,
+            turnId: row.turn_id,
+            type: row.type,
+            payload: parseJsonRecord(row.payload_json),
+        });
+    }
+    const dispatchRows = db.prepare(`SELECT trace_id, turn_id, unit_type, unit_id, status, started_at, ended_at, exit_reason,
+            error_summary, retry_after_ms, attempt_n, max_attempts
+     FROM unit_dispatches${suffix}`).all(params);
+    for (const row of dispatchRows) {
+        entries.push({
+            source: "unit_dispatches",
+            ts: String(row.ended_at ?? row.started_at ?? ""),
+            traceId: String(row.trace_id ?? ""),
+            turnId: typeof row.turn_id === "string" ? row.turn_id : null,
+            type: `dispatch-${String(row.status ?? "unknown")}`,
+            payload: { ...row },
+        });
+    }
+    const gitRows = db.prepare(`SELECT trace_id, turn_id, unit_type, unit_id, stage, action, push, status, error,
+            metadata_json, updated_at
+     FROM turn_git_transactions${suffix}`).all(params);
+    for (const row of gitRows) {
+        entries.push({
+            source: "turn_git_transactions",
+            ts: String(row.updated_at ?? ""),
+            traceId: String(row.trace_id ?? ""),
+            turnId: typeof row.turn_id === "string" ? row.turn_id : null,
+            type: `gitops-${String(row.stage ?? "unknown")}`,
+            payload: {
+                ...row,
+                metadata: parseJsonRecord(row.metadata_json),
+            },
+        });
+    }
+    return entries.filter((entry) => entry.ts !== "").sort(byTimestamp);
+}
+function readJsonlTimeline(basePath, filter) {
+    const path = join(gsdRoot(basePath), "audit", "events.jsonl");
+    if (!existsSync(path))
+        return [];
+    return readFileSync(path, "utf-8")
+        .split("\n")
+        .filter(Boolean)
+        .map((line) => {
+        const event = parseJsonRecord(line);
+        const entry = {
+            source: "audit_jsonl",
+            ts: String(event.ts ?? ""),
+            traceId: typeof event.traceId === "string" ? event.traceId : undefined,
+            turnId: typeof event.turnId === "string" ? event.turnId : null,
+            type: String(event.type ?? "audit"),
+            payload: parseJsonRecord(event.payload),
+        };
+        return entry.ts && matchesFilter(entry, filter) ? entry : null;
+    })
+        .filter((entry) => entry !== null)
+        .sort(byTimestamp);
+}
+export function buildTurnTimeline(basePath, filter = {}) {
+    if (isDbAvailable()) {
+        return {
+            authoritative: "db",
+            degraded: false,
+            entries: readDbTimeline(filter),
+        };
+    }
+    return {
+        authoritative: "degraded-fallback",
+        degraded: true,
+        entries: readJsonlTimeline(basePath, filter),
+    };
+}

package/dist/resources/extensions/shared/gsd-phase-state.js

@@ -1,29 +1,71 @@
 /**
- * GSD Phase State — cross-extension coordination
+ * GSD2 Phase State — cross-extension coordination
  * Copyright (c) 2026 Jeremy McSpadden <jeremy@fluxlabs.net>
  *
  * Lightweight module-level state that GSD auto-mode writes to and the
  * subagent tool reads from. Both extensions run in the same process so
  * a module variable is sufficient — no file I/O needed.
  */
+import { buildAuditEnvelope, emitUokAuditEvent } from "../gsd/uok/audit.js";
 let _active = false;
 let _currentPhase = null;
+let _auditContext = null;
+function emitPhaseChange(action, previousPhase, nextPhase) {
+    if (!_auditContext)
+        return;
+    emitUokAuditEvent(_auditContext.basePath, buildAuditEnvelope({
+        traceId: _auditContext.traceId,
+        turnId: _auditContext.turnId,
+        causedBy: _auditContext.causedBy,
+        category: "orchestration",
+        type: "phase_changed",
+        payload: {
+            action,
+            active: _active,
+            previousPhase,
+            nextPhase,
+        },
+    }));
+}
+export function configureGSDPhaseAudit(context) {
+    _auditContext = context;
+}
 /** Mark GSD auto-mode as active. */
-export function activateGSD() {
+export function activateGSD(context) {
+    if (context)
+        _auditContext = context;
+    const previousPhase = _currentPhase;
     _active = true;
+    emitPhaseChange("activate", previousPhase, _currentPhase);
 }
 /** Mark GSD auto-mode as inactive and clear the current phase. */
 export function deactivateGSD() {
+    const previousPhase = _currentPhase;
     _active = false;
     _currentPhase = null;
+    emitPhaseChange("deactivate", previousPhase, _currentPhase);
+    _auditContext = null;
 }
 /** Set the currently dispatched GSD phase (e.g. "plan-milestone"). */
-export function setCurrentPhase(phase) {
+export function setCurrentPhase(phase, context) {
+    if (context)
+        _auditContext = context;
+    if (!_active) {
+        process.emitWarning(`Ignoring GSD phase "${phase}" while GSD auto-mode is inactive`, {
+            code: "GSD_PHASE_INACTIVE",
+        });
+        return false;
+    }
+    const previousPhase = _currentPhase;
     _currentPhase = phase;
+    emitPhaseChange("set", previousPhase, _currentPhase);
+    return true;
 }
 /** Clear the current phase (unit completed or aborted). */
 export function clearCurrentPhase() {
+    const previousPhase = _currentPhase;
     _currentPhase = null;
+    emitPhaseChange("clear", previousPhase, _currentPhase);
 }
 /** Returns true if GSD auto-mode is currently active. */
 export function isGSDActive() {

package/dist/resources/extensions/shared/interview-ui.js

@@ -1,3 +1,4 @@
+// GSD2 — Shared interview round UI widget
 /**
  * Shared interview round UI widget.
  *
@@ -128,14 +129,24 @@ export async function showInterviewRound(questions, opts, ctx) {
         let showingExitConfirm = false;
         let exitCursor = 0; // 0 = keep going (default), 1 = end interview
         let cachedLines;
+        let completed = false;
+        let removeAbortListener;
+        function finish(result) {
+            if (completed)
+                return;
+            completed = true;
+            removeAbortListener?.();
+            done(result);
+        }
         // External cancellation (e.g. remote channel won the race)
         if (opts.signal) {
-            const onAbort = () => done({ endInterview: false, answers: {} });
+            const onAbort = () => finish({ endInterview: false, answers: {} });
             if (opts.signal.aborted) {
                 onAbort();
             }
             else {
                 opts.signal.addEventListener("abort", onAbort, { once: true });
+                removeAbortListener = () => opts.signal?.removeEventListener("abort", onAbort);
             }
         }
         // Editor is created once; editorTheme comes from the design system
@@ -212,7 +223,7 @@ export async function showInterviewRound(questions, opts, ctx) {
         }
         function submit() {
             saveEditorToState();
-            done(buildResult());
+            finish(buildResult());
         }
         function goNextOrSubmit() {
             if (!isMultiSelect(currentIdx)) {
@@ -267,7 +278,7 @@ export async function showInterviewRound(questions, opts, ctx) {
                     return;
                 }
                 if (data === "2") {
-                    done({ endInterview: false, answers: {} });
+                    finish({ endInterview: false, answers: {} });
                     return;
                 }
                 if (matchesKey(data, Key.enter) || matchesKey(data, Key.space)) {
@@ -276,7 +287,7 @@ export async function showInterviewRound(questions, opts, ctx) {
                         refresh();
                     }
                     else {
-                        done({ endInterview: false, answers: {} });
+                        finish({ endInterview: false, answers: {} });
                     }
                     return;
                 }