@ai-matrx/content-ir 0.2.1 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 0.3.0 — 2026-08-29
+
+- **KIND PRESERVATION now covers STRUCTURAL raws.** A node that degrades to
+  `raw_object` because its value failed schema validation, carried a duplicate
+  key, or violated the parent's `itemKinds` keeps its identified kind on the
+  raw event, the envelope root (`root.kind` with `kindState: "raw"`), and the
+  `nodeIndex` entry for nested children. Previously only schema-availability
+  raws preserved the kind, so a payload that was off by ONE field rendered as
+  anonymous raw JSON with no repaint subscription and no route — the single
+  most damaging class of the 2026-08-29 "kind slips through the cracks" audit
+  (crack #9). The render seam's registration boundary is unchanged: an
+  unregistered slug is still never claimed. Consumers should route a
+  registered kind-preserved raw to their generic floor and surface
+  `residue.notices` (the exact `raw_fallback` reason is recorded there).
+  Pinned by two new kind-parser tests.
+
+## 0.2.2 — 2026-08-24
+
+- `rehydrateRunResult` now rejects nested entries whose `__kind` is not
+  `node_outcome`, even when the object carries plausible run/node identity.
+  This keeps a malformed sibling from masquerading as a valid terminal result.
+- Workflow Studio now delegates runtime-wrapper field reading and output-ref
+  rehydration to the package APIs; its host adapter retains only deferred,
+  persistent diagnostics for present-but-broken wrappers.
+
 ## 0.2.1 — 2026-08-24
 
 - **FIX — `validateStructuralLeg` no longer rejects every current kind

package/dist/index.cjs

@@ -390,7 +390,11 @@ var IrTree = class {
     }
     for (const [pathKey] of this.rawPaths) {
       if (pathKey === "") continue;
-      nodeIndex[pathKey] = { kind: "", kindState: "raw", status: "complete" };
+      nodeIndex[pathKey] = {
+        kind: this.rawKinds.get(pathKey) ?? "",
+        kindState: "raw",
+        status: "complete"
+      };
     }
     return {
       v: IR_VERSION,
@@ -905,7 +909,7 @@ var KindStreamParser = class {
    * Recorded at the first root key; ADOPTED only when the root object closes
    * (`completeTypedObject`). That is the surface registry's complete-only
    * convergence law, and every json_root_key row is `streaming:false` — these
-   * legacy shapes are recognised by their whole payload, so speculating
+   * legacy shapes are recognized by their whole payload, so speculating
    * mid-stream would flash a kind component over an object that may never
    * satisfy the schema. An explicit `expectedRootKind` (an agent's declared
    * output schema) is stronger context and always wins; an actual `__kind`
@@ -1314,12 +1318,12 @@ var KindStreamParser = class {
     }
     const arrayItemError = this.validateArrayItemKind(path, kind);
     if (arrayItemError) {
-      this.emitRawObject(path, objectValue, arrayItemError, at);
+      this.emitRawObject(path, objectValue, arrayItemError, at, kind);
       return;
     }
     const outcome = this.validateObjectAgainstSchema(objectValue, schema);
     if (outcome.error) {
-      this.emitRawObject(path, objectValue, outcome.error, at);
+      this.emitRawObject(path, objectValue, outcome.error, at, kind);
       return;
     }
     this.objectKinds.set(pathKey, kind);
@@ -1351,7 +1355,7 @@ var KindStreamParser = class {
       schema
     );
     if (outcome.error) {
-      this.emitRawObject(path, objectValue, outcome.error, at);
+      this.emitRawObject(path, objectValue, outcome.error, at, kind);
       return;
     }
     this.emitSchemaNotices(path, kind, outcome, at);
@@ -1411,8 +1415,9 @@ var KindStreamParser = class {
   markNodeRaw(path, liveValue, reason, at) {
     const pathKey = this.pathKey(path);
     if (this.rawObjectPaths.has(pathKey)) return;
+    const identifiedKind = this.objectKinds.get(pathKey) ?? (typeof liveValue === "object" && liveValue !== null && !Array.isArray(liveValue) ? readObjectKind(liveValue) ?? void 0 : void 0);
     this.speculativeKinds.delete(pathKey);
-    this.emitRawObject(path, safeCopy(liveValue), reason, at);
+    this.emitRawObject(path, safeCopy(liveValue), reason, at, identifiedKind);
   }
   emitRawObject(path, value, reason, at, identifiedKind) {
     const pathKey = this.pathKey(path);
@@ -4376,7 +4381,7 @@ function rehydrateRunResult(raw, frame) {
   if (raw[KIND_KEY] !== RUN_RESULT_KIND) return null;
   const ref = str(raw, "output_ref");
   const resolved = ref === null ? void 0 : readOutputRef(frame, ref);
-  const outputs = Array.isArray(raw.outputs) ? raw.outputs.map((child) => rehydrateNodeOutcome(child, frame) ?? child) : [];
+  const outputs = Array.isArray(raw.outputs) ? raw.outputs.map((child) => rehydrateNodeOutcome(child, frame)).filter((child) => child !== null) : [];
   return readRunResultValue({
     ...raw,
     ...resolved === void 0 ? {} : { output: resolved },