@ai-matrx/content-ir 0.19.20 → 0.19.21

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.19.21
+### Unreleased
+
+- `/core` **A MISSING FIELD NEVER DEGRADES A BLOCK** (Arman, 2026-09-28). `validateObjectAgainstSchema` / `validateObjectAgainstFields` no longer turn an absent `required` field into a `raw_fallback`: the block resolves, the snapshot fills the field blank (`emptyValueForFieldSchema`), and the gap rides the residue. Only a PRESENT value of the wrong type is still a contract violation. A pure prediction (`expectedRootKind` / parent-schema speculation, no `__kind`, no surface) claims an object only when it carries at least one of the kind's fields, so unrelated data is never hidden behind an empty component. Effect: legacy `json_root_key` payloads (`quiz_title`, `comparison`, `decision_tree`, `diagram`, `presentation`, `math_problem`) now resolve to their kind while STREAMING and in client-only parses, instead of showing "missing required field" until the server's saved copy arrived. Consumer action: kind bridges must read their legacy wrapped/renamed shape (matrx-frontend `unwrapLegacyRoot` in `features/content-ir/kinds/legacy-bridge-utils.ts`).
+
 ## 0.19.20
 ### Unreleased
 

package/dist/core.cjs

@@ -1268,7 +1268,7 @@ var KindStreamParser = class {
     }
     if (!declaredKind && committedKind && this.speculativeKinds.has(pathKey)) {
       this.speculativeKinds.delete(pathKey);
-      this.finalizeSpeculatedObject(path, objectValue, committedKind, at);
+      this.finalizeSpeculatedObject(path, objectValue, committedKind, at, true);
       return;
     }
     if (path.length === 0 && !declaredKind && !committedKind && this.rootSurfaceKind) {
@@ -1346,7 +1346,7 @@ var KindStreamParser = class {
     });
   }
   /** Validate + complete an object typed purely by parent prediction. */
-  finalizeSpeculatedObject(path, objectValue, kind, at) {
+  finalizeSpeculatedObject(path, objectValue, kind, at, requireSharedField = false) {
     const schema = this.lookupSchema(kind);
     if (!schema) {
       this.emitRawObject(
@@ -1359,6 +1359,15 @@ var KindStreamParser = class {
       );
       return;
     }
+    if (requireSharedField && !Object.keys(objectValue).some((key) => key in schema.fields)) {
+      this.emitRawObject(
+        path,
+        objectValue,
+        `Object carries none of "${kind}"'s fields.`,
+        at
+      );
+      return;
+    }
     const outcome = this.validateObjectAgainstSchema(
       { ...objectValue, [KIND_KEY]: kind },
       schema
@@ -1619,16 +1628,7 @@ var KindStreamParser = class {
         ...emptyOutcome
       };
     }
-    for (const [fieldName, fieldSchema] of Object.entries(schema.fields)) {
-      if (fieldSchema.required) {
-        if (!(fieldName in objectValue)) {
-          return {
-            error: `Kind "${schema.kind}" is missing required field "${fieldName}".`,
-            ...emptyOutcome
-          };
-        }
-        continue;
-      }
+    for (const fieldName of Object.keys(schema.fields)) {
       if (!(fieldName in objectValue)) {
         optionalMissing.push(fieldName);
       }
@@ -1835,17 +1835,7 @@ var KindStreamParser = class {
   validateObjectAgainstFields(objectValue, fields) {
     const optionalMissing = [];
     const extraFields = [];
-    const emptyOutcome = { optionalMissing, extraFields };
-    for (const [fieldName, fieldSchema] of Object.entries(fields)) {
-      if (fieldSchema.required) {
-        if (!(fieldName in objectValue)) {
-          return {
-            error: `Inline object is missing required field "${fieldName}".`,
-            ...emptyOutcome
-          };
-        }
-        continue;
-      }
+    for (const fieldName of Object.keys(fields)) {
       if (!(fieldName in objectValue)) {
         optionalMissing.push(fieldName);
       }