@ai-matrx/records 0.58.117 → 0.58.118

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog — @ai-matrx/records
 
+## 0.58.118
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/records/v0.58.117..npm/records/v0.58.118 -- apps/shared/records`).
+No source changes intended and no consumer action required.
+
 ## 0.58.117
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see
@@ -9,6 +15,8 @@ No source changes intended and no consumer action required.
 ## 0.58.116
 ### Unreleased
 
+- **Metadata search, aggregate and owner lookup span organizations** (active-org law, 2026-09-30): new `organizationsOpen()` (which of the person's organizations can answer, unavailable ones WITH reason), `ownerOrganization({table_id|record_id})`; `metadataSearch({text, organization_id?})` now returns `{matches, organizations_covered, unavailable}` (each match carries `organization_id`; was a door-absent refusal typed `never`, still a refusal when no organization answers); `recordAggregate` takes optional `organization_id` and, with `config.organizationIds`, runs in the table's owning organization (rows carry `organization_id`). No `organizationIds` = unchanged. Consumer action: none required; matrx-extend drops its per-org fan-out.
+
 - **`wholeValueSize` is kit's `formatFileSize`** (package-twins drain, 2026-09-30): `728 KB` unchanged; a pointer under 10 KB reads `5.0 KB` (was `5 KB`) and one under 1 KB reads `512 B` (was `1 KB`). New dependency: `@ai-matrx/kit` (`workspace:*`). Consumer action: none.
 
 ## 0.58.115

package/dist/core/index.cjs

@@ -40986,6 +40986,13 @@ function createRecordsClient(config) {
     }
     return last;
   }
+  const spans = (filter) => Boolean(filter) || (config.organizationIds?.length ?? 0) > 0;
+  const metadataSearchDoor = () => {
+    const refusal = doorAbsent(DOORS.metadataSearch);
+    scream({ code: refusal.code, message: refusal.message, ...refusal.hint ? { hint: refusal.hint } : {}, where: "metadataSearch" });
+    return err(refusal);
+  };
+  const unavailableReason = (error) => `${error.message}${error.hint ? ` ${error.hint}` : ""}`;
   const client = {
     config,
     async recordWrite({ table_id, data }) {
@@ -42315,7 +42322,23 @@ function createRecordsClient(config) {
         "dashboardDelete"
       );
     },
-    async recordAggregate({ table_id, groupBy, measures, bucket, filter, limit, compare }) {
+    async recordAggregate({ table_id, organization_id, groupBy, measures, bucket, filter, limit, compare }) {
+      if (spans(organization_id)) {
+        const owner = await client.ownerOrganization({ table_id, ...organization_id ? { organization_id } : {} });
+        const target = owner.ok && owner.data ? owner.data : organization_id ?? org;
+        if (target !== org) {
+          const answered = await clientFor(target).recordAggregate({
+            table_id,
+            ...groupBy ? { groupBy } : {},
+            ...measures ? { measures } : {},
+            ...bucket !== void 0 ? { bucket } : {},
+            ...filter ? { filter } : {},
+            ...limit !== void 0 ? { limit } : {},
+            ...compare !== void 0 ? { compare } : {}
+          });
+          return answered.ok ? ok(answered.data.map((row) => ({ ...row, organization_id: target }))) : answered;
+        }
+      }
       return callDoor(
         DOORS.recordAggregate,
         {
@@ -43231,10 +43254,80 @@ function createRecordsClient(config) {
         "ruleDeclare"
       );
     },
-    async metadataSearch() {
-      const refusal = doorAbsent(DOORS.metadataSearch);
-      scream({ code: refusal.code, message: refusal.message, ...refusal.hint ? { hint: refusal.hint } : {}, where: "metadataSearch" });
-      return err(refusal);
+    async metadataSearch({ text, organization_id }) {
+      if (spans(organization_id) && readOrgs(organization_id).length > 0) {
+        const targets = readOrgs(organization_id).filter((t) => t !== null);
+        const unavailable = [];
+        const answers = await Promise.all(
+          targets.map(async (t) => {
+            const sub = clientFor(t);
+            const open = await sub.storeIsOpen();
+            if (!open.ok) {
+              unavailable.push({ organization_id: t, reason: unavailableReason(open.error) });
+              return null;
+            }
+            if (!open.data) {
+              unavailable.push({ organization_id: t, reason: "The custom data store is switched off for this organization." });
+              return null;
+            }
+            const found = metadataSearchDoor();
+            if (!found.ok) {
+              unavailable.push({ organization_id: t, reason: unavailableReason(found.error) });
+              return { t, found };
+            }
+            return { t, found };
+          })
+        );
+        const matches = [];
+        const covered = [];
+        let firstRefusal = null;
+        for (const answer of answers) {
+          if (!answer) continue;
+          if (!answer.found.ok) {
+            firstRefusal ??= answer.found.error;
+            continue;
+          }
+          covered.push(answer.t);
+          for (const m of answer.found.data.matches) matches.push({ ...m, organization_id: answer.t });
+        }
+        const inOrder = (a, b) => targets.indexOf(a.organization_id) - targets.indexOf(b.organization_id);
+        unavailable.sort(inOrder);
+        if (covered.length === 0 && firstRefusal) return err(firstRefusal);
+        return ok({ matches, organizations_covered: covered, unavailable });
+      }
+      return metadataSearchDoor();
+    },
+    async organizationsOpen(args) {
+      const targets = readOrgs(args?.organization_id).filter((t) => t !== null);
+      const open = [];
+      const unavailable = [];
+      await Promise.all(
+        targets.map(async (t) => {
+          const result = await clientFor(t).storeIsOpen();
+          if (!result.ok) unavailable.push({ organization_id: t, reason: unavailableReason(result.error) });
+          else if (!result.data)
+            unavailable.push({ organization_id: t, reason: "The custom data store is switched off for this organization." });
+          else open.push(t);
+        })
+      );
+      const position = (id) => targets.indexOf(id);
+      open.sort((a, b) => position(a) - position(b));
+      unavailable.sort((a, b) => position(a.organization_id) - position(b.organization_id));
+      return ok({ open, unavailable });
+    },
+    async ownerOrganization({ table_id, record_id, organization_id }) {
+      if (table_id) {
+        const read = await client.tableRead({ table_id, ...organization_id ? { organization_id } : {} });
+        if (!read.ok) return err(read.error);
+        return ok(read.data ? read.data.organization_id ?? null : null);
+      }
+      if (record_id) {
+        const read = await client.recordRead({ record_id, ...organization_id ? { organization_id } : {} });
+        if (!read.ok) return ok(null);
+        const targets = readOrgs(organization_id);
+        return ok(recordOrgs.get(record_id) ?? organization_id ?? (targets.length === 1 ? targets[0] ?? null : null));
+      }
+      return ok(null);
     },
     async fieldPropose() {
       const refusal = doorAbsent(DOORS.fieldPropose);