@north-light/crouter 0.3.206 → 0.3.207

package/dist/core/canvas/paths.d.ts

@@ -59,8 +59,8 @@ export declare function reportsDir(nodeId: string): string;
 export declare function messagesDir(nodeId: string): string;
 export declare function nodeMetaPath(nodeId: string): string;
 export declare function inboxPath(nodeId: string): string;
-/** The node-owned ambient "current situation" sidecar — the latest hidden
- *  `<situational-context>` text injected into bearings/kickoff (see
+/** The node-owned ambient "current situation" sidecar — ONE rendered runtime
+ *  card, restated by the session-start bearings (see
  *  `runtime/situational-context.ts`), upserted in place rather than appended so
  *  only the newest applet/situation state is ever carried. Lives beside
  *  meta.json/inbox.jsonl (node-runtime state) rather than under context/ (the

package/dist/core/canvas/paths.js

@@ -137,8 +137,8 @@ export function nodeMetaPath(nodeId) {
 export function inboxPath(nodeId) {
     return join(nodeDir(nodeId), 'inbox.jsonl');
 }
-/** The node-owned ambient "current situation" sidecar — the latest hidden
- *  `<situational-context>` text injected into bearings/kickoff (see
+/** The node-owned ambient "current situation" sidecar — ONE rendered runtime
+ *  card, restated by the session-start bearings (see
  *  `runtime/situational-context.ts`), upserted in place rather than appended so
  *  only the newest applet/situation state is ever carried. Lives beside
  *  meta.json/inbox.jsonl (node-runtime state) rather than under context/ (the

package/dist/core/runtime/situational-context.d.ts

@@ -12,8 +12,6 @@ export declare function formatSituationalProse(prose: string): string;
  *  No-op for blank text, so a caller can pass through an optional/empty value
  *  with no guard at the call site. */
 export declare function appendSituationalContext(nodeId: string, text: string): void;
-/** Read the current situational context, or null if none was ever set. */
-export declare function readSituationalContext(nodeId: string): string | null;
 /** The node's stored situational card, verbatim, or null when none is set.
  *  The ONE read of the sidecar. A sidecar written before the card cut holds
  *  bare prose; that single legacy branch lives here alone and self-clears on

package/dist/core/runtime/situational-context.js

@@ -46,8 +46,9 @@ export function appendSituationalContext(nodeId, text) {
     mkdirSync(nodeDir(nodeId), { recursive: true });
     writeFileSync(situationalContextPath(nodeId), body + '\n', 'utf8');
 }
-/** Read the current situational context, or null if none was ever set. */
-export function readSituationalContext(nodeId) {
+/** Read the stored text, or null if none was ever set. Module-private:
+ *  `situationalContextEnvelope` is the one read, and it shape-checks. */
+function readSituationalContext(nodeId) {
     const p = situationalContextPath(nodeId);
     if (!existsSync(p))
         return null;

package/dist/core/runtime/situational-live.js

@@ -32,7 +32,7 @@ export async function setSituationalContextLive(nodeId, text) {
         throw new Error(`setSituationalContextLive: unknown node ${nodeId}`);
     const envelope = situationalContextEnvelope(nodeId);
     if (envelope === null)
-        return; // blank text — appendSituationalContext no-ops, nothing to deliver
+        return; // no sidecar at all — blank text on a node that never had one
     await deliverCustomMessageLive(nodeId, {
         customType: SITUATIONAL_CONTEXT_CUSTOM_TYPE,
         content: envelope,

package/dist/core/runtime/spawn.d.ts

@@ -67,10 +67,10 @@ export interface SpawnChildOpts {
     /** Preallocated node id, used when a managed worktree must be named before birth. */
     nodeId?: string;
     /** Hidden ambient "current situation" text — NOT the visible prompt/body.
-     *  Persisted via `appendSituationalContext` BEFORE launch so canvas-context-
-     *  intro's session_start bearings carry it as a `<situational-context>`
-     *  sibling from the node's very first turn. Passed through unchanged into a
-     *  scheduled node-birth command. Omit for no ambient context. */
+     *  Stored as a `situational` card BEFORE launch so canvas-context-intro's
+     *  session_start bearings nest it from the node's very first turn. Passed
+     *  through unchanged into a scheduled node-birth command. Omit for no
+     *  ambient context. */
     situationalContext?: string;
 }
 /** Resolve a `--fork-from` value to an ABSOLUTE `.jsonl` source path for the

package/dist/daemon/messaging/node-message.d.ts

@@ -5,7 +5,10 @@ export interface NodeMessageDelivery {
     revived: boolean;
 }
 export interface RuntimeMessageCard {
-    kind: string;
+    /** A bare core kind only. This renders with `formatCard`, which leaves the
+     *  body raw — a namespaced kind's body is decoded on read (D12) and would be
+     *  corrupted. Extend the union rather than widening to `string`. */
+    kind: 'review-comment' | 'review-queued' | 'review-approval';
     facts: Record<string, string | number | boolean | undefined>;
 }
 /**

package/dist/pi-extensions/canvas-inbox-watcher.js

@@ -705,8 +705,10 @@ class CanvasInboxWatcher {
             });
         }, stage);
     }
-    /** The visible delivery and its own entry's one-shot cards in ONE send, so a
-     *  failed body never leaves its cards delivered and requeued for a resend. */
+    /** The visible delivery and its own entry's one-shot cards share ONE failure
+     *  unit: a throw anywhere requeues the whole entry, so a retry may repeat a
+     *  card already handed off (context is restatable; the human's body is not,
+     *  and it is sent last). */
     sendVisible(entries, cards, content, route, stage) {
         return this.sendDelivery('visible', entries, () => {
             if (route !== 'idle' && route !== 'steer' && route !== 'followUp') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.206",
+  "version": "0.3.207",
   "description": "crtr — agent runtime with memory, plugins, and marketplaces",
   "type": "module",
   "main": "dist/index.js",

package/runtime.lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.206",
+  "version": "0.3.207",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@north-light/crouter",
-      "version": "0.3.206",
+      "version": "0.3.207",
       "hasInstallScript": true,
       "license": "MIT",
       "dependencies": {