@x12i/memorix-service 3.0.6 → 3.1.0

package/dist/assist/facts.js

@@ -0,0 +1,237 @@
+function effectiveEntries(platform, agentIds) {
+    const resolved = platform.metadata.resolveEffective(agentIds);
+    return (resolved.effective ?? []);
+}
+function findByKindId(entries, kind, id) {
+    return entries.find((e) => e.kind === kind && e.id === id);
+}
+function slimDef(def, keys) {
+    const out = { id: def.id };
+    for (const k of keys) {
+        if (k in def)
+            out[k] = def[k];
+    }
+    return out;
+}
+function fieldPaths(def) {
+    const fields = def.fields;
+    if (!Array.isArray(fields))
+        return [];
+    return fields
+        .map((f) => {
+        if (f && typeof f === "object" && !Array.isArray(f)) {
+            return String(f.path ?? "").trim();
+        }
+        return "";
+    })
+        .filter(Boolean);
+}
+/** Bounded metadata slice for Validate + Ask. */
+export function gatherEntityFacts(platform, entity) {
+    if (entity.kind === "platform-magit") {
+        const diag = platform.diagnostics({
+            orgId: entity.orgId,
+            agentIds: entity.agentIds.length ? entity.agentIds : ["opx"],
+        });
+        return {
+            magit: diag.magit,
+            magitDisabledReason: diag.magitDisabledReason,
+            durableMetadata: diag.durableMetadata,
+            hasMongo: diag.hasMongo,
+            mode: diag.mode,
+        };
+    }
+    const entries = effectiveEntries(platform, entity.agentIds);
+    const abstracts = entries
+        .filter((e) => e.kind === "abstract-types")
+        .slice(0, 40)
+        .map((e) => slimDef(e.definition, ["id", "name", "properties", "bindings", "objectTypes"]));
+    const objectTypes = entries
+        .filter((e) => e.kind === "object-types")
+        .slice(0, 60)
+        .map((e) => ({
+        id: e.id,
+        name: e.definition.name,
+        abstractTypes: e.definition.abstractTypes,
+        fieldPaths: fieldPaths(e.definition),
+    }));
+    const mappings = entries
+        .filter((e) => e.kind === "mappings")
+        .slice(0, 40)
+        .map((e) => slimDef(e.definition, [
+        "id",
+        "name",
+        "purpose",
+        "objectType",
+        "contentType",
+        "map",
+        "sourceId",
+        "abstractType",
+        "endpoint",
+        "mode",
+        "trigger",
+        "reverse",
+    ]));
+    const relationships = entries
+        .filter((e) => e.kind === "relationship-definitions")
+        .slice(0, 40)
+        .map((e) => slimDef(e.definition, [
+        "id",
+        "name",
+        "meaning",
+        "directionality",
+        "from",
+        "to",
+        "discoveryRules",
+    ]));
+    const sources = entries
+        .filter((e) => e.kind === "sources")
+        .slice(0, 40)
+        .map((e) => slimDef(e.definition, ["id", "name", "connectorId", "streams", "objectTypes", "routes"]));
+    const services = entries
+        .filter((e) => e.kind === "services")
+        .slice(0, 30)
+        .map((e) => slimDef(e.definition, ["id", "name", "inputs", "outputs"]));
+    const pipelines = entries
+        .filter((e) => e.kind === "pipelines")
+        .slice(0, 30)
+        .map((e) => slimDef(e.definition, ["id", "name", "steps"]));
+    const provenance = platform.metadata.resolveEffective(entity.agentIds);
+    const base = {
+        entity,
+        resolveOk: provenance.ok,
+        issues: (provenance.issues ?? []).slice(0, 20),
+        referenceIssues: (provenance.referenceIssues ?? []).slice(0, 20),
+        abstracts,
+        objectTypes,
+        mappings,
+        relationships,
+        sources,
+        services,
+        pipelines,
+        magit: Boolean(platform.magit),
+    };
+    switch (entity.kind) {
+        case "object-type": {
+            const ot = findByKindId(entries, "object-types", entity.id);
+            base.objectType = ot
+                ? {
+                    ...slimDef(ot.definition, [
+                        "id",
+                        "name",
+                        "dataCategory",
+                        "abstractTypes",
+                        "contentTypes",
+                        "fields",
+                    ]),
+                    fieldPaths: fieldPaths(ot.definition),
+                }
+                : null;
+            break;
+        }
+        case "connector": {
+            const src = findByKindId(entries, "sources", entity.id);
+            base.connector = src
+                ? slimDef(src.definition, [
+                    "id",
+                    "name",
+                    "connectorId",
+                    "streams",
+                    "objectTypes",
+                    "routes",
+                    "checkpoint",
+                ])
+                : null;
+            break;
+        }
+        case "agent": {
+            const agents = entries.filter((e) => e.kind === "agents");
+            const agent = findByKindId(entries, "agents", entity.id) ??
+                agents.find((a) => a.id === entity.id);
+            base.agent = agent
+                ? slimDef(agent.definition, ["id", "name", "parentIds", "description"])
+                : { id: entity.id };
+            base.counts = {
+                objectTypes: objectTypes.length,
+                abstracts: abstracts.length,
+                sources: sources.length,
+                services: services.length,
+                mappings: mappings.length,
+                relationships: relationships.length,
+                pipelines: pipelines.length,
+            };
+            break;
+        }
+        case "abstract": {
+            const abs = findByKindId(entries, "abstract-types", entity.id);
+            base.abstract = abs
+                ? slimDef(abs.definition, ["id", "name", "properties", "bindings", "objectTypes"])
+                : null;
+            break;
+        }
+        case "mapping": {
+            const m = findByKindId(entries, "mappings", entity.id);
+            base.mapping = m
+                ? slimDef(m.definition, [
+                    "id",
+                    "name",
+                    "purpose",
+                    "objectType",
+                    "contentType",
+                    "map",
+                    "sourceId",
+                    "abstractType",
+                    "endpoint",
+                    "mode",
+                    "trigger",
+                    "reverse",
+                ])
+                : null;
+            break;
+        }
+        case "relationship": {
+            const r = findByKindId(entries, "relationship-definitions", entity.id);
+            base.relationship = r
+                ? slimDef(r.definition, [
+                    "id",
+                    "name",
+                    "meaning",
+                    "directionality",
+                    "from",
+                    "to",
+                    "discoveryRules",
+                ])
+                : null;
+            break;
+        }
+        case "service": {
+            const s = findByKindId(entries, "services", entity.id);
+            base.service = s
+                ? slimDef(s.definition, ["id", "name", "inputs", "outputs"])
+                : null;
+            break;
+        }
+        case "pipeline": {
+            const p = findByKindId(entries, "pipelines", entity.id);
+            base.pipeline = p
+                ? slimDef(p.definition, ["id", "name", "steps"])
+                : null;
+            break;
+        }
+        case "memory-source": {
+            const src = findByKindId(entries, "sources", entity.id);
+            base.memorySource = src
+                ? slimDef(src.definition, ["id", "name", "connectorId", "streams", "routes"])
+                : null;
+            break;
+        }
+        case "run": {
+            base.runId = entity.id;
+            break;
+        }
+        default:
+            break;
+    }
+    return base;
+}
+//# sourceMappingURL=facts.js.map

package/dist/assist/facts.js.map

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

package/dist/assist/merge-ask-proposal.d.ts

@@ -0,0 +1,9 @@
+import type { MetadataPack } from "@x12i/memorix-metadata";
+import type { AskProposal } from "./types.js";
+/**
+ * Merge Ask proposal arrays into a base pack (or empty pack for agentId).
+ * Does not install — callers validate / stage / install with confirm.
+ */
+export declare function mergeAskProposalIntoPack(base: MetadataPack | null | undefined, agentId: string, proposal: AskProposal): MetadataPack;
+export declare function proposalHasContent(proposal: AskProposal): boolean;
+//# sourceMappingURL=merge-ask-proposal.d.ts.map

package/dist/assist/merge-ask-proposal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-ask-proposal.d.ts","sourceRoot":"","sources":["../../src/assist/merge-ask-proposal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA+B9C;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,EACrC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,WAAW,GACpB,YAAY,CAsBd;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAUjE"}

package/dist/assist/merge-ask-proposal.js

@@ -0,0 +1,57 @@
+import { emptyMetadataPack } from "../magit/pack-to-patchset.js";
+function upsertById(list, items) {
+    const out = Array.isArray(list)
+        ? list.map((x) => ({ ...x }))
+        : [];
+    if (!Array.isArray(items))
+        return out;
+    for (const item of items) {
+        if (!item || typeof item !== "object" || Array.isArray(item))
+            continue;
+        const rec = item;
+        const id = String(rec.id ?? "").trim();
+        if (!id)
+            continue;
+        const idx = out.findIndex((x) => String(x.id ?? "") === id);
+        if (idx >= 0)
+            out[idx] = { ...out[idx], ...rec };
+        else
+            out.push({ ...rec });
+    }
+    return out;
+}
+/**
+ * Merge Ask proposal arrays into a base pack (or empty pack for agentId).
+ * Does not install — callers validate / stage / install with confirm.
+ */
+export function mergeAskProposalIntoPack(base, agentId, proposal) {
+    const pack = base
+        ? structuredClone(base)
+        : emptyMetadataPack(agentId);
+    const fields = [
+        ["objectTypes", proposal.objectTypes],
+        ["abstractTypes", proposal.abstractTypes],
+        ["mappings", proposal.mappings],
+        ["relationshipDefinitions", proposal.relationshipDefinitions],
+        ["sources", proposal.sources],
+        ["services", proposal.services],
+        ["pipelines", proposal.pipelines],
+    ];
+    for (const [field, items] of fields) {
+        if (!items?.length)
+            continue;
+        const current = pack[field];
+        pack[field] = upsertById(current, items);
+    }
+    return pack;
+}
+export function proposalHasContent(proposal) {
+    return Boolean(proposal.objectTypes?.length ||
+        proposal.abstractTypes?.length ||
+        proposal.mappings?.length ||
+        proposal.relationshipDefinitions?.length ||
+        proposal.sources?.length ||
+        proposal.services?.length ||
+        proposal.pipelines?.length);
+}
+//# sourceMappingURL=merge-ask-proposal.js.map

package/dist/assist/merge-ask-proposal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-ask-proposal.js","sourceRoot":"","sources":["../../src/assist/merge-ask-proposal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAYjE,SAAS,UAAU,CACjB,IAAgD,EAChD,KAA4B;IAE5B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAC7B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7B,CAAC,CAAE,EAAqC,CAAC;IAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,SAAS;QACvE,MAAM,GAAG,GAAG,IAA+B,CAAC;QAC5C,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,EAAE;YAAE,SAAS;QAClB,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;QAC5D,IAAI,GAAG,IAAI,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC;;YAC5C,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAqC,EACrC,OAAe,EACf,QAAqB;IAErB,MAAM,IAAI,GAAiB,IAAI;QAC7B,CAAC,CAAE,eAAe,CAAC,IAAI,CAAkB;QACzC,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAE/B,MAAM,MAAM,GAAmD;QAC7D,CAAC,aAAa,EAAE,QAAQ,CAAC,WAAW,CAAC;QACrC,CAAC,eAAe,EAAE,QAAQ,CAAC,aAAa,CAAC;QACzC,CAAC,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC;QAC/B,CAAC,yBAAyB,EAAE,QAAQ,CAAC,uBAAuB,CAAC;QAC7D,CAAC,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC;QAC7B,CAAC,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC;QAC/B,CAAC,WAAW,EAAE,QAAQ,CAAC,SAAS,CAAC;KAClC,CAAC;IAEF,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,EAAE,MAAM;YAAE,SAAS;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAA+C,CAAC;QACzE,IAAgC,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAqB;IACtD,OAAO,OAAO,CACZ,QAAQ,CAAC,WAAW,EAAE,MAAM;QAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM;QAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM;QACzB,QAAQ,CAAC,uBAAuB,EAAE,MAAM;QACxC,QAAQ,CAAC,OAAO,EAAE,MAAM;QACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM;QACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAC7B,CAAC;AACJ,CAAC"}

package/dist/assist/types.d.ts

@@ -0,0 +1,60 @@
+/** Entity-scoped Studio Assist contracts (Validate + Ask). */
+export declare const ENTITY_KINDS: readonly ["agent", "connector", "object-type", "abstract", "mapping", "relationship", "service", "pipeline", "platform-magit", "memory-source", "run"];
+export type EntityKind = (typeof ENTITY_KINDS)[number];
+export type EntityRef = {
+    kind: EntityKind;
+    id: string;
+    orgId: string;
+    agentIds: string[];
+};
+export type CheckStatus = "pass" | "fail" | "warn";
+export type ValidateCheck = {
+    id: string;
+    status: CheckStatus;
+    message: string;
+};
+export type AutoFix = {
+    id: string;
+    label: string;
+    description: string;
+};
+export type ValidateReport = {
+    entity: EntityRef;
+    status: "ok" | "gaps" | "errors";
+    checks: ValidateCheck[];
+    autoFixes?: AutoFix[];
+    facts?: Record<string, unknown>;
+};
+export type AskIntent = "match-abstracts" | "propose-mappings" | "propose-relationships" | "auto" | "platform-magit";
+export type AskActionId = "stage-proposal" | "validate-draft-pack" | "install-draft" | "navigate";
+export type AskAction = {
+    id: AskActionId;
+    label: string;
+    requiresConfirm: boolean;
+    href?: string;
+};
+export type AskProposal = {
+    abstractTypes?: unknown[];
+    objectTypes?: unknown[];
+    mappings?: unknown[];
+    relationshipDefinitions?: unknown[];
+    sources?: unknown[];
+    services?: unknown[];
+    pipelines?: unknown[];
+};
+export type AskResult = {
+    entity: EntityRef;
+    summary: string;
+    intent: string;
+    proposal: AskProposal;
+    rationale: string[];
+    actions: AskAction[];
+    askUnavailable?: boolean;
+    autoInstall: false;
+};
+export declare function parseEntityRef(body: unknown, fallbackScope: {
+    orgId: string;
+    agentIds: string[];
+}): EntityRef;
+export declare function parseAskIntent(raw: unknown): AskIntent;
+//# sourceMappingURL=types.d.ts.map

package/dist/assist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/assist/types.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAE9D,eAAO,MAAM,YAAY,wJAYf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnD,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC;IACjC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,SAAS,GACjB,iBAAiB,GACjB,kBAAkB,GAClB,uBAAuB,GACvB,MAAM,GACN,gBAAgB,CAAC;AAErB,MAAM,MAAM,WAAW,GACnB,gBAAgB,GAChB,qBAAqB,GACrB,eAAe,GACf,UAAU,CAAC;AAEf,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,WAAW,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,OAAO,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,uBAAuB,CAAC,EAAE,OAAO,EAAE,CAAC;IACpC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,WAAW,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,KAAK,CAAC;CACpB,CAAC;AAEF,wBAAgB,cAAc,CAC5B,IAAI,EAAE,OAAO,EACb,aAAa,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GACnD,SAAS,CA4BX;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CAYtD"}

package/dist/assist/types.js

@@ -0,0 +1,57 @@
+/** Entity-scoped Studio Assist contracts (Validate + Ask). */
+export const ENTITY_KINDS = [
+    "agent",
+    "connector",
+    "object-type",
+    "abstract",
+    "mapping",
+    "relationship",
+    "service",
+    "pipeline",
+    "platform-magit",
+    "memory-source",
+    "run",
+];
+export function parseEntityRef(body, fallbackScope) {
+    const b = (body ?? {});
+    const e = (b.entity ?? b);
+    const kind = String(e.kind ?? "").trim();
+    if (!ENTITY_KINDS.includes(kind)) {
+        throw new Error(`invalid entity.kind: ${kind || "(empty)"}`);
+    }
+    const id = String(e.id ?? "").trim();
+    if (!id && kind !== "platform-magit") {
+        throw new Error("entity.id required");
+    }
+    const orgId = String(e.orgId ?? fallbackScope.orgId ?? "").trim();
+    if (!orgId)
+        throw new Error("entity.orgId required");
+    let agentIds = fallbackScope.agentIds;
+    if (Array.isArray(e.agentIds)) {
+        agentIds = e.agentIds.map((a) => String(a).trim()).filter(Boolean);
+    }
+    else if (typeof e.agentIds === "string" && e.agentIds.trim()) {
+        agentIds = e.agentIds.split(",").map((a) => a.trim()).filter(Boolean);
+    }
+    if (agentIds.length === 0 && kind !== "platform-magit") {
+        throw new Error("entity.agentIds required");
+    }
+    return {
+        kind,
+        id: id || "magit",
+        orgId,
+        agentIds,
+    };
+}
+export function parseAskIntent(raw) {
+    const s = String(raw ?? "auto").trim();
+    if (s === "match-abstracts" ||
+        s === "propose-mappings" ||
+        s === "propose-relationships" ||
+        s === "auto" ||
+        s === "platform-magit") {
+        return s;
+    }
+    return "auto";
+}
+//# sourceMappingURL=types.js.map

package/dist/assist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/assist/types.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAE9D,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,OAAO;IACP,WAAW;IACX,aAAa;IACb,UAAU;IACV,SAAS;IACT,cAAc;IACd,SAAS;IACT,UAAU;IACV,gBAAgB;IAChB,eAAe;IACf,KAAK;CACG,CAAC;AA0EX,MAAM,UAAU,cAAc,CAC5B,IAAa,EACb,aAAoD;IAEpD,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;IAClD,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAA4B,CAAC;IACrD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAgB,CAAC;IACvD,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,IAAI,SAAS,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC,EAAE,IAAI,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,aAAa,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClE,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACrD,IAAI,QAAQ,GAAa,aAAa,CAAC,QAAQ,CAAC;IAChD,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC;SAAM,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/D,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO;QACL,IAAI;QACJ,EAAE,EAAE,EAAE,IAAI,OAAO;QACjB,KAAK;QACL,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,IACE,CAAC,KAAK,iBAAiB;QACvB,CAAC,KAAK,kBAAkB;QACxB,CAAC,KAAK,uBAAuB;QAC7B,CAAC,KAAK,MAAM;QACZ,CAAC,KAAK,gBAAgB,EACtB,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/assist/validate.d.ts

@@ -0,0 +1,4 @@
+import type { MemorixPlatform } from "../platform.js";
+import type { EntityRef, ValidateReport } from "./types.js";
+export declare function validateEntity(platform: MemorixPlatform, entity: EntityRef): ValidateReport;
+//# sourceMappingURL=validate.d.ts.map

package/dist/assist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/assist/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,KAAK,EACV,SAAS,EAET,cAAc,EACf,MAAM,YAAY,CAAC;AA6BpB,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,SAAS,GAChB,cAAc,CAyThB"}