@x12i/memorix-writer 1.3.0 → 1.4.0

package/README.md

@@ -70,7 +70,7 @@ Override defaults only when you need to:
 
 ## Collection resolution
 
-Writes target **`memorix-entities`** or **`memorix-events`** based on the write descriptor (`target.kind`, defaulting from `identity.idField`). Database names follow [Memorix Database Conventions](./docs/MEMORIX-DATABASE-CONVENTIONS.md) (`MEMORIX_ENTITIES_DB`, `MEMORIX_EVENTS_DB`, …).
+Writes target **`memorix-entities`**, **`memorix-events`**, or **`memorix-knowledge`** based on the write descriptor (`target.kind`, defaulting from `identity.idField`). Database names follow [Memorix Database Conventions](./docs/MEMORIX-DATABASE-CONVENTIONS.md) (`MEMORIX_ENTITIES_DB`, `MEMORIX_EVENTS_DB`, `MEMORIX_KNOWLEDGE_DB`, …).
 
 Collection name resolution order:
 
@@ -105,6 +105,8 @@ npm run catalox:seed:write-descriptors:validate
 
 Seed file: [`catalox-seeds/memorix-write-descriptors.manifest.json`](catalox-seeds/memorix-write-descriptors.manifest.json)
 
+Shipped write descriptors include `asset-analysis-write` (entity) and corpus helpers `content-documents-snapshot-write` / `content-documents-chunk-write` (`knowledge` target). Record builders: [`@x12i/memorix-corpus`](../memorix-corpus/README.md).
+
 ## Acceptance criteria
 
 | ID | Status |
@@ -150,6 +152,35 @@ import {
 
 Full contract: [docs/GRAPH-RUNS.md](./docs/GRAPH-RUNS.md).
 
+## Job-type run tracking (`_jobTypeRuns`) — MRX-CR-003
+
+Parallel stamp APIs keyed by `jobTypeId` (shared `GraphRunEntry` shape). Domain writes reject `_jobTypeRuns` in input.
+
+```typescript
+import {
+  markJobTypeRunStarted,
+  markJobTypeRunCompleted,
+  markJobTypeRunFailed,
+  ensureJobTypeRunIndexes,
+} from "@x12i/memorix-writer";
+```
+
+Full contract: [docs/JOB-TYPE-RUNS.md](./docs/JOB-TYPE-RUNS.md).
+
+## Entity collection bootstrap — MRX-CR-005
+
+```typescript
+import { initializeEntityCollections } from "@x12i/memorix-writer";
+
+await initializeEntityCollections(client, "assets", {
+  contentTypes: ["core", "inferences"],
+  graphRunIndexes: true,
+  jobTypeRunIndexes: true,
+});
+```
+
+Idempotent: creates missing collections and ensures standard indexes (`idx_updatedAt`, `idx_graphRuns`, optional `idx_jobTypeRuns`, etc.).
+
 ## Development
 
 ```bash

package/catalox-seeds/memorix-write-descriptors.manifest.json

@@ -158,6 +158,181 @@
           "defaultMode": "summary"
         }
       }
+    },
+    {
+      "catalogId": "memorix-write-descriptors",
+      "data": {
+        "id": "content-documents-snapshot-write",
+        "entity": "content-documents",
+        "title": "Write Content Document Snapshot",
+        "target": {
+          "kind": "knowledge",
+          "contentType": "snapshots"
+        },
+        "identity": {
+          "idField": "knowledgeId",
+          "requireExistingCanonical": false
+        },
+        "operations": {
+          "allowed": ["add", "upsert"],
+          "default": "upsert"
+        },
+        "fields": {
+          "title": {
+            "label": "Title",
+            "inputPath": "title",
+            "target": { "path": "data.title" },
+            "writable": true,
+            "valueType": "string"
+          },
+          "summary": {
+            "label": "Summary",
+            "inputPath": "summary",
+            "target": { "path": "data.summary" },
+            "writable": true,
+            "valueType": "string"
+          },
+          "language": {
+            "label": "Language",
+            "inputPath": "language",
+            "target": { "path": "data.language" },
+            "writable": true,
+            "valueType": "string"
+          },
+          "sourceKind": {
+            "label": "Source kind",
+            "inputPath": "sourceKind",
+            "target": { "path": "source.kind" },
+            "writable": true,
+            "valueType": "string"
+          },
+          "sourceUri": {
+            "label": "Source URI",
+            "inputPath": "sourceUri",
+            "target": { "path": "source.uri" },
+            "writable": true,
+            "valueType": "string"
+          },
+          "canonicalUri": {
+            "label": "Canonical URI",
+            "inputPath": "canonicalUri",
+            "target": { "path": "source.canonicalUri" },
+            "writable": true,
+            "valueType": "string"
+          },
+          "contentHash": {
+            "label": "Content hash",
+            "inputPath": "contentHash",
+            "target": { "path": "provenance.contentHash" },
+            "writable": true,
+            "valueType": "string"
+          },
+          "cleanMarkdown": {
+            "label": "Clean Markdown",
+            "inputPath": "cleanMarkdown",
+            "target": { "path": "content.cleanMarkdown" },
+            "writable": true,
+            "valueType": "content",
+            "content": {
+              "enabled": true,
+              "objectType": "memorix-content-object",
+              "acceptBody": true,
+              "acceptPointer": true,
+              "format": "markdown",
+              "maxBytes": 10485760,
+              "contentKeyTemplate": "content-documents/{{knowledgeId}}/{{contentHash}}/clean.md",
+              "generatePreview": true,
+              "previewMaxChars": 500,
+              "computeMetadata": true,
+              "storage": {
+                "provider": "gcs",
+                "bucket": "memorix-content",
+                "prefix": "content-documents"
+              }
+            }
+          }
+        },
+        "content": {
+          "allowed": true,
+          "allowedFields": ["cleanMarkdown"],
+          "generatePreview": true,
+          "previewMaxChars": 500,
+          "computeMetadata": true,
+          "maxBytes": 10485760
+        },
+        "validation": {
+          "rejectUnknownFields": true,
+          "requireAtLeastOneWritableField": true
+        },
+        "return": {
+          "defaultMode": "summary"
+        }
+      }
+    },
+    {
+      "catalogId": "memorix-write-descriptors",
+      "data": {
+        "id": "content-documents-chunk-write",
+        "entity": "content-documents",
+        "title": "Write Content Document Chunk",
+        "target": {
+          "kind": "knowledge",
+          "contentType": "chunks"
+        },
+        "identity": {
+          "idField": "knowledgeId",
+          "requireExistingCanonical": false
+        },
+        "operations": {
+          "allowed": ["add"],
+          "default": "add"
+        },
+        "fields": {
+          "text": {
+            "label": "Chunk text",
+            "inputPath": "text",
+            "target": { "path": "data.text" },
+            "required": true,
+            "writable": true,
+            "valueType": "string"
+          },
+          "sectionTitle": {
+            "label": "Section title",
+            "inputPath": "sectionTitle",
+            "target": { "path": "data.sectionTitle" },
+            "writable": true,
+            "valueType": "string"
+          },
+          "tokenCount": {
+            "label": "Token count",
+            "inputPath": "tokenCount",
+            "target": { "path": "data.tokenCount" },
+            "writable": true,
+            "valueType": "number"
+          },
+          "chunkIndex": {
+            "label": "Chunk index",
+            "inputPath": "chunkIndex",
+            "target": { "path": "provenance.chunkIndex" },
+            "writable": true,
+            "valueType": "number"
+          },
+          "contentHash": {
+            "label": "Parent content hash",
+            "inputPath": "contentHash",
+            "target": { "path": "parent.contentHash" },
+            "writable": true,
+            "valueType": "string"
+          }
+        },
+        "validation": {
+          "rejectUnknownFields": true,
+          "requireAtLeastOneWritableField": true
+        },
+        "return": {
+          "defaultMode": "summary"
+        }
+      }
     }
   ]
 }

package/dist/collections/initialize-entity-collections.d.ts

@@ -0,0 +1,15 @@
+import type { MemorixWriterClient } from "../client/types.js";
+export type InitializeEntityCollectionsOptions = {
+    contentTypes?: ("core" | "event" | "inferences")[];
+    graphRunIndexes?: boolean;
+    jobTypeRunIndexes?: boolean;
+};
+export type InitializeEntityCollectionsResult = {
+    created: string[];
+    existing: string[];
+};
+/**
+ * Create entity content collections if missing and ensure recommended indexes (MRX-CR-005).
+ */
+export declare function initializeEntityCollections(client: MemorixWriterClient, entity: string, options?: InitializeEntityCollectionsOptions): Promise<InitializeEntityCollectionsResult>;
+//# sourceMappingURL=initialize-entity-collections.d.ts.map

package/dist/collections/initialize-entity-collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialize-entity-collections.d.ts","sourceRoot":"","sources":["../../src/collections/initialize-entity-collections.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAM9D,MAAM,MAAM,kCAAkC,GAAG;IAC/C,YAAY,CAAC,EAAE,CAAC,MAAM,GAAG,OAAO,GAAG,YAAY,CAAC,EAAE,CAAC;IACnD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAsCF;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,kCAAuC,GAC/C,OAAO,CAAC,iCAAiC,CAAC,CAiD5C"}

package/dist/collections/initialize-entity-collections.js

@@ -0,0 +1,70 @@
+import { ensureEntityCollectionIndexes } from "@x12i/memorix-mongo";
+import { getWriterMemorixTier } from "../client/ensure-tier.js";
+import { loadMemorixEntityDescriptor } from "../descriptors/load-entity-descriptor.js";
+import { MemorixWriterError } from "../errors/errors.js";
+import { resolveMemorixDbName } from "../mongo/env.js";
+const DEFAULT_CONTENT_TYPES = [
+    "core",
+    "inferences",
+];
+function resolveContentTypeKeys(entityContentTypes, requested) {
+    const keys = Object.keys(entityContentTypes);
+    const resolved = [];
+    for (const key of requested) {
+        if (keys.includes(key)) {
+            resolved.push(key);
+            continue;
+        }
+        const byPostfix = keys.find((k) => entityContentTypes[k]?.postfix?.trim().toLowerCase() === key);
+        if (byPostfix)
+            resolved.push(byPostfix);
+    }
+    return [...new Set(resolved)];
+}
+function resolveCollectionName(collectionPrefix, contentType, contentTypeKey) {
+    if (contentType.collection?.trim())
+        return contentType.collection.trim();
+    const postfix = contentType.postfix?.trim() || contentTypeKey;
+    return `${collectionPrefix.trim()}-${postfix}`;
+}
+/**
+ * Create entity content collections if missing and ensure recommended indexes (MRX-CR-005).
+ */
+export async function initializeEntityCollections(client, entity, options = {}) {
+    const entityDescriptor = await loadMemorixEntityDescriptor(client, entity);
+    const tier = await getWriterMemorixTier(client);
+    const env = tier.env;
+    const requested = options.contentTypes ?? DEFAULT_CONTENT_TYPES ?? [];
+    const contentTypeKeys = resolveContentTypeKeys(entityDescriptor.contentTypes ?? {}, requested);
+    if (contentTypeKeys.length === 0) {
+        throw new MemorixWriterError("DESCRIPTOR_MISSING", `No matching content types for initializeEntityCollections on "${entity}"`);
+    }
+    const target = "entity";
+    const dbName = resolveMemorixDbName(target, env);
+    const db = tier.client.db(dbName);
+    const created = [];
+    const existing = [];
+    const prefix = String(entityDescriptor.collectionPrefix ?? entity).trim();
+    for (const contentTypeKey of contentTypeKeys) {
+        const ct = entityDescriptor.contentTypes[contentTypeKey];
+        if (!ct)
+            continue;
+        const collectionName = resolveCollectionName(prefix, ct, contentTypeKey);
+        const listed = await db.listCollections({ name: collectionName }).toArray();
+        const wasExisting = listed.length > 0;
+        if (!wasExisting) {
+            await db.createCollection(collectionName).catch(() => undefined);
+            created.push(collectionName);
+        }
+        else {
+            existing.push(collectionName);
+        }
+        const coll = db.collection(collectionName);
+        await ensureEntityCollectionIndexes(coll, {
+            graphRunIndexes: options.graphRunIndexes ?? true,
+            jobTypeRunIndexes: options.jobTypeRunIndexes ?? false,
+        });
+    }
+    return { created, existing };
+}
+//# sourceMappingURL=initialize-entity-collections.js.map

package/dist/collections/initialize-entity-collections.js.map

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

package/dist/graph-runs/write-result.d.ts

@@ -6,6 +6,8 @@ export type WriteGraphRunResultOptions = {
     jobRunId: string;
     attempts: number;
     graphVersion?: string;
+    /** When set, also stamps `_jobTypeRuns.<jobTypeId>` in the same transaction (MRX-CR-003). */
+    jobTypeId?: string;
 };
 export type WriteGraphRunResultResponse = {
     ok: true;

package/dist/graph-runs/write-result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-result.d.ts","sourceRoot":"","sources":["../../src/graph-runs/write-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAgB9D,MAAM,MAAM,0BAA0B,GAAG;IACvC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,qBAAqB,CAAC;CAC/B,CAAC;AAiBF,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,mBAAmB,EAC3B,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,2BAA2B,CAAC,CAwItC"}
+{"version":3,"file":"write-result.d.ts","sourceRoot":"","sources":["../../src/graph-runs/write-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAiB9D,MAAM,MAAM,0BAA0B,GAAG;IACvC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6FAA6F;IAC7F,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,qBAAqB,CAAC;CAC/B,CAAC;AAiBF,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,mBAAmB,EAC3B,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,2BAA2B,CAAC,CA+ItC"}

package/dist/graph-runs/write-result.js

@@ -4,6 +4,7 @@ import { MemorixWriterError } from "../errors/errors.js";
 import { deepSet } from "../utils/path.js";
 import { graphRunDotPath } from "./constants.js";
 import { readGraphRunEntry } from "./context.js";
+import { jobTypeRunDotPath } from "../job-type-runs/constants.js";
 import { ensurePersistencyRelationDescriptor } from "./ensure-persistency-relation.js";
 import { graphRunLogContext } from "./logging.js";
 import { resolvePersistencyIds } from "./resolve-persistency-ids.js";
@@ -94,7 +95,13 @@ export async function writeGraphRunResult(client, ref, graphId, opts) {
                         ? { graphVersion: existing.graphVersion }
                         : {}),
             };
-            const stamp = await sourceAdapter.patch(resolved.collection, resolved.filter, { [graphRunDotPath(graphId)]: entry }, { session });
+            const patchPayload = {
+                [graphRunDotPath(graphId)]: entry,
+            };
+            if (opts.jobTypeId) {
+                patchPayload[jobTypeRunDotPath(opts.jobTypeId)] = entry;
+            }
+            const stamp = await sourceAdapter.patch(resolved.collection, resolved.filter, patchPayload, { session });
             if (stamp.matchedCount === 0) {
                 throw new MemorixWriterError("RECORD_NOT_FOUND", `Source record disappeared while stamping _graphRuns for ${resolveRecordCollection(ref).collection}`);
             }

package/dist/graph-runs/write-result.js.map

@@ -1 +1 @@
-{"version":3,"file":"write-result.js","sourceRoot":"","sources":["../../src/graph-runs/write-result.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,mCAAmC,EAAE,MAAM,kCAAkC,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AAiBxC,SAAS,mBAAmB,CAC1B,GAAqB,EACrB,iBAAoC;IAEpC,OAAO,iBAAiB,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC;AAChD,CAAC;AAED,SAAS,oBAAoB,CAC3B,MAAqB;IAErB,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,MAAM,KAAK,WAAW;QAAE,OAAO,aAAa,CAAC;IACjD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAA2B,EAC3B,GAAqB,EACrB,OAAe,EACf,IAAgC;IAEhC,kBAAkB,CAAC;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,OAAO;QACP,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,qBAAqB;KACjC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,yBAAyB,CAAC,IAAI,EAAE;QACpD,MAAM,EAAE,QAAQ,CAAC,MAAM;KACxB,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,mBAAmB,CAAC,GAAG,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACtE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,GAC1D,qBAAqB,CAAC,GAAG,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACrD,MAAM,gBAAgB,GAAG,4BAA4B,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC9E,MAAM,aAAa,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,UAAU,EAAE,CAAC;IACrD,MAAM,aAAa,GAAG,yBAAyB,CAAC,IAAI,EAAE;QACpD,MAAM,EAAE,YAAY;KACrB,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC;IACzC,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,mCAAmC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,aAAa,GAA0B;QAC3C,MAAM,EAAE,YAAY;QACpB,UAAU,EAAE,IAAI,CAAC,iBAAiB,CAAC,UAAU;QAC7C,WAAW,EAAE,IAAI,CAAC,iBAAiB,CAAC,WAAW;QAC/C,QAAQ,EAAE,cAAc;KACzB,CAAC;IAEF,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;IAE3C,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,eAAe,CAAC,KAAK,IAAI,EAAE;YACvC,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,OAAO,CAC3C,QAAQ,CAAC,UAAU,EACnB,QAAQ,CAAC,MAAM,EACf,EAAE,OAAO,EAAE,CACZ,CAAC;YACF,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,IAAI,kBAAkB,CAC1B,kBAAkB,EAClB,+BAA+B,QAAQ,CAAC,UAAU,QAAQ,QAAQ,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAClI,CAAC;YACJ,CAAC;YAED,MAAM,QAAQ,GAAG,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAEvD,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC7C,MAAM,SAAS,GAA4B;gBACzC,GAAG,IAAI,CAAC,aAAa;gBACrB,CAAC,aAAa,CAAC,EAAE,UAAU;gBAC3B,QAAQ,EAAE,cAAc;gBACxB,UAAU,EAAE,WAAW;gBACvB,SAAS,EAAE,WAAW;aACvB,CAAC;YAEF,IAAI,IAAI,EAAE,CAAC;gBACT,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;YACvD,CAAC;YAED,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,aAAa,CAAC,MAAM,CAAC,gBAAgB,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YACvE,CAAC;iBAAM,CAAC;gBACN,MAAM,cAAc,GAAG,MAAM,aAAa,CAAC,OAAO,CAChD,gBAAgB,EAChB,YAAY,EACZ,EAAE,OAAO,EAAE,CACZ,CAAC;gBACF,IAAI,cAAc,EAAE,SAAS,EAAE,CAAC;oBAC9B,SAAS,CAAC,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC;gBACjD,CAAC;gBAED,MAAM,aAAa,GAAG,MAAM,aAAa,CAAC,OAAO,CAC/C,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,IAAI,EACJ,EAAE,OAAO,EAAE,CACZ,CAAC;gBAEF,IACE,aAAa,CAAC,YAAY,KAAK,CAAC;oBAChC,aAAa,CAAC,aAAa,KAAK,CAAC,EACjC,CAAC;oBACD,MAAM,IAAI,kBAAkB,CAC1B,oBAAoB,EACpB,mCAAmC,gBAAgB,EAAE,CACtD,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,MAAM,KAAK,GAAG;gBACZ,MAAM,EAAE,MAAe;gBACvB,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,WAAW;gBAC7C,WAAW;gBACX,YAAY,EAAE,IAAI,CAAC,QAAQ;gBAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,MAAM,EAAE,aAAa;gBACrB,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS;oBACjC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE;oBACrC,CAAC,CAAC,QAAQ,EAAE,YAAY,KAAK,SAAS;wBACpC,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE;wBACzC,CAAC,CAAC,EAAE,CAAC;aACV,CAAC;YAEF,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,KAAK,CACrC,QAAQ,CAAC,UAAU,EACnB,QAAQ,CAAC,MAAM,EACf,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,EACrC,EAAE,OAAO,EAAE,CACZ,CAAC;YACF,IAAI,KAAK,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,kBAAkB,CAC1B,kBAAkB,EAClB,2DAA2D,uBAAuB,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,CACrG,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,kBAAkB;YAAE,MAAM,GAAG,CAAC;QACjD,MAAM,IAAI,kBAAkB,CAC1B,wBAAwB,EACxB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,qCAAqC,CAC3E,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AACtE,CAAC"}
+{"version":3,"file":"write-result.js","sourceRoot":"","sources":["../../src/graph-runs/write-result.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -20,16 +20,31 @@ export { ensureGraphRunIndexes } from "./graph-runs/ensure-indexes.js";
 export { GRAPH_RUNS_FIELD, graphRunDotPath } from "./graph-runs/constants.js";
 export { resolveRecordCollection, resolveCollectionFromRef, resolvePersistencyCollection, resolvePersistencyRecordId, } from "./graph-runs/resolve-record-collection.js";
 export { graphRunLogContext } from "./graph-runs/logging.js";
+export { markJobTypeRunStarted } from "./job-type-runs/mark-started.js";
+export { markJobTypeRunFailed } from "./job-type-runs/mark-failed.js";
+export { markJobTypeRunCompleted } from "./job-type-runs/mark-completed.js";
+export { getJobTypeRun } from "./job-type-runs/get-run.js";
+export { ensureJobTypeRunIndexes } from "./job-type-runs/ensure-indexes.js";
+export { JOB_TYPE_RUNS_FIELD, jobTypeRunDotPath, jobTypeRunFieldKey, } from "./job-type-runs/constants.js";
+export { readJobTypeRunEntry } from "./job-type-runs/context.js";
+export { jobTypeRunLogContext } from "./job-type-runs/logging.js";
 export type { MarkGraphRunStartedOptions, MarkGraphRunStartedResult, } from "./graph-runs/mark-started.js";
 export type { MarkGraphRunFailedOptions, MarkGraphRunFailedResult, } from "./graph-runs/mark-failed.js";
 export type { WriteGraphRunResultOptions, WriteGraphRunResultResponse, } from "./graph-runs/write-result.js";
 export type { ClearGraphRunResult } from "./graph-runs/clear-run.js";
 export type { EnsureGraphRunIndexesResult } from "./graph-runs/ensure-indexes.js";
 export type { GraphRunLogContext } from "./graph-runs/logging.js";
-export type { GraphRunStatus, GraphRunResultPointer, GraphRunError, GraphRunEntry, GraphRunsField, MemorixRecordRef, PersistencyRecordIdSource, PersistencyLinkIntent, PersistencyTarget, } from "@x12i/memorix-descriptors/types";
+export type { MarkJobTypeRunStartedOptions, MarkJobTypeRunStartedResult, } from "./job-type-runs/mark-started.js";
+export type { MarkJobTypeRunFailedOptions, MarkJobTypeRunFailedResult, } from "./job-type-runs/mark-failed.js";
+export type { MarkJobTypeRunCompletedOptions, MarkJobTypeRunCompletedResult, } from "./job-type-runs/mark-completed.js";
+export type { EnsureJobTypeRunIndexesResult } from "./job-type-runs/ensure-indexes.js";
+export type { JobTypeRunLogContext } from "./job-type-runs/logging.js";
+export type { GraphRunStatus, GraphRunResultPointer, GraphRunError, GraphRunEntry, GraphRunsField, JobTypeRunsField, MemorixRecordRef, PersistencyRecordIdSource, PersistencyLinkIntent, PersistencyTarget, } from "@x12i/memorix-descriptors/types";
 export type { MemorixWriterClient, CreateMemorixWriterOptions, CreateMemorixWriterFromEnvOptions, CataloxLike, MemorixObjectWriterLike, MemorixContentWriterRegistry, MemorixRetrievalClient, MemorixWriterDefaults, WriteMemorixRecordRequest, WriteMemorixRecordResponse, WriteMemorixRecordsRequest, WriteMemorixRecordsResponse, ValidateMemorixWriteResponse, } from "./client/types.js";
 export type { MemorixWriteDescriptor, MemorixWriteFieldDescriptor, MemorixIdempotencyDescriptor, } from "./descriptors/write-descriptor-types.js";
 export type { MemorixEntityDescriptor, MemorixContentObject, MemorixContentStorageDescriptor, MemorixContentTypeDescriptor, MemorixPropertyDescriptor, } from "./descriptors/entity-descriptor-types.js";
 export type { MemorixWriteIssue } from "./errors/issues.js";
+export { initializeEntityCollections } from "./collections/initialize-entity-collections.js";
+export type { InitializeEntityCollectionsOptions, InitializeEntityCollectionsResult, } from "./collections/initialize-entity-collections.js";
 export { MemorixWriterError } from "./errors/errors.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -19,5 +19,14 @@ export { ensureGraphRunIndexes } from "./graph-runs/ensure-indexes.js";
 export { GRAPH_RUNS_FIELD, graphRunDotPath } from "./graph-runs/constants.js";
 export { resolveRecordCollection, resolveCollectionFromRef, resolvePersistencyCollection, resolvePersistencyRecordId, } from "./graph-runs/resolve-record-collection.js";
 export { graphRunLogContext } from "./graph-runs/logging.js";
+export { markJobTypeRunStarted } from "./job-type-runs/mark-started.js";
+export { markJobTypeRunFailed } from "./job-type-runs/mark-failed.js";
+export { markJobTypeRunCompleted } from "./job-type-runs/mark-completed.js";
+export { getJobTypeRun } from "./job-type-runs/get-run.js";
+export { ensureJobTypeRunIndexes } from "./job-type-runs/ensure-indexes.js";
+export { JOB_TYPE_RUNS_FIELD, jobTypeRunDotPath, jobTypeRunFieldKey, } from "./job-type-runs/constants.js";
+export { readJobTypeRunEntry } from "./job-type-runs/context.js";
+export { jobTypeRunLogContext } from "./job-type-runs/logging.js";
+export { initializeEntityCollections } from "./collections/initialize-entity-collections.js";
 export { MemorixWriterError } from "./errors/errors.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAEzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AACpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAEtF,OAAO,EACL,iCAAiC,EACjC,mCAAmC,EACnC,qCAAqC,EACrC,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,eAAe,EACf,2BAA2B,EAC3B,sBAAsB,EACtB,yBAAyB,EACzB,oCAAoC,EACpC,mCAAmC,GACpC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,EAAE,gCAAgC,EAAE,MAAM,2CAA2C,CAAC;AAC7F,OAAO,EACL,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AA8D7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAEzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AACpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAEtF,OAAO,EACL,iCAAiC,EACjC,mCAAmC,EACnC,qCAAqC,EACrC,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,eAAe,EACf,2BAA2B,EAC3B,sBAAsB,EACtB,yBAAyB,EACzB,oCAAoC,EACpC,mCAAmC,GACpC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,EAAE,gCAAgC,EAAE,MAAM,2CAA2C,CAAC;AAC7F,OAAO,EACL,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AA6ElE,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAO7F,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/job-type-runs/constants.d.ts

@@ -0,0 +1,2 @@
+export { JOB_TYPE_RUNS_FIELD, jobTypeRunDotPath, jobTypeRunFieldKey, } from "@x12i/memorix-descriptors/types";
+//# sourceMappingURL=constants.d.ts.map

package/dist/job-type-runs/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/job-type-runs/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,iCAAiC,CAAC"}

package/dist/job-type-runs/constants.js

@@ -0,0 +1,2 @@
+export { JOB_TYPE_RUNS_FIELD, jobTypeRunDotPath, jobTypeRunFieldKey, } from "@x12i/memorix-descriptors/types";
+//# sourceMappingURL=constants.js.map

package/dist/job-type-runs/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/job-type-runs/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,iCAAiC,CAAC"}

package/dist/job-type-runs/context.d.ts

@@ -0,0 +1,3 @@
+import type { GraphRunEntry } from "@x12i/memorix-descriptors/types";
+export declare function readJobTypeRunEntry(doc: Record<string, unknown>, jobTypeId: string): GraphRunEntry | undefined;
+//# sourceMappingURL=context.d.ts.map

package/dist/job-type-runs/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/job-type-runs/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAEd,MAAM,iCAAiC,CAAC;AAGzC,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,SAAS,EAAE,MAAM,GAChB,aAAa,GAAG,SAAS,CAG3B"}

package/dist/job-type-runs/context.js

@@ -0,0 +1,6 @@
+import { JOB_TYPE_RUNS_FIELD, jobTypeRunFieldKey } from "./constants.js";
+export function readJobTypeRunEntry(doc, jobTypeId) {
+    const jobTypeRuns = doc[JOB_TYPE_RUNS_FIELD];
+    return jobTypeRuns?.[jobTypeRunFieldKey(jobTypeId)];
+}
+//# sourceMappingURL=context.js.map

package/dist/job-type-runs/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/job-type-runs/context.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzE,MAAM,UAAU,mBAAmB,CACjC,GAA4B,EAC5B,SAAiB;IAEjB,MAAM,WAAW,GAAG,GAAG,CAAC,mBAAmB,CAAiC,CAAC;IAC7E,OAAO,WAAW,EAAE,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/dist/job-type-runs/ensure-indexes.d.ts

@@ -0,0 +1,10 @@
+import type { MongoClient } from "mongodb";
+import type { MemorixRecordRef } from "@x12i/memorix-descriptors/types";
+export type EnsureJobTypeRunIndexesResult = {
+    ok: true;
+    collection: string;
+    jobTypeId: string;
+    indexes: string[];
+};
+export declare function ensureJobTypeRunIndexes(client: MongoClient, ref: MemorixRecordRef, jobTypeId: string, env?: NodeJS.ProcessEnv): Promise<EnsureJobTypeRunIndexesResult>;
+//# sourceMappingURL=ensure-indexes.d.ts.map

package/dist/job-type-runs/ensure-indexes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-indexes.d.ts","sourceRoot":"","sources":["../../src/job-type-runs/ensure-indexes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AASxE,MAAM,MAAM,6BAA6B,GAAG;IAC1C,EAAE,EAAE,IAAI,CAAC;IACT,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,6BAA6B,CAAC,CAuCxC"}

package/dist/job-type-runs/ensure-indexes.js

@@ -0,0 +1,32 @@
+import { resolveMemorixDbName } from "../mongo/env.js";
+import { resolveIdFieldForTarget, resolveRecordCollection, } from "../graph-runs/resolve-record-collection.js";
+import { jobTypeRunDotPath } from "./constants.js";
+import { jobTypeRunLogContext } from "./logging.js";
+export async function ensureJobTypeRunIndexes(client, ref, jobTypeId, env = process.env) {
+    jobTypeRunLogContext({
+        jobRunId: "",
+        jobTypeId,
+        recordRef: ref,
+        operation: "ensureJobTypeRunIndexes",
+    });
+    const resolved = resolveRecordCollection(ref);
+    const dbName = resolveMemorixDbName(resolved.target, env);
+    const idField = resolveIdFieldForTarget(ref.target);
+    const col = client.db(dbName).collection(resolved.collection);
+    const statusIndex = `${jobTypeRunDotPath(jobTypeId)}.status_1_${idField}_1`;
+    const completedAtIndex = `${jobTypeRunDotPath(jobTypeId)}.completedAt_-1`;
+    const reprocessIndex = `${jobTypeRunDotPath(jobTypeId)}.status_1_completedAt_-1`;
+    await col.createIndex({ [jobTypeRunDotPath(jobTypeId) + ".status"]: 1, [idField]: 1 }, { name: statusIndex });
+    await col.createIndex({ [jobTypeRunDotPath(jobTypeId) + ".completedAt"]: -1 }, { name: completedAtIndex });
+    await col.createIndex({
+        [jobTypeRunDotPath(jobTypeId) + ".status"]: 1,
+        [jobTypeRunDotPath(jobTypeId) + ".completedAt"]: -1,
+    }, { name: reprocessIndex });
+    return {
+        ok: true,
+        collection: resolved.collection,
+        jobTypeId,
+        indexes: [statusIndex, completedAtIndex, reprocessIndex],
+    };
+}
+//# sourceMappingURL=ensure-indexes.js.map

package/dist/job-type-runs/ensure-indexes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-indexes.js","sourceRoot":"","sources":["../../src/job-type-runs/ensure-indexes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AASpD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAmB,EACnB,GAAqB,EACrB,SAAiB,EACjB,MAAyB,OAAO,CAAC,GAAG;IAEpC,oBAAoB,CAAC;QACnB,QAAQ,EAAE,EAAE;QACZ,SAAS;QACT,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,yBAAyB;KACrC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,uBAAuB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAE9D,MAAM,WAAW,GAAG,GAAG,iBAAiB,CAAC,SAAS,CAAC,aAAa,OAAO,IAAI,CAAC;IAC5E,MAAM,gBAAgB,GAAG,GAAG,iBAAiB,CAAC,SAAS,CAAC,iBAAiB,CAAC;IAC1E,MAAM,cAAc,GAAG,GAAG,iBAAiB,CAAC,SAAS,CAAC,0BAA0B,CAAC;IAEjF,MAAM,GAAG,CAAC,WAAW,CACnB,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EAC/D,EAAE,IAAI,EAAE,WAAW,EAAE,CACtB,CAAC;IACF,MAAM,GAAG,CAAC,WAAW,CACnB,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,EACvD,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAC3B,CAAC;IACF,MAAM,GAAG,CAAC,WAAW,CACnB;QACE,CAAC,iBAAiB,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC;QAC7C,CAAC,iBAAiB,CAAC,SAAS,CAAC,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;KACpD,EACD,EAAE,IAAI,EAAE,cAAc,EAAE,CACzB,CAAC;IAEF,OAAO;QACL,EAAE,EAAE,IAAI;QACR,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,SAAS;QACT,OAAO,EAAE,CAAC,WAAW,EAAE,gBAAgB,EAAE,cAAc,CAAC;KACzD,CAAC;AACJ,CAAC"}

package/dist/job-type-runs/get-run.d.ts

@@ -0,0 +1,8 @@
+import type { GraphRunEntry, MemorixRecordRef } from "@x12i/memorix-descriptors/types";
+import type { MemorixWriterClient } from "../client/types.js";
+/**
+ * Read a job-type run stamp from a source record (MRX-CR-003).
+ * Returns undefined when the record or stamp is absent (no throw).
+ */
+export declare function getJobTypeRun(client: MemorixWriterClient, ref: MemorixRecordRef, jobTypeId: string): Promise<GraphRunEntry | undefined>;
+//# sourceMappingURL=get-run.d.ts.map

package/dist/job-type-runs/get-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-run.d.ts","sourceRoot":"","sources":["../../src/job-type-runs/get-run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAM9D;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,mBAAmB,EAC3B,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAKpC"}

package/dist/job-type-runs/get-run.js

@@ -0,0 +1,14 @@
+import { createGraphRunWriterContext, } from "../graph-runs/context.js";
+import { readJobTypeRunEntry } from "./context.js";
+/**
+ * Read a job-type run stamp from a source record (MRX-CR-003).
+ * Returns undefined when the record or stamp is absent (no throw).
+ */
+export async function getJobTypeRun(client, ref, jobTypeId) {
+    const ctx = await createGraphRunWriterContext(client, ref);
+    const doc = await ctx.adapter.findOne(ctx.resolved.collection, ctx.resolved.filter);
+    if (!doc)
+        return undefined;
+    return readJobTypeRunEntry(doc, jobTypeId);
+}
+//# sourceMappingURL=get-run.js.map

package/dist/job-type-runs/get-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-run.js","sourceRoot":"","sources":["../../src/job-type-runs/get-run.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,2BAA2B,GAC5B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAA2B,EAC3B,GAAqB,EACrB,SAAiB;IAEjB,MAAM,GAAG,GAAG,MAAM,2BAA2B,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpF,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,OAAO,mBAAmB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AAC7C,CAAC"}

package/dist/job-type-runs/logging.d.ts

@@ -0,0 +1,9 @@
+import type { MemorixRecordRef } from "@x12i/memorix-descriptors/types";
+export type JobTypeRunLogContext = {
+    jobRunId: string;
+    jobTypeId: string;
+    recordRef: MemorixRecordRef;
+    operation: "markJobTypeRunStarted" | "markJobTypeRunCompleted" | "markJobTypeRunFailed" | "ensureJobTypeRunIndexes";
+};
+export declare function jobTypeRunLogContext(ctx: JobTypeRunLogContext): JobTypeRunLogContext;
+//# sourceMappingURL=logging.d.ts.map

package/dist/job-type-runs/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/job-type-runs/logging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAExE,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,SAAS,EACL,uBAAuB,GACvB,yBAAyB,GACzB,sBAAsB,GACtB,yBAAyB,CAAC;CAC/B,CAAC;AAEF,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,oBAAoB,GACxB,oBAAoB,CAEtB"}

package/dist/job-type-runs/logging.js

@@ -0,0 +1,4 @@
+export function jobTypeRunLogContext(ctx) {
+    return ctx;
+}
+//# sourceMappingURL=logging.js.map

package/dist/job-type-runs/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../src/job-type-runs/logging.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,oBAAoB,CAClC,GAAyB;IAEzB,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/job-type-runs/mark-completed.d.ts

@@ -0,0 +1,15 @@
+import type { GraphRunResultPointer, MemorixRecordRef } from "@x12i/memorix-descriptors/types";
+import type { MemorixWriterClient } from "../client/types.js";
+export type MarkJobTypeRunCompletedOptions = {
+    jobRunId: string;
+    attempts: number;
+    result?: GraphRunResultPointer;
+    graphVersion?: string;
+};
+export type MarkJobTypeRunCompletedResult = {
+    ok: true;
+    jobTypeId: string;
+    recordRef: MemorixRecordRef;
+};
+export declare function markJobTypeRunCompleted(client: MemorixWriterClient, ref: MemorixRecordRef, jobTypeId: string, opts: MarkJobTypeRunCompletedOptions): Promise<MarkJobTypeRunCompletedResult>;
+//# sourceMappingURL=mark-completed.d.ts.map

package/dist/job-type-runs/mark-completed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark-completed.d.ts","sourceRoot":"","sources":["../../src/job-type-runs/mark-completed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAU9D,MAAM,MAAM,8BAA8B,GAAG;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,gBAAgB,CAAC;CAC7B,CAAC;AAEF,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,mBAAmB,EAC3B,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,8BAA8B,GACnC,OAAO,CAAC,6BAA6B,CAAC,CAsCxC"}

package/dist/job-type-runs/mark-completed.js

@@ -0,0 +1,38 @@
+import { MemorixWriterError } from "../errors/errors.js";
+import { createGraphRunWriterContext, loadSourceRecord, } from "../graph-runs/context.js";
+import { jobTypeRunDotPath } from "./constants.js";
+import { readJobTypeRunEntry } from "./context.js";
+import { jobTypeRunLogContext } from "./logging.js";
+export async function markJobTypeRunCompleted(client, ref, jobTypeId, opts) {
+    const ctx = await createGraphRunWriterContext(client, ref);
+    const doc = await loadSourceRecord(ctx);
+    const existing = readJobTypeRunEntry(doc, jobTypeId);
+    const completedAt = new Date().toISOString();
+    jobTypeRunLogContext({
+        jobRunId: opts.jobRunId,
+        jobTypeId,
+        recordRef: ref,
+        operation: "markJobTypeRunCompleted",
+    });
+    const entry = {
+        status: "done",
+        startedAt: existing?.startedAt ?? completedAt,
+        completedAt,
+        lastJobRunId: opts.jobRunId,
+        attempts: opts.attempts,
+        ...(opts.result !== undefined ? { result: opts.result } : existing?.result !== undefined ? { result: existing.result } : {}),
+        ...(opts.graphVersion !== undefined
+            ? { graphVersion: opts.graphVersion }
+            : existing?.graphVersion !== undefined
+                ? { graphVersion: existing.graphVersion }
+                : {}),
+    };
+    const stamp = await ctx.adapter.patch(ctx.resolved.collection, ctx.resolved.filter, {
+        [jobTypeRunDotPath(jobTypeId)]: entry,
+    });
+    if (stamp.matchedCount === 0) {
+        throw new MemorixWriterError("RECORD_NOT_FOUND", `Source record disappeared while stamping _jobTypeRuns for ${ctx.resolved.collection}`);
+    }
+    return { ok: true, jobTypeId, recordRef: ref };
+}
+//# sourceMappingURL=mark-completed.js.map

package/dist/job-type-runs/mark-completed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark-completed.js","sourceRoot":"","sources":["../../src/job-type-runs/mark-completed.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAepD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAA2B,EAC3B,GAAqB,EACrB,SAAiB,EACjB,IAAoC;IAEpC,MAAM,GAAG,GAAG,MAAM,2BAA2B,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE7C,oBAAoB,CAAC;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS;QACT,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,yBAAyB;KACrC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG;QACZ,MAAM,EAAE,MAAe;QACvB,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,WAAW;QAC7C,WAAW;QACX,YAAY,EAAE,IAAI,CAAC,QAAQ;QAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5H,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS;YACjC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE;YACrC,CAAC,CAAC,QAAQ,EAAE,YAAY,KAAK,SAAS;gBACpC,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE;gBACzC,CAAC,CAAC,EAAE,CAAC;KACV,CAAC;IAEF,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE;QAClF,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK;KACtC,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,kBAAkB,CAC1B,kBAAkB,EAClB,6DAA6D,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE,CACvF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;AACjD,CAAC"}

package/dist/job-type-runs/mark-failed.d.ts

@@ -0,0 +1,14 @@
+import type { GraphRunError, MemorixRecordRef } from "@x12i/memorix-descriptors/types";
+import type { MemorixWriterClient } from "../client/types.js";
+export type MarkJobTypeRunFailedOptions = {
+    jobRunId: string;
+    attempts: number;
+    error: GraphRunError;
+};
+export type MarkJobTypeRunFailedResult = {
+    ok: true;
+    jobTypeId: string;
+    recordRef: MemorixRecordRef;
+};
+export declare function markJobTypeRunFailed(client: MemorixWriterClient, ref: MemorixRecordRef, jobTypeId: string, opts: MarkJobTypeRunFailedOptions): Promise<MarkJobTypeRunFailedResult>;
+//# sourceMappingURL=mark-failed.d.ts.map

package/dist/job-type-runs/mark-failed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark-failed.d.ts","sourceRoot":"","sources":["../../src/job-type-runs/mark-failed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAU9D,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,gBAAgB,CAAC;CAC7B,CAAC;AAEF,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,mBAAmB,EAC3B,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,2BAA2B,GAChC,OAAO,CAAC,0BAA0B,CAAC,CAoCrC"}

package/dist/job-type-runs/mark-failed.js

@@ -0,0 +1,36 @@
+import { MemorixWriterError } from "../errors/errors.js";
+import { createGraphRunWriterContext, loadSourceRecord, } from "../graph-runs/context.js";
+import { jobTypeRunDotPath } from "./constants.js";
+import { readJobTypeRunEntry } from "./context.js";
+import { jobTypeRunLogContext } from "./logging.js";
+export async function markJobTypeRunFailed(client, ref, jobTypeId, opts) {
+    const ctx = await createGraphRunWriterContext(client, ref);
+    const doc = await loadSourceRecord(ctx);
+    const existing = readJobTypeRunEntry(doc, jobTypeId);
+    const completedAt = new Date().toISOString();
+    jobTypeRunLogContext({
+        jobRunId: opts.jobRunId,
+        jobTypeId,
+        recordRef: ref,
+        operation: "markJobTypeRunFailed",
+    });
+    const entry = {
+        status: "failed",
+        startedAt: existing?.startedAt ?? completedAt,
+        completedAt,
+        lastJobRunId: opts.jobRunId,
+        attempts: opts.attempts,
+        error: opts.error,
+        ...(existing?.graphVersion !== undefined
+            ? { graphVersion: existing.graphVersion }
+            : {}),
+    };
+    const stamp = await ctx.adapter.patch(ctx.resolved.collection, ctx.resolved.filter, {
+        [jobTypeRunDotPath(jobTypeId)]: entry,
+    });
+    if (stamp.matchedCount === 0) {
+        throw new MemorixWriterError("RECORD_NOT_FOUND", `Source record disappeared while stamping _jobTypeRuns for ${ctx.resolved.collection}`);
+    }
+    return { ok: true, jobTypeId, recordRef: ref };
+}
+//# sourceMappingURL=mark-failed.js.map

package/dist/job-type-runs/mark-failed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark-failed.js","sourceRoot":"","sources":["../../src/job-type-runs/mark-failed.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAcpD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAA2B,EAC3B,GAAqB,EACrB,SAAiB,EACjB,IAAiC;IAEjC,MAAM,GAAG,GAAG,MAAM,2BAA2B,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE7C,oBAAoB,CAAC;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS;QACT,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,sBAAsB;KAClC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG;QACZ,MAAM,EAAE,QAAiB;QACzB,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,WAAW;QAC7C,WAAW;QACX,YAAY,EAAE,IAAI,CAAC,QAAQ;QAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,CAAC,QAAQ,EAAE,YAAY,KAAK,SAAS;YACtC,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE;YACzC,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IAEF,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE;QAClF,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK;KACtC,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,kBAAkB,CAC1B,kBAAkB,EAClB,6DAA6D,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE,CACvF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;AACjD,CAAC"}

package/dist/job-type-runs/mark-started.d.ts

@@ -0,0 +1,15 @@
+import type { MemorixRecordRef } from "@x12i/memorix-descriptors/types";
+import type { MemorixWriterClient } from "../client/types.js";
+export type MarkJobTypeRunStartedOptions = {
+    jobRunId: string;
+    attempts: number;
+    graphVersion?: string;
+};
+export type MarkJobTypeRunStartedResult = {
+    ok: true;
+    action: "stamped" | "no_op";
+    jobTypeId: string;
+    recordRef: MemorixRecordRef;
+};
+export declare function markJobTypeRunStarted(client: MemorixWriterClient, ref: MemorixRecordRef, jobTypeId: string, opts: MarkJobTypeRunStartedOptions): Promise<MarkJobTypeRunStartedResult>;
+//# sourceMappingURL=mark-started.d.ts.map

package/dist/job-type-runs/mark-started.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark-started.d.ts","sourceRoot":"","sources":["../../src/job-type-runs/mark-started.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAU9D,MAAM,MAAM,4BAA4B,GAAG;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,gBAAgB,CAAC;CAC7B,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,mBAAmB,EAC3B,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,4BAA4B,GACjC,OAAO,CAAC,2BAA2B,CAAC,CAuCtC"}

package/dist/job-type-runs/mark-started.js

@@ -0,0 +1,36 @@
+import { MemorixWriterError } from "../errors/errors.js";
+import { createGraphRunWriterContext, loadSourceRecord, } from "../graph-runs/context.js";
+import { jobTypeRunDotPath } from "./constants.js";
+import { readJobTypeRunEntry } from "./context.js";
+import { jobTypeRunLogContext } from "./logging.js";
+export async function markJobTypeRunStarted(client, ref, jobTypeId, opts) {
+    const ctx = await createGraphRunWriterContext(client, ref);
+    const doc = await loadSourceRecord(ctx);
+    const existing = readJobTypeRunEntry(doc, jobTypeId);
+    jobTypeRunLogContext({
+        jobRunId: opts.jobRunId,
+        jobTypeId,
+        recordRef: ref,
+        operation: "markJobTypeRunStarted",
+    });
+    if (existing?.status === "in_progress" &&
+        existing.lastJobRunId === opts.jobRunId) {
+        return { ok: true, action: "no_op", jobTypeId, recordRef: ref };
+    }
+    const startedAt = new Date().toISOString();
+    const entry = {
+        status: "in_progress",
+        startedAt,
+        lastJobRunId: opts.jobRunId,
+        attempts: opts.attempts,
+        ...(opts.graphVersion !== undefined ? { graphVersion: opts.graphVersion } : {}),
+    };
+    const stamp = await ctx.adapter.patch(ctx.resolved.collection, ctx.resolved.filter, {
+        [jobTypeRunDotPath(jobTypeId)]: entry,
+    });
+    if (stamp.matchedCount === 0) {
+        throw new MemorixWriterError("RECORD_NOT_FOUND", `Source record disappeared while stamping _jobTypeRuns for ${ctx.resolved.collection}`);
+    }
+    return { ok: true, action: "stamped", jobTypeId, recordRef: ref };
+}
+//# sourceMappingURL=mark-started.js.map

package/dist/job-type-runs/mark-started.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark-started.js","sourceRoot":"","sources":["../../src/job-type-runs/mark-started.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAepD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAA2B,EAC3B,GAAqB,EACrB,SAAiB,EACjB,IAAkC;IAElC,MAAM,GAAG,GAAG,MAAM,2BAA2B,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAErD,oBAAoB,CAAC;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS;QACT,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,uBAAuB;KACnC,CAAC,CAAC;IAEH,IACE,QAAQ,EAAE,MAAM,KAAK,aAAa;QAClC,QAAQ,CAAC,YAAY,KAAK,IAAI,CAAC,QAAQ,EACvC,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;IAClE,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG;QACZ,MAAM,EAAE,aAAsB;QAC9B,SAAS;QACT,YAAY,EAAE,IAAI,CAAC,QAAQ;QAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChF,CAAC;IAEF,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE;QAClF,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK;KACtC,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,kBAAkB,CAC1B,kBAAkB,EAClB,6DAA6D,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE,CACvF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;AACpE,CAAC"}

package/dist/validation/validate-fields.js

@@ -17,7 +17,7 @@ export function validateInputFields(args) {
     }
     if (rejectUnknown) {
         for (const key of Object.keys(input)) {
-            if (key === "_graphRuns") {
+            if (key === "_graphRuns" || key === "_jobTypeRuns") {
                 issues.push(writeIssue("SYSTEM_FIELD_NOT_WRITABLE", `system field "${key}" cannot be written via writeMemorixRecord`, { path: key, severity: "error" }));
                 continue;
             }

package/dist/validation/validate-fields.js.map

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

package/dist/validation/validate-immutability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-immutability.d.ts","sourceRoot":"","sources":["../../src/validation/validate-immutability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAC5F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAa7D,wBAAgB,8BAA8B,CAAC,IAAI,EAAE;IACnD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;IACpD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,2BAA2B,KAAK,MAAM,CAAC;CACjF,GAAG,iBAAiB,EAAE,CA0BtB"}
+{"version":3,"file":"validate-immutability.d.ts","sourceRoot":"","sources":["../../src/validation/validate-immutability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAC5F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAc7D,wBAAgB,8BAA8B,CAAC,IAAI,EAAE;IACnD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;IACpD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,2BAA2B,KAAK,MAAM,CAAC;CACjF,GAAG,iBAAiB,EAAE,CA0BtB"}

package/dist/validation/validate-immutability.js

@@ -6,6 +6,7 @@ const PROTECTED_PATHS = new Set([
     "recordId",
     "createdAt",
     "_graphRuns",
+    "_jobTypeRuns",
     "_memorix.writeDescriptorId",
 ]);
 export function validateImmutableFieldsOnPatch(args) {

package/dist/validation/validate-immutability.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate-immutability.js","sourceRoot":"","sources":["../../src/validation/validate-immutability.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,UAAU;IACV,SAAS;IACT,UAAU;IACV,WAAW;IACX,YAAY;IACZ,4BAA4B;CAC7B,CAAC,CAAC;AAEH,MAAM,UAAU,8BAA8B,CAAC,IAK9C;IACC,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,IAAI,CAAC,KAAK,CAAC,SAAS;YAAE,SAAS;QAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACtD,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC;YAAE,SAAS;QAClE,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YACnD,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,wBAAwB,EAAE,UAAU,IAAI,gBAAgB,EAAE;gBACnE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;aACxB,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,wBAAwB,EAAE,iBAAiB,IAAI,qBAAqB,EAAE;gBAC/E,IAAI;aACL,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"validate-immutability.js","sourceRoot":"","sources":["../../src/validation/validate-immutability.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,UAAU;IACV,SAAS;IACT,UAAU;IACV,WAAW;IACX,YAAY;IACZ,cAAc;IACd,4BAA4B;CAC7B,CAAC,CAAC;AAEH,MAAM,UAAU,8BAA8B,CAAC,IAK9C;IACC,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,IAAI,CAAC,KAAK,CAAC,SAAS;YAAE,SAAS;QAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACtD,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC;YAAE,SAAS;QAClE,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YACnD,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,wBAAwB,EAAE,UAAU,IAAI,gBAAgB,EAAE;gBACnE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;aACxB,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,wBAAwB,EAAE,iBAAiB,IAAI,qBAAqB,EAAE;gBAC/E,IAAI;aACL,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/docs/JOB-TYPE-RUNS.md

@@ -0,0 +1,79 @@
+# Job-type run tracking (`_jobTypeRuns`) — MRX-CR-003
+
+Record-level visibility for job-type identity over Memorix entity and event records. Multiple graphs can share one `jobTypeId`; eligibility and reprocessing prefer `_jobTypeRuns[jobTypeId]` over `_graphRuns[graphId]`.
+
+## Overview
+
+The reserved system field `_jobTypeRuns` is stored **top-level on the Mongo payload document**, parallel to `_graphRuns`. It is keyed by sanitized `jobTypeId` (`.` → `_`) and reuses the `GraphRunEntry` shape.
+
+Domain `writeMemorixRecord` operations **must not** accept `_jobTypeRuns` in user input.
+
+Shared types and helpers live in `@x12i/memorix-descriptors/types`:
+
+- `JobTypeRunsField`, `GraphRunEntry`
+- `jobTypeRunFieldKey(jobTypeId)`, `jobTypeRunDotPath(jobTypeId)`
+
+## Writer APIs (`@x12i/memorix-writer`)
+
+```typescript
+import {
+  markJobTypeRunStarted,
+  markJobTypeRunCompleted,
+  markJobTypeRunFailed,
+  ensureJobTypeRunIndexes,
+  writeGraphRunResult,
+} from "@x12i/memorix-writer";
+```
+
+### `markJobTypeRunStarted(ref, jobTypeId, opts)`
+
+Sets `_jobTypeRuns.<key>` to `{ status: "in_progress", ... }`. Idempotent when already `in_progress` with the same `lastJobRunId`.
+
+### `markJobTypeRunCompleted(ref, jobTypeId, opts)`
+
+Sets `status: "done"` with optional `result` pointer. Use when completion does not go through `writeGraphRunResult`.
+
+### `markJobTypeRunFailed(ref, jobTypeId, opts)`
+
+Sets terminal `failed` status with `error` and `completedAt`.
+
+### `writeGraphRunResult(ref, graphId, { ..., jobTypeId? })`
+
+When `jobTypeId` is provided, stamps both `_graphRuns.<graphId>` and `_jobTypeRuns.<key>` in the same Mongo transaction.
+
+### `ensureJobTypeRunIndexes(client, ref, jobTypeId)`
+
+Opt-in compound indexes for reprocessing filters:
+
+- `{ "_jobTypeRuns.<key>.status": 1, <idField>: 1 }`
+- `{ "_jobTypeRuns.<key>.completedAt": -1 }`
+- `{ "_jobTypeRuns.<key>.status": 1, "_jobTypeRuns.<key>.completedAt": -1 }` (reprocessing)
+
+## Read helper (`@x12i/memorix-mongo`)
+
+```typescript
+import { getJobTypeRun } from "@x12i/memorix-mongo";
+
+const entry = await getJobTypeRun(retrieval, "assets", recordId, jobTypeId, "core");
+```
+
+## Indexes and performance
+
+Baseline sparse index (created by `ensureCoreCollection` / `initializeEntityCollections`):
+
+```javascript
+db.<canonicalCollection>.createIndex({ _jobTypeRuns: 1 }, { sparse: true, name: "idx_jobTypeRuns" });
+```
+
+Per-jobType compound indexes remain opt-in via `ensureJobTypeRunIndexes`.
+
+## Error codes
+
+Same semantics as `_graphRuns`: `RECORD_NOT_FOUND`, `SYSTEM_FIELD_NOT_WRITABLE`, etc.
+
+Log correlation shape: `{ jobRunId, jobTypeId, recordRef, operation }`.
+
+## References
+
+- MRX-CR-003 change request
+- [GRAPH-RUNS.md](./GRAPH-RUNS.md) — parallel `_graphRuns` contract (MRX-FRS-001)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/memorix-writer",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Descriptor-driven write layer for Memorix entity/event records and content objects",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,9 +26,10 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@x12i/catalox": "^5.1.1",
-    "@x12i/memorix-descriptors": "^1.10.0",
-    "@x12i/memorix-retrieval": "^1.13.0",
+    "@x12i/catalox": "^5.9.8",
+    "@x12i/memorix-descriptors": "file:../memorix-descriptors",
+    "@x12i/memorix-mongo": "file:../memorix-mongo",
+    "@x12i/memorix-retrieval": "file:../memorix-retrieval",
     "mongodb": "^6.21.0"
   },
   "devDependencies": {
@@ -44,5 +45,10 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/x12i/memorix-mono-repo.git",
+    "directory": "memorix-writer"
   }
 }