@x12i/memorix-pipeline 1.1.0

package/README.md

@@ -0,0 +1,93 @@
+# @x12i/memorix-pipeline
+
+Descriptor-driven entity processing pipeline for Memorix.
+
+## Platform vs custom processing
+
+| Layer | Responsibility |
+|-------|----------------|
+| **Platform** (`memorix-pipeline`) | Read descriptor metadata, build entity flow graph, run resolvers/insights by ID, roll associated data, stamp `_system.lifecycle` |
+| **Resolvers** (`memorix-resolvers`) | Domain-specific join/normalization behind registered types |
+| **Insights** (`memorix-insights`) | Staged fact resolution and judgment generation |
+| **Association** | Generic roll-down driven by `processing.entityRoutes` and postfix policy |
+
+## Lifecycle order
+
+1. Run assigned resolvers on `data` (`resolution`)
+2. Run assigned insight stages (`enrichment`)
+3. Resolve parent links from entity routes (`association`)
+4. Roll parent context into `associatedData`
+5. Re-associate same-record side content by postfix
+6. Stamp route and processing metadata
+
+## Package API
+
+```ts
+import {
+  runPipelineJob,
+  getPipelineRecordStatus,
+  listPipelineRecordsByStatus,
+  compilePipelineStatusFilter,
+  createMongoPipelineDataAccess,
+} from "@x12i/memorix-pipeline";
+
+const result = await runPipelineJob({
+  descriptors,
+  dataAccess: createMongoPipelineDataAccess({ client, descriptors }),
+  stages: ["resolution", "enrichment", "association"],
+  objectTypes: ["assets"],
+  dryRun: true,
+  rerun: false,
+});
+```
+
+### Stages
+
+| Stage | Job type id | Primary lifecycle |
+|-------|-------------|-------------------|
+| `resolution` | `entity-pipeline.resolution` | `entity-resolved` |
+| `enrichment` | `entity-pipeline.enrichment` | `entity-insights-processed` |
+| `association` | `entity-pipeline.association` | `entity-associated` |
+
+Status is persisted on records under:
+
+- `_system.processing.entityPipeline` — lifecycle + route statuses
+- `_system._jobTypeRuns.<jobTypeId>` — run status (`in_progress`, `done`, `failed`)
+
+### Status filters
+
+```ts
+compilePipelineStatusFilter({ stageNotDone: { stage: "resolution" } });
+compilePipelineStatusFilter({ stageJobStatus: { stage: "association", status: "failed" } });
+compilePipelineStatusFilter({ routeStatus: { status: "deferred" } });
+```
+
+## Explorer HTTP API
+
+Routes are exposed by `@x12i/memorix-explorer-api`:
+
+| Method | Route | Purpose |
+|--------|-------|---------|
+| `POST` | `/api/explorer/pipeline/run` | Run selected stages (default dry-run) |
+| `POST` | `/api/explorer/pipeline/rerun` | Re-run selected stages |
+| `GET` | `/api/explorer/pipeline/status?objectType=&recordId=` | Read one record's pipeline status |
+| `GET` | `/api/explorer/pipeline/records?objectType=&stage=&status=` | List records filtered by status |
+
+Apply mode requires `MEMORIX_EXPLORER_ENABLE_PIPELINE_WRITES=true` and request body `{ "apply": true }` or `{ "dryRun": false }`.
+
+Example:
+
+```bash
+curl -X POST http://localhost:5181/api/explorer/pipeline/run \
+  -H 'Content-Type: application/json' \
+  -d '{"stages":["resolution"],"objectTypes":["assets"],"apply":true}'
+```
+
+## CLI
+
+```bash
+node memorix-pipeline/scripts/run-entity-pipeline.mjs --dry-run
+node memorix-pipeline/scripts/run-entity-pipeline.mjs --apply
+```
+
+Entity routes, resolver assignments, and insight stages are declared in object-type descriptor `processing` metadata.

package/dist/association/associated-buckets.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Maps a content postfix to its associated* bucket name.
+ * snapshots/data → associatedData; analysis → associatedAnalysis; discovery → associatedDiscovery.
+ */
+export declare function associatedPropertyForPostfix(postfix: string): string;
+export declare function isExcludedAssociationPostfix(postfix: string, excludePostfixes?: string[]): boolean;
+export declare function eligibleSideContentPostfixes(contentTypes: Record<string, {
+    postfix?: string;
+}>, excludePostfixes?: string[]): string[];
+export declare function buildAssociatedPayload(sourceRecord: Record<string, unknown>, contentPostfix: string): Record<string, unknown>;
+export declare function appendUniqueAssociatedItem(target: Record<string, unknown>, propertyName: string, item: Record<string, unknown>): void;
+//# sourceMappingURL=associated-buckets.d.ts.map

package/dist/association/associated-buckets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"associated-buckets.d.ts","sourceRoot":"","sources":["../../src/association/associated-buckets.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMpE;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,gBAAgB,GAAE,MAAM,EAAoC,GAC3D,OAAO,CAIT;AAED,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,gBAAgB,GAAE,MAAM,EAAoC,GAC3D,MAAM,EAAE,CASV;AAED,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,cAAc,EAAE,MAAM,GACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAezB;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,IAAI,CAgBN"}

package/dist/association/associated-buckets.js

@@ -0,0 +1,66 @@
+const DEFAULT_EXCLUDED_POSTFIXES = new Set(["core", "raw"]);
+function pascalCase(value) {
+    return value
+        .split(/[-_]/)
+        .filter(Boolean)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join("");
+}
+/**
+ * Maps a content postfix to its associated* bucket name.
+ * snapshots/data → associatedData; analysis → associatedAnalysis; discovery → associatedDiscovery.
+ */
+export function associatedPropertyForPostfix(postfix) {
+    const normalized = postfix.trim().toLowerCase();
+    if (normalized === "snapshots" || normalized === "data") {
+        return "associatedData";
+    }
+    return `associated${pascalCase(normalized)}`;
+}
+export function isExcludedAssociationPostfix(postfix, excludePostfixes = [...DEFAULT_EXCLUDED_POSTFIXES]) {
+    const normalized = postfix.trim().toLowerCase();
+    const exclusions = new Set(excludePostfixes.map((p) => p.trim().toLowerCase()));
+    return exclusions.has(normalized);
+}
+export function eligibleSideContentPostfixes(contentTypes, excludePostfixes = [...DEFAULT_EXCLUDED_POSTFIXES]) {
+    const postfixes = new Set();
+    for (const ct of Object.values(contentTypes)) {
+        const postfix = (ct.postfix ?? "").trim().toLowerCase();
+        if (!postfix || isExcludedAssociationPostfix(postfix, excludePostfixes))
+            continue;
+        if (postfix === "snapshots")
+            continue;
+        postfixes.add(postfix);
+    }
+    return [...postfixes].sort();
+}
+export function buildAssociatedPayload(sourceRecord, contentPostfix) {
+    const bucket = contentPostfix === "snapshots" ? "data" : contentPostfix;
+    const payload = bucket === "data"
+        ? sourceRecord.data
+        : sourceRecord[bucket];
+    const item = {
+        ...(payload ?? {}),
+        contentType: contentPostfix,
+    };
+    if (typeof sourceRecord.recordId === "string") {
+        item.recordId = sourceRecord.recordId;
+    }
+    return item;
+}
+export function appendUniqueAssociatedItem(target, propertyName, item) {
+    const existing = target[propertyName];
+    const list = Array.isArray(existing) ? [...existing] : [];
+    const recordId = item.recordId;
+    if (typeof recordId === "string") {
+        const duplicate = list.some((entry) => entry &&
+            typeof entry === "object" &&
+            entry.recordId === recordId &&
+            entry.contentType === item.contentType);
+        if (duplicate)
+            return;
+    }
+    list.push(item);
+    target[propertyName] = list;
+}
+//# sourceMappingURL=associated-buckets.js.map

package/dist/association/associated-buckets.js.map

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

package/dist/association/association-roll-down.d.ts

@@ -0,0 +1,33 @@
+import type { MemorixEntityRouteDescriptor } from "@x12i/memorix-descriptors/types";
+export type ParentLinkResult = {
+    routeKey: string;
+    parentObjectType: string;
+    linked: boolean;
+    status: "linked" | "unlinked" | "skipped" | "deferred" | "prerequisite-missing";
+    reason?: string;
+    parentRecordIds: string[];
+};
+export type AssociationRollDownResult = {
+    record: Record<string, unknown>;
+    parentLinks: ParentLinkResult[];
+    associatedPropertiesTouched: string[];
+};
+export declare function rollParentAssociatedData(childRecord: Record<string, unknown>, parentRecords: Array<Record<string, unknown>>): Record<string, unknown>;
+export declare function attachSideContentFromRecord(record: Record<string, unknown>, contentTypes: Record<string, {
+    postfix?: string;
+}>, excludePostfixes?: string[]): {
+    record: Record<string, unknown>;
+    propertiesTouched: string[];
+};
+export declare function applyAssociationRollDown(input: {
+    childRecord: Record<string, unknown>;
+    routes: MemorixEntityRouteDescriptor[];
+    parentRecordsByType: Map<string, Array<Record<string, unknown>>>;
+    parentSideContentByType?: Map<string, Map<string, Record<string, unknown>>>;
+    contentTypes: Record<string, {
+        postfix?: string;
+    }>;
+    rollParentSnapshots?: boolean;
+    excludePostfixes?: string[];
+}): AssociationRollDownResult;
+//# sourceMappingURL=association-roll-down.d.ts.map

package/dist/association/association-roll-down.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"association-roll-down.d.ts","sourceRoot":"","sources":["../../src/association/association-roll-down.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAE7B,MAAM,iCAAiC,CAAC;AAUzC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,sBAAsB,CAAC;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,2BAA2B,EAAE,MAAM,EAAE,CAAC;CACvC,CAAC;AA+EF,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC5C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBzB;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,gBAAgB,GAAE,MAAM,EAAoB,GAC3C;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAAE,CAoBlE;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,EAAE,4BAA4B,EAAE,CAAC;IACvC,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACjE,uBAAuB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5E,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B,GAAG,yBAAyB,CAmE5B"}

package/dist/association/association-roll-down.js

@@ -0,0 +1,154 @@
+import { getByPath, normalizeJoinValues } from "@x12i/memorix-resolvers";
+import { appendUniqueAssociatedItem, associatedPropertyForPostfix, buildAssociatedPayload, eligibleSideContentPostfixes, } from "./associated-buckets.js";
+import { hasLifecycleProcess } from "../lifecycle/pipeline-lifecycle.js";
+function mapPrerequisiteAction(action) {
+    switch (action) {
+        case "skip":
+            return "skipped";
+        case "defer":
+            return "deferred";
+        case "markUnresolved":
+            return "prerequisite-missing";
+        default:
+            return "prerequisite-missing";
+    }
+}
+function evaluatePrerequisites(prerequisites, parentRecords, parentSideContent) {
+    if (!prerequisites || prerequisites.length === 0) {
+        return { satisfied: true, status: "linked" };
+    }
+    for (const prerequisite of prerequisites) {
+        if (prerequisite.lifecycleProcess) {
+            const hasProcess = parentRecords.some((parent) => hasLifecycleProcess(parent, prerequisite.lifecycleProcess));
+            if (!hasProcess) {
+                return {
+                    satisfied: false,
+                    status: mapPrerequisiteAction(prerequisite.onMissing),
+                    reason: `Parent missing lifecycle process ${prerequisite.lifecycleProcess}`,
+                };
+            }
+        }
+        if (prerequisite.parentContentPostfix) {
+            const postfix = prerequisite.parentContentPostfix;
+            const hasContent = parentRecords.some((parent) => {
+                if (postfix === "snapshots" || postfix === "data")
+                    return Boolean(parent.data);
+                return Boolean(parent[postfix]);
+            });
+            const fromSideMap = parentSideContent?.has(postfix);
+            if (!hasContent && !fromSideMap) {
+                return {
+                    satisfied: false,
+                    status: mapPrerequisiteAction(prerequisite.onMissing),
+                    reason: `Parent missing content postfix ${postfix}`,
+                };
+            }
+        }
+    }
+    return { satisfied: true, status: "linked" };
+}
+function matchParentRecords(childRecord, route, parentRecords) {
+    const childValues = normalizeJoinValues(getByPath(childRecord, route.source.path));
+    if (childValues.length === 0)
+        return [];
+    const matches = [];
+    for (const parent of parentRecords) {
+        const parentValues = normalizeJoinValues(getByPath(parent, route.target.path));
+        const hit = childValues.some((childValue) => parentValues.some((parentValue) => String(childValue) === String(parentValue)));
+        if (hit)
+            matches.push(parent);
+    }
+    return matches;
+}
+export function rollParentAssociatedData(childRecord, parentRecords) {
+    const next = { ...childRecord };
+    for (const parent of parentRecords) {
+        const parentAssociated = parent.associatedData;
+        if (!Array.isArray(parentAssociated))
+            continue;
+        for (const item of parentAssociated) {
+            if (!item || typeof item !== "object")
+                continue;
+            appendUniqueAssociatedItem(next, "associatedData", {
+                ...item,
+                inheritedFrom: parent.recordId,
+                contentType: "snapshots",
+            });
+        }
+        const parentData = buildAssociatedPayload(parent, "snapshots");
+        appendUniqueAssociatedItem(next, "associatedData", parentData);
+    }
+    return next;
+}
+export function attachSideContentFromRecord(record, contentTypes, excludePostfixes = ["core", "raw"]) {
+    const next = { ...record };
+    const propertiesTouched = [];
+    const postfixes = eligibleSideContentPostfixes(contentTypes, excludePostfixes);
+    for (const postfix of postfixes) {
+        const propertyName = associatedPropertyForPostfix(postfix);
+        const payload = buildAssociatedPayload(record, postfix);
+        const bucket = postfix === "snapshots" ? "data" : postfix;
+        const hasContent = bucket === "data"
+            ? Boolean(record.data && typeof record.data === "object")
+            : Boolean(record[bucket]);
+        if (!hasContent)
+            continue;
+        appendUniqueAssociatedItem(next, propertyName, payload);
+        propertiesTouched.push(propertyName);
+    }
+    return { record: next, propertiesTouched };
+}
+export function applyAssociationRollDown(input) {
+    let record = { ...input.childRecord };
+    const parentLinks = [];
+    const associatedPropertiesTouched = [];
+    for (const route of input.routes) {
+        const parents = input.parentRecordsByType.get(route.parentObjectType) ?? [];
+        const matchedParents = matchParentRecords(record, route, parents);
+        const prerequisite = evaluatePrerequisites(route.prerequisites, matchedParents.length > 0 ? matchedParents : parents, input.parentSideContentByType?.get(route.parentObjectType));
+        if (!prerequisite.satisfied) {
+            parentLinks.push({
+                routeKey: route.routeKey,
+                parentObjectType: route.parentObjectType,
+                linked: false,
+                status: prerequisite.status,
+                reason: prerequisite.reason,
+                parentRecordIds: [],
+            });
+            continue;
+        }
+        if (matchedParents.length === 0) {
+            parentLinks.push({
+                routeKey: route.routeKey,
+                parentObjectType: route.parentObjectType,
+                linked: false,
+                status: "unlinked",
+                reason: "No parent record matched join paths",
+                parentRecordIds: [],
+            });
+            continue;
+        }
+        if (input.rollParentSnapshots !== false) {
+            record = rollParentAssociatedData(record, matchedParents);
+            associatedPropertiesTouched.push("associatedData");
+        }
+        parentLinks.push({
+            routeKey: route.routeKey,
+            parentObjectType: route.parentObjectType,
+            linked: true,
+            status: "linked",
+            parentRecordIds: matchedParents
+                .map((parent) => parent.recordId)
+                .filter((id) => typeof id === "string"),
+        });
+    }
+    const sideContent = attachSideContentFromRecord(record, input.contentTypes, input.excludePostfixes);
+    record = sideContent.record;
+    associatedPropertiesTouched.push(...sideContent.propertiesTouched);
+    return {
+        record,
+        parentLinks,
+        associatedPropertiesTouched: [...new Set(associatedPropertiesTouched)],
+    };
+}
+//# sourceMappingURL=association-roll-down.js.map

package/dist/association/association-roll-down.js.map

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

package/dist/graph/entity-flow-graph.d.ts

@@ -0,0 +1,17 @@
+import type { MemorixEntityDescriptor, MemorixEntityRouteDescriptor } from "@x12i/memorix-descriptors/types";
+export type EntityFlowNode = {
+    objectType: string;
+    descriptor: MemorixEntityDescriptor;
+    depth: number;
+    parents: string[];
+    children: string[];
+};
+export type EntityFlowGraph = {
+    nodes: Map<string, EntityFlowNode>;
+    routes: MemorixEntityRouteDescriptor[];
+    processingOrder: string[];
+};
+export declare function buildEntityFlowGraph(descriptors: MemorixEntityDescriptor[]): EntityFlowGraph;
+export declare function routesForChild(graph: EntityFlowGraph, childObjectType: string): MemorixEntityRouteDescriptor[];
+export declare function routesForParentChild(graph: EntityFlowGraph, parentObjectType: string, childObjectType: string): MemorixEntityRouteDescriptor[];
+//# sourceMappingURL=entity-flow-graph.d.ts.map

package/dist/graph/entity-flow-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-flow-graph.d.ts","sourceRoot":"","sources":["../../src/graph/entity-flow-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,4BAA4B,EAC7B,MAAM,iCAAiC,CAAC;AAEzC,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,uBAAuB,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACnC,MAAM,EAAE,4BAA4B,EAAE,CAAC;IACvC,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,CAAC;AAiEF,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,uBAAuB,EAAE,GACrC,eAAe,CAoBjB;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,eAAe,EACtB,eAAe,EAAE,MAAM,GACtB,4BAA4B,EAAE,CAIhC;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,eAAe,EACtB,gBAAgB,EAAE,MAAM,EACxB,eAAe,EAAE,MAAM,GACtB,4BAA4B,EAAE,CAMhC"}

package/dist/graph/entity-flow-graph.js

@@ -0,0 +1,79 @@
+function collectRoutes(descriptors) {
+    const routes = [];
+    for (const descriptor of descriptors) {
+        const entityRoutes = descriptor.processing?.entityRoutes ?? [];
+        for (const route of entityRoutes) {
+            routes.push({
+                ...route,
+                childObjectType: route.childObjectType ?? descriptor.entityName,
+            });
+        }
+    }
+    return routes;
+}
+function buildAdjacency(routes) {
+    const parents = new Map();
+    const children = new Map();
+    for (const route of routes) {
+        const child = route.childObjectType ?? "";
+        const parent = route.parentObjectType;
+        if (!child || !parent)
+            continue;
+        if (!parents.has(child))
+            parents.set(child, new Set());
+        parents.get(child).add(parent);
+        if (!children.has(parent))
+            children.set(parent, new Set());
+        children.get(parent).add(child);
+    }
+    return { parents, children };
+}
+function topologicalOrder(objectTypes, parents) {
+    const inDegree = new Map();
+    for (const type of objectTypes) {
+        inDegree.set(type, parents.get(type)?.size ?? 0);
+    }
+    const queue = objectTypes.filter((type) => (inDegree.get(type) ?? 0) === 0);
+    const order = [];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        order.push(current);
+        for (const [child, parentSet] of parents.entries()) {
+            if (!parentSet.has(current))
+                continue;
+            const next = (inDegree.get(child) ?? 0) - 1;
+            inDegree.set(child, next);
+            if (next === 0)
+                queue.push(child);
+        }
+    }
+    const remaining = objectTypes.filter((type) => !order.includes(type));
+    return [...order, ...remaining];
+}
+export function buildEntityFlowGraph(descriptors) {
+    const descriptorByType = new Map(descriptors.map((d) => [d.entityName, d]));
+    const routes = collectRoutes(descriptors);
+    const { parents, children } = buildAdjacency(routes);
+    const objectTypes = [...descriptorByType.keys()];
+    const processingOrder = topologicalOrder(objectTypes, parents);
+    const nodes = new Map();
+    for (const objectType of objectTypes) {
+        const descriptor = descriptorByType.get(objectType);
+        nodes.set(objectType, {
+            objectType,
+            descriptor,
+            depth: processingOrder.indexOf(objectType),
+            parents: [...(parents.get(objectType) ?? [])],
+            children: [...(children.get(objectType) ?? [])],
+        });
+    }
+    return { nodes, routes, processingOrder };
+}
+export function routesForChild(graph, childObjectType) {
+    return graph.routes.filter((route) => (route.childObjectType ?? childObjectType) === childObjectType);
+}
+export function routesForParentChild(graph, parentObjectType, childObjectType) {
+    return graph.routes.filter((route) => route.parentObjectType === parentObjectType &&
+        (route.childObjectType ?? childObjectType) === childObjectType);
+}
+//# sourceMappingURL=entity-flow-graph.js.map

package/dist/graph/entity-flow-graph.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { associatedPropertyForPostfix, isExcludedAssociationPostfix, eligibleSideContentPostfixes, buildAssociatedPayload, appendUniqueAssociatedItem, } from "./association/associated-buckets.js";
+export { applyAssociationRollDown, rollParentAssociatedData, attachSideContentFromRecord, type ParentLinkResult, type AssociationRollDownResult, } from "./association/association-roll-down.js";
+export { buildEntityFlowGraph, routesForChild, routesForParentChild, type EntityFlowGraph, type EntityFlowNode, } from "./graph/entity-flow-graph.js";
+export { stampPipelineLifecycle, stampRouteStatus, readPipelineProcessingState, hasLifecycleProcess, type PipelineLifecycleProcess, type PipelineRouteStatus, type PipelineProcessingState, } from "./lifecycle/pipeline-lifecycle.js";
+export { createMongoPipelineDataAccess, pipelineRecordRefToMemorixRef, type CreateMongoPipelineDataAccessOptions, } from "./mongo/data-access.js";
+export { PIPELINE_STAGES, PIPELINE_JOB_TYPE_IDS, STAGE_PRIMARY_LIFECYCLE, STAGE_LIFECYCLE_PROCESSES, jobTypeIdForStage, primaryLifecycleForStage, defaultStages, type PipelineStage, } from "./pipeline-job-types.js";
+export { runResolutionStage, runEnrichmentStage, runAssociationStage, runNarrativeSyncStage, type StageRunResult, } from "./pipeline-stages.js";
+export { evaluateHavingNarratives, applyNarrativeSync, NARRATIVE_SYNC_DETECTED_BY, type NarrativeSyncResult, type NarrativeSyncDataAccess, } from "./narratives/narrative-sync.js";
+export { compilePipelineStatusFilter, compilePipelineStatusFilters, getPipelineRecordStatus, listPipelineRecordsByStatus, type PipelineRecordListItem, type PipelineRecordStatus, type PipelineStatusFilterInput, } from "./pipeline-status.js";
+export { runPipelineJob, type RunPipelineJobOptions, type RunPipelineJobResult, } from "./pipeline-jobs.js";
+export { processEntityPipeline, recordIsPipelineReady, type PipelineDataAccess, type PipelineJobTypeRunHooks, type PipelineRecordRef, type PipelineRecordContext, type PipelineRunSummary, type ProcessEntityPipelineOptions, type ProcessEntityPipelineResult, type ProcessedEntityRecord, } from "./pipeline-engine.js";
+export { loadPipelinePartsCatalog, catalogPartIdsForObjectType, stageReferenceMeta, defaultRepoRoot, type PipelinePart, type PipelinePartKind, type PipelinePartsCatalog, type EnrichmentPlaybook, type LoadPipelinePartsCatalogOptions, } from "./parts-catalog/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,4BAA4B,EAC5B,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,GAC/B,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,2BAA2B,EAC3B,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,GAC7B,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC7B,KAAK,oCAAoC,GAC1C,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,EACjB,wBAAwB,EACxB,aAAa,EACb,KAAK,aAAa,GACnB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,cAAc,GACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,0BAA0B,EAC1B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,GAC7B,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,uBAAuB,EACvB,2BAA2B,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,GAC/B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,kBAAkB,EAClB,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,+BAA+B,GACrC,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export { associatedPropertyForPostfix, isExcludedAssociationPostfix, eligibleSideContentPostfixes, buildAssociatedPayload, appendUniqueAssociatedItem, } from "./association/associated-buckets.js";
+export { applyAssociationRollDown, rollParentAssociatedData, attachSideContentFromRecord, } from "./association/association-roll-down.js";
+export { buildEntityFlowGraph, routesForChild, routesForParentChild, } from "./graph/entity-flow-graph.js";
+export { stampPipelineLifecycle, stampRouteStatus, readPipelineProcessingState, hasLifecycleProcess, } from "./lifecycle/pipeline-lifecycle.js";
+export { createMongoPipelineDataAccess, pipelineRecordRefToMemorixRef, } from "./mongo/data-access.js";
+export { PIPELINE_STAGES, PIPELINE_JOB_TYPE_IDS, STAGE_PRIMARY_LIFECYCLE, STAGE_LIFECYCLE_PROCESSES, jobTypeIdForStage, primaryLifecycleForStage, defaultStages, } from "./pipeline-job-types.js";
+export { runResolutionStage, runEnrichmentStage, runAssociationStage, runNarrativeSyncStage, } from "./pipeline-stages.js";
+export { evaluateHavingNarratives, applyNarrativeSync, NARRATIVE_SYNC_DETECTED_BY, } from "./narratives/narrative-sync.js";
+export { compilePipelineStatusFilter, compilePipelineStatusFilters, getPipelineRecordStatus, listPipelineRecordsByStatus, } from "./pipeline-status.js";
+export { runPipelineJob, } from "./pipeline-jobs.js";
+export { processEntityPipeline, recordIsPipelineReady, } from "./pipeline-engine.js";
+export { loadPipelinePartsCatalog, catalogPartIdsForObjectType, stageReferenceMeta, defaultRepoRoot, } from "./parts-catalog/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,4BAA4B,EAC5B,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,GAG5B,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,oBAAoB,GAGrB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,2BAA2B,EAC3B,mBAAmB,GAIpB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,GAE9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,EACjB,wBAAwB,EACxB,aAAa,GAEd,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,GAEtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,0BAA0B,GAG3B,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,uBAAuB,EACvB,2BAA2B,GAI5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,cAAc,GAGf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GAStB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,kBAAkB,EAClB,eAAe,GAMhB,MAAM,0BAA0B,CAAC"}

package/dist/lifecycle/pipeline-lifecycle.d.ts

@@ -0,0 +1,22 @@
+export type PipelineLifecycleProcess = "entity-resolved" | "entity-insights-processed" | "entity-parent-linked" | "entity-associated" | "entity-side-content-associated" | "entity-route-unlinked" | "entity-route-skipped" | "entity-route-deferred" | "entity-prerequisite-missing" | "entity-narratives-synced";
+export type PipelineRouteStatus = {
+    routeKey: string;
+    parentObjectType: string;
+    status: "linked" | "unlinked" | "skipped" | "deferred" | "prerequisite-missing";
+    reason?: string;
+    at: string;
+};
+export type PipelineProcessingState = {
+    lifecycle: Array<{
+        process: string;
+        processedAt: string;
+    }>;
+    routeStatuses: PipelineRouteStatus[];
+    lastRunAt?: string;
+    graphId?: string;
+};
+export declare function stampPipelineLifecycle(record: Record<string, unknown>, process: PipelineLifecycleProcess, processedAt?: string): Record<string, unknown>;
+export declare function stampRouteStatus(record: Record<string, unknown>, status: Omit<PipelineRouteStatus, "at">, at?: string): Record<string, unknown>;
+export declare function readPipelineProcessingState(record: Record<string, unknown>): PipelineProcessingState;
+export declare function hasLifecycleProcess(record: Record<string, unknown>, process: string): boolean;
+//# sourceMappingURL=pipeline-lifecycle.d.ts.map

package/dist/lifecycle/pipeline-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-lifecycle.d.ts","sourceRoot":"","sources":["../../src/lifecycle/pipeline-lifecycle.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,wBAAwB,GAChC,iBAAiB,GACjB,2BAA2B,GAC3B,sBAAsB,GACtB,mBAAmB,GACnB,gCAAgC,GAChC,uBAAuB,GACvB,sBAAsB,GACtB,uBAAuB,GACvB,6BAA6B,GAC7B,0BAA0B,CAAC;AAE/B,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,sBAAsB,CAAC;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AA4BF,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,wBAAwB,EACjC,WAAW,GAAE,MAAiC,GAC7C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4BzB;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,EACvC,EAAE,GAAE,MAAiC,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBzB;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,uBAAuB,CAEzB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,GACd,OAAO,CAUT"}