@ai-matrx/records 0.58.0 → 0.58.2

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog — @ai-matrx/records
 
+## 0.58.2
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/records/v0.58.1..npm/records/v0.58.2 -- apps/shared/records`).
+No source changes intended and no consumer action required.
+
+## Unreleased — lane SC-1-TAILS (2026-09-24)
+
+* **`client.tableHome({ table_id })` and `client.tableMove({ table_id, to_organization_id, expected_version })`** — the
+  store utility for "which organization is this table in, and move it" (`custom.table_home` / `custom.table_move`,
+  SC-1' + SC-1-TAILS). Asked by the TABLE's id, never the bound organization; `null` = not given to this person;
+  `door_absent` (and nothing called) on a store whose catalogue lacks the doors.
+* `placement.ts` gains `TableHome`, `TableHomeDestination`, `TableMoved`, `parseTableHome`, `parseTableMoved` and
+  `moveConsequence` (the sentence said before a move: columns, rows, trash, the tables that live inside it, links
+  that reach back across the wall).
+* **Consumer action:** matrx-frontend swaps `features/unified-data/where-it-lives/` for `@ai-matrx/records-ui`'s
+  `WhereItLives` once both are installed. `pnpm records:generate` after the chair applies the doors.
+
+## 0.58.1
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/records/v0.58.0..npm/records/v0.58.1 -- apps/shared/records`).
+No source changes intended and no consumer action required.
+
 ## 0.58.0 (2026-09-24 — published by PUBLISH-SWEEP-5; folds every section below down to 0.57.3)
 
 * **`src/store.generated.ts` is regenerated from the LIVE main database at publish time** (608 doors).

package/dist/core/index.cjs

@@ -2310,6 +2310,7 @@ __export(core_exports, {
   memoryStore: () => memoryStore,
   mintClientKey: () => mintClientKey,
   mintOpId: () => mintOpId,
+  moveConsequence: () => moveConsequence,
   moveInOrder: () => moveInOrder,
   offeredAsContext: () => offeredAsContext,
   ok: () => ok,
@@ -2318,6 +2319,8 @@ __export(core_exports, {
   optionKey: () => optionKey,
   optionLabel: () => optionLabel,
   parseCsv: () => parseCsv,
+  parseTableHome: () => parseTableHome,
+  parseTableMoved: () => parseTableMoved,
   planQuery: () => planQuery,
   portalArchiveConsequence: () => portalArchiveConsequence,
   portalConfirmLine: () => portalConfirmLine,
@@ -3003,6 +3006,66 @@ function keptTableHref(fact, hrefs) {
   }
   return hrefs.table(fact.table_id);
 }
+function countOf(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
+function wordsOf(value) {
+  return typeof value === "string" && value.length > 0 ? value : null;
+}
+function parseTableHome(raw) {
+  if (!raw || typeof raw !== "object") return null;
+  const row = raw;
+  const table = row.table;
+  const org = row.organization;
+  if (!table || !org || !wordsOf(table.id) || !wordsOf(org.id) || !wordsOf(org.name)) return null;
+  const carries = row.carries ?? {};
+  const destinations = Array.isArray(row.destinations) ? row.destinations : [];
+  return {
+    table: { id: String(table.id), name: wordsOf(table.name) ?? "This table", version: countOf(table.version) },
+    organization: { id: String(org.id), name: String(org.name) },
+    mayMove: row.may_move === true,
+    whyNot: wordsOf(row.why_not),
+    heldBy: Array.isArray(row.held_by) ? row.held_by.filter((s) => typeof s === "string") : [],
+    destinations: destinations.filter((d) => !!d && typeof d === "object" && !!wordsOf(d.id)).map((d) => ({
+      id: String(d.id),
+      name: wordsOf(d.name) ?? "An organization",
+      role: wordsOf(d.role) ?? "member",
+      ok: d.ok === true,
+      why: wordsOf(d.why)
+    })),
+    carries: {
+      fields: countOf(carries.fields),
+      records: countOf(carries.records),
+      inTrash: countOf(carries.in_trash),
+      choiceLists: countOf(carries.choice_lists),
+      withIt: countOf(carries.with_it),
+      tablesInside: countOf(carries.tables_inside),
+      linksAcross: countOf(carries.links_across)
+    }
+  };
+}
+function parseTableMoved(raw) {
+  const row = raw ?? {};
+  const to = row.to ?? {};
+  const from = row.from ?? {};
+  const table = row.table ?? {};
+  if (row.moved !== true || !wordsOf(to.id)) return null;
+  return {
+    to: { id: String(to.id), name: wordsOf(to.name) ?? "the new organization" },
+    from: { id: wordsOf(from.id) ?? "", name: wordsOf(from.name) ?? "its old organization" },
+    tableName: wordsOf(table.name) ?? "The table"
+  };
+}
+function plural(n, one, many) {
+  return `${n} ${n === 1 ? one : many}`;
+}
+function moveConsequence(home, to) {
+  const c = home.carries;
+  const parts = [plural(c.fields, "column", "columns"), plural(c.records, "row", "rows")];
+  if (c.inTrash > 0) parts.push(`${c.inTrash} in the trash`);
+  const extra = c.choiceLists + c.withIt;
+  return `${home.table.name} moves to ${to.name} with its ${parts.join(", ")}` + (c.tablesInside > 0 ? `, the ${plural(c.tablesInside, "table", "tables")} that live${c.tablesInside === 1 ? "s" : ""} inside it or its rows (with their own rows)` : "") + (extra > 0 ? `, and ${plural(extra, "thing", "things")} built only on it (choice lists, rules, dashboards, templates)` : "") + `, its comments, forms, saved views and history. ` + (c.linksAcross > 0 ? `${plural(c.linksAcross, "link", "links")} to rows that stay in ${home.organization.name} keep${c.linksAcross === 1 ? "s" : ""} pointing there, across the two organizations. ` : "") + `People who see it only because they are in ${home.organization.name} stop seeing it; people it was shared with by name keep it. You can move it back from the same place.`;
+}
 
 // src/capture-queue.ts
 var DB_NAME = "matrx-capture";
@@ -3072,7 +3135,7 @@ function memoryStore() {
     setMeta: async (key, value) => void meta.set(key, value)
   };
 }
-function countOf(items) {
+function countOf2(items) {
   const c = { waiting: 0, sending: 0, refused: 0, landed: 0 };
   for (const i of items) c[i.state] += 1;
   return c;
@@ -3089,7 +3152,7 @@ function openCaptureQueue(opts) {
   const announce = async () => {
     if (!opts.onChange) return;
     const items = await store.all();
-    opts.onChange(countOf(items), items);
+    opts.onChange(countOf2(items), items);
   };
   const oldestFirst = (items) => items.slice().sort((a, b) => a.captured_at.localeCompare(b.captured_at));
   const queue = {
@@ -3118,7 +3181,7 @@ function openCaptureQueue(opts) {
       return key;
     },
     list: () => store.all().then(oldestFirst),
-    counts: () => store.all().then(countOf),
+    counts: () => store.all().then(countOf2),
     async sync() {
       if (syncing) return syncing;
       syncing = (async () => {
@@ -5368,6 +5431,8 @@ function scopeChip(scope) {
 
 // src/core/doors.ts
 var OWED_BY = {
+  table_home: "SC-1' \u2014 matrx-frontend migrations/campaign/sc1p_a_table_says_where_it_lives_and_its_owner_can_move_it.sql (and its grant file), applied by the chair",
+  table_move: "SC-1' / SC-1-TAILS \u2014 sc1p_a_table_says_where_it_lives_and_its_owner_can_move_it.sql, then sc1t_a_table_moves_with_the_tables_inside_it.sql, applied by the chair",
   metadata_search: "W5-SRV / W5-AGENT \u2014 the agent surface's eight verbs",
   record_aggregate: "W5-SRV / W5-AGENT \u2014 `record_aggregate` is one of the eight verbs",
   field_propose: "W5-AGENT \u2014 AGT-4/AGT-8, the proposal and its approvers",
@@ -5693,6 +5758,12 @@ var DOORS = {
   // ask, under the same wall and visibility gate as `portals` itself.
   portalTables: "portal_tables",
   tableFacts: "table_facts",
+  // WHERE A TABLE LIVES, AND MOVING IT (SC-1' / SC-1-TAILS). `table_home` answers only when the
+  // caller may open the Table (custom.where_id_opens) and names its organization FROM THE TABLE;
+  // `table_move` moves it into another organization the caller belongs to, with every Table
+  // inside it, or refuses with one sentence.
+  tableHome: "table_home",
+  tableMove: "table_move",
   portalCard: "portal_card",
   portalDeclare: "portal_declare",
   portalInvite: "portal_invite",
@@ -6215,6 +6286,40 @@ function createRecordsClient(config) {
       if (!doorExists(DOORS.tableFacts)) return ok(null);
       return callDoor(DOORS.tableFacts, { p_organization_id: org }, "tableFacts");
     },
+    async tableHome({ table_id }) {
+      const answered = await callDoor(DOORS.tableHome, { p_table_id: table_id }, "tableHome");
+      if (!answered.ok) return answered;
+      if (answered.data === null || answered.data === void 0) return ok(null);
+      const home = parseTableHome(answered.data);
+      if (!home) {
+        const refusal = {
+          code: "not_supported",
+          message: "The record store answered where this table lives in a shape this client cannot read, so nothing is claimed about it.",
+          hint: "Regenerate @ai-matrx/records against the store (pnpm records:generate) \u2014 the door and this client disagree."
+        };
+        scream({ code: refusal.code, message: refusal.message, ...refusal.hint ? { hint: refusal.hint } : {}, where: "tableHome" });
+        return err(refusal);
+      }
+      return ok(home);
+    },
+    async tableMove({ table_id, to_organization_id, expected_version }) {
+      const answered = await callDoor(
+        DOORS.tableMove,
+        { p_table_id: table_id, p_to_organization_id: to_organization_id, p_expected_version: expected_version ?? null },
+        "tableMove"
+      );
+      if (!answered.ok) return answered;
+      const moved = parseTableMoved(answered.data);
+      if (!moved) {
+        const refusal = {
+          code: "not_supported",
+          message: "The record store answered the move in a shape this client cannot read. Look where the table lives before trying again."
+        };
+        scream({ code: refusal.code, message: refusal.message, where: "tableMove" });
+        return err(refusal);
+      }
+      return ok(moved);
+    },
     async tableArchived({ table_id }) {
       const kernel = await callDoor(DOORS.tableKernelId, {}, "tableArchived.kernel");
       if (!kernel.ok) return err(kernel.error);