aimeat 1.40.1 → 2.0.0

package/dist/src/storage/repositories/invitation.repository.d.ts

@@ -13,6 +13,8 @@
  *   v1.0.0 — 2026-07-04 — Initial (email invitations for unregistered users).
  *   v1.1.0 — 2026-07-05 — Add provisioned-code invitations: type ('link'|'code'), provisionedOwner, countInvitationsByInviter (per-inviter quota).
  *   v1.2.0 — 2026-07-07 — Add getCodeInvitationByProvisionedOwner (first-login credential issuance, TARGET-011).
+ *   v1.3.0 — 2026-07-18 — Add returnUrl: an allowlisted app/node URL the inviter can pin so a link
+ *     invitee lands back in the inviting app (e.g. the Experience Center) already signed in after accept.
  */
 /** One selected workspace + the role the invitee should receive there. */
 export interface InvitationWorkspaceGrant {
@@ -36,6 +38,7 @@ export interface InvitationRecord {
     expiresAt: string;
     acceptedAt: string | null;
     acceptedBy: string | null;
+    returnUrl: string | null;
 }
 export interface InvitationRepository {
     /** Persist a new email invitation (token stored as hash only). */

package/dist/src/storage/repositories/invitation.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"invitation.repository.d.ts","sourceRoot":"","sources":["../../../../src/storage/repositories/invitation.repository.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,0EAA0E;AAC1E,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,GAAG,aAAa,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC5B,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,UAAU,EAAE,wBAAwB,EAAE,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,+EAA+E;IAC/E,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACzE,+DAA+D;IAC/D,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC5D,8FAA8F;IAC9F,yBAAyB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC3H,yFAAyF;IACzF,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxK;;mFAE+E;IAC/E,mCAAmC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACrF,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACnG,iGAAiG;IACjG,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5D"}
+{"version":3,"file":"invitation.repository.d.ts","sourceRoot":"","sources":["../../../../src/storage/repositories/invitation.repository.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,0EAA0E;AAC1E,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,GAAG,aAAa,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC5B,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,UAAU,EAAE,wBAAwB,EAAE,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,+EAA+E;IAC/E,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACzE,+DAA+D;IAC/D,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC5D,8FAA8F;IAC9F,yBAAyB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC3H,yFAAyF;IACzF,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxK;;mFAE+E;IAC/E,mCAAmC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACrF,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACnG,iGAAiG;IACjG,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5D"}

package/dist/src/storage/repositories/invitation.repository.js

@@ -13,6 +13,8 @@
  *   v1.0.0 — 2026-07-04 — Initial (email invitations for unregistered users).
  *   v1.1.0 — 2026-07-05 — Add provisioned-code invitations: type ('link'|'code'), provisionedOwner, countInvitationsByInviter (per-inviter quota).
  *   v1.2.0 — 2026-07-07 — Add getCodeInvitationByProvisionedOwner (first-login credential issuance, TARGET-011).
+ *   v1.3.0 — 2026-07-18 — Add returnUrl: an allowlisted app/node URL the inviter can pin so a link
+ *     invitee lands back in the inviting app (e.g. the Experience Center) already signed in after accept.
  */
 export {};
 //# sourceMappingURL=invitation.repository.js.map

package/dist/src/storage/repositories/invitation.repository.js.map

@@ -1 +1 @@
-{"version":3,"file":"invitation.repository.js","sourceRoot":"","sources":["../../../../src/storage/repositories/invitation.repository.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}
+{"version":3,"file":"invitation.repository.js","sourceRoot":"","sources":["../../../../src/storage/repositories/invitation.repository.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/src/storage/repositories/memory.repository.d.ts

@@ -29,6 +29,21 @@ export interface MemoryVersionRecord {
     /** ISO timestamp this version was archived (the retired version's updatedAt). */
     recordedAt: string;
 }
+/** Lightweight memory row WITHOUT the (potentially large) `value` — key + metadata + the stored
+ *  per-row `byteSize`. Backs the profile Memory tab's `?include=meta` listing so opening a keyspace of
+ *  thousands of keys never loads or serialises a single value: the DB projects these columns only. */
+export interface MemoryMetaRow {
+    key: string;
+    ownerGaii: string;
+    visibility: MemoryRecord['visibility'];
+    tags: string[];
+    version: number;
+    flagCount: number;
+    /** Byte size of the value (the stored per-row byteSize; 0 for legacy rows not yet rewritten). */
+    byteSize: number;
+    createdAt: string;
+    updatedAt: string;
+}
 /** A single ranked full-text hit from {@link MemoryRepository.searchText}. */
 export interface MemoryTextHit {
     record: MemoryRecord;
@@ -56,6 +71,67 @@ export interface MemoryRepository {
     /** Atomically update memory only if the current version matches expectedVersion. Returns null on conflict. */
     setMemoryIfVersion?(record: MemoryRecord, expectedVersion: number): Promise<MemoryRecord | null>;
     getMemory(ownerGaii: string, key: string): Promise<MemoryRecord | null>;
+    /**
+     * BULK PRIMITIVE — read MANY keys under ONE owner in a single `key IN (…)` query (data-access
+     * redesign, Phase 1). Backs the batched existing-row lookup a bulk write does, replacing one
+     * getMemory per entry (an N-entry import was N serial round-trips just to check existence). Returns
+     * only the keys that exist (live, non-expired); order is not guaranteed — the caller indexes by key.
+     * Optional so a backend without it falls back to the adapter's per-key loop.
+     */
+    getMemoryByKeys?(ownerGaii: string, keys: string[]): Promise<MemoryRecord[]>;
+    /**
+     * BULK PRIMITIVE — read MANY keys ACROSS ALL owners in one `key IN (…)` query (Phase 2). Unlike
+     * {@link getMemoryByKeys} (single owner), this fetches every live row whose key is in the set no matter
+     * which owner holds it — for a fixed, caller-known key list whose owners are NOT known up front (e.g.
+     * the `…meta.manifest` key of each workspace in an organism: one owner per workspace, but a different
+     * member may own each). Collapses a per-key `listAllMemory` probe loop (the discovery list's
+     * per-workspace canReadWs manifest scan) into ONE query. Returns only existing (live, non-expired) rows;
+     * order is not guaranteed and a key forked across owners may return more than one row (the caller
+     * dedupes, e.g. by freshest). Optional — a backend without it falls back to a per-key any-owner loop.
+     */
+    getMemoryByKeysAnyOwner?(keys: string[]): Promise<MemoryRecord[]>;
+    /**
+     * BULK PRIMITIVE — upsert MANY rows as ONE unit (Phase 1). Same per-row semantics as
+     * {@link setMemory} (version bump, trackable-history archive, byteSize), but committed together
+     * (SQLite: one transaction) so a bulk import pays one commit instead of N. Optional; the adapter
+     * falls back to a sequential loop when absent.
+     */
+    bulkSetMemory?(records: MemoryRecord[]): Promise<MemoryRecord[]>;
+    /**
+     * BULK PRIMITIVE — delete a record's whole family (`baseKey` itself plus its `baseKey.*` children:
+     * `.draft` / `.latest` / `.version.N`) under one owner in ONE statement (Phase 1), WITHOUT matching a
+     * sibling `baseKeyX`. Replaces the per-key gated deletes a record teardown does today (a 550-record
+     * CADENCE delete was thousands of round-trips). Returns the number of rows removed. Optional.
+     */
+    deleteMemorySubtree?(ownerGaii: string, baseKey: string): Promise<number>;
+    /**
+     * BULK PRIMITIVE — delete EVERY memory row whose key begins with `keyPrefix`, across ALL owners, in
+     * ONE statement (Phase 2). Backs the whole-workspace / whole-organism wipe (organism.{id}.[w.{ws}.]*),
+     * replacing its per-key deleteMemory loop over thousands of rows. Deletes active AND archived rows —
+     * a wipe removes the container entirely. Pass a prefix ending at a key boundary (e.g. `organism.{id}.`)
+     * so a sibling id can't be caught. Returns the number of rows removed. Optional.
+     */
+    deleteMemoryByPrefix?(keyPrefix: string): Promise<number>;
+    /**
+     * BULK PRIMITIVE — delete MANY rows addressed by explicit (ownerGaii, key) pairs in ONE unit (Phase 2:
+     * SQLite = one transaction; Prisma = chunked deleteMany). Backs the batched record-family delete
+     * (a caller-authorized set of rows collected across records that may span owner identities). Returns
+     * the number of rows removed. Optional.
+     */
+    bulkDeleteMemory?(refs: {
+        ownerGaii: string;
+        key: string;
+    }[]): Promise<number>;
+    /**
+     * BULK PRIMITIVE — enumerate the (ownerGaii, key) ADDRESSES of every row under a key prefix, across ALL
+     * owners, WITHOUT loading any value (Phase 2). Backs the batched record delete: it needs only the
+     * addresses to filter (same-owner + role) and delete, so a value-loading `listAllMemory` scan per
+     * record was pure waste (the value bytes dominated the delete cost). Cheap even over a whole namespace.
+     */
+    listMemoryKeysByPrefix?(keyPrefix: string): Promise<{
+        ownerGaii: string;
+        key: string;
+    }[]>;
     listMemory(ownerGaii: string, opts?: {
         prefix?: string;
         visibility?: string;
@@ -63,6 +139,40 @@ export interface MemoryRepository {
         maxFlags?: number;
         archived?: ArchiveFilter;
     }): Promise<MemoryRecord[]>;
+    /**
+     * List one owner's memory as lightweight META rows — key + metadata + stored `byteSize`, with the
+     * `value` NEVER loaded or transferred (the DB projects only the metadata columns). Backs
+     * `GET /v1/memory?include=meta`: the profile Memory tab lists thousands of keys + their sizes without
+     * paying to deserialise + re-serialise every value (the old meta path loaded all values just to omit
+     * them from the response and sum bytes in JS). Same filters as {@link listMemory}.
+     */
+    listMemoryMeta(ownerGaii: string, opts?: {
+        prefix?: string;
+        visibility?: string;
+        tags?: string[];
+        maxFlags?: number;
+        archived?: ArchiveFilter;
+    }): Promise<MemoryMetaRow[]>;
+    /**
+     * List memory across MANY owner identities in ONE query (ownerGaii IN …) — the owner-scope union in
+     * a single round-trip instead of one {@link listMemory} per identity (an owner with ~100 agents was
+     * ~65 serial reads). Rows may contain the same key under several identities; the caller
+     * (services/owner-memory.ts) dedups GHII-first. `*Meta` is the value-free variant for ?include=meta.
+     */
+    listMemoryForOwners(ownerGaiis: string[], opts?: {
+        prefix?: string;
+        visibility?: string;
+        tags?: string[];
+        maxFlags?: number;
+        archived?: ArchiveFilter;
+    }): Promise<MemoryRecord[]>;
+    listMemoryMetaForOwners(ownerGaiis: string[], opts?: {
+        prefix?: string;
+        visibility?: string;
+        tags?: string[];
+        maxFlags?: number;
+        archived?: ArchiveFilter;
+    }): Promise<MemoryMetaRow[]>;
     /**
      * Count DISTINCT memory keys across the given owner identities (GHII + agents + GEAIs) — cheap
      * (no values loaded/transferred), mirroring listOwnerScopeMemory's key-dedup. For stat displays
@@ -73,6 +183,19 @@ export interface MemoryRepository {
         visibility?: string;
         archived?: ArchiveFilter;
     }): Promise<number>;
+    /**
+     * Sum the byte size of all of ONE owner's memory VALUES, computed DB-side (no values loaded/
+     * transferred). Backs the memory total-size quota (§8.2). Cheap and O(1)-ish via a stored
+     * per-row `byteSize`, unlike loading every record and re-serialising its value on each write —
+     * that load-all was O(N) per write / O(N²) per bulk import.
+     */
+    sumMemoryBytes(ownerGaii: string): Promise<number>;
+    /**
+     * Sum the byte size of memory VALUES across MANY owner identities (GHII + agents + GEAIs) in ONE
+     * DB-side aggregate — the owner-scope total-usage figure (profile Home). Replaces calling
+     * {@link sumMemoryBytes} once per identity (an owner with ~100 agents = ~100 serial round-trips).
+     */
+    sumMemoryBytesForOwners(ownerGaiis: string[]): Promise<number>;
     deleteMemory(ownerGaii: string, key: string): Promise<boolean>;
     deleteAllMemory(ownerGaii: string): Promise<number>;
     incrementMemoryFlagCount(ownerGaii: string, key: string): Promise<void>;
@@ -89,7 +212,15 @@ export interface MemoryRepository {
      * substring scan) this is the cross-owner primitive the librarian fans across organisms with.
      */
     searchText(query: string, opts?: MemoryTextSearchOpts): Promise<MemoryTextHit[]>;
-    /** List all memory across all owners with optional filtering and pagination (admin). */
+    /**
+     * List all memory across all owners with optional filtering and pagination (admin).
+     *
+     * `excludeVersionRows` drops `.version.N` workspace history rows IN SQL (`key NOT LIKE '%.version.%'`)
+     * — the hot workspace read paths (index/overview/REST read/publish) collapse instances to
+     * `.latest`/`.draft` and always DISCARD version rows, so loading + JSON.parsing every historic
+     * full-copy value was pure waste that grew with publish count. Callers that genuinely consume
+     * history (activity feed, object delete, export) must NOT set it.
+     */
     listAllMemory(opts?: {
         prefix?: string;
         ownerPrefix?: string;
@@ -97,6 +228,7 @@ export interface MemoryRepository {
         limit?: number;
         offset?: number;
         archived?: ArchiveFilter;
+        excludeVersionRows?: boolean;
     }): Promise<{
         items: MemoryRecord[];
         total: number;

package/dist/src/storage/repositories/memory.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory.repository.d.ts","sourceRoot":"","sources":["../../../../src/storage/repositories/memory.repository.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memory.repository.d.ts","sourceRoot":"","sources":["../../../../src/storage/repositories/memory.repository.ts"],"names":[],"mappings":"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"}

package/dist/src/storage/repositories/micro-memory.repository.d.ts

@@ -15,6 +15,12 @@ export interface MicroMemoryRepository {
     setMicroMemory(record: MicroMemoryRecord): Promise<MicroMemoryRecord>;
     getMicroMemory(gaii: string, set: string): Promise<MicroMemoryRecord | null>;
     listMicroMemorySets(gaii: string): Promise<MicroMemoryRecord[]>;
+    /** Total micro-memory bytes + set count across MANY identities in ONE query (usage summary; keeps it
+     *  off a per-identity fan-out over this deprecated subsystem). */
+    getMicroMemoryTotalForOwners(gaiis: string[]): Promise<{
+        bytes: number;
+        sets: number;
+    }>;
     deleteMicroMemory(gaii: string, set: string): Promise<boolean>;
     deleteMicroMemoryEntry(gaii: string, set: string, key: string): Promise<boolean>;
     findMicroMemoryByAccessCode(set: string, accessCode: string): Promise<MicroMemoryRecord | null>;

package/dist/src/storage/repositories/micro-memory.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"micro-memory.repository.d.ts","sourceRoot":"","sources":["../../../../src/storage/repositories/micro-memory.repository.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACtE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC7E,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAChE,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjF,2BAA2B,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CACjG"}
+{"version":3,"file":"micro-memory.repository.d.ts","sourceRoot":"","sources":["../../../../src/storage/repositories/micro-memory.repository.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACtE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC7E,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAChE;sEACkE;IAClE,4BAA4B,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxF,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjF,2BAA2B,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CACjG"}

package/dist/src/storage/repositories/organism.repository.d.ts

@@ -9,6 +9,7 @@
  *   - PendingApproval methods: create/get/list/update plus listOverduePendingApprovals
  *
  * @version-history
+ *   v1.1.0 — 2026-07-16 — Add listPendingApprovalsForOrgs batch primitive (Phase 3 fan-out→IN).
  *   v1.0.0 — 2026-07-13 — Header added; file pre-dates header standard
  */
 import type { ArchiveFilter, OrganismRecord, OrganismMembershipRecord, JoinRequestRecord, OrganismReputationRecord, PendingApprovalRecord } from '../interface.js';
@@ -49,6 +50,15 @@ export interface OrganismRepository {
     listPendingApprovals(organismId: string, opts?: {
         status?: string;
     }): Promise<PendingApprovalRecord[]>;
+    /**
+     * BULK PRIMITIVE (Phase 3) — pending approvals for MANY organisms in ONE `organismId IN (…)` query,
+     * grouped by organism. Backs the "Waiting for you" home aggregate, which called listPendingApprovals
+     * once per member organism. Keyed by organismId (an org with none is absent). Optional — a backend
+     * without it falls back to a per-organism loop.
+     */
+    listPendingApprovalsForOrgs?(organismIds: string[], opts?: {
+        status?: string;
+    }): Promise<Record<string, PendingApprovalRecord[]>>;
     updatePendingApproval(id: string, updates: Partial<PendingApprovalRecord>): Promise<PendingApprovalRecord | null>;
     listOverduePendingApprovals(nowIso: string): Promise<PendingApprovalRecord[]>;
 }

package/dist/src/storage/repositories/organism.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"organism.repository.d.ts","sourceRoot":"","sources":["../../../../src/storage/repositories/organism.repository.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"organism.repository.d.ts","sourceRoot":"","sources":["../../../../src/storage/repositories/organism.repository.ts"],"names":[],"mappings":"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"}

package/dist/src/storage/repositories/stats.repository.d.ts

@@ -1,12 +1,41 @@
 /**
  * @file stats.repository.ts
- * @description Storage repository for persisting stats counters and daily history.
- * @version-history v1.0.0 -- 2026-05-21 -- Initial creation
+ * @description Storage repository for persisting stats counters and daily history, plus the operator
+ *   storage-growth telemetry: per-table row counts (backend-specific) captured as hourly snapshots.
+ * @version-history
+ *   v1.1.0 -- 2026-07-16 -- Storage stats snapshots (per-table row counts over time) for the admin DB tab.
+ *   v1.0.0 -- 2026-05-21 -- Initial creation
  */
+/** An hourly snapshot of the node's storage size: live row count per table + the total, at a point in time. */
+export interface StorageStatsSnapshot {
+    id: string;
+    capturedAt: string;
+    counts: Record<string, number>;
+    totalRows: number;
+}
 export interface StatsRepository {
     flushStats(counters: Record<string, number>): Promise<void>;
     loadStats(): Promise<Record<string, number>>;
     flushDailyHistory(history: Record<string, Record<string, number>>): Promise<void>;
     loadDailyHistory(): Promise<Record<string, Record<string, number>>>;
+    /** Current live row count per table/collection (backend-specific; an estimate is acceptable). */
+    getTableRowCounts(): Promise<Record<string, number>>;
+    /** Memory-table composition: how many rows are `.version.N` workspace-history snapshots and how
+     *  many are archived. Both classes live in the single memory table and inflate it invisibly —
+     *  the admin Database tab surfaces them so an operator sees WHAT the table is made of, not just
+     *  its size. One DB-side aggregate, no values loaded. */
+    getMemoryRowBreakdown(): Promise<{
+        versionRows: number;
+        archivedRows: number;
+    }>;
+    /** Persist one storage-size snapshot (append-only; keyed by id). */
+    saveStorageStatsSnapshot(snapshot: StorageStatsSnapshot): Promise<void>;
+    /** Snapshots newest-first, optionally bounded by count and/or a since-ISO lower bound. */
+    listStorageStatsSnapshots(opts?: {
+        limit?: number;
+        sinceIso?: string;
+    }): Promise<StorageStatsSnapshot[]>;
+    /** Delete snapshots captured strictly before the ISO cutoff. Returns the number removed. */
+    pruneStorageStatsSnapshots(beforeIso: string): Promise<number>;
 }
 //# sourceMappingURL=stats.repository.d.ts.map

package/dist/src/storage/repositories/stats.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stats.repository.d.ts","sourceRoot":"","sources":["../../../../src/storage/repositories/stats.repository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7C,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CACrE"}
+{"version":3,"file":"stats.repository.d.ts","sourceRoot":"","sources":["../../../../src/storage/repositories/stats.repository.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,+GAA+G;AAC/G,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7C,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAEpE,iGAAiG;IACjG,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD;;;6DAGyD;IACzD,qBAAqB,IAAI,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChF,oEAAoE;IACpE,wBAAwB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,0FAA0F;IAC1F,yBAAyB,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACzG,4FAA4F;IAC5F,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAChE"}

package/dist/src/storage/repositories/stats.repository.js

@@ -1,7 +1,10 @@
 /**
  * @file stats.repository.ts
- * @description Storage repository for persisting stats counters and daily history.
- * @version-history v1.0.0 -- 2026-05-21 -- Initial creation
+ * @description Storage repository for persisting stats counters and daily history, plus the operator
+ *   storage-growth telemetry: per-table row counts (backend-specific) captured as hourly snapshots.
+ * @version-history
+ *   v1.1.0 -- 2026-07-16 -- Storage stats snapshots (per-table row counts over time) for the admin DB tab.
+ *   v1.0.0 -- 2026-05-21 -- Initial creation
  */
 export {};
 //# sourceMappingURL=stats.repository.js.map

package/dist/src/storage/repositories/stats.repository.js.map

@@ -1 +1 @@
-{"version":3,"file":"stats.repository.js","sourceRoot":"","sources":["../../../../src/storage/repositories/stats.repository.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}
+{"version":3,"file":"stats.repository.js","sourceRoot":"","sources":["../../../../src/storage/repositories/stats.repository.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/src/storage/repositories/work.repository.d.ts

@@ -18,5 +18,12 @@ export interface WorkRepository {
     listWorkByProvider(gaii: string): Promise<WorkRecord[]>;
     listWorkByRequester(gaii: string): Promise<WorkRecord[]>;
     listAllWork(limit?: number): Promise<WorkRecord[]>;
+    /** Count work rows across MANY providers whose status is in `statuses`, in ONE query — batches the
+     *  owner-agents fan-out the Home dashboard / work inbox would otherwise run as one query per agent. */
+    countPendingWorkByProviders(providerGaiis: string[], statuses: string[]): Promise<number>;
+    /** All work rows for MANY providers in ONE `providerGaii IN (…)` query (batches GET /v1/work/inbox). */
+    listWorkByProviders(providerGaiis: string[]): Promise<WorkRecord[]>;
+    /** All work rows for MANY requesters in ONE `requesterGaii IN (…)` query (batches GET /v1/work/sent). */
+    listWorkByRequesters(requesterGaiis: string[]): Promise<WorkRecord[]>;
 }
 //# sourceMappingURL=work.repository.d.ts.map

package/dist/src/storage/repositories/work.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"work.repository.d.ts","sourceRoot":"","sources":["../../../../src/storage/repositories/work.repository.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAClD,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC1D,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC3F,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACxD,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACzD,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;CACpD"}
+{"version":3,"file":"work.repository.d.ts","sourceRoot":"","sources":["../../../../src/storage/repositories/work.repository.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAClD,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC1D,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC3F,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACxD,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACzD,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACnD;2GACuG;IACvG,2BAA2B,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1F,wGAAwG;IACxG,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACpE,yGAAyG;IACzG,oBAAoB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;CACvE"}

package/dist/src/storage/repositories-impl/memory-repository.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @file src/storage/repositories-impl/memory-repository.ts
+ * @description Backend-AGNOSTIC memory repository — composes the {@link ../adapter/memory-adapter.js}
+ *   primitives into domain read/write operations. This is the layer the old `repositories/*.ts`
+ *   interfaces never had: real, shared composition (owner-scope union + GHII-first key dedup, subtree
+ *   enumeration, bulk write/delete) that runs identically on every backend because it touches ONLY the
+ *   adapter — no SQL, no Prisma filters, no Mongo operators, and no business rules (quota, schema,
+ *   auth). Those live above (service) or below (adapter). One instance wraps one adapter.
+ *
+ * @structure
+ *   MemoryRepository — get / getAcrossOwners / listForOwner(s) / listMetaForOwners / countForOwners /
+ *     sumBytesForOwners / search / listByKeyPrefix / write / writeMany / delete / deleteMany /
+ *     subtreeRefs / deleteSubtree / history; dedupByKey composition helper
+ * @usage
+ *   const repo = new MemoryRepository(adapter);
+ *   const rows = await repo.listForOwners(identities, opts);   // deduped GHII-first by the service
+ * @version-history
+ *   v1.0.0 — 2026-07-15 — Phase 0 scaffolding: composition over the adapter, no behaviour change.
+ */
+import type { MemoryRecord } from '../interface.js';
+import type { CountOpts, KeyPrefixOpts, ListOpts, MemoryMetaRow, MemoryRef, MemoryStorageAdapter, MemoryTextHit, MemoryTextSearchOpts, MemoryVersionRecord } from '../adapter/memory-adapter.js';
+/** A row addressable by (key, ownerGaii) — the minimum {@link dedupByKey} needs to rank + dedupe. */
+interface KeyedRow {
+    key: string;
+    ownerGaii: string;
+}
+export declare class MemoryRepository {
+    private readonly adapter;
+    constructor(adapter: MemoryStorageAdapter);
+    get(ownerGaii: string, key: string): Promise<MemoryRecord | null>;
+    /** Many keys under one owner in one read (batched existing-row lookup for a bulk write). */
+    getByKeys(ownerGaii: string, keys: string[]): Promise<MemoryRecord[]>;
+    /** One key across many identities in one IN read (owner-scope point read), NOT deduped — the caller
+     *  chooses the priority order via {@link dedupByKey} / {@link firstByPriority}. */
+    getAcrossOwners(ownerGaiis: string[], key: string): Promise<MemoryRecord[]>;
+    listForOwner(ownerGaii: string, opts?: ListOpts): Promise<MemoryRecord[]>;
+    /** MANY identities' keyspaces in one IN read (owner-scope union, NOT deduped). */
+    listForOwners(ownerGaiis: string[], opts?: ListOpts): Promise<MemoryRecord[]>;
+    listMetaForOwner(ownerGaii: string, opts?: ListOpts): Promise<MemoryMetaRow[]>;
+    listMetaForOwners(ownerGaiis: string[], opts?: ListOpts): Promise<MemoryMetaRow[]>;
+    listByKeyPrefix(opts?: KeyPrefixOpts): Promise<{
+        items: MemoryRecord[];
+        total: number;
+    }>;
+    countForOwners(ownerGaiis: string[], opts?: CountOpts): Promise<number>;
+    sumBytesForOwner(ownerGaii: string): Promise<number>;
+    sumBytesForOwners(ownerGaiis: string[]): Promise<number>;
+    search(query: string, opts?: MemoryTextSearchOpts): Promise<MemoryTextHit[]>;
+    history(ownerGaii: string, key: string, opts?: {
+        limit?: number;
+    }): Promise<MemoryVersionRecord[]>;
+    write(record: MemoryRecord): Promise<MemoryRecord>;
+    writeIfVersion(record: MemoryRecord, expectedVersion: number): Promise<MemoryRecord | null>;
+    writeMany(records: MemoryRecord[]): Promise<MemoryRecord[]>;
+    delete(ownerGaii: string, key: string): Promise<boolean>;
+    deleteMany(refs: MemoryRef[]): Promise<number>;
+    /**
+     * Enumerate the (ownerGaii, key) refs of a record's whole family — the base key itself plus its
+     * `base.*` children (`.draft` / `.latest` / `.version.N`) — under one owner, via a single prefix
+     * read. Backs the record-family delete (today done key-by-key). A dedicated subtree-delete primitive
+     * replaces the enumerate-then-delete in Phase 2; this keeps the composition backend-agnostic now.
+     */
+    subtreeRefs(ownerGaii: string, baseKey: string): Promise<MemoryRef[]>;
+    /** Delete a record's whole family under one owner in one call. Uses the adapter's one-statement subtree
+     *  primitive (which itself falls back to enumerate-then-delete on a backend that lacks it). */
+    deleteSubtree(ownerGaii: string, baseKey: string): Promise<number>;
+    /**
+     * Dedupe rows by `key`, keeping the copy owned by the HIGHEST-priority identity (earliest in
+     * `identities`). This is the owner-scope rule: a key present under both the GHII and an agent resolves
+     * to the GHII copy. Pure — moved here from services/owner-memory.ts so every owner-scope read shares
+     * one implementation.
+     */
+    static dedupByKey<T extends KeyedRow>(rows: T[], identities: string[]): T[];
+    /** The highest-priority row for a single key across an identity list (owner-scope point read). */
+    static firstByPriority<T extends KeyedRow>(rows: T[], identities: string[]): T | null;
+}
+export {};
+//# sourceMappingURL=memory-repository.d.ts.map

package/dist/src/storage/repositories-impl/memory-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-repository.d.ts","sourceRoot":"","sources":["../../../../src/storage/repositories-impl/memory-repository.ts"],"names":[],"mappings":"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"}

package/dist/src/storage/repositories-impl/memory-repository.js

@@ -0,0 +1,121 @@
+export class MemoryRepository {
+    adapter;
+    constructor(adapter) {
+        this.adapter = adapter;
+    }
+    // ── Reads ──────────────────────────────────────────────────────────
+    get(ownerGaii, key) {
+        return this.adapter.getByKey(ownerGaii, key);
+    }
+    /** Many keys under one owner in one read (batched existing-row lookup for a bulk write). */
+    getByKeys(ownerGaii, keys) {
+        if (keys.length === 0)
+            return Promise.resolve([]);
+        return this.adapter.getByKeys(ownerGaii, keys);
+    }
+    /** One key across many identities in one IN read (owner-scope point read), NOT deduped — the caller
+     *  chooses the priority order via {@link dedupByKey} / {@link firstByPriority}. */
+    getAcrossOwners(ownerGaiis, key) {
+        return this.adapter.getByOwners(ownerGaiis, key);
+    }
+    listForOwner(ownerGaii, opts) {
+        return this.adapter.findByOwner(ownerGaii, opts);
+    }
+    /** MANY identities' keyspaces in one IN read (owner-scope union, NOT deduped). */
+    listForOwners(ownerGaiis, opts) {
+        return this.adapter.findByOwners(ownerGaiis, opts);
+    }
+    listMetaForOwner(ownerGaii, opts) {
+        return this.adapter.findMetaByOwner(ownerGaii, opts);
+    }
+    listMetaForOwners(ownerGaiis, opts) {
+        return this.adapter.findMetaByOwners(ownerGaiis, opts);
+    }
+    listByKeyPrefix(opts) {
+        return this.adapter.findByKeyPrefix(opts);
+    }
+    countForOwners(ownerGaiis, opts) {
+        return this.adapter.countByOwners(ownerGaiis, opts);
+    }
+    sumBytesForOwner(ownerGaii) {
+        return this.adapter.sumBytesByOwner(ownerGaii);
+    }
+    sumBytesForOwners(ownerGaiis) {
+        return this.adapter.sumBytesByOwners(ownerGaiis);
+    }
+    search(query, opts) {
+        return this.adapter.textSearch(query, opts);
+    }
+    history(ownerGaii, key, opts) {
+        return this.adapter.history(ownerGaii, key, opts);
+    }
+    // ── Writes ─────────────────────────────────────────────────────────
+    write(record) {
+        return this.adapter.upsert(record);
+    }
+    writeIfVersion(record, expectedVersion) {
+        if (this.adapter.upsertIfVersion)
+            return this.adapter.upsertIfVersion(record, expectedVersion);
+        return this.adapter.upsert(record).then(r => r);
+    }
+    writeMany(records) {
+        if (records.length === 0)
+            return Promise.resolve([]);
+        return this.adapter.bulkUpsert(records);
+    }
+    // ── Deletes ────────────────────────────────────────────────────────
+    delete(ownerGaii, key) {
+        return this.adapter.deleteByKey(ownerGaii, key);
+    }
+    deleteMany(refs) {
+        if (refs.length === 0)
+            return Promise.resolve(0);
+        return this.adapter.bulkDelete(refs);
+    }
+    /**
+     * Enumerate the (ownerGaii, key) refs of a record's whole family — the base key itself plus its
+     * `base.*` children (`.draft` / `.latest` / `.version.N`) — under one owner, via a single prefix
+     * read. Backs the record-family delete (today done key-by-key). A dedicated subtree-delete primitive
+     * replaces the enumerate-then-delete in Phase 2; this keeps the composition backend-agnostic now.
+     */
+    async subtreeRefs(ownerGaii, baseKey) {
+        const rows = await this.adapter.findByOwner(ownerGaii, { prefix: baseKey });
+        return rows
+            .filter(r => r.key === baseKey || r.key.startsWith(baseKey + '.'))
+            .map(r => ({ ownerGaii: r.ownerGaii, key: r.key }));
+    }
+    /** Delete a record's whole family under one owner in one call. Uses the adapter's one-statement subtree
+     *  primitive (which itself falls back to enumerate-then-delete on a backend that lacks it). */
+    deleteSubtree(ownerGaii, baseKey) {
+        return this.adapter.deleteSubtree(ownerGaii, baseKey);
+    }
+    // ── Composition helpers (backend-agnostic) ─────────────────────────
+    /**
+     * Dedupe rows by `key`, keeping the copy owned by the HIGHEST-priority identity (earliest in
+     * `identities`). This is the owner-scope rule: a key present under both the GHII and an agent resolves
+     * to the GHII copy. Pure — moved here from services/owner-memory.ts so every owner-scope read shares
+     * one implementation.
+     */
+    static dedupByKey(rows, identities) {
+        const priority = new Map(identities.map((id, i) => [id, i]));
+        const rank = (r) => priority.get(r.ownerGaii) ?? identities.length;
+        const ranked = [...rows].sort((a, b) => rank(a) - rank(b));
+        const seen = new Set();
+        const out = [];
+        for (const r of ranked) {
+            if (!seen.has(r.key)) {
+                seen.add(r.key);
+                out.push(r);
+            }
+        }
+        return out;
+    }
+    /** The highest-priority row for a single key across an identity list (owner-scope point read). */
+    static firstByPriority(rows, identities) {
+        if (rows.length === 0)
+            return null;
+        const priority = new Map(identities.map((id, i) => [id, i]));
+        return [...rows].sort((a, b) => (priority.get(a.ownerGaii) ?? identities.length) - (priority.get(b.ownerGaii) ?? identities.length))[0];
+    }
+}
+//# sourceMappingURL=memory-repository.js.map

package/dist/src/storage/repositories-impl/memory-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-repository.js","sourceRoot":"","sources":["../../../../src/storage/repositories-impl/memory-repository.ts"],"names":[],"mappings":"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"}