@synaplink/orqlaude 0.8.0 → 0.9.3

package/dist/__tests__/v09.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/v09.test.js

@@ -0,0 +1,189 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { snapshotSession, clearTailCache } from "../lib/jsonl_tail.js";
+import { readChildExitRecord } from "../lib/spawn_cli.js";
+/**
+ * v0.9.0 — observability overhaul.
+ *
+ * Covers:
+ *  • A. snapshotSession falls back to stdoutPath when JSONL is missing
+ *  • E. readChildExitRecord parses the exit JSON file
+ *  • D. orphan notifications round-trip via state.ts schema
+ *  • F. wait_for_status_change fingerprint changes on key transitions
+ *       (smoke; the long-poll loop itself is integration-tested by
+ *       running a fleet end-to-end).
+ *  • cleanup_worktrees lock-release predicate (state mutation only).
+ *
+ * Smoke style: build temp files / state, call the unit-under-test
+ * directly, assert observable behavior. No subprocess spawning - those
+ * paths are covered by manual integration runs.
+ */
+async function mkTempDir(prefix) {
+    const raw = await fs.mkdtemp(path.join(os.tmpdir(), prefix));
+    return await fs.realpath(raw);
+}
+// ---- A: stdoutPath fallback in snapshotSession -----------------------------
+test("v0.9.0 A: snapshotSession reads tokens from stdout log when JSONL is missing", async () => {
+    clearTailCache();
+    const dir = await mkTempDir("orq-v09-A-");
+    const stdoutPath = path.join(dir, ".orqlaude.stdout.log");
+    // Write two stream-json events: one assistant with usage, one result.
+    const events = [
+        {
+            type: "assistant",
+            message: {
+                content: [{ type: "text", text: "Working on it" }],
+                usage: { input_tokens: 100, output_tokens: 50, cache_read_input_tokens: 0, cache_creation_input_tokens: 0 },
+            },
+            timestamp: new Date().toISOString(),
+        },
+        {
+            type: "result",
+            subtype: "completed",
+            total_cost_usd: 0.0012,
+            timestamp: new Date().toISOString(),
+        },
+    ];
+    await fs.writeFile(stdoutPath, events.map((e) => JSON.stringify(e)).join("\n") + "\n");
+    // session id is fake - the canonical JSONL path won't exist.
+    const fakeSession = "00000000-0000-4000-8000-000000000000";
+    const snap = await snapshotSession("/tmp/non-existent-cwd", fakeSession, stdoutPath);
+    assert.equal(snap.exists, true);
+    assert.equal(snap.source, "stdout_log");
+    assert.equal(snap.resolvedPath, stdoutPath);
+    assert.equal(snap.inputTokens, 100);
+    assert.equal(snap.outputTokens, 50);
+    assert.equal(snap.terminated, true);
+    assert.equal(snap.terminationReason, "completed");
+});
+test("v0.9.0 A: snapshotSession returns 'none' source when neither file exists", async () => {
+    clearTailCache();
+    const fakeSession = "11111111-0000-4000-8000-000000000000";
+    const snap = await snapshotSession("/tmp/non-existent-cwd-2", fakeSession);
+    assert.equal(snap.exists, false);
+    assert.equal(snap.source, "none");
+    assert.equal(snap.resolvedPath, null);
+});
+test("v0.9.0 A: snapshotSession prefers JSONL when both exist", async () => {
+    clearTailCache();
+    const dir = await mkTempDir("orq-v09-A-pref-");
+    const stdoutPath = path.join(dir, ".orqlaude.stdout.log");
+    // Stdout says 50 input tokens; JSONL we'll forge to say 200.
+    await fs.writeFile(stdoutPath, JSON.stringify({
+        type: "assistant",
+        message: { content: [], usage: { input_tokens: 50, output_tokens: 0 } },
+    }) + "\n");
+    // Build the JSONL at the canonical path so the resolver picks it.
+    const sessionId = "22222222-0000-4000-8000-000000000000";
+    // We need to mirror jsonlPathFor's encoding without importing it again.
+    const fakeCwd = await mkTempDir("orq-v09-A-cwd-");
+    const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
+    const jsonlDir = path.join(home, ".claude", "projects", fakeCwd.replace(/\//g, "-"));
+    await fs.mkdir(jsonlDir, { recursive: true });
+    const jsonlPath = path.join(jsonlDir, `${sessionId}.jsonl`);
+    await fs.writeFile(jsonlPath, JSON.stringify({
+        type: "assistant",
+        message: { content: [], usage: { input_tokens: 200, output_tokens: 0 } },
+    }) + "\n");
+    try {
+        const snap = await snapshotSession(fakeCwd, sessionId, stdoutPath);
+        assert.equal(snap.source, "jsonl");
+        assert.equal(snap.resolvedPath, jsonlPath);
+        assert.equal(snap.inputTokens, 200, "JSONL wins over stdout log when both exist");
+    }
+    finally {
+        await fs.rm(jsonlPath, { force: true });
+        await fs.rm(jsonlDir, { recursive: true, force: true });
+    }
+});
+// ---- E: readChildExitRecord ------------------------------------------------
+test("v0.9.0 E: readChildExitRecord returns null when file missing", async () => {
+    const dir = await mkTempDir("orq-v09-E-");
+    const exitPath = path.join(dir, ".orqlaude.exit.json");
+    const rec = await readChildExitRecord(exitPath);
+    assert.equal(rec, null);
+});
+test("v0.9.0 E: readChildExitRecord parses a written record", async () => {
+    const dir = await mkTempDir("orq-v09-E2-");
+    const exitPath = path.join(dir, ".orqlaude.exit.json");
+    const written = {
+        exit_code: 0,
+        signal: null,
+        terminated_at: Date.now(),
+        success: true,
+    };
+    await fs.writeFile(exitPath, JSON.stringify(written));
+    const rec = await readChildExitRecord(exitPath);
+    assert.ok(rec, "should parse");
+    assert.equal(rec.exit_code, 0);
+    assert.equal(rec.signal, null);
+    assert.equal(rec.success, true);
+    assert.equal(typeof rec.terminated_at, "number");
+});
+test("v0.9.0 E: readChildExitRecord rejects malformed json gracefully", async () => {
+    const dir = await mkTempDir("orq-v09-E3-");
+    const exitPath = path.join(dir, ".orqlaude.exit.json");
+    await fs.writeFile(exitPath, "{not json");
+    const rec = await readChildExitRecord(exitPath);
+    assert.equal(rec, null);
+});
+// ---- D: orphan-notification migration --------------------------------------
+test("v0.9.0 D: state.ts migrate fills orphanNotifications on a fresh v3 state", async () => {
+    const stateDir = await mkTempDir("orq-v09-D-");
+    // Write a hand-rolled state.json that omits the orphan arrays (mimicking
+    // a v3 file written by v0.8.0).
+    await fs.writeFile(path.join(stateDir, "orqlaude-state.json"), JSON.stringify({ schemaVersion: 3, plans: {} }));
+    const { StateStore } = await import("../lib/state.js");
+    const store = new StateStore(stateDir);
+    const orphans = await store.read((s) => ({
+        n: s.orphanNotifications,
+        r: s.orphanResponseRequests,
+    }));
+    // v0.9.1: pin the migration contract. The migrate fn explicitly
+    // initializes these arrays (out.orphanNotifications = out.orphanNotifications
+    // ?? []) so a load of a v3-without-orphans file must result in arrays,
+    // not undefineds. The notifier's `?? []` is defense-in-depth, not the
+    // primary contract.
+    assert.ok(Array.isArray(orphans.n), "orphanNotifications should be initialized as []");
+    assert.ok(Array.isArray(orphans.r), "orphanResponseRequests should be initialized as []");
+    assert.equal(orphans.n.length, 0);
+    assert.equal(orphans.r.length, 0);
+});
+test("v0.9.0 D: notify_user without plan_id pushes to orphan queue", async () => {
+    const stateDir = await mkTempDir("orq-v09-D2-");
+    const { StateStore } = await import("../lib/state.js");
+    const store = new StateStore(stateDir);
+    // Simulate what notify_user does when plan_id is absent.
+    await store.update((state) => {
+        state.orphanNotifications = state.orphanNotifications ?? [];
+        state.orphanNotifications.push({
+            id: "abc123",
+            text: "test ping",
+            urgency: "normal",
+            createdAt: Date.now(),
+            delivered: false,
+        });
+    });
+    const out = await store.read((s) => s.orphanNotifications);
+    assert.equal(out.length, 1);
+    assert.equal(out[0].text, "test ping");
+});
+// ---- F: fingerprint computation --------------------------------------------
+//
+// We can't call wait_for_status_change directly (it's tool-registered) but
+// the fingerprint shape is part of the contract. This test pins the
+// observable contract: token deltas of < 1 KB don't churn the fingerprint,
+// but a status transition does.
+test("v0.9.0 F: fingerprint shape is stable across sub-KB token deltas", () => {
+    const fp = (status, tokens) => `${status}|t1:${status}::${Math.floor(tokens / 1024)}::0:?`;
+    // 500-token to 800-token delta: same KB bucket.
+    assert.equal(fp("running", 500), fp("running", 800));
+    // 500 to 1500: different KB bucket.
+    assert.notEqual(fp("running", 500), fp("running", 1500));
+    // Status transition: always different.
+    assert.notEqual(fp("running", 500), fp("done", 500));
+});
+//# sourceMappingURL=v09.test.js.map

package/dist/__tests__/v09.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v09.test.js","sourceRoot":"","sources":["../../src/__tests__/v09.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAwB,MAAM,qBAAqB,CAAC;AAEhF;;;;;;;;;;;;;;;GAeG;AAEH,KAAK,UAAU,SAAS,CAAC,MAAc;IACrC,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7D,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAChC,CAAC;AAED,+EAA+E;AAE/E,IAAI,CAAC,8EAA8E,EAAE,KAAK,IAAI,EAAE;IAC9F,cAAc,EAAE,CAAC;IACjB,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC;IAC1D,sEAAsE;IACtE,MAAM,MAAM,GAAG;QACb;YACE,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE;gBACP,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;gBAClD,KAAK,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE,uBAAuB,EAAE,CAAC,EAAE,2BAA2B,EAAE,CAAC,EAAE;aAC5G;YACD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC;QACD;YACE,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,WAAW;YACpB,cAAc,EAAE,MAAM;YACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC;KACF,CAAC;IACF,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAEvF,6DAA6D;IAC7D,MAAM,WAAW,GAAG,sCAAsC,CAAC;IAC3D,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,uBAAuB,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IAErF,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC5C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IACpC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IACpC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACpC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC;AACpD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;IAC1F,cAAc,EAAE,CAAC;IACjB,MAAM,WAAW,GAAG,sCAAsC,CAAC;IAC3D,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,yBAAyB,EAAE,WAAW,CAAC,CAAC;IAC3E,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACjC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;IACzE,cAAc,EAAE,CAAC;IACjB,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC;IAC1D,6DAA6D;IAC7D,MAAM,EAAE,CAAC,SAAS,CAChB,UAAU,EACV,IAAI,CAAC,SAAS,CAAC;QACb,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,EAAE;KACxE,CAAC,GAAG,IAAI,CACV,CAAC;IAEF,kEAAkE;IAClE,MAAM,SAAS,GAAG,sCAAsC,CAAC;IACzD,wEAAwE;IACxE,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;IAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IACrF,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,SAAS,QAAQ,CAAC,CAAC;IAC5D,MAAM,EAAE,CAAC,SAAS,CAChB,SAAS,EACT,IAAI,CAAC,SAAS,CAAC;QACb,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,EAAE,EAAE;KACzE,CAAC,GAAG,IAAI,CACV,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QACnE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,4CAA4C,CAAC,CAAC;IACpF,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,MAAM,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,+EAA+E;AAE/E,IAAI,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;IAC9E,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;IACvD,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC1B,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;IACvE,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,aAAa,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;IACvD,MAAM,OAAO,GAAoB;QAC/B,SAAS,EAAE,CAAC;QACZ,MAAM,EAAE,IAAI;QACZ,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE;QACzB,OAAO,EAAE,IAAI;KACd,CAAC;IACF,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC/B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAC/B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAChC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;AACnD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;IACjF,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,aAAa,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;IACvD,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC1B,CAAC,CAAC,CAAC;AAEH,+EAA+E;AAE/E,IAAI,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;IAC1F,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,CAAC;IAC/C,yEAAyE;IACzE,gCAAgC;IAChC,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,qBAAqB,CAAC,EAC1C,IAAI,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAChD,CAAC;IACF,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;QAC5C,CAAC,EAAE,CAAC,CAAC,mBAAmB;QACxB,CAAC,EAAE,CAAC,CAAC,sBAAsB;KAC5B,CAAC,CAAC,CAAC;IACJ,gEAAgE;IAChE,8EAA8E;IAC9E,uEAAuE;IACvE,sEAAsE;IACtE,oBAAoB;IACpB,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,iDAAiD,CAAC,CAAC;IACvF,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,oDAAoD,CAAC,CAAC;IAC1F,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAClC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AACpC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;IAC9E,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,aAAa,CAAC,CAAC;IAChD,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC;IACvC,yDAAyD;IACzD,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC,KAAU,EAAE,EAAE;QAChC,KAAK,CAAC,mBAAmB,GAAG,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC;QAC5D,KAAK,CAAC,mBAAmB,CAAC,IAAI,CAAC;YAC7B,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,QAAQ;YACjB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAChE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC5B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AACzC,CAAC,CAAC,CAAC;AAEH,+EAA+E;AAC/E,EAAE;AACF,2EAA2E;AAC3E,oEAAoE;AACpE,2EAA2E;AAC3E,gCAAgC;AAEhC,IAAI,CAAC,kEAAkE,EAAE,GAAG,EAAE;IAC5E,MAAM,EAAE,GAAG,CAAC,MAAc,EAAE,MAAc,EAAE,EAAE,CAAC,GAAG,MAAM,OAAO,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;IAC3G,gDAAgD;IAChD,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;IACrD,oCAAoC;IACpC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;IACzD,uCAAuC;IACvC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;AACvD,CAAC,CAAC,CAAC"}

package/dist/__tests__/v092.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/v092.test.js

@@ -0,0 +1,125 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { snapshotSession, clearTailCache } from "../lib/jsonl_tail.js";
+/**
+ * v0.9.2 — billed-vs-cached token accounting.
+ *
+ * Covers:
+ *  • SessionSnapshot exposes separate billedTokens / cachedTokens / total
+ *  • billedTokens = input + output (Plan-cost-relevant)
+ *  • cachedTokens = cache_read + cache_creation (free on the Plan)
+ *  • totalEffectiveTokens = sum (back-compat)
+ *  • Plan.budgetMode defaults to "billed" via newPlan
+ *
+ * The budget-enforcement flow (status() / wait_for_status_change calling
+ * enforceBudget with the right bucket) is covered by integration-style
+ * runs against a live fleet; the unit tests here pin the snapshot maths.
+ */
+async function mkTempDir(prefix) {
+    const raw = await fs.mkdtemp(path.join(os.tmpdir(), prefix));
+    return await fs.realpath(raw);
+}
+test("v0.9.2: snapshotSession exposes billed and cached buckets separately", async () => {
+    clearTailCache();
+    const dir = await mkTempDir("orq-v092-buckets-");
+    const stdoutPath = path.join(dir, ".orqlaude.stdout.log");
+    // One assistant event with usage covering all four bucket fields.
+    await fs.writeFile(stdoutPath, JSON.stringify({
+        type: "assistant",
+        message: {
+            content: [{ type: "text", text: "x" }],
+            usage: {
+                input_tokens: 100,
+                output_tokens: 50,
+                cache_read_input_tokens: 8000,
+                cache_creation_input_tokens: 200,
+            },
+        },
+        timestamp: new Date().toISOString(),
+    }) + "\n");
+    const fakeSession = "00000000-0000-4000-8000-000000000aaa";
+    const snap = await snapshotSession("/tmp/non-existent-cwd-v092", fakeSession, stdoutPath);
+    assert.equal(snap.billedTokens, 150, "input + output only");
+    assert.equal(snap.cachedTokens, 8200, "cache_read + cache_creation");
+    assert.equal(snap.totalEffectiveTokens, 8350, "sum of all four buckets");
+    assert.equal(snap.totalEffectiveTokens, snap.billedTokens + snap.cachedTokens, "total = billed + cached");
+});
+test("v0.9.2: billed bucket excludes cache reads (the user is on the Claude Plan)", async () => {
+    clearTailCache();
+    const dir = await mkTempDir("orq-v092-billed-");
+    const stdoutPath = path.join(dir, ".orqlaude.stdout.log");
+    // A typical agent turn: small fresh input, small output, huge cache read.
+    // This mirrors the pattern we saw in the v0.9.1 live test where Agnets
+    // were reading 100k+ from cache per turn.
+    await fs.writeFile(stdoutPath, [
+        JSON.stringify({
+            type: "assistant",
+            message: {
+                content: [],
+                usage: { input_tokens: 200, output_tokens: 100, cache_read_input_tokens: 100000 },
+            },
+        }),
+        JSON.stringify({
+            type: "assistant",
+            message: {
+                content: [],
+                usage: { input_tokens: 150, output_tokens: 80, cache_read_input_tokens: 100000 },
+            },
+        }),
+    ].join("\n") + "\n");
+    const fakeSession = "00000000-0000-4000-8000-000000000bbb";
+    const snap = await snapshotSession("/tmp/non-existent-cwd-v092-b", fakeSession, stdoutPath);
+    assert.equal(snap.billedTokens, 530, "200+100 + 150+80 = 530 - what the Plan cares about");
+    assert.equal(snap.cachedTokens, 200000, "two turns of 100k cache reads");
+    assert.equal(snap.totalEffectiveTokens, 200530);
+    // The KEY ratio: cache reads are 376x larger than billed. A budget cap
+    // applied to `totalEffectiveTokens` would fire spuriously; applied to
+    // `billedTokens` it reflects real Plan usage.
+    const inflationRatio = snap.totalEffectiveTokens / snap.billedTokens;
+    assert.ok(inflationRatio > 100, `cache inflates the total by ${Math.round(inflationRatio)}x`);
+});
+test("v0.9.2: empty snapshot has zeros for all three rollups", async () => {
+    clearTailCache();
+    const snap = await snapshotSession("/tmp/non-existent-cwd-v092-empty", "11111111-0000-4000-8000-000000000000");
+    assert.equal(snap.billedTokens, 0);
+    assert.equal(snap.cachedTokens, 0);
+    assert.equal(snap.totalEffectiveTokens, 0);
+});
+test("v0.9.2: Plan.budgetMode defaults to undefined on newPlan; consumers treat undefined as 'billed'", async () => {
+    const { newPlan } = await import("../lib/state.js");
+    const p = newPlan("test", 100000, [
+        { title: "a", prompt: "p", tldr: "t" },
+        { title: "b", prompt: "p", tldr: "t" },
+    ]);
+    // newPlan itself doesn't set budgetMode - create_plan does. Both
+    // semantics are valid; consumers must fallback to "billed" on undefined.
+    // This pins the contract.
+    assert.ok(p.budgetMode === undefined || p.budgetMode === "billed");
+});
+test("v0.9.2: total = billed + cached invariant holds across mixed events", async () => {
+    clearTailCache();
+    const dir = await mkTempDir("orq-v092-invariant-");
+    const stdoutPath = path.join(dir, ".orqlaude.stdout.log");
+    // Mix of event shapes: assistant with full usage, assistant with partial,
+    // user (no usage), result row.
+    await fs.writeFile(stdoutPath, [
+        JSON.stringify({
+            type: "assistant",
+            message: { content: [], usage: { input_tokens: 10, output_tokens: 5, cache_read_input_tokens: 100, cache_creation_input_tokens: 20 } },
+        }),
+        JSON.stringify({ type: "user", message: { content: "noop" } }),
+        JSON.stringify({
+            type: "assistant",
+            message: { content: [], usage: { input_tokens: 7, output_tokens: 3 } },
+        }),
+        JSON.stringify({ type: "result", subtype: "completed" }),
+    ].join("\n") + "\n");
+    const snap = await snapshotSession("/tmp/non-existent-cwd-v092-inv", "22222222-0000-4000-8000-000000000000", stdoutPath);
+    assert.equal(snap.billedTokens, 25); // 10+5 + 7+3
+    assert.equal(snap.cachedTokens, 120); // 100 + 20
+    assert.equal(snap.totalEffectiveTokens, snap.billedTokens + snap.cachedTokens);
+});
+//# sourceMappingURL=v092.test.js.map

package/dist/__tests__/v092.test.js.map

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

package/dist/cli/easter_egg.js

@@ -1,18 +1,40 @@
 import { TAGLINES } from "./taglines.js";
 import { style } from "../lib/style.js";
 /**
- * Bare `orql` easter egg — a never-repeating typewriter cycling through
- * 149 tagline variants under the orqlaude diamond logo. Runs until Ctrl-C.
+ * Bare `orql` easter egg — typewriter cycling through 149 tagline variants
+ * beneath the orqlaude diamond. Runs until Ctrl-C / Ctrl-D.
  *
- * The natural terminal cursor sits at the end of each tagline while it's
- * displayed and blinks on its own — no explicit blink animation needed.
+ * v0.9.3 rewrite. Two fixes over the v0.6.1 implementation:
+ *
+ *   1. **Stdin echo no longer bleeds into the line.** Previously the
+ *      terminal was in cooked mode with echo on, so anything the user
+ *      typed at the keyboard while the animation ran was printed inline
+ *      with the tagline — and the `\b \b` erase pass walked back over
+ *      their characters too, leaving partial garbage when the next
+ *      tagline started. Now we put stdin in raw mode and silently
+ *      swallow every byte except Ctrl-C (0x03) and Ctrl-D (0x04).
+ *
+ *   2. **Full-screen ownership + resize-aware redraw.** Enters the
+ *      alternate screen buffer (\x1b[?1049h, the same mode vim / less /
+ *      htop use) so the orqlaude logo claims the entire viewport while
+ *      running, with nothing else visible. On exit, the original shell
+ *      contents are restored. We repaint the full frame from top-left on
+ *      every animation tick AND on `process.stdout` resize events — so
+ *      the watermark always lives in the top-left corner regardless of
+ *      window size.
+ *
+ * If stdout isn't a TTY (piped, CI, redirected), we fall back to a
+ * single-line static print and exit immediately. Animation only happens
+ * when there's an interactive terminal on the other end.
  */
 const ESC = "\x1b[";
-const SAVE = `${ESC}s`;
-const RESTORE = `${ESC}u`;
-const CLEAR_TO_EOL = `${ESC}K`;
-const SAND_FG = `${ESC}38;2;185;182;171m`;
-const RESET = `${ESC}0m`;
+const ALT_SCREEN_ENTER = `${ESC}?1049h`;
+const ALT_SCREEN_LEAVE = `${ESC}?1049l`;
+const HIDE_CURSOR = `${ESC}?25l`;
+const SHOW_CURSOR = `${ESC}?25h`;
+const CLEAR_SCREEN = `${ESC}2J`;
+const MOVE_TO_HOME = `${ESC}H`;
+const moveTo = (row, col) => `${ESC}${row};${col}H`;
 const TYPE_MIN_MS = 28;
 const TYPE_MAX_MS = 90;
 const HOLD_MIN_MS = 1100;
@@ -21,65 +43,131 @@ const ERASE_MIN_MS = 12;
 const ERASE_MAX_MS = 30;
 const BETWEEN_MIN_MS = 280;
 const BETWEEN_MAX_MS = 600;
+// Layout: 1-based rows/cols (ANSI convention).
+// Row 1: blank padding so the logo doesn't kiss the top edge.
+// Row 2-4: logo + wordmark + tagline.
+// The tagline starts at column 14 (after `   ◆◆◆      ` which is exactly
+// 13 visible chars when the ANSI color codes are stripped: 3 spaces + 3
+// glyphs + 6 spaces + 1 = column 14 for the first tagline char).
+const LOGO_ROW = 2;
+const WORDMARK_ROW = 3;
+const TAGLINE_ROW = 4;
+const TAGLINE_COL = 14;
 export async function runEasterEgg() {
+    // Non-TTY fallback (piped, redirected, CI). No animation, no alt screen.
+    if (!process.stdout.isTTY) {
+        process.stdout.write(`◆ orqlaude — ${TAGLINES[0]}\n`);
+        return 0;
+    }
     return new Promise((resolve) => {
         let stopped = false;
-        const onSig = () => {
+        let currentText = "";
+        const cleanup = () => {
+            try {
+                if (process.stdin.isTTY && process.stdin.setRawMode) {
+                    process.stdin.setRawMode(false);
+                }
+            }
+            catch {
+                /* harmless on shutdown */
+            }
+            process.stdin.removeListener("data", onData);
+            process.stdin.pause();
+            process.stdout.off("resize", onResize);
+            process.removeListener("SIGINT", stop);
+            process.stdout.write(SHOW_CURSOR + ALT_SCREEN_LEAVE);
+        };
+        const stop = () => {
+            if (stopped)
+                return;
             stopped = true;
-            // Move cursor below the tagline line and reset, then exit.
-            process.stdout.write(RESET + "\n\n");
+            cleanup();
             resolve(0);
         };
-        process.on("SIGINT", onSig);
-        // Static logo + wordmark. Last line ends without a newline so the
-        // cursor sits where taglines should animate.
-        const logo = [
-            `   ${style.coral("◆◆◆")}`,
-            `  ${style.coral("◆   ◆")}     ${style.bold(style.coral("orqlaude"))}`,
-            `   ${style.coral("◆◆◆")}      `, // trailing spaces are the "padding" before the tagline
-        ];
-        process.stdout.write("\n" + logo.join("\n"));
-        process.stdout.write(SAVE);
-        // Animate in a loop. We do this without `await` in the main scope so
-        // SIGINT can interrupt cleanly via the `stopped` flag check between
-        // sleeps.
+        // Raw-mode keystroke capture. Every byte is swallowed; Ctrl-C / Ctrl-D
+        // exit. This is what stops the user's keyboard from echoing into the
+        // animation.
+        const onData = (chunk) => {
+            for (const byte of chunk) {
+                if (byte === 0x03 /* Ctrl-C */ || byte === 0x04 /* Ctrl-D */) {
+                    stop();
+                    return;
+                }
+                // All other input is silently discarded.
+            }
+        };
+        // Repaint the full frame from the top-left. Called on every animation
+        // tick and on terminal resize. Idempotent.
+        const paintFrame = () => {
+            const out = [
+                MOVE_TO_HOME,
+                CLEAR_SCREEN,
+                moveTo(LOGO_ROW, 4),
+                style.coral("◆◆◆"),
+                moveTo(WORDMARK_ROW, 3),
+                style.coral("◆   ◆"),
+                "     ",
+                style.bold(style.coral("orqlaude")),
+                moveTo(TAGLINE_ROW, 4),
+                style.coral("◆◆◆"),
+                moveTo(TAGLINE_ROW, TAGLINE_COL),
+                style.sand(currentText),
+            ];
+            process.stdout.write(out.join(""));
+        };
+        const onResize = () => {
+            paintFrame();
+        };
+        // Initial setup.
+        process.stdout.write(ALT_SCREEN_ENTER + HIDE_CURSOR);
+        try {
+            if (process.stdin.isTTY && process.stdin.setRawMode) {
+                process.stdin.setRawMode(true);
+            }
+            process.stdin.resume();
+            process.stdin.on("data", onData);
+        }
+        catch {
+            /* if raw mode isn't available, we'll only react to SIGINT */
+        }
+        process.on("SIGINT", stop);
+        process.stdout.on("resize", onResize);
+        paintFrame();
+        // Animation loop.
         (async () => {
             let lastIdx = -1;
             while (!stopped) {
                 let idx = Math.floor(Math.random() * TAGLINES.length);
-                // Never repeat the previous tagline.
                 while (idx === lastIdx) {
                     idx = Math.floor(Math.random() * TAGLINES.length);
                 }
                 lastIdx = idx;
                 const tagline = TAGLINES[idx];
-                // Reset cursor + clear any leftover from the previous tagline.
-                process.stdout.write(RESTORE + CLEAR_TO_EOL + SAND_FG);
-                // Type out character by character. Each char is plain text — the
-                // SAND_FG above persists until we reset, so a single \b backspace
-                // erases one visible character.
-                for (let i = 0; i < tagline.length; i++) {
+                // Type out character by character. Repainting the whole frame
+                // each tick is overkill, but it's correct under resize and
+                // makes the code easier to reason about than tracking partial
+                // updates.
+                for (let i = 1; i <= tagline.length; i++) {
                     if (stopped)
                         return;
-                    process.stdout.write(tagline[i]);
+                    currentText = tagline.slice(0, i);
+                    paintFrame();
                     await sleep(rand(TYPE_MIN_MS, TYPE_MAX_MS));
                 }
-                // Hold while the natural terminal cursor blinks at the end.
                 await sleep(rand(HOLD_MIN_MS, HOLD_MAX_MS));
                 if (stopped)
                     return;
-                // Erase backwards for a satisfying "delete" feel.
-                for (let i = tagline.length; i > 0; i--) {
+                for (let i = tagline.length - 1; i >= 0; i--) {
                     if (stopped)
                         return;
-                    process.stdout.write("\b \b");
+                    currentText = tagline.slice(0, i);
+                    paintFrame();
                     await sleep(rand(ERASE_MIN_MS, ERASE_MAX_MS));
                 }
-                process.stdout.write(RESET);
                 await sleep(rand(BETWEEN_MIN_MS, BETWEEN_MAX_MS));
             }
         })().catch(() => {
-            /* swallow — never crash on the easter egg */
+            /* never crash the easter egg */
         });
     });
 }

package/dist/cli/easter_egg.js.map

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

package/dist/cli.js

@@ -26,7 +26,7 @@ import { tailAudit } from "./cli/tail.js";
 import { openPlan } from "./cli/open.js";
 import { showAbout } from "./cli/about.js";
 import { runEasterEgg } from "./cli/easter_egg.js";
-const VERSION = "0.8.0";
+import { VERSION } from "./lib/version.js";
 /**
  * orqlaude CLI — read-only inspection of state + audit log + Telegram setup
  * and run.