spexcode 0.7.0-next.13 → 0.7.0-next.14

package/node_modules/@spexcode/session-application/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spexcode/session-application",
-  "version": "0.7.0-next.13",
+  "version": "0.7.0-next.14",
   "publishConfig": { "access": "public" },
   "type": "module",
   "description": "Adopter-owned composition of session protocol and topology transactions.",
@@ -16,10 +16,10 @@
     "test": "npm run build && tsx --import ../../scripts/test-home.mjs --test src/*.test.ts"
   },
   "dependencies": {
-    "@spexcode/session-events": "0.7.0-next.13",
-    "@spexcode/session-protocol": "0.7.0-next.13",
-    "@spexcode/session-runtime": "0.7.0-next.13",
-    "@spexcode/session-topology": "0.7.0-next.13"
+    "@spexcode/session-events": "0.7.0-next.14",
+    "@spexcode/session-protocol": "0.7.0-next.14",
+    "@spexcode/session-runtime": "0.7.0-next.14",
+    "@spexcode/session-topology": "0.7.0-next.14"
   },
   "devDependencies": {
     "@types/node": "^20.16.0",

package/node_modules/@spexcode/session-events/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spexcode/session-events",
-  "version": "0.7.0-next.13",
+  "version": "0.7.0-next.14",
   "publishConfig": { "access": "public" },
   "type": "module",
   "description": "Append-only session facts and deterministic ordered replay inputs.",
@@ -15,7 +15,7 @@
     "prepublishOnly": "node ../../scripts/release-publish.mjs --from-package-publish",
     "test": "npm run build && tsx --import ../../scripts/test-home.mjs --test src/*.test.ts"
   },
-  "dependencies": { "@spexcode/session-protocol": "0.7.0-next.13" },
+  "dependencies": { "@spexcode/session-protocol": "0.7.0-next.14" },
   "devDependencies": {
     "@types/node": "^20.16.0",
     "tsx": "^4.19.2",

package/node_modules/@spexcode/session-protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spexcode/session-protocol",
-  "version": "0.7.0-next.13",
+  "version": "0.7.0-next.14",
   "type": "module",
   "description": "A durable SQLite session message protocol.",
   "files": [

package/node_modules/@spexcode/session-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spexcode/session-runtime",
-  "version": "0.7.0-next.13",
+  "version": "0.7.0-next.14",
   "publishConfig": { "access": "public" },
   "type": "module",
   "description": "Adopter-owned bindings between protocol addresses and native runtime identities.",
@@ -15,7 +15,7 @@
     "prepublishOnly": "node ../../scripts/release-publish.mjs --from-package-publish",
     "test": "npm run build && tsx --import ../../scripts/test-home.mjs --test src/*.test.ts"
   },
-  "dependencies": { "@spexcode/session-protocol": "0.7.0-next.13" },
+  "dependencies": { "@spexcode/session-protocol": "0.7.0-next.14" },
   "devDependencies": {
     "@types/node": "^20.16.0",
     "tsx": "^4.19.2",

package/node_modules/@spexcode/session-selflaunch/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spexcode/session-selflaunch",
-  "version": "0.7.0-next.13",
+  "version": "0.7.0-next.14",
   "publishConfig": { "access": "public" },
   "type": "module",
   "description": "A fail-closed self-launch adopter for the SpexCode session protocol.",
@@ -24,8 +24,8 @@
     "test": "npm run build && tsx --import ../../scripts/test-home.mjs --test src/*.test.ts"
   },
   "dependencies": {
-    "@spexcode/session-protocol": "0.7.0-next.13",
-    "@spexcode/session-runtime": "0.7.0-next.13"
+    "@spexcode/session-protocol": "0.7.0-next.14",
+    "@spexcode/session-runtime": "0.7.0-next.14"
   },
   "devDependencies": {
     "@types/node": "^20.16.0",

package/node_modules/@spexcode/session-topology/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spexcode/session-topology",
-  "version": "0.7.0-next.13",
+  "version": "0.7.0-next.14",
   "publishConfig": { "access": "public" },
   "type": "module",
   "description": "A neutral SQLite relation model for session addresses.",
@@ -15,7 +15,7 @@
     "prepublishOnly": "node ../../scripts/release-publish.mjs --from-package-publish",
     "test": "npm run build && tsx --import ../../scripts/test-home.mjs --test src/*.test.ts"
   },
-  "dependencies": { "@spexcode/session-protocol": "0.7.0-next.13" },
+  "dependencies": { "@spexcode/session-protocol": "0.7.0-next.14" },
   "devDependencies": {
     "@types/node": "^20.16.0",
     "tsx": "^4.19.2",

package/node_modules/@spexcode/spec-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spexcode/spec-cli",
-  "version": "0.7.0-next.13",
+  "version": "0.7.0-next.14",
   "type": "module",
   "description": "SpexCode CLI + server. The root spexcode package delegates to this compiled package; dashboard assets live in @spexcode/spec-dashboard.",
   "bin": {
@@ -35,12 +35,12 @@
     "test": "tsx --import ../scripts/test-home.mjs --test src/*.test.ts"
   },
   "dependencies": {
-    "@spexcode/session-application": "0.7.0-next.13",
-    "@spexcode/session-selflaunch": "0.7.0-next.13",
-    "@spexcode/spec-core": "0.7.0-next.13",
-    "@spexcode/spec-eval": "0.7.0-next.13",
-    "@spexcode/spec-forge": "0.7.0-next.13",
-    "@spexcode/transcript": "0.7.0-next.13",
+    "@spexcode/session-application": "0.7.0-next.14",
+    "@spexcode/session-selflaunch": "0.7.0-next.14",
+    "@spexcode/spec-core": "0.7.0-next.14",
+    "@spexcode/spec-eval": "0.7.0-next.14",
+    "@spexcode/spec-forge": "0.7.0-next.14",
+    "@spexcode/transcript": "0.7.0-next.14",
     "smol-toml": "^1.8.0"
   },
   "devDependencies": {

package/node_modules/@spexcode/spec-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spexcode/spec-core",
-  "version": "0.7.0-next.13",
+  "version": "0.7.0-next.14",
   "type": "module",
   "description": "SpexCode's dependency-minimal spec graph core.",
   "files": [

package/node_modules/@spexcode/spec-eval/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spexcode/spec-eval",
-  "version": "0.7.0-next.13",
+  "version": "0.7.0-next.14",
   "type": "module",
   "exports": {
     ".": "./dist/index.js",
@@ -26,7 +26,7 @@
     "test": "tsx --import ../scripts/test-home.mjs --test src/*.test.ts"
   },
   "dependencies": {
-    "@spexcode/spec-core": "0.7.0-next.13"
+    "@spexcode/spec-core": "0.7.0-next.14"
   },
   "devDependencies": {
     "@types/node": "^20.16.0",

package/node_modules/@spexcode/spec-forge/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spexcode/spec-forge",
-  "version": "0.7.0-next.13",
+  "version": "0.7.0-next.14",
   "type": "module",
   "exports": {
     ".": "./dist/index.js",
@@ -22,7 +22,7 @@
     "test": "tsx --test src/*.test.ts"
   },
   "dependencies": {
-    "@spexcode/spec-core": "0.7.0-next.13"
+    "@spexcode/spec-core": "0.7.0-next.14"
   },
   "devDependencies": {
     "@types/node": "^20.16.0",

package/node_modules/@spexcode/transcript/dist/parsers.d.ts

@@ -45,6 +45,7 @@ export declare class IntervalCollector {
     private readonly evicted;
     private readonly synthesized;
     sawTimestamp: boolean;
+    sawRecord: boolean;
     omittedTurns: number;
     omittedBytes: number;
     outOfOrderEvents: number;

package/node_modules/@spexcode/transcript/dist/parsers.js

@@ -133,7 +133,14 @@ export function claudeEvent(value) {
             return { at: eventAt, turn: { id: idOf(entry) ?? idOf(message), at: eventAt, role: 'user', text, tools: [] } };
     }
     if (entry.type === 'assistant' && message.role === 'assistant') {
-        const turn = { id: idOf(entry) ?? idOf(message), at: eventAt, role: 'assistant', tools: [] };
+        // ONE API MESSAGE IS ONE TURN, however many lines Claude wrote it as. It writes one CONTENT BLOCK per
+        // line — prose on one, each tool call on its own — and every line of the same message repeats that
+        // message's `id` while carrying its own `uuid`. Keying on the line made one message up to six turns:
+        // measured over twelve recent threads, 5,077 assistant lines carry only 2,396 distinct message ids, so a
+        // turn count read off the lines is more than twice the truth. Keying on the message id lets the collector
+        // fold the fragments back together with the rule it already has for a re-emitted turn — text kept, calls
+        // merged by their own ids — so nothing here has to accumulate.
+        const turn = { id: idOf(message) ?? idOf(entry), at: eventAt, role: 'assistant', tools: [] };
         for (const blockValue of items(message.content)) {
             const block = object(blockValue);
             if (block?.type === 'text')
@@ -517,6 +524,7 @@ export class IntervalCollector {
     evicted = new Set();
     synthesized = new Map(); // `<role>@<at>` → how many turns already wore it
     sawTimestamp = false;
+    sawRecord = false; // a record this harness's parser RECOGNIZED arrived, with or without a clock
     omittedTurns = 0;
     omittedBytes = 0;
     outOfOrderEvents = 0;
@@ -528,6 +536,7 @@ export class IntervalCollector {
         this.range.to = to; }
     // returns true once the source has moved past `to` (the caller may then bound its lookahead)
     add(event) {
+        this.sawRecord = true;
         const eventAt = event.at;
         if (eventAt === null)
             return this.pastRange;
@@ -600,7 +609,13 @@ export class IntervalCollector {
         return this.pastRange;
     }
     finish(revision, harness) {
-        if (!this.sawTimestamp)
+        // THE CLOCK GATE IS ABOUT THE HARNESS, NOT THE MOMENT. It catches a source whose conversational records
+        // carry no usable time, which makes interval reads impossible. It must NOT catch a thread that has simply
+        // not spoken yet: every Claude transcript opens with clockless bookkeeping (`mode`, `permission-mode`,
+        // `file-history-snapshot`) before its first message — 40 of 40 real threads on this box — and those lines
+        // are not records this parser recognizes at all, so failing on them put an error frame on the page for the
+        // first moments of EVERY new session, which is exactly when someone is watching.
+        if (this.sawRecord && !this.sawTimestamp)
             throw new TranscriptReadError('invalid', `${harness} transcript has no reliable timestamps; interval reads are unavailable`);
         return {
             revision,

package/node_modules/@spexcode/transcript/dist/readers.js

@@ -205,8 +205,13 @@ class LineFileCursor {
         catch (error) {
             throw new TranscriptReadError('unreadable', `${this.harness} transcript is unreadable: ${error instanceof Error ? error.message : String(error)}`);
         }
+        // AN EMPTY FILE IS A THREAD THAT HAS NOT SPOKEN YET, not a broken one. The harness creates the transcript
+        // before it writes the first record, so the moments right after a session starts — exactly when a person is
+        // watching — read as zero bytes. Failing there put an error on the page for a conversation that simply had
+        // not begun. Zero bytes is unambiguous in a way a garbled file is not: there is nothing to misread, so this
+        // is the one place the no-timestamp gate is skipped rather than tripped.
         if (size <= 0)
-            throw new TranscriptReadError('unreadable', `${this.harness} transcript is unreadable: file is empty`);
+            return { revision: fileRevision(this.path) ?? '0', from: this.from, to, turns: [], truncated: false, omittedTurns: 0, omittedBytes: 0, outOfOrderEvents: 0 };
         // a source that shrank was rewritten underneath the cursor: forget the position and read the interval afresh
         if (!this.started || size < this.scan.position) {
             this.restart(size);
@@ -216,8 +221,9 @@ class LineFileCursor {
         let fd = null;
         try {
             fd = openSync(this.path, 'r');
-            let postRangeLines = 0;
+            let postRangeLines = 0, parsedLines = 0, unparsableLines = 0;
             this.scan = scanLines(fd, this.scan, (value, offset) => {
+                parsedLines++;
                 const event = this.parse(value);
                 if (!event)
                     return false;
@@ -226,7 +232,11 @@ class LineFileCursor {
                     intervalOffsets.set(this.seekKey, offset);
                 const pastRange = this.collector.add(event);
                 return pastRange && ++postRangeLines >= lookahead;
-            }, (bytes) => { this.collector.omittedBytes += bytes; });
+            }, (bytes) => { unparsableLines++; this.collector.omittedBytes += bytes; });
+            // a file in which NOTHING is JSON is not this thread's transcript at all — that is the loud case, and it
+            // stays loud; a file whose lines parse but say nothing conversational yet is simply not started
+            if (!parsedLines && unparsableLines > 0)
+                throw new TranscriptReadError('invalid', `${this.harness} transcript cannot be parsed: no line is JSON`);
         }
         catch (error) {
             if (error instanceof TranscriptReadError)

package/node_modules/@spexcode/transcript/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spexcode/transcript",
-  "version": "0.7.0-next.13",
+  "version": "0.7.0-next.14",
   "type": "module",
   "description": "Normalized agent transcripts: one parser per harness, a bounded interval reader over a native thread file or an in-memory event stream, and the full/delta frame protocol every transport and renderer share.",
   "files": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spexcode",
-  "version": "0.7.0-next.13",
+  "version": "0.7.0-next.14",
   "type": "module",
   "description": "SpexCode — a spec-driven, self-developing dev tool. The `spex` CLI + spec server reads the .spec tree and its git history, and serves the dashboard.",
   "license": "MIT",
@@ -44,7 +44,7 @@
     "prepack": "node scripts/sync-init-plugins.mjs --check && node scripts/prepack.mjs"
   },
   "dependencies": {
-    "@spexcode/spec-cli": "0.7.0-next.13"
+    "@spexcode/spec-cli": "0.7.0-next.14"
   },
   "publishConfig": {
     "access": "public"