@ai-matrx/associations 0.13.135 → 0.13.136

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog — @ai-matrx/associations
 
+## 0.13.136
+
+**A retired entity token never crashes the host.** `getEntityInfo(token)` for a token the live
+vocabulary no longer carries now returns a stand-in labelled `<token> (retired)` and reports
+`retired_entity_token` through the errorSink once per token, instead of throwing
+`Cannot read properties of undefined (reading 'titleColumn')`. 0.13.135's regenerated vocabulary
+dropped `dataset`, `structured_list`, `udt_dataset_*` and `udt_structured_list_items` (deactivated
+in `platform.entity_types` by the custom-data cutover) — its changelog line "no source changes"
+was wrong — and a module-scope `getEntityInfo("structured_list")` in the frontend then crashed
+every route of the dev app (found by real test PB-05, 2026-10-02 19:46Z).
+
+**Consumer action:** search your code for the retired tokens above and move each reference to
+the live token; each one now lands in your error sink as `retired_entity_token` until you do.
+
 ## 0.13.135
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see
@@ -991,7 +1005,7 @@ Automatic changed-only republish (docs/metadata drift since the last tag — see
 `git diff npm/associations/v0.10.2..npm/associations/v0.10.3 -- apps/shared/associations`).
 No source changes intended and no consumer action required.
 
-## Unreleased
+## 0.13.136
 
 Regenerated the entity vocabulary from the live registry (999 active tokens): adds
 `document`, `document_version`, `message_template_detail`, `skill_detail` and

package/dist/core/index.cjs

@@ -2403,8 +2403,35 @@ function createEntityRegistry(errorSink, initialOverlay) {
   const overlayByToken = {
     ...initialOverlay ?? {}
   };
+  const retiredReported = /* @__PURE__ */ new Set();
+  function retiredTokenMeta(token) {
+    if (!retiredReported.has(token)) {
+      retiredReported.add(token);
+      errorSink({
+        code: "retired_entity_token",
+        message: `[entityRegistry] "${token}" is not in the live entity vocabulary (retired or renamed in platform.entity_types). The host still references it; rename the reference to the live token, or drop it. Serving a stand-in so the page can render.`,
+        context: { token }
+      });
+    }
+    return {
+      token,
+      schema: "",
+      table: "",
+      label: `${token} (retired)`,
+      baseTier: 1,
+      isComponent: false,
+      isModule: false,
+      isListed: false,
+      scopeable: false,
+      category: null,
+      referencePickable: false,
+      titleColumn: null,
+      contentRole: null,
+      referenceCategory: null
+    };
+  }
   function getEntityInfo(token) {
-    const meta = ENTITY_TYPE_METADATA[token];
+    const meta = ENTITY_TYPE_METADATA[token] ?? retiredTokenMeta(token);
     const overlay = overlayByToken[token];
     const labelPlural = overlay?.labelPlural ?? `${meta.label}s`;
     const titleColumn = meta.titleColumn;