@yagni-app/code-staging 0.3.2-staging.1119.1 → 0.3.2-staging.1120.1

package/dist/extension/index.js

@@ -20,6 +20,7 @@ import { registerCostCommand } from "./costHud.js";
 import { isDebug } from "./diagnostics.js";
 import { droppedSessionRuns, sessionRunIds } from "./sessionRuns.js";
 import { codeStateHome } from "./stateHome.js";
+import { logTurnLifecycle } from "./turnLog.js";
 import { createYagniFooterFactory, cyclePermissionMode, formatCwd, GIT_MUTATING_PATTERN, isShiftTab } from "./footer.js";
 import { RerouteNotifier } from "./rerouteNotice.js";
 import { isFreshWorkspace, registerTeamSetupCommand, runInitPass as defaultRunInitPass } from "./initPass.js";
@@ -581,6 +582,28 @@ export async function registerYagni(pi, deps = {}) {
                 rulesSection,
             }),
         });
+    // Turn-lifecycle WAL: a `turn_start` with no matching `turn_end` is the
+    // silent-freeze tell (the turn that left the UI stuck on "Working…"), even
+    // if the process is later killed. `turn_end` records the final stopReason so
+    // an `error` / `aborted` end is visible at a glance without reading the raw
+    // session .jsonl. Fail-soft; nothing here may break a turn.
+    const turnStartMs = new Map();
+    const sessionIdForLog = () => deps.env?.YAGNI_SESSION_ID;
+    pi.on("turn_start", (event) => {
+        turnStartMs.set(event.turnIndex, Date.now());
+        logTurnLifecycle({ kind: "turn_start", sessionId: sessionIdForLog(), turnIndex: event.turnIndex });
+    });
+    pi.on("turn_end", (event) => {
+        const startedAt = turnStartMs.get(event.turnIndex);
+        turnStartMs.delete(event.turnIndex);
+        logTurnLifecycle({
+            kind: "turn_end",
+            sessionId: sessionIdForLog(),
+            turnIndex: event.turnIndex,
+            stopReason: event.message?.stopReason,
+            elapsedMs: startedAt !== undefined ? Date.now() - startedAt : undefined,
+        });
+    });
     // Two finalized-message guards share this handler (their conditions are
     // mutually exclusive: YAG-460 takes error-stopped messages, YAG-466 takes
     // stop/length ones without an errorMessage).

package/dist/extension/turnLog.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Client-side turn-lifecycle log — makes a "stuck on Working…" turn legible
+ * without spelunking the raw session `.jsonl`.
+ *
+ * A session write-only WAL, not a buffered in-memory structure: the whole
+ * point is that a turn which STARTS but never ENDS (the silent-freeze failure
+ * this log exists to catch) still leaves a `turn_start` record with no
+ * matching `turn_end`, even if the process is later killed. Each record is a
+ * single sanitized JSON line (no message content, tokens, or tool payloads —
+ * only a timestamp, the session id, a stable event name, and the turn's final
+ * stop reason / error class when it ends). Follows `diagnostics.ts` exactly:
+ * rotating file under `~/.yagni-code/logs/`, fail-soft, hermetic under
+ * `node --test`.
+ */
+export declare function _setTurnLogHomeForTest(dir: string | null): void;
+export declare function turnLogPath(): string;
+export type TurnLifecycleEvent = {
+    kind: "turn_start";
+    sessionId?: string;
+    turnIndex?: number;
+} | {
+    kind: "turn_end";
+    sessionId?: string;
+    turnIndex?: number;
+    /** The fixed stopReason enum from the final assistant message — never a raw error message. */
+    stopReason?: string;
+    /** Time since the matching turn_start, ms. */
+    elapsedMs?: number;
+};
+/**
+ * Append one sanitized lifecycle record. Fail-soft — a logging failure must
+ * never break the turn. `errorClass` is a caller-mapped category, never a
+ * raw error message.
+ */
+export declare function logTurnLifecycle(ev: TurnLifecycleEvent): void;
+/** List existing lifecycle log files (active + rotations), for a report. */
+export declare function listTurnLogFiles(): string[];
+//# sourceMappingURL=turnLog.d.ts.map

package/dist/extension/turnLog.js

@@ -0,0 +1,93 @@
+/**
+ * Client-side turn-lifecycle log — makes a "stuck on Working…" turn legible
+ * without spelunking the raw session `.jsonl`.
+ *
+ * A session write-only WAL, not a buffered in-memory structure: the whole
+ * point is that a turn which STARTS but never ENDS (the silent-freeze failure
+ * this log exists to catch) still leaves a `turn_start` record with no
+ * matching `turn_end`, even if the process is later killed. Each record is a
+ * single sanitized JSON line (no message content, tokens, or tool payloads —
+ * only a timestamp, the session id, a stable event name, and the turn's final
+ * stop reason / error class when it ends). Follows `diagnostics.ts` exactly:
+ * rotating file under `~/.yagni-code/logs/`, fail-soft, hermetic under
+ * `node --test`.
+ */
+import { appendFileSync, mkdirSync, readdirSync, renameSync, statSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { codeStateHome } from "./stateHome.js";
+/** Test seam: point the log at a tmpdir (mirrors _setDiagnosticsHomeForTest). */
+let homeOverride = null;
+export function _setTurnLogHomeForTest(dir) {
+    homeOverride = dir;
+}
+function turnLogDir() {
+    return join(codeStateHome(homeOverride), "logs");
+}
+export function turnLogPath() {
+    return join(turnLogDir(), "turn-lifecycle.log");
+}
+const MAX_LOG_BYTES = 256 * 1024;
+const KEEP_ROTATIONS = 2;
+/** Shift turn-lifecycle.log -> .1 -> .2 once the active file passes the cap. */
+function rotateIfNeeded(path) {
+    try {
+        if (!statSync(path).isFile() || statSync(path).size < MAX_LOG_BYTES)
+            return;
+        for (let i = KEEP_ROTATIONS; i >= 1; i--) {
+            const from = i === 1 ? path : `${path}.${i - 1}`;
+            const to = `${path}.${i}`;
+            try {
+                renameSync(from, to);
+            }
+            catch {
+                /* absent source — fine */
+            }
+        }
+    }
+    catch {
+        /* rotation is best-effort */
+    }
+}
+/**
+ * Append one sanitized lifecycle record. Fail-soft — a logging failure must
+ * never break the turn. `errorClass` is a caller-mapped category, never a
+ * raw error message.
+ */
+export function logTurnLifecycle(ev) {
+    try {
+        // Hermetic under `node --test`: never touch the real home dir unless a test
+        // explicitly overrode it (same rule as diagnostics.ts, which prevents the
+        // suite's exit from depending on the CI filesystem).
+        if (process.env.NODE_TEST_CONTEXT && homeOverride === null)
+            return;
+        const line = {
+            ts: new Date().toISOString(),
+            event: ev.kind,
+            ...(ev.sessionId ? { sessionId: ev.sessionId } : {}),
+            ...(ev.turnIndex !== undefined ? { turnIndex: ev.turnIndex } : {}),
+            ...(ev.kind === "turn_end" && ev.stopReason !== undefined ? { stopReason: ev.stopReason } : {}),
+            ...(ev.kind === "turn_end" && ev.elapsedMs !== undefined ? { elapsedMs: ev.elapsedMs } : {}),
+        };
+        const path = turnLogPath();
+        mkdirSync(dirname(path), { recursive: true });
+        rotateIfNeeded(path);
+        appendFileSync(path, JSON.stringify(line) + "\n", "utf8");
+    }
+    catch {
+        /* logging must never throw into the editor */
+    }
+}
+/** List existing lifecycle log files (active + rotations), for a report. */
+export function listTurnLogFiles() {
+    try {
+        const dir = turnLogDir();
+        return readdirSync(dir)
+            .filter((f) => f.startsWith("turn-lifecycle.log"))
+            .sort()
+            .map((f) => join(dir, f));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=turnLog.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yagni-app/code-staging",
-  "version": "0.3.2-staging.1119.1",
+  "version": "0.3.2-staging.1120.1",
   "description": "YAGNI Code: a terminal coding agent that already knows your company. One YAGNI login routes the model and grounds the agent in your team's context.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "YAGNI, Inc. <jack@yagni.app> (https://yagni.app)",
@@ -39,5 +39,5 @@
     "smol-toml": "^1.8.0",
     "typebox": "^1.3.11"
   },
-  "yagniSourceSha": "44ed4bcc995ffa2b075c202e5aa1a23f5ec808b6"
+  "yagniSourceSha": "a65ced918d4a73680643f5d0bf08f33f7f043e9b"
 }