@x12i/memorix-service 3.7.0 → 3.7.6

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

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

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

@@ -0,0 +1,29 @@
+import type { MemorixPlatform } from "../platform.js";
+import type { MemorixScope } from "../scope.js";
+export type AnalysisEnqueueResult = {
+    status: "queued";
+    policy: string;
+    operationId: string;
+    required: boolean;
+} | {
+    status: "skipped";
+    reason: string;
+    policy?: string;
+};
+/**
+ * The analyze pipeline and its `content`/`snapshots` persist target live on
+ * the host agent that installed them. Writer agents (for example
+ * `network-synapix`) do not carry that pipeline. Union the host agent when
+ * the writer scope cannot see it.
+ */
+export declare function resolveAnalyzeAgentIds(scopeAgentIds: string[], hasPipeline: (agentIds: string[]) => boolean): string[];
+export declare function maybeEnqueueNexumAnalysis(input: {
+    platform: Pick<MemorixPlatform, "metadata" | "operationalDbFor" | "portsFor">;
+    scope: MemorixScope;
+    objectType: string;
+    contentType: string;
+    recordId: string;
+    revision: number;
+    data?: Record<string, unknown>;
+}): Promise<AnalysisEnqueueResult>;
+//# sourceMappingURL=enqueue.d.ts.map

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

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

package/dist/nexum-analysis/enqueue.js

@@ -0,0 +1,190 @@
+/**
+ * After a successful content write, optionally enqueue Nexum analyze.
+ */
+import { randomUUID } from "node:crypto";
+import { isNexumAutoAnalyzeEnabled, matchNexumIndexingPolicy, recordToNexumItems, resolveNexumIndexingPolicies, } from "./policy.js";
+import { enqueueAnalysisOutbox, markAnalysisOutbox } from "./outbox.js";
+import { invokePipeline } from "../pipeline-invoke.js";
+import { memorixActivityRing } from "../activity-ring.js";
+const HOST_ANALYZE_PIPELINE = "opx-nexum-analyze";
+const HOST_ANALYZE_AGENT = "opx";
+/**
+ * The analyze pipeline and its `content`/`snapshots` persist target live on
+ * the host agent that installed them. Writer agents (for example
+ * `network-synapix`) do not carry that pipeline. Union the host agent when
+ * the writer scope cannot see it.
+ */
+export function resolveAnalyzeAgentIds(scopeAgentIds, hasPipeline) {
+    if (hasPipeline(scopeAgentIds))
+        return scopeAgentIds;
+    if (!scopeAgentIds.includes(HOST_ANALYZE_AGENT) &&
+        hasPipeline([HOST_ANALYZE_AGENT])) {
+        return [...scopeAgentIds, HOST_ANALYZE_AGENT];
+    }
+    return scopeAgentIds;
+}
+function emitIndexStatus(input) {
+    memorixActivityRing.recordIndex({
+        orgId: input.orgId,
+        operationId: input.operationId,
+        status: input.status,
+        policyId: input.policyId,
+        runId: input.runId,
+        pipelineId: input.pipelineId,
+        error: input.error,
+        source: input.source,
+    });
+}
+export async function maybeEnqueueNexumAnalysis(input) {
+    if (!isNexumAutoAnalyzeEnabled()) {
+        return { status: "skipped", reason: "indexing disabled" };
+    }
+    if (!process.env.MEMORIX_NEXUM_URL?.trim() && !process.env.NEXUM_URL?.trim()) {
+        return { status: "skipped", reason: "indexing worker unset" };
+    }
+    const effective = input.platform.metadata.resolveEffective(input.scope.agentIds);
+    const extensionBag = {};
+    for (const e of effective.effective ?? []) {
+        if (!e.kind?.includes("."))
+            continue;
+        if (!extensionBag[e.kind])
+            extensionBag[e.kind] = [];
+        extensionBag[e.kind].push({
+            id: e.id,
+            ...e.definition,
+        });
+    }
+    // Prefer custom-kind id used by pack declarations.
+    if (!extensionBag["nexum.indexing-policy"]) {
+        const aliased = (effective.effective ?? []).filter((e) => e.kind === "nexum.indexing-policy");
+        if (aliased.length) {
+            extensionBag["nexum.indexing-policy"] = aliased.map((e) => ({
+                id: e.id,
+                ...e.definition,
+            }));
+        }
+    }
+    const policies = resolveNexumIndexingPolicies({
+        extensions: extensionBag,
+    });
+    const candidate = {
+        orgId: input.scope.orgId,
+        agentIds: input.scope.agentIds,
+        objectType: input.objectType,
+        contentType: input.contentType,
+        recordId: input.recordId,
+        revision: input.revision,
+        data: input.data,
+    };
+    const policy = matchNexumIndexingPolicy(candidate, policies);
+    if (!policy) {
+        return { status: "skipped", reason: "no matching indexing policy" };
+    }
+    const items = recordToNexumItems(candidate);
+    if (!items.length) {
+        return {
+            status: "skipped",
+            reason: "no analyzeable payload",
+            policy: policy.id,
+        };
+    }
+    let db;
+    try {
+        db = input.platform.operationalDbFor(input.scope.orgId);
+    }
+    catch {
+        return {
+            status: "skipped",
+            reason: "operational db unavailable",
+            policy: policy.id,
+        };
+    }
+    const operationId = `anl_${randomUUID().replace(/-/g, "").slice(0, 16)}`;
+    await enqueueAnalysisOutbox(db, {
+        candidate,
+        policyId: policy.id,
+        operationId,
+    });
+    const source = {
+        objectType: candidate.objectType,
+        contentType: candidate.contentType,
+        recordId: candidate.recordId,
+        revision: candidate.revision,
+    };
+    emitIndexStatus({
+        orgId: candidate.orgId,
+        operationId,
+        status: "queued",
+        policyId: policy.id,
+        source,
+    });
+    // Fire-and-forget pipeline start (do not block write response).
+    void (async () => {
+        try {
+            await markAnalysisOutbox(db, candidate, {
+                status: "analyzing",
+                pipelineId: HOST_ANALYZE_PIPELINE,
+            });
+            emitIndexStatus({
+                orgId: candidate.orgId,
+                operationId,
+                status: "analyzing",
+                policyId: policy.id,
+                pipelineId: HOST_ANALYZE_PIPELINE,
+                source,
+            });
+            const analyzeAgentIds = resolveAnalyzeAgentIds(input.scope.agentIds, (agentIds) => Boolean(input.platform.metadata.getDefinition(agentIds, "pipelines", HOST_ANALYZE_PIPELINE)?.definition));
+            const result = await invokePipeline({
+                platform: input.platform,
+                orgId: input.scope.orgId,
+                agentIds: analyzeAgentIds,
+                pipelineId: HOST_ANALYZE_PIPELINE,
+                input: { items },
+                wait: true,
+            });
+            const status = result.status === "succeeded" ? "succeeded" : "failed";
+            await markAnalysisOutbox(db, candidate, {
+                status,
+                runId: result.run.runId,
+                pipelineId: result.pipelineId,
+                error: result.status === "succeeded"
+                    ? undefined
+                    : String(result.run.error ?? result.status),
+            });
+            emitIndexStatus({
+                orgId: candidate.orgId,
+                operationId,
+                status,
+                policyId: policy.id,
+                runId: result.run.runId,
+                pipelineId: result.pipelineId,
+                error: result.status === "succeeded"
+                    ? undefined
+                    : String(result.run.error ?? result.status),
+                source,
+            });
+        }
+        catch (err) {
+            const error = err instanceof Error ? err.message : String(err);
+            await markAnalysisOutbox(db, candidate, {
+                status: "failed",
+                error,
+            }).catch(() => undefined);
+            emitIndexStatus({
+                orgId: candidate.orgId,
+                operationId,
+                status: "failed",
+                policyId: policy.id,
+                error,
+                source,
+            });
+        }
+    })();
+    return {
+        status: "queued",
+        policy: policy.id,
+        operationId,
+        required: policy.processing?.mode === "async-required",
+    };
+}
+//# sourceMappingURL=enqueue.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enqueue.js","sourceRoot":"","sources":["../../src/nexum-analysis/enqueue.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,kBAAkB,EAClB,4BAA4B,GAE7B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAe1D,MAAM,qBAAqB,GAAG,mBAAmB,CAAC;AAClD,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,aAAuB,EACvB,WAA4C;IAE5C,IAAI,WAAW,CAAC,aAAa,CAAC;QAAE,OAAO,aAAa,CAAC;IACrD,IACE,CAAC,aAAa,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAC3C,WAAW,CAAC,CAAC,kBAAkB,CAAC,CAAC,EACjC,CAAC;QACD,OAAO,CAAC,GAAG,aAAa,EAAE,kBAAkB,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,SAAS,eAAe,CAAC,KAcxB;IACC,mBAAmB,CAAC,WAAW,CAAC;QAC9B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,KAQ/C;IACC,IAAI,CAAC,yBAAyB,EAAE,EAAE,CAAC;QACjC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC5D,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;QAC7E,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;IAChE,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CACxD,KAAK,CAAC,KAAK,CAAC,QAAQ,CACrB,CAAC;IACF,MAAM,YAAY,GAA8B,EAAE,CAAC;IACnD,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;QAC1C,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QACrC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACrD,YAAY,CAAC,CAAC,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC;YACzB,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,GAAI,CAAC,CAAC,UAAsC;SAC7C,CAAC,CAAC;IACL,CAAC;IACD,mDAAmD;IACnD,IAAI,CAAC,YAAY,CAAC,uBAAuB,CAAC,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,CAAC,SAAS,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAChD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,uBAAuB,CAC1C,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,YAAY,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC1D,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,GAAI,CAAC,CAAC,UAAsC;aAC7C,CAAC,CAAC,CAAC;QACN,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,4BAA4B,CAAC;QAC5C,UAAU,EAAE,YAAY;KACzB,CAAC,CAAC;IACH,MAAM,SAAS,GAAsB;QACnC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK;QACxB,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ;QAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC;IACF,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC7D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,6BAA6B,EAAE,CAAC;IACtE,CAAC;IAED,MAAM,KAAK,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,wBAAwB;YAChC,MAAM,EAAE,MAAM,CAAC,EAAE;SAClB,CAAC;IACJ,CAAC;IAED,IAAI,EAAE,CAAC;IACP,IAAI,CAAC;QACH,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,4BAA4B;YACpC,MAAM,EAAE,MAAM,CAAC,EAAE;SAClB,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACzE,MAAM,qBAAqB,CAAC,EAAE,EAAE;QAC9B,SAAS;QACT,QAAQ,EAAE,MAAM,CAAC,EAAE;QACnB,WAAW;KACZ,CAAC,CAAC;IACH,MAAM,MAAM,GAAG;QACb,UAAU,EAAE,SAAS,CAAC,UAAU;QAChC,WAAW,EAAE,SAAS,CAAC,WAAW;QAClC,QAAQ,EAAE,SAAS,CAAC,QAAQ;QAC5B,QAAQ,EAAE,SAAS,CAAC,QAAQ;KAC7B,CAAC;IACF,eAAe,CAAC;QACd,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,WAAW;QACX,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,MAAM,CAAC,EAAE;QACnB,MAAM;KACP,CAAC,CAAC;IAEH,gEAAgE;IAChE,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,IAAI,CAAC;YACH,MAAM,kBAAkB,CAAC,EAAE,EAAE,SAAS,EAAE;gBACtC,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,qBAAqB;aAClC,CAAC,CAAC;YACH,eAAe,CAAC;gBACd,KAAK,EAAE,SAAS,CAAC,KAAK;gBACtB,WAAW;gBACX,MAAM,EAAE,WAAW;gBACnB,QAAQ,EAAE,MAAM,CAAC,EAAE;gBACnB,UAAU,EAAE,qBAAqB;gBACjC,MAAM;aACP,CAAC,CAAC;YACH,MAAM,eAAe,GAAG,sBAAsB,CAC5C,KAAK,CAAC,KAAK,CAAC,QAAQ,EACpB,CAAC,QAAQ,EAAE,EAAE,CACX,OAAO,CACL,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CACnC,QAAQ,EACR,WAAW,EACX,qBAAqB,CACtB,EAAE,UAAU,CACd,CACJ,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC;gBAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK;gBACxB,QAAQ,EAAE,eAAe;gBACzB,UAAU,EAAE,qBAAqB;gBACjC,KAAK,EAAE,EAAE,KAAK,EAAE;gBAChB,IAAI,EAAE,IAAI;aACX,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;YACtE,MAAM,kBAAkB,CAAC,EAAE,EAAE,SAAS,EAAE;gBACtC,MAAM;gBACN,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK;gBACvB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,KAAK,EACH,MAAM,CAAC,MAAM,KAAK,WAAW;oBAC3B,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC;aAChD,CAAC,CAAC;YACH,eAAe,CAAC;gBACd,KAAK,EAAE,SAAS,CAAC,KAAK;gBACtB,WAAW;gBACX,MAAM;gBACN,QAAQ,EAAE,MAAM,CAAC,EAAE;gBACnB,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK;gBACvB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,KAAK,EACH,MAAM,CAAC,MAAM,KAAK,WAAW;oBAC3B,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC;gBAC/C,MAAM;aACP,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC/D,MAAM,kBAAkB,CAAC,EAAE,EAAE,SAAS,EAAE;gBACtC,MAAM,EAAE,QAAQ;gBAChB,KAAK;aACN,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC1B,eAAe,CAAC;gBACd,KAAK,EAAE,SAAS,CAAC,KAAK;gBACtB,WAAW;gBACX,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE,MAAM,CAAC,EAAE;gBACnB,KAAK;gBACL,MAAM;aACP,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,OAAO;QACL,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,MAAM,CAAC,EAAE;QACjB,WAAW;QACX,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,KAAK,gBAAgB;KACvD,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,44 @@
+/**
+ * Durable Nexum analysis outbox in `{orgId}_operational.nexum-analysis-outbox`.
+ * Unique on address+revision; newer revisions supersede older queued/analyzing rows.
+ */
+import type { Db } from "mongodb";
+import type { AnalysisCandidate } from "./policy.js";
+export type AnalysisOutboxStatus = "queued" | "analyzing" | "succeeded" | "failed" | "skipped" | "superseded" | "dead-letter";
+export type AnalysisOutboxRow = {
+    operationId: string;
+    orgId: string;
+    agentIds: string[];
+    objectType: string;
+    contentType: string;
+    recordId: string;
+    revision: number;
+    policyId: string;
+    status: AnalysisOutboxStatus;
+    pipelineId?: string;
+    runId?: string;
+    error?: string;
+    attempts?: number;
+    enqueuedAt: string;
+    updatedAt: string;
+};
+export declare function enqueueAnalysisOutbox(db: Db, input: {
+    candidate: AnalysisCandidate;
+    policyId: string;
+    operationId: string;
+}): Promise<AnalysisOutboxRow>;
+export declare function markAnalysisOutbox(db: Db, candidate: AnalysisCandidate, patch: Partial<Pick<AnalysisOutboxRow, "status" | "pipelineId" | "runId" | "error" | "attempts">>): Promise<void>;
+export declare function listQueuedAnalysis(db: Db, limit?: number): Promise<AnalysisOutboxRow[]>;
+/**
+ * Reconcile scanner: requeue stale failed rows (bounded attempts) or DLQ;
+ * DLQ stuck analyzing rows past STALE_MS.
+ */
+export declare function reconcileAnalysisOutbox(db: Db, opts?: {
+    now?: Date;
+    staleMs?: number;
+    maxAttempts?: number;
+}): Promise<{
+    requeued: number;
+    deadLetter: number;
+}>;
+//# sourceMappingURL=outbox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"outbox.d.ts","sourceRoot":"","sources":["../../src/nexum-analysis/outbox.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,WAAW,GACX,WAAW,GACX,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,aAAa,CAAC;AAElB,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AA8CF,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,EAAE,EACN,KAAK,EAAE;IACL,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,GACA,OAAO,CAAC,iBAAiB,CAAC,CAyD5B;AAED,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,EAAE,EACN,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,OAAO,CACZ,IAAI,CACF,iBAAiB,EACjB,QAAQ,GAAG,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CACzD,CACF,GACA,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,EAAE,EACN,KAAK,SAAK,GACT,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAc9B;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,EAAE,EACN,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CA2EnD"}

package/dist/nexum-analysis/outbox.js

@@ -0,0 +1,176 @@
+import { memorixActivityRing } from "../activity-ring.js";
+const COLL = "nexum-analysis-outbox";
+const MAX_ATTEMPTS = 5;
+/** Stuck analyzing / failed rows older than this move to dead-letter (or requeue once). */
+const STALE_MS = 15 * 60 * 1000;
+function rowId(c) {
+    return `${c.orgId}\0${c.objectType}\0${c.contentType}\0${c.recordId}\0${c.revision}`;
+}
+function addressFilter(c) {
+    return {
+        orgId: c.orgId,
+        objectType: c.objectType,
+        contentType: c.contentType,
+        recordId: c.recordId,
+    };
+}
+function emitOutboxActivity(row) {
+    memorixActivityRing.recordIndex({
+        orgId: row.orgId,
+        operationId: row.operationId,
+        status: row.status,
+        policyId: row.policyId,
+        error: row.error,
+        source: {
+            objectType: row.objectType,
+            contentType: row.contentType,
+            recordId: row.recordId,
+            revision: row.revision,
+        },
+    });
+}
+export async function enqueueAnalysisOutbox(db, input) {
+    const now = new Date().toISOString();
+    const row = {
+        operationId: input.operationId,
+        orgId: input.candidate.orgId,
+        agentIds: [...input.candidate.agentIds],
+        objectType: input.candidate.objectType,
+        contentType: input.candidate.contentType,
+        recordId: input.candidate.recordId,
+        revision: input.candidate.revision,
+        policyId: input.policyId,
+        status: "queued",
+        attempts: 0,
+        enqueuedAt: now,
+        updatedAt: now,
+    };
+    const coll = db.collection(COLL);
+    // Supersede older revisions still in flight for the same address.
+    const superseded = await coll.find({
+        ...addressFilter(input.candidate),
+        revision: { $lt: input.candidate.revision },
+        status: { $in: ["queued", "analyzing", "failed"] },
+    }).toArray();
+    await coll.updateMany({
+        ...addressFilter(input.candidate),
+        revision: { $lt: input.candidate.revision },
+        status: { $in: ["queued", "analyzing", "failed"] },
+    }, {
+        $set: {
+            status: "superseded",
+            updatedAt: now,
+            error: `superseded by revision ${input.candidate.revision}`,
+        },
+    });
+    for (const raw of superseded) {
+        const prev = raw;
+        emitOutboxActivity({
+            orgId: prev.orgId,
+            operationId: prev.operationId,
+            status: "superseded",
+            policyId: prev.policyId,
+            error: `superseded by revision ${input.candidate.revision}`,
+            objectType: prev.objectType,
+            contentType: prev.contentType,
+            recordId: prev.recordId,
+            revision: prev.revision,
+        });
+    }
+    await coll.updateOne({ _id: rowId(input.candidate) }, { $set: row }, { upsert: true });
+    return row;
+}
+export async function markAnalysisOutbox(db, candidate, patch) {
+    await db.collection(COLL).updateOne({ _id: rowId(candidate) }, {
+        $set: {
+            ...patch,
+            updatedAt: new Date().toISOString(),
+        },
+    });
+}
+export async function listQueuedAnalysis(db, limit = 50) {
+    const rows = await db
+        .collection(COLL)
+        .find({ status: "queued" })
+        .sort({ enqueuedAt: 1 })
+        .limit(limit)
+        .toArray();
+    return rows.map((r) => {
+        const { _id: _unused, ...rest } = r;
+        void _unused;
+        return rest;
+    });
+}
+/**
+ * Reconcile scanner: requeue stale failed rows (bounded attempts) or DLQ;
+ * DLQ stuck analyzing rows past STALE_MS.
+ */
+export async function reconcileAnalysisOutbox(db, opts) {
+    const now = opts?.now ?? new Date();
+    const staleMs = opts?.staleMs ?? STALE_MS;
+    const maxAttempts = opts?.maxAttempts ?? MAX_ATTEMPTS;
+    const cutoff = new Date(now.getTime() - staleMs).toISOString();
+    const coll = db.collection(COLL);
+    let requeued = 0;
+    let deadLetter = 0;
+    const stale = await coll
+        .find({
+        status: { $in: ["analyzing", "failed"] },
+        updatedAt: { $lt: cutoff },
+    })
+        .limit(100)
+        .toArray();
+    for (const raw of stale) {
+        const row = raw;
+        const attempts = Number(row.attempts ?? 0);
+        const iso = now.toISOString();
+        if (row.status === "failed" && attempts < maxAttempts) {
+            await coll.updateOne({ _id: raw._id }, {
+                $set: {
+                    status: "queued",
+                    updatedAt: iso,
+                    error: undefined,
+                },
+                $inc: { attempts: 1 },
+            });
+            requeued += 1;
+            emitOutboxActivity({
+                orgId: row.orgId,
+                operationId: row.operationId,
+                status: "queued",
+                policyId: row.policyId,
+                objectType: row.objectType,
+                contentType: row.contentType,
+                recordId: row.recordId,
+                revision: row.revision,
+            });
+        }
+        else {
+            const error = row.error ??
+                (row.status === "analyzing"
+                    ? "stale analyzing → dead-letter"
+                    : "max attempts → dead-letter");
+            await coll.updateOne({ _id: raw._id }, {
+                $set: {
+                    status: "dead-letter",
+                    updatedAt: iso,
+                    error,
+                },
+            });
+            deadLetter += 1;
+            emitOutboxActivity({
+                orgId: row.orgId,
+                operationId: row.operationId,
+                status: "dead-letter",
+                policyId: row.policyId,
+                error,
+                objectType: row.objectType,
+                contentType: row.contentType,
+                recordId: row.recordId,
+                revision: row.revision,
+            });
+        }
+    }
+    return { requeued, deadLetter };
+}
+//# sourceMappingURL=outbox.js.map

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

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

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

@@ -0,0 +1,48 @@
+/**
+ * Nexum auto-analyze eligibility (metadata policy + env gate).
+ * Hard exclusions prevent loops on knowledge-graph subjects we just wrote.
+ */
+export type NexumIndexingPolicy = {
+    id: string;
+    enabled: boolean;
+    match: {
+        objectTypes?: string[];
+        contentTypes?: string[];
+        excludeObjectTypes?: string[];
+        excludeContentTypes?: string[];
+    };
+    processing?: {
+        mode?: "async-required" | "async" | "off";
+    };
+};
+export type AnalysisCandidate = {
+    orgId: string;
+    agentIds: string[];
+    objectType: string;
+    contentType: string;
+    recordId: string;
+    revision: number;
+    data?: Record<string, unknown>;
+};
+/**
+ * Env master switch — indexing is **on by default**.
+ * Opt out with `NEXUM_AUTO_ANALYZE=0` / `false` / `no` / `off`.
+ */
+export declare function isNexumAutoAnalyzeEnabled(env?: NodeJS.ProcessEnv): boolean;
+export declare function parsePoliciesFromExtensions(extensions: Record<string, unknown> | undefined | null): NexumIndexingPolicy[];
+export declare function matchNexumIndexingPolicy(candidate: Pick<AnalysisCandidate, "objectType" | "contentType" | "data">, policies: NexumIndexingPolicy[]): NexumIndexingPolicy | null;
+export declare function resolveNexumIndexingPolicies(input: {
+    extensions?: Record<string, unknown> | null;
+    env?: NodeJS.ProcessEnv;
+}): NexumIndexingPolicy[];
+/** Map a landed Memorix record into Nexum analyze items[]. */
+export declare function recordToNexumItems(candidate: AnalysisCandidate): Array<{
+    id: string;
+    inputType: "content" | "structured" | "unknown";
+    objectType?: string;
+    title?: string;
+    format?: string;
+    content?: string;
+    data?: Record<string, unknown>;
+}>;
+//# sourceMappingURL=policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/nexum-analysis/policy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE;QACL,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC9B,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;KAChC,CAAC;IACF,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,GAAG,KAAK,CAAC;KAC3C,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAyBF;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAMT;AAED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,GACrD,mBAAmB,EAAE,CAwCvB;AAiBD,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,IAAI,CACb,iBAAiB,EACjB,YAAY,GAAG,aAAa,GAAG,MAAM,CACtC,EACD,QAAQ,EAAE,mBAAmB,EAAE,GAC9B,mBAAmB,GAAG,IAAI,CAwB5B;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,mBAAmB,EAAE,CAIxB;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,iBAAiB,GAAG,KAAK,CAAC;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC,CAsCD"}