@ai-matrx/content-ir 0.2.2 → 0.3.0

package/dist/index.d.cts

@@ -462,7 +462,7 @@ declare class KindStreamParser {
      * 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`
@@ -877,7 +877,7 @@ declare function envelopeCacheFromEnvelopes(envelopes: readonly CanonicalBlockIR
  *
  * The frontend host shell is `redux/render-block-envelope.ts` (binds the
  * hooks to `seedEnvelope` + `captureError`); aidream's Workflow Studio binds
- * its own. Contract: features/content-ir/docs/PYTHON_ENVELOPE_CONTRACT.md.
+ * its own. Contract: /Users/armanisadeghi/code/common-docs/systems/content-ir-system/PYTHON_ENVELOPE_CONTRACT.md.
  */
 
 /** Read a CanonicalBlockIR envelope off a block's metadata (or anything). */
@@ -1194,7 +1194,7 @@ interface KindDefinition {
  *     edges → the same `KindSchema` the parser/emitter consume, re-attaching
  *     `object.kind` / `array.itemKinds` from the edges by path.
  *
- * Design invariants (KIND_REGISTRY_STORAGE.md §4):
+ * Design invariants (from the 2026-07-05 kind-registry storage design, since deleted):
  *   - The `data` element is `FieldSchema` + `name`, MINUS ref targets. Order is
  *     intrinsic to the array (fixes the jsonb key-reorder bug).
  *   - `kind_edge` is the SINGLE source of truth for kind→kind refs: `object`
@@ -1334,7 +1334,7 @@ declare function storageToKindSchema(kind: string, shape: KindStorageShape): Kin
  * row out of production. This module is PURE (deps injected) so it runs in the
  * harness, in CI, and in a browser author-save alike.
  *
- * Ownership split (KIND_REGISTRY_STORAGE.md §2): the caller writes the outcome
+ * Ownership split (the 2026-07-05 kind-registry storage design, since deleted; the live contract is the code below): the caller writes the outcome
  * to the LIVE `content_ir.kind_definition` row's `is_active`; the canonical
  * `_version_capture` trigger snapshots that state into `history.row_versions`
  * (never a post-hoc history mutation).

package/dist/index.d.ts

@@ -462,7 +462,7 @@ declare class KindStreamParser {
      * 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`
@@ -877,7 +877,7 @@ declare function envelopeCacheFromEnvelopes(envelopes: readonly CanonicalBlockIR
  *
  * The frontend host shell is `redux/render-block-envelope.ts` (binds the
  * hooks to `seedEnvelope` + `captureError`); aidream's Workflow Studio binds
- * its own. Contract: features/content-ir/docs/PYTHON_ENVELOPE_CONTRACT.md.
+ * its own. Contract: /Users/armanisadeghi/code/common-docs/systems/content-ir-system/PYTHON_ENVELOPE_CONTRACT.md.
  */
 
 /** Read a CanonicalBlockIR envelope off a block's metadata (or anything). */
@@ -1194,7 +1194,7 @@ interface KindDefinition {
  *     edges → the same `KindSchema` the parser/emitter consume, re-attaching
  *     `object.kind` / `array.itemKinds` from the edges by path.
  *
- * Design invariants (KIND_REGISTRY_STORAGE.md §4):
+ * Design invariants (from the 2026-07-05 kind-registry storage design, since deleted):
  *   - The `data` element is `FieldSchema` + `name`, MINUS ref targets. Order is
  *     intrinsic to the array (fixes the jsonb key-reorder bug).
  *   - `kind_edge` is the SINGLE source of truth for kind→kind refs: `object`
@@ -1334,7 +1334,7 @@ declare function storageToKindSchema(kind: string, shape: KindStorageShape): Kin
  * row out of production. This module is PURE (deps injected) so it runs in the
  * harness, in CI, and in a browser author-save alike.
  *
- * Ownership split (KIND_REGISTRY_STORAGE.md §2): the caller writes the outcome
+ * Ownership split (the 2026-07-05 kind-registry storage design, since deleted; the live contract is the code below): the caller writes the outcome
  * to the LIVE `content_ir.kind_definition` row's `is_active`; the canonical
  * `_version_capture` trigger snapshots that state into `history.row_versions`
  * (never a post-hoc history mutation).

package/dist/index.js

@@ -384,7 +384,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,
@@ -899,7 +903,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`
@@ -1308,12 +1312,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);
@@ -1345,7 +1349,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);
@@ -1405,8 +1409,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);