@x12i/memorix-service 3.7.1 → 3.7.6

package/dist/nexum-analysis/policy.js

@@ -0,0 +1,165 @@
+/**
+ * Nexum auto-analyze eligibility (metadata policy + env gate).
+ * Hard exclusions prevent loops on knowledge-graph subjects we just wrote.
+ */
+const DEFAULT_POLICIES = [
+    {
+        id: "default-content-knowledge",
+        enabled: true,
+        match: {
+            objectTypes: ["content"],
+            contentTypes: ["snapshots", "knowx"],
+            excludeContentTypes: ["raw", "nexum"],
+        },
+        processing: { mode: "async-required" },
+    },
+];
+function asRecord(v) {
+    return v && typeof v === "object" && !Array.isArray(v)
+        ? v
+        : null;
+}
+function asString(v) {
+    return typeof v === "string" ? v.trim() : "";
+}
+/**
+ * Env master switch — indexing is **on by default**.
+ * Opt out with `NEXUM_AUTO_ANALYZE=0` / `false` / `no` / `off`.
+ */
+export function isNexumAutoAnalyzeEnabled(env = process.env) {
+    const raw = String(env.NEXUM_AUTO_ANALYZE ?? "")
+        .trim()
+        .toLowerCase();
+    if (!raw)
+        return true;
+    return !(raw === "0" || raw === "false" || raw === "no" || raw === "off");
+}
+export function parsePoliciesFromExtensions(extensions) {
+    const bag = extensions?.["nexum.indexing-policy"] ??
+        extensions?.["nexum-indexing-policy"];
+    if (!Array.isArray(bag))
+        return [];
+    const out = [];
+    for (const raw of bag) {
+        const o = asRecord(raw);
+        if (!o)
+            continue;
+        const id = asString(o.id);
+        if (!id)
+            continue;
+        const match = asRecord(o.match) ?? {};
+        out.push({
+            id,
+            enabled: o.enabled !== false,
+            match: {
+                objectTypes: Array.isArray(match.objectTypes)
+                    ? match.objectTypes.map(asString).filter(Boolean)
+                    : undefined,
+                contentTypes: Array.isArray(match.contentTypes)
+                    ? match.contentTypes.map(asString).filter(Boolean)
+                    : undefined,
+                excludeObjectTypes: Array.isArray(match.excludeObjectTypes)
+                    ? match.excludeObjectTypes.map(asString).filter(Boolean)
+                    : undefined,
+                excludeContentTypes: Array.isArray(match.excludeContentTypes)
+                    ? match.excludeContentTypes.map(asString).filter(Boolean)
+                    : undefined,
+            },
+            processing: {
+                mode: asString(asRecord(o.processing)?.mode) === "off"
+                    ? "off"
+                    : asString(asRecord(o.processing)?.mode) === "async"
+                        ? "async"
+                        : "async-required",
+            },
+        });
+    }
+    return out;
+}
+function matchesList(value, list) {
+    if (!list?.length)
+        return true;
+    return list.some((p) => p === "*" || p === value);
+}
+function excluded(value, list) {
+    if (!list?.length)
+        return false;
+    return list.some((p) => {
+        if (p === value)
+            return true;
+        if (p.endsWith("-*") && value.startsWith(p.slice(0, -1)))
+            return true;
+        if (p.endsWith("*") && value.startsWith(p.slice(0, -1)))
+            return true;
+        return false;
+    });
+}
+export function matchNexumIndexingPolicy(candidate, policies) {
+    const kind = asString(candidate.data?.kind);
+    // Never re-analyze Nexum persist output (loop guard).
+    if (kind === "knowledge-graph")
+        return null;
+    if (candidate.objectType.startsWith("nexum-"))
+        return null;
+    if (candidate.contentType === "nexum")
+        return null;
+    for (const policy of policies) {
+        if (!policy.enabled)
+            continue;
+        if (policy.processing?.mode === "off")
+            continue;
+        if (excluded(candidate.objectType, policy.match.excludeObjectTypes) ||
+            excluded(candidate.contentType, policy.match.excludeContentTypes)) {
+            continue;
+        }
+        if (matchesList(candidate.objectType, policy.match.objectTypes) &&
+            matchesList(candidate.contentType, policy.match.contentTypes)) {
+            return policy;
+        }
+    }
+    return null;
+}
+export function resolveNexumIndexingPolicies(input) {
+    const fromPack = parsePoliciesFromExtensions(input.extensions);
+    if (fromPack.length)
+        return fromPack;
+    return DEFAULT_POLICIES;
+}
+/** Map a landed Memorix record into Nexum analyze items[]. */
+export function recordToNexumItems(candidate) {
+    const data = candidate.data ?? {};
+    const markdown = typeof data.markdown === "string" ? data.markdown.trim() : "";
+    if (markdown) {
+        return [
+            {
+                id: candidate.recordId,
+                inputType: "content",
+                objectType: candidate.objectType,
+                title: (typeof data.title === "string" && data.title.trim()) ||
+                    candidate.recordId,
+                format: (typeof data.sourceFormat === "string" && data.sourceFormat) ||
+                    "markdown",
+                content: markdown,
+            },
+        ];
+    }
+    if (Object.keys(data).length === 0)
+        return [];
+    return [
+        {
+            id: candidate.recordId,
+            inputType: "structured",
+            objectType: candidate.objectType,
+            title: (typeof data.title === "string" && data.title.trim()) ||
+                (typeof data.label === "string" && data.label.trim()) ||
+                candidate.recordId,
+            data: {
+                ...data,
+                contentType: candidate.contentType,
+                recordId: candidate.recordId,
+                revision: candidate.revision,
+            },
+        },
+    ];
+}
+//# sourceMappingURL=policy.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * Process-wide reconcile ticker for Nexum analysis outbox (DLQ + requeue).
+ */
+import type { MemorixPlatform } from "../platform.js";
+export declare function startNexumAnalysisReconcileTicker(platform: MemorixPlatform, opts?: {
+    intervalMs?: number;
+}): () => void;
+//# sourceMappingURL=reconcile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../src/nexum-analysis/reconcile.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtD,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,eAAe,EACzB,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,MAAM,IAAI,CA4BZ"}

package/dist/nexum-analysis/reconcile.js

@@ -0,0 +1,37 @@
+import { reconcileAnalysisOutbox } from "./outbox.js";
+export function startNexumAnalysisReconcileTicker(platform, opts) {
+    const intervalMs = opts?.intervalMs ?? 60_000;
+    const tickOnce = async () => {
+        try {
+            const client = platform.getMongoClient();
+            if (!client)
+                return;
+            const dbs = await client.db().admin().listDatabases();
+            for (const d of dbs.databases ?? []) {
+                const name = d.name ?? "";
+                if (!name.endsWith("_operational"))
+                    continue;
+                const orgId = name.slice(0, -"_operational".length);
+                if (!orgId)
+                    continue;
+                let db;
+                try {
+                    db = platform.operationalDbFor(orgId);
+                }
+                catch {
+                    continue;
+                }
+                await reconcileAnalysisOutbox(db);
+            }
+        }
+        catch {
+            // Ticker must not crash the service.
+        }
+    };
+    void tickOnce();
+    const handle = setInterval(() => void tickOnce(), intervalMs);
+    if (typeof handle.unref === "function")
+        handle.unref();
+    return () => clearInterval(handle);
+}
+//# sourceMappingURL=reconcile.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.js","sourceRoot":"","sources":["../../src/nexum-analysis/reconcile.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,UAAU,iCAAiC,CAC/C,QAAyB,EACzB,IAA8B;IAE9B,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,MAAM,CAAC;IAC9C,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,EAAE,CAAC;YACzC,IAAI,CAAC,MAAM;gBAAE,OAAO;YACpB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,aAAa,EAAE,CAAC;YACtD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;gBACpC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;gBAC1B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;oBAAE,SAAS;gBAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;gBACpD,IAAI,CAAC,KAAK;oBAAE,SAAS;gBACrB,IAAI,EAAE,CAAC;gBACP,IAAI,CAAC;oBACH,EAAE,GAAG,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;gBACxC,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;gBACD,MAAM,uBAAuB,CAAC,EAAE,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;QACvC,CAAC;IACH,CAAC,CAAC;IACF,KAAK,QAAQ,EAAE,CAAC;IAChB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,EAAE,UAAU,CAAC,CAAC;IAC9D,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,UAAU;QAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IACvD,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC"}