@ai-matrx/records 0.75.4 → 0.76.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog — @ai-matrx/records
 
+## 0.76.0
+
+**Template seed rows carry a row icon (CHAIR-TEMPLATE-UPGRADE).**
+
+- `UseCaseRow.icon?: string` — a `@ai-matrx/icons` name (e.g. "Package"). `rowsFor` writes it as the
+  record's own `icon`, so an installed template's rows draw their icon wherever a link to them shows
+  (`custom.relation_words_with_icons_many` reads `data->>'icon'`).
+- Store side (live 2026-10-06, migration `chair_template_upgrade_b_seed_rows_carry_an_icon`):
+  `custom.record_platform_keys()` now lists `icon` beside `parent_id`, so a `fields` Table accepts it
+  without a column; `custom.template_upgrade` sets the new version's row icon on rows the install
+  already has, only where the row has none (counted as `counts.icons`). An icon a person set is never
+  overwritten.
+
+**Consumer action:** none. A template that wants row icons sets `icon` on its rows and bumps its version.
+
 ## 0.75.4
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/memory/index.cjs

@@ -406,6 +406,7 @@ function rowsFor(table, ids, deferred) {
       }
       values[key] = Array.isArray(value) ? value.map((v) => idOf(rel.relationTarget, v)) : idOf(rel.relationTarget, value);
     }
+    if (typeof r.icon === "string" && r.icon.trim()) values["icon"] = r.icon.trim();
     values["_actor"] = ACTOR;
     return values;
   });