@x12i/memorix-service 3.13.0 → 3.14.1

package/dist/metadata-view.js

@@ -0,0 +1,67 @@
+/** Wrap a store so every change to its contents moves `generation()`. */
+export function trackMetadataGeneration(store) {
+    let generation = 0;
+    const tracked = {
+        ...store,
+        generation: () => generation,
+        replaceAgentPack(...args) {
+            store.replaceAgentPack(...args);
+            generation++;
+        },
+        appendLedger(...args) {
+            store.appendLedger(...args);
+            generation++;
+        },
+        commitFrom(...args) {
+            store.commitFrom(...args);
+            generation++;
+        },
+    };
+    if (typeof store.hydrate === "function") {
+        // Hydrate swaps the whole snapshot. Move the count before and after so no
+        // reader keeps an answer built from the previous snapshot.
+        tracked.hydrate = async () => {
+            generation++;
+            try {
+                await store.hydrate();
+            }
+            finally {
+                generation++;
+            }
+        };
+    }
+    return tracked;
+}
+/** Answer metadata reads from a cache that is dropped when the store changes. */
+export function createMetadataView(client, generation) {
+    let seen = generation();
+    const effective = new Map();
+    const abstracts = new Map();
+    const definitions = new Map();
+    const fresh = () => {
+        const now = generation();
+        if (now === seen)
+            return;
+        seen = now;
+        effective.clear();
+        abstracts.clear();
+        definitions.clear();
+    };
+    const agentsKey = (agentIds) => agentIds.join("\u0000");
+    function memo(cache, key, build) {
+        fresh();
+        if (cache.has(key))
+            return cache.get(key);
+        const value = build();
+        // A build that itself changed the store (it should not) must not be kept.
+        if (generation() === seen)
+            cache.set(key, value);
+        return value;
+    }
+    return {
+        resolveEffective: (agentIds) => memo(effective, agentsKey(agentIds), () => client.resolveEffective(agentIds)),
+        resolveAbstracts: (agentIds) => memo(abstracts, agentsKey(agentIds), () => client.resolveAbstracts(agentIds)),
+        getDefinition: (agentIds, kind, id) => memo(definitions, `${agentsKey(agentIds)}\u0001${kind}\u0001${id}`, () => client.getDefinition(agentIds, kind, id)),
+    };
+}
+//# sourceMappingURL=metadata-view.js.map

package/dist/metadata-view.js.map

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

package/dist/nexum-analysis/enqueue.d.ts

@@ -18,7 +18,7 @@ export type AnalysisEnqueueResult = {
  */
 export declare function resolveAnalyzeAgentIds(scopeAgentIds: string[], hasPipeline: (agentIds: string[]) => boolean): string[];
 export declare function maybeEnqueueNexumAnalysis(input: {
-    platform: Pick<MemorixPlatform, "metadata" | "operationalDbFor" | "portsFor">;
+    platform: Pick<MemorixPlatform, "metadata" | "operationalDbFor" | "portsFor"> & Partial<Pick<MemorixPlatform, "metadataView">>;
     scope: MemorixScope;
     objectType: string;
     contentType: string;

package/dist/nexum-analysis/enqueue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enqueue.d.ts","sourceRoot":"","sources":["../../src/nexum-analysis/enqueue.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAahD,MAAM,MAAM,qBAAqB,GAC7B;IACE,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB,GACD;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAKN;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,EAAE,EACvB,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,OAAO,GAC3C,MAAM,EAAE,CASV;AA6BD,wBAAsB,yBAAyB,CAAC,KAAK,EAAE;IACrD,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,kBAAkB,GAAG,UAAU,CAAC,CAAC;IAC9E,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA0KjC"}
+{"version":3,"file":"enqueue.d.ts","sourceRoot":"","sources":["../../src/nexum-analysis/enqueue.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAahD,MAAM,MAAM,qBAAqB,GAC7B;IACE,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB,GACD;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAKN;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,EAAE,EACvB,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,OAAO,GAC3C,MAAM,EAAE,CASV;AA6BD,wBAAsB,yBAAyB,CAAC,KAAK,EAAE;IACrD,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,kBAAkB,GAAG,UAAU,CAAC,GAC3E,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC,CAAC;IACjD,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA2KjC"}

package/dist/nexum-analysis/enqueue.js

@@ -43,7 +43,8 @@ export async function maybeEnqueueNexumAnalysis(input) {
     if (!process.env.MEMORIX_NEXUM_URL?.trim() && !process.env.NEXUM_URL?.trim()) {
         return { status: "skipped", reason: "indexing worker unset" };
     }
-    const effective = input.platform.metadata.resolveEffective(input.scope.agentIds);
+    // Per-write path: read the catalog from the view so a write does not rebuild it.
+    const effective = (input.platform.metadataView ?? input.platform.metadata).resolveEffective(input.scope.agentIds);
     const extensionBag = {};
     for (const e of effective.effective ?? []) {
         if (!e.kind?.includes("."))

package/dist/nexum-analysis/enqueue.js.map

@@ -1 +1 @@
-{"version":3,"file":"enqueue.js","sourceRoot":"","sources":["../../src/nexum-analysis/enqueue.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"enqueue.js","sourceRoot":"","sources":["../../src/nexum-analysis/enqueue.ts"],"names":[],"mappings":"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"}

package/dist/openapi/openapi.json

@@ -2769,7 +2769,7 @@
     "/api/data/content/batch": {
       "post": {
         "operationId": "dataWriteContentBatch",
-        "summary": "Write up to 500 rows. One receipt or error per row, in order. One bad row does not reject the batch.",
+        "summary": "Write up to 500 rows. One receipt or error per row, in order. One bad row does not reject the batch. With queue: true on the body each row is accepted into the write queue in array order, and a row's result is the 202 body of POST /api/data/content (status queued) or an error.",
         "tags": ["Data"],
         "parameters": [
           { "$ref": "#/components/parameters/XMemorixCaller" },
@@ -2784,6 +2784,10 @@
                 "type": "object",
                 "required": ["writes"],
                 "properties": {
+                  "queue": {
+                    "type": "boolean",
+                    "description": "true accepts every row into the durable write queue. Set on the body, not on a row."
+                  },
                   "writes": {
                     "type": "array",
                     "maxItems": 500,
@@ -2818,27 +2822,114 @@
     "/api/data/receipts": {
       "get": {
         "operationId": "dataListWriteReceipts",
-        "summary": "List write receipts for x-memorix-caller. Rejected receipts stay for 7 days.",
+        "summary": "List write receipts for x-memorix-caller. Without runId: rejected by default, newest first. With runId: the queued writes of that run in accept order, every status unless status is given. Stored and rejected receipts stay for 7 days.",
         "tags": ["Data"],
         "parameters": [
           { "$ref": "#/components/parameters/XMemorixCaller" },
           { "$ref": "#/components/parameters/XMemorixOrgId" },
           { "$ref": "#/components/parameters/XMemorixAgentIds" },
+          {
+            "name": "runId",
+            "in": "query",
+            "description": "List the queued writes of this run (_metadata.execution.runId).",
+            "schema": { "type": "string" }
+          },
+          {
+            "name": "stepId",
+            "in": "query",
+            "description": "With runId: only this step (_metadata.execution.stepId).",
+            "schema": { "type": "string" }
+          },
           {
             "name": "status",
             "in": "query",
-            "schema": { "type": "string", "enum": ["pending", "stored", "rejected", "all"], "default": "rejected" }
+            "description": "Without runId: pending, queued, stored, rejected or all (default rejected). With runId: queued, stored or rejected (default every status).",
+            "schema": { "type": "string", "enum": ["pending", "queued", "stored", "rejected", "all"] }
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }
+          },
+          {
+            "name": "cursor",
+            "in": "query",
+            "description": "With runId: pageInfo.nextCursor of the previous page. An invalid cursor is 400.",
+            "schema": { "type": "string" }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Receipts for this caller. With runId the body has pageInfo { nextCursor, limit }; nextCursor is null on the last page.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": ["receipts"],
+                  "properties": {
+                    "scope": { "$ref": "#/components/schemas/MemorixScope" },
+                    "receipts": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
+                    "pageInfo": {
+                      "type": "object",
+                      "properties": {
+                        "nextCursor": { "type": "string", "nullable": true },
+                        "limit": { "type": "integer" }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": { "description": "status, cursor or stepId is not valid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }
+        }
+      }
+    },
+    "/api/data/receipts/summary": {
+      "get": {
+        "operationId": "dataSummarizeWriteReceipts",
+        "summary": "Counts of one run's queued writes for x-memorix-caller. queued: 0 means the run's queue has drained: every accepted row is stored or rejected.",
+        "tags": ["Data"],
+        "parameters": [
+          { "$ref": "#/components/parameters/XMemorixCaller" },
+          { "$ref": "#/components/parameters/XMemorixOrgId" },
+          { "$ref": "#/components/parameters/XMemorixAgentIds" },
+          { "name": "runId", "in": "query", "required": true, "schema": { "type": "string" } },
+          {
+            "name": "stepId",
+            "in": "query",
+            "description": "Narrow the counts to one step.",
+            "schema": { "type": "string" }
           }
         ],
         "responses": {
-          "200": { "description": "Receipts for this caller" }
+          "200": {
+            "description": "Counts by status",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": ["runId", "queued", "stored", "rejected"],
+                  "properties": {
+                    "scope": { "$ref": "#/components/schemas/MemorixScope" },
+                    "runId": { "type": "string" },
+                    "stepId": { "type": "string" },
+                    "queued": { "type": "integer" },
+                    "stored": { "type": "integer" },
+                    "rejected": { "type": "integer" }
+                  }
+                }
+              }
+            }
+          },
+          "400": { "description": "runId is required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }
         }
       }
     },
     "/api/data/receipts/{receiptId}": {
       "get": {
         "operationId": "dataGetWriteReceipt",
-        "summary": "pending, stored (with receipt), or rejected (with error)",
+        "summary": "pending or queued (neither a receipt nor an error), stored (with receipt), or rejected (with error). A queued-write receipt also has storageKey, runId and stepId.",
         "tags": ["Data"],
         "parameters": [
           { "$ref": "#/components/parameters/XMemorixCaller" },
@@ -2855,7 +2946,7 @@
     "/api/data/content": {
       "get": {
         "operationId": "dataGetContent",
-        "summary": "Concrete content get/list",
+        "summary": "Concrete content get/list. An exact get (recordId) of a key that has a queued write not yet stored answers 200 with pending: true and receiptId. When no document is stored yet, record is the latest queued submission without a revision, and currentRevision is null. When a document is stored, record and currentRevision are the stored ones. A list returns stored documents only.",
         "tags": [
           "Data"
         ],
@@ -3106,7 +3197,7 @@
       },
       "post": {
         "operationId": "dataWriteContent",
-        "summary": "Concrete write. precondition none creates or replaces. Every 2xx includes a receipt.",
+        "summary": "Concrete write. precondition none creates or replaces. A 200 includes a receipt. With queue: true the row is accepted into a durable queue and answers 202 status queued; see docs/async-content-write-FR.md. A queued write takes no writeId, no op other than upsert, and no precondition other than none. The idempotency key is the storage key plus _metadata.execution.runId plus _metadata.execution.stepId. The same tuple with a different body (data, _metadata, _audit, anything) is 409 QUEUE_KEY_REUSED.",
         "tags": [
           "Data"
         ],
@@ -3192,16 +3283,29 @@
             }
           },
           "202": {
-            "description": "Accepted. Memorix retries the write. Poll GET /api/data/receipts/{receiptId}.",
+            "description": "Accepted. status pending: a synchronous write failed in a way a retry can fix, and Memorix retries it. status queued: the row was accepted with queue: true and is stored in the write queue, not yet in the content collection. Either way, poll GET /api/data/receipts/{receiptId}.",
             "content": {
               "application/json": {
                 "schema": {
                   "type": "object",
-                  "required": ["receiptId", "status", "retryAfterMs"],
+                  "required": ["receiptId", "status"],
                   "properties": {
                     "receiptId": { "type": "string" },
-                    "status": { "type": "string", "enum": ["pending"] },
-                    "retryAfterMs": { "type": "integer" }
+                    "status": { "type": "string", "enum": ["pending", "queued"] },
+                    "retryAfterMs": { "type": "integer", "description": "status pending only." },
+                    "storageKey": {
+                      "type": "object",
+                      "description": "status queued only.",
+                      "required": ["objectType", "contentType", "recordId"],
+                      "properties": {
+                        "objectType": { "type": "string" },
+                        "contentType": { "type": "string" },
+                        "recordId": { "type": "string" },
+                        "discriminator": { "type": "string" }
+                      }
+                    },
+                    "runId": { "type": "string", "description": "status queued only. From _metadata.execution.runId." },
+                    "stepId": { "type": "string", "description": "status queued only. From _metadata.execution.stepId." }
                   }
                 }
               }

package/dist/platform.d.ts

@@ -13,6 +13,7 @@ import { type RunLedger, type PipelineRuntime } from "@x12i/memorix-pipeline/v2"
 import { type OperationalStores } from "@x12i/memorix-pipeline-runtime";
 import { ServiceError } from "./errors.js";
 import { type DeliveryArtifactStore, type RawRecordStore, type TargetItemReceiptStore } from "./mgc-landing-stores.js";
+import { type MetadataView } from "./metadata-view.js";
 import { type ServiceCatalog } from "./catalog-bridge.js";
 import { type MemorixScope } from "./scope.js";
 import { type WriteReceiptStore } from "./writes/receipt-store.js";
@@ -61,6 +62,12 @@ export type MemorixPlatform = {
     mode: RuntimeMode;
     client: MongoClient | null;
     metadata: UnifiedMetadataClient;
+    /**
+     * Same reads as `metadata` (`resolveEffective`, `resolveAbstracts`, `getDefinition`),
+     * answered once per metadata change instead of once per call. Results are shared:
+     * read them, do not edit them. Use this on per-request paths.
+     */
+    metadataView: MetadataView;
     isolation: IsolationSession | null;
     /**
      * Magit pack versioning. Active when Magit is enabled (default on) and durable

package/dist/platform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAQL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAU5B,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAeL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAGL,KAAK,+BAA+B,EACrC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAQL,KAAK,SAAS,EACd,KAAK,eAAe,EAGrB,MAAM,2BAA2B,CAAC;AAOnC,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAIL,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC5B,MAAM,yBAAyB,CAAC;AAajC,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/D,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAUL,KAAK,gBAAgB,EACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAaL,yBAAyB,EACzB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,8BAA8B,CAAC;AAWtC,OAAO,EACL,gBAAgB,EAGjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,CAAC;AAEzC,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,sEAAsE;IACtE,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,2EAA2E;IAC3E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kDAAkD;IAClD,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,cAAc,EAAE,qBAAqB,CAAC;IACtC,aAAa,EAAE,kBAAkB,CAAC;IAClC,MAAM,EAAE,eAAe,CAAC;IACxB,cAAc,EAAE,cAAc,CAAC;IAC/B,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,iBAAiB,EAAE,qBAAqB,CAAC;IACzC,QAAQ,EAAE,eAAe,CAAC;IAC1B,YAAY,EAAE,gBAAgB,CAAC;IAC/B,SAAS,EAAE,eAAe,CAAC;IAC3B,YAAY,EAAE,gBAAgB,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,qBAAqB,CAAC;IAChC,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACnC;;;OAGG;IACH,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC/B,mFAAmF;IACnF,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,0DAA0D;IAC1D,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,oEAAoE;IACpE,iBAAiB,CACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GACrE,IAAI,CAAC;IACR,yDAAyD;IACzD,mBAAmB,CAAC,KAAK,EAAE,OAAO,gCAAgC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC9F,8DAA8D;IAC9D,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,+DAA+D;IAC/D,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,sDAAsD;IACtD,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,yDAAyD;IACzD,cAAc,EAAE,cAAc,CAAC;IAC/B,iEAAiE;IACjE,kBAAkB,EAAE,sBAAsB,CAAC;IAC3C,yDAAyD;IACzD,iBAAiB,EAAE,qBAAqB,CAAC;IACzC,iDAAiD;IACjD,SAAS,EAAE,eAAe,CAAC;IAC3B,kDAAkD;IAClD,iBAAiB,EAAE,uBAAuB,CAAC;IAC3C,yFAAyF;IACzF,QAAQ,EAAE;QACR,QAAQ,EAAE,0BAA0B,CAAC;QACrC,aAAa,EAAE;YACb,UAAU,EAAE,MAAM,CAAC;YACnB,QAAQ,EAAE,MAAM,CAAC;YACjB,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC;KACH,GAAG,IAAI,CAAC;IACT,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,EAAE,CAAC;IACpC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,EAAE,CAAC;IACjC,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C;;;OAGG;IACH,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAAC;IACvD;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC;;;OAGG;IACH,0BAA0B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,0DAA0D;IAC1D,UAAU,IAAI,MAAM,EAAE,CAAC;IACvB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,+BAA+B,CAAC;IACzE,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,QAAQ,CAAC;IACxC;;;OAGG;IACH,uBAAuB,IAAI,IAAI,CAAC;IAChC;;;OAGG;IACH,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAAC;IAC3D;;;OAGG;IACH,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACzD;;;OAGG;IACH,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAAC;IACvD;;;OAGG;IACH,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,wBAAwB,CAAC;IACjE;;OAEG;IACH,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAAC;IAC3D,iDAAiD;IACjD,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAAC;IAC3D,mCAAmC;IACnC,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACvD,gCAAgC;IAChC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACjD,yCAAyC;IACzC,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACvD,qDAAqD;IACrD,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAAC;IAC1D,0EAA0E;IAC1E,SAAS,EAAE,eAAe,CAAC;IAC3B,4EAA4E;IAC5E,yBAAyB,CAAC,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,IAAI,CAAC;IACxF;;;OAGG;IACH,mBAAmB,CAAC,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,IAAI,CAAC;IAChE;;;OAGG;IACH,gCAAgC,CAAC,IAAI,CAAC,EAAE;QACtC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;KACpF,GAAG,MAAM,IAAI,CAAC;IACf,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,2CAA2C;IAC3C,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAAC;IACnD,gEAAgE;IAChE,uBAAuB,CAAC,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,IAAI,CAAC;IACpE,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,oFAAoF;IACpF,sBAAsB,CAAC,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,IAAI,CAAC;IACnE,gCAAgC;IAChC,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,8EAA8E;IAC9E,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,+DAA+D;IAC/D,+BAA+B,CAC7B,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;KACpF,GACA,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC,CAAC;IAClE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1D,kFAAkF;IAClF,cAAc,IAAI,WAAW,GAAG,IAAI,CAAC;IACrC;;;OAGG;IACH,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACnC;;;OAGG;IACH,QAAQ,EAAE,eAAe,CAAC;CAC3B,CAAC;AAEF,qBAAa,oBAAqB,SAAQ,YAAY;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,eAAe,CAAC,CAwgD1B"}
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"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"}

package/dist/platform.js

@@ -25,6 +25,7 @@ import { resolveKnowxWorkerBaseUrl } from "./pipeline-compile.js";
 import { createRemoteOrLocalPort, createRunPipelinePort, createRunxPort, } from "./pipeline-ports.js";
 import { createMongoMetadataStore, } from "./mongo-metadata-store.js";
 import { mergeGrantedContentTypes } from "./analytics/content-allow.js";
+import { createMetadataView, trackMetadataGeneration, } from "./metadata-view.js";
 import { catalogFromMetadataClient, HOST_KNOWLEDGE_AGENT_ID, readerCatalogWithHostKnowledge, relationshipMetadataResolver, } from "./catalog-bridge.js";
 import { normalizeOrgId } from "./scope.js";
 import { createMemoryHookStore, createMongoHookStore } from "./hooks/store.js";
@@ -34,7 +35,7 @@ import { tickHookStore } from "./hooks/worker.js";
 import { createMemoryWriteReceiptStore, createMongoWriteReceiptStore, } from "./writes/receipt-store.js";
 import { runContentWrite } from "./writes/content-write.js";
 import { commitWriteEffects } from "./writes/effects.js";
-import { tickWriteReceipts } from "./writes/worker.js";
+import { drainQueuedWrites, QUEUE_DEFAULT_CONCURRENCY, tickWriteReceipts } from "./writes/worker.js";
 import { assertSafeSandboxOrgId, recordCreatedDatabase, } from "./isolation.js";
 import { createMagitPackService, isMetadataMagitEnabled, magitPackageTypeIdConfigured, magitPackageTypeIdForDiagnostics, magitStoreSelectorConfigured, magitTypedStoreConfigured, resolveMagitCatalogTenant, resolveMagitRepoRootParent, resolveMagitStorageTokenEnv, } from "./magit/magit-pack-service.js";
 import { loadGenericConnectorsConfig, } from "./generic-connectors.js";
@@ -171,23 +172,29 @@ export async function createMemorixPlatform(deps) {
         ? deps.isolation.isolatedMetadataDb
         : "memorix_platform_metadata";
     let metadata;
+    let metadataGeneration;
     if (deps.mode === "prod" || (client && !deps.allowMemoryMetadata)) {
         if (deps.isolation) {
             // Touch creates DB; record in ledger
             recordCreatedDatabase(deps.isolation, durableMetadataDbName);
         }
         const metaDb = client.db(durableMetadataDbName);
-        durableMetadata = createMongoMetadataStore(metaDb);
+        const tracked = trackMetadataGeneration(createMongoMetadataStore(metaDb));
+        durableMetadata = tracked;
+        metadataGeneration = tracked.generation;
         log?.(`[memorix-service] hydrating metadata (${durableMetadataDbName})…`);
         await durableMetadata.hydrate();
         log?.(`[memorix-service] metadata ready`);
         metadata = createMetadataClient(durableMetadata);
     }
     else {
-        metadata = createMetadataClient(createInMemoryMetadataStore());
+        const tracked = trackMetadataGeneration(createInMemoryMetadataStore());
+        metadataGeneration = tracked.generation;
+        metadata = createMetadataClient(tracked);
         log?.(`[memorix-service] in-memory metadata store ready`);
     }
-    const analyticsViews = createAnalyticsMetadataViews(metadata);
+    const metadataView = createMetadataView(metadata, metadataGeneration);
+    const analyticsViews = createAnalyticsMetadataViews(metadataView);
     function invalidateOrgPortsCache() {
         portsCache.clear();
         analyticsViews.invalidate();
@@ -289,6 +296,11 @@ export async function createMemorixPlatform(deps) {
         return stores;
     }
     const writeReceiptStores = new Map();
+    /** Queued rows applied at the same time. Each apply is an ordinary content write. */
+    function queueConcurrency() {
+        const raw = Number(process.env.MEMORIX_QUEUE_CONCURRENCY);
+        return Number.isFinite(raw) && raw >= 1 ? Math.min(Math.floor(raw), 64) : QUEUE_DEFAULT_CONCURRENCY;
+    }
     function writeReceiptsFor(orgId) {
         orgId = resolveOrgId(orgId);
         const existing = writeReceiptStores.get(orgId);
@@ -523,7 +535,7 @@ export async function createMemorixPlatform(deps) {
                 recordCreatedDatabase(deps.isolation, databaseNameFor(scope.orgId, kind));
             }
         }
-        const baseCatalog = catalogFromMetadataClient(metadata, scope.agentIds);
+        const baseCatalog = catalogFromMetadataClient(metadataView, scope.agentIds);
         const writerCatalog = {
             ...baseCatalog,
             getObjectType(objectType) {
@@ -532,7 +544,7 @@ export async function createMemorixPlatform(deps) {
         };
         const readerCatalog = scope.agentIds.includes(HOST_KNOWLEDGE_AGENT_ID)
             ? writerCatalog
-            : readerCatalogWithHostKnowledge(writerCatalog, (objectType) => mergeGrantedContentTypes(scope.orgId, objectType, catalogFromMetadataClient(metadata, [HOST_KNOWLEDGE_AGENT_ID]).getObjectType(objectType)), scope.agentIds);
+            : readerCatalogWithHostKnowledge(writerCatalog, (objectType) => mergeGrantedContentTypes(scope.orgId, objectType, catalogFromMetadataClient(metadataView, [HOST_KNOWLEDGE_AGENT_ID]).getObjectType(objectType)), scope.agentIds);
         const catalog = writerCatalog;
         const plane = createMongoDataPlane(client);
         const { writer: contentWriter } = createMongoContentWriter({
@@ -806,6 +818,9 @@ export async function createMemorixPlatform(deps) {
     let hookTicker = null;
     let writeReceiptTicker = null;
     let lastReceiptDiscovery = 0;
+    /** One drain of the queued-write backlog at a time in this process. */
+    let queuedDrain = null;
+    let platformClosing = false;
     let platformRef;
     let hookPump = null;
     let hookPumpAgain = false;
@@ -1148,34 +1163,54 @@ export async function createMemorixPlatform(deps) {
                 /* discovery is best-effort */
             }
         }
+        const replay = async (row) => {
+            const scope = row.request.scope;
+            if (deps.isolation && scope.orgId !== deps.isolation.orgId)
+                return;
+            const ports = portsFor(scope);
+            await runContentWrite({
+                scope,
+                caller: row.caller,
+                datasource: {
+                    service: row.caller,
+                    declared: row.request.datasourceDeclared,
+                    declaration: row.request.datasourceDeclaration,
+                },
+                ports,
+                receipts: writeReceiptsFor(row.orgId),
+                onCommitted: (event) => commitWriteEffects({
+                    platform: platformRef,
+                    scope,
+                    caller: row.caller,
+                    event,
+                }),
+            }, {}, row);
+        };
         await tickWriteReceipts({
             orgIds: [...orgIds],
             now: new Date().toISOString(),
             storeFor: (orgId) => writeReceiptsFor(orgId),
-            replay: async (row) => {
-                const scope = row.request.scope;
-                if (deps.isolation && scope.orgId !== deps.isolation.orgId)
-                    return;
-                const ports = portsFor(scope);
-                await runContentWrite({
-                    scope,
-                    caller: row.caller,
-                    datasource: {
-                        service: row.caller,
-                        declared: row.request.datasourceDeclared,
-                        declaration: row.request.datasourceDeclaration,
-                    },
-                    ports,
-                    receipts: writeReceiptsFor(row.orgId),
-                    onCommitted: (event) => commitWriteEffects({
-                        platform: platformRef,
-                        scope,
-                        caller: row.caller,
-                        event,
-                    }),
-                }, {}, row);
-            },
+            replay,
         });
+        // Queued writes drain on their own, so a long backlog does not hold up the retry above.
+        if (!queuedDrain && !platformClosing) {
+            const drain = drainQueuedWrites({
+                orgIds: [...orgIds],
+                now: () => new Date().toISOString(),
+                storeFor: (orgId) => writeReceiptsFor(orgId),
+                replay,
+                concurrency: queueConcurrency(),
+                shouldStop: () => platformClosing,
+            })
+                .then(() => undefined)
+                .finally(() => {
+                if (queuedDrain === drain)
+                    queuedDrain = null;
+            });
+            queuedDrain = drain;
+        }
+        if (queuedDrain)
+            await queuedDrain;
     }
     function startWriteReceiptTicker(opts) {
         if (writeReceiptTicker) {
@@ -1238,6 +1273,7 @@ export async function createMemorixPlatform(deps) {
         mode: deps.mode,
         client,
         metadata,
+        metadataView,
         isolation: deps.isolation ?? null,
         magit,
         rehydrateMetadata,
@@ -1320,6 +1356,9 @@ export async function createMemorixPlatform(deps) {
                 clearInterval(writeReceiptTicker);
                 writeReceiptTicker = null;
             }
+            platformClosing = true;
+            if (queuedDrain)
+                await queuedDrain.catch(() => undefined);
             if (hookPump)
                 await hookPump.catch(() => undefined);
             if (analytics)