spexcode 0.6.6 → 0.6.7

package/node_modules/@spexcode/session-core/dist/delivery-queue.d.ts

@@ -2,6 +2,7 @@ export type PendingMessage = {
     mid: string;
     text: string;
     from: string | null;
+    attributes?: Record<string, string>;
     dispatch?: {
         operation: string;
         requestDigest: string;

package/node_modules/@spexcode/session-core/dist/delivery-queue.js

@@ -63,6 +63,11 @@ function read(id) {
         return raw.filter((m) => !!m && typeof m === 'object'
             && typeof m.mid === 'string'
             && typeof m.text === 'string'
+            && (m.attributes === undefined
+                || (!!m.attributes
+                    && typeof m.attributes === 'object'
+                    && !Array.isArray(m.attributes)
+                    && Object.values(m.attributes).every((value) => typeof value === 'string')))
             && (m.dispatch === undefined
                 || (typeof m.dispatch?.operation === 'string'
                     && typeof m.dispatch?.requestDigest === 'string')));
@@ -71,6 +76,11 @@ function read(id) {
         return [];
     } // absent, empty, or unparseable all mean the honest thing: nothing owed
 }
+function sameAttributes(left, right) {
+    const leftEntries = Object.entries(left ?? {}).sort(([a], [b]) => a.localeCompare(b));
+    const rightEntries = Object.entries(right ?? {}).sort(([a], [b]) => a.localeCompare(b));
+    return JSON.stringify(leftEntries) === JSON.stringify(rightEntries);
+}
 // Written whole and atomically; an empty queue is REMOVED rather than left as `[]`, so "is anything owed?" is
 // one existsSync on the sweep's hot path.
 function write(id, msgs) {
@@ -165,7 +175,8 @@ export async function drain(id, insert, timeoutMs = 5_000) {
                 if (head.dispatch) {
                     const receipt = sentDispatchReceipt(id, head.dispatch.operation, head.dispatch.requestDigest);
                     if (!receipt || receipt.mid !== head.mid || !receipt.delivery
-                        || receipt.delivery.text !== head.text || receipt.delivery.from !== head.from)
+                        || receipt.delivery.text !== head.text || receipt.delivery.from !== head.from
+                        || !sameAttributes(receipt.delivery.attributes, head.attributes))
                         return { delivered, remaining: queued.length };
                     if (receipt.delivered)
                         ok = true;

package/node_modules/@spexcode/session-core/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { acceptMessage, MessageKeyConflict, type AcceptMessageOptions, type MessageIdempotency, type PreparedMessage } from './message.js';
 export { drain, owesDelivery, pendingMessages, type PendingMessage } from './delivery-queue.js';
-export { publishRuntimeSessionState, readRuntimeSession, registerRuntimeSession, runtimeSessionChildren, RuntimeSessionConflict, type RuntimeSessionRecord, type RuntimeSessionRegistration, type RuntimeSessionState, } from './runtime-session.js';
+export { publishRuntimeSessionState, readRuntimeSession, registerRuntimeSession, runtimeSessionNotification, runtimeSessionChildren, RuntimeSessionConflict, type RuntimeSessionRecord, type RuntimeSessionNotification, type RuntimeSessionRegistration, type RuntimeSessionState, } from './runtime-session.js';
 export { advanceFollow, followedSessions, followCursor, readCursors, unreadSince, type Cursors } from './session-cursors.js';
 export { currentHumanTurn, lastHumanSendVia, recordStatus, timelineEvents, timelineStamp, timelineTail, type SessionTurn, type TimelineEvent, } from './session-timeline.js';

package/node_modules/@spexcode/session-core/dist/index.js

@@ -1,5 +1,5 @@
 export { acceptMessage, MessageKeyConflict } from './message.js';
 export { drain, owesDelivery, pendingMessages } from './delivery-queue.js';
-export { publishRuntimeSessionState, readRuntimeSession, registerRuntimeSession, runtimeSessionChildren, RuntimeSessionConflict, } from './runtime-session.js';
+export { publishRuntimeSessionState, readRuntimeSession, registerRuntimeSession, runtimeSessionNotification, runtimeSessionChildren, RuntimeSessionConflict, } from './runtime-session.js';
 export { advanceFollow, followedSessions, followCursor, readCursors, unreadSince } from './session-cursors.js';
 export { currentHumanTurn, lastHumanSendVia, recordStatus, timelineEvents, timelineStamp, timelineTail, } from './session-timeline.js';

package/node_modules/@spexcode/session-core/dist/message.js

@@ -12,6 +12,7 @@ const keyedPending = (receipt, mid, delivery) => ({
     mid,
     text: delivery.text,
     from: delivery.from,
+    ...(delivery.attributes ? { attributes: delivery.attributes } : {}),
     dispatch: { operation: receipt.operation, requestDigest: receipt.requestDigest },
 });
 // The durable acceptance boundary. Product validation and prompt composition run while the record fence is

package/node_modules/@spexcode/session-core/dist/runtime-session.d.ts

@@ -1,4 +1,5 @@
 import { type SessionLifecycle, type SessionProposal } from '@spexcode/spec-core';
+import { type PendingMessage } from './delivery-queue.js';
 export type RuntimeSessionRegistration = {
     sessionId: string;
     runtimeOwner: string;
@@ -35,6 +36,16 @@ export type RuntimeSessionRecord = {
     note: string | null;
     createdAt: number;
 };
+export type RuntimeSessionNotification = {
+    childSessionId: string;
+    runtimeOwner: string;
+    runtimeState: string;
+    revision: string;
+    lifecycle: SessionLifecycle;
+    proposal: SessionProposal | null;
+    note: string | null;
+    runtimeMetadata: Record<string, string>;
+};
 export declare class RuntimeSessionConflict extends Error {
     readonly code = "runtime_session_conflict";
     constructor(message: string);
@@ -42,6 +53,7 @@ export declare class RuntimeSessionConflict extends Error {
 export declare function registerRuntimeSession(input: RuntimeSessionRegistration): Promise<{
     replayed: boolean;
 }>;
+export declare function runtimeSessionNotification(parentSessionId: string, message: PendingMessage): RuntimeSessionNotification | null;
 export declare function publishRuntimeSessionState(input: RuntimeSessionState): Promise<{
     notified: string[];
     replayed: boolean;

package/node_modules/@spexcode/session-core/dist/runtime-session.js

@@ -14,6 +14,7 @@ export class RuntimeSessionConflict extends Error {
 }
 const digest = (value) => createHash('sha256').update(value).digest('hex');
 const watchPath = (target) => sessionArtifactPath(target, 'watchers.json');
+const RUNTIME_NOTIFICATION_KIND = 'spex.runtime-state.v1';
 function scalar(value, field) {
     const normalized = value.trim();
     if (!normalized)
@@ -183,14 +184,52 @@ function stateMessage(record) {
     const note = record.note ? ` — ${record.note}` : '';
     return `[spex watch] ${record.sessionId} is ${record.runtimeState ?? record.lifecycle}${proposal}${note}`;
 }
+function notificationAttributes(record) {
+    if (!record.revision || !record.runtimeState)
+        throw new RuntimeSessionConflict(`runtime session ${record.sessionId} has no publishable state revision`);
+    return {
+        kind: RUNTIME_NOTIFICATION_KIND,
+        runtimeOwner: record.runtimeOwner,
+        runtimeState: record.runtimeState,
+        revision: record.revision,
+        lifecycle: record.lifecycle,
+        proposal: record.proposal ?? '',
+        note: record.note ?? '',
+    };
+}
 function pendingFor(receipt, mid) {
     return {
         mid,
         text: receipt.delivery.text,
         from: receipt.delivery.from,
+        ...(receipt.delivery.attributes ? { attributes: receipt.delivery.attributes } : {}),
         dispatch: { operation: receipt.operation, requestDigest: receipt.requestDigest },
     };
 }
+export function runtimeSessionNotification(parentSessionId, message) {
+    const parent = scalar(parentSessionId, 'parentSessionId');
+    const child = message.from?.trim();
+    const attributes = message.attributes;
+    if (!child || !attributes || attributes.kind !== RUNTIME_NOTIFICATION_KIND)
+        return null;
+    const record = readRuntimeSession(child);
+    if (!record || record.parentSessionId !== parent || record.runtimeOwner !== attributes.runtimeOwner)
+        return null;
+    if (!attributes.revision || !attributes.runtimeState || !isSessionLifecycle(attributes.lifecycle))
+        return null;
+    if (attributes.proposal && !isSessionProposal(attributes.proposal))
+        return null;
+    return {
+        childSessionId: child,
+        runtimeOwner: attributes.runtimeOwner,
+        runtimeState: attributes.runtimeState,
+        revision: attributes.revision,
+        lifecycle: attributes.lifecycle,
+        proposal: isSessionProposal(attributes.proposal) ? attributes.proposal : null,
+        note: attributes.note || null,
+        runtimeMetadata: record.runtimeMetadata,
+    };
+}
 export async function publishRuntimeSessionState(input) {
     const id = scalar(input.sessionId, 'sessionId');
     const owner = scalar(input.runtimeOwner, 'runtimeOwner');
@@ -222,10 +261,11 @@ export async function publishRuntimeSessionState(input) {
             runtime_revision: revision,
         });
         const message = stateMessage(candidate);
+        const attributes = notificationAttributes(candidate);
         const historical = watchers.map((watcher) => {
             const operation = `runtime-state:${id}`;
             const requestDigest = digest(`${id}\0${watcher}\0${revision}`);
-            const payloadHash = digest(`${operation}\0${requestDigest}\0${message}`);
+            const payloadHash = digest(`${operation}\0${requestDigest}\0${message}\0${JSON.stringify(attributes)}`);
             const prior = sentDispatchReceipt(watcher, operation, requestDigest);
             if (prior && prior.payloadHash !== payloadHash)
                 throw new RuntimeSessionConflict(`runtime revision ${revision} notification is already bound to different bytes`);
@@ -252,7 +292,7 @@ export async function publishRuntimeSessionState(input) {
                 operation,
                 requestDigest,
                 payloadHash,
-                delivery: { text: message, from: id },
+                delivery: { text: message, from: id, attributes },
             };
             if (prior) {
                 if (!prior.delivered)

package/node_modules/@spexcode/session-core/dist/session-timeline.d.ts

@@ -21,6 +21,7 @@ export type SentDispatchReceipt = {
     delivery?: {
         text: string;
         from: string | null;
+        attributes?: Record<string, string>;
     };
 };
 export declare function recordStatus(id: string, status: SessionLifecycle, proposal: SessionProposal | null, note: string | null): void;

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

@@ -1,6 +1,6 @@
 {
   "name": "@spexcode/session-core",
-  "version": "0.6.6",
+  "version": "0.6.7",
   "type": "module",
   "description": "SpexCode's durable file-based session communication protocol.",
   "files": [
@@ -23,7 +23,7 @@
     "test": "npm run build && tsx --import ../../scripts/test-home.mjs --test src/*.test.ts && node --test scripts/public-boundary.test.mjs"
   },
   "dependencies": {
-    "@spexcode/spec-core": "0.6.6"
+    "@spexcode/spec-core": "0.6.7"
   },
   "devDependencies": {
     "@types/node": "^20.16.0",

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

@@ -1,6 +1,6 @@
 {
   "name": "@spexcode/spec-cli",
-  "version": "0.6.6",
+  "version": "0.6.7",
   "type": "module",
   "description": "SpexCode CLI + server. The root spexcode package delegates to this compiled package; dashboard assets live in @spexcode/spec-dashboard.",
   "bin": {
@@ -36,10 +36,10 @@
     "test": "tsx --import ../scripts/test-home.mjs --test src/*.test.ts"
   },
   "dependencies": {
-    "@spexcode/session-core": "0.6.6",
-    "@spexcode/spec-core": "0.6.6",
-    "@spexcode/spec-eval": "0.6.6",
-    "@spexcode/spec-forge": "0.6.6"
+    "@spexcode/session-core": "0.6.7",
+    "@spexcode/spec-core": "0.6.7",
+    "@spexcode/spec-eval": "0.6.7",
+    "@spexcode/spec-forge": "0.6.7"
   },
   "devDependencies": {
     "@types/node": "^20.16.0",

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

@@ -1,6 +1,6 @@
 {
   "name": "@spexcode/spec-core",
-  "version": "0.6.6",
+  "version": "0.6.7",
   "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.6.6",
+  "version": "0.6.7",
   "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.6.6"
+    "@spexcode/spec-core": "0.6.7"
   },
   "devDependencies": {
     "@types/node": "^20.16.0",

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spexcode",
-  "version": "0.6.6",
+  "version": "0.6.7",
   "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",
@@ -38,7 +38,7 @@
     "prepack": "node scripts/sync-init-plugins.mjs --check && node scripts/prepack.mjs"
   },
   "dependencies": {
-    "@spexcode/spec-cli": "0.6.6"
+    "@spexcode/spec-cli": "0.6.7"
   },
   "publishConfig": {
     "access": "public"