@x12i/memorix-metadata 0.0.0-bootstrap.0

package/dist/fingerprint.js

@@ -0,0 +1,66 @@
+import { FINGERPRINT_EXCLUDED_KEYS, SET_ARRAY_PATHS } from "./kind-fields.js";
+/**
+ * Schema-normalize a definition for canonical equality:
+ * - drop provenance / install / runtime fields
+ * - apply shallow schema defaults (undefined omitted; null parentId → null)
+ * - stable object-key ordering
+ * - preserve array order except explicit set-arrays (sorted)
+ */
+export function schemaNormalizeForFingerprint(value, keyHint) {
+    if (value === undefined)
+        return undefined;
+    if (value === null)
+        return null;
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        const normalized = value
+            .map((item) => schemaNormalizeForFingerprint(item))
+            .filter((item) => item !== undefined);
+        if (keyHint && SET_ARRAY_PATHS.has(keyHint)) {
+            return [...normalized]
+                .map((item) => JSON.stringify(item))
+                .sort()
+                .map((s) => JSON.parse(s));
+        }
+        return normalized;
+    }
+    if (typeof value === "object") {
+        const obj = value;
+        const out = {};
+        const keys = Object.keys(obj)
+            .filter((k) => !FINGERPRINT_EXCLUDED_KEYS.has(k))
+            .sort();
+        for (const key of keys) {
+            const next = schemaNormalizeForFingerprint(obj[key], key);
+            if (next !== undefined)
+                out[key] = next;
+        }
+        return out;
+    }
+    return String(value);
+}
+/** Deterministic fingerprint of a schema-normalized definition. */
+export function fingerprintDefinition(definition) {
+    const normalized = schemaNormalizeForFingerprint(definition);
+    return stableStringify(normalized);
+}
+function stableStringify(value) {
+    if (value === null)
+        return "null";
+    if (typeof value === "string")
+        return JSON.stringify(value);
+    if (typeof value === "number" || typeof value === "boolean")
+        return String(value);
+    if (Array.isArray(value)) {
+        return `[${value.map((v) => stableStringify(v)).join(",")}]`;
+    }
+    if (typeof value === "object") {
+        const obj = value;
+        const keys = Object.keys(obj).sort();
+        return `{${keys.map((k) => `${JSON.stringify(k)}:${stableStringify(obj[k])}`).join(",")}}`;
+    }
+    return JSON.stringify(String(value));
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/fingerprint.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { METADATA_KIND_IDS, METADATA_KIND_REGISTRY, FORBIDDEN_OPERATIONAL_KIND_IDS, isMetadataKindId, isForbiddenOperationalKindId, getMetadataKind, type MetadataKindId, type MetadataKindSpec, } from "./kinds.js";
+export type * from "./types.js";
+export { validateMetadataPack, assertValidMetadataPack, } from "./validate.js";
+export { normalizeOpsPackBundle } from "./normalize.js";
+export { fingerprintDefinition, schemaNormalizeForFingerprint, } from "./fingerprint.js";
+export { MULTI_AGENT_COMBINATION_RULE, resolveEffectiveMetadata, resolveMultiAgentMetadata, getRawAgentView, collapseAncestorSelections, resolveParentChain, type DefinitionProvenance, type ConflictReport, type EffectiveDefinition, type EffectiveMetadataResult, type ResolveIssue, type RawAgentView, } from "./multi-agent-rule.js";
+export { resolveAbstractBindings, resolveAbstractBindingsFromPack, resolveAbstractReverseWrite, type AbstractResolveIssue, type ConcreteMemberPlan, type PropertyConcretePath, type AbstractPropertyPlan, type AbstractBindingPlan, type RelationshipEndpointExpansion, type AbstractResolutionResult, } from "./abstracts.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,iBAAiB,EACjB,sBAAsB,EACtB,8BAA8B,EAC9B,gBAAgB,EAChB,4BAA4B,EAC5B,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AAEpB,mBAAmB,YAAY,CAAC;AAEhC,OAAO,EACL,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EACL,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,EACzB,eAAe,EACf,0BAA0B,EAC1B,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,uBAAuB,EACvB,+BAA+B,EAC/B,2BAA2B,EAC3B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,GAC9B,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { METADATA_KIND_IDS, METADATA_KIND_REGISTRY, FORBIDDEN_OPERATIONAL_KIND_IDS, isMetadataKindId, isForbiddenOperationalKindId, getMetadataKind, } from "./kinds.js";
+export { validateMetadataPack, assertValidMetadataPack, } from "./validate.js";
+export { normalizeOpsPackBundle } from "./normalize.js";
+export { fingerprintDefinition, schemaNormalizeForFingerprint, } from "./fingerprint.js";
+export { MULTI_AGENT_COMBINATION_RULE, resolveEffectiveMetadata, resolveMultiAgentMetadata, getRawAgentView, collapseAncestorSelections, resolveParentChain, } from "./multi-agent-rule.js";
+export { resolveAbstractBindings, resolveAbstractBindingsFromPack, resolveAbstractReverseWrite, } from "./abstracts.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,iBAAiB,EACjB,sBAAsB,EACtB,8BAA8B,EAC9B,gBAAgB,EAChB,4BAA4B,EAC5B,eAAe,GAGhB,MAAM,YAAY,CAAC;AAIpB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EACL,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,EACzB,eAAe,EACf,0BAA0B,EAC1B,kBAAkB,GAOnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,uBAAuB,EACvB,+BAA+B,EAC/B,2BAA2B,GAQ5B,MAAM,gBAAgB,CAAC"}

package/dist/kind-fields.d.ts

@@ -0,0 +1,13 @@
+import type { MetadataKindId } from "./kinds.js";
+import type { MetadataPack } from "./types.js";
+/** Pack array field for each declarative kind (excluding pack envelope). */
+export declare const KIND_TO_PACK_FIELD: Record<Exclude<MetadataKindId, never>, keyof MetadataPack>;
+export declare const PACK_DEFINITION_KINDS: MetadataKindId[];
+/**
+ * Arrays treated as unordered sets for fingerprinting only.
+ * All other arrays preserve order (semantic).
+ */
+export declare const SET_ARRAY_PATHS: Set<string>;
+/** Fields excluded from equality fingerprints (provenance / install / runtime). */
+export declare const FINGERPRINT_EXCLUDED_KEYS: Set<string>;
+//# sourceMappingURL=kind-fields.d.ts.map

package/dist/kind-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kind-fields.d.ts","sourceRoot":"","sources":["../src/kind-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,EAAE,MAAM,CACrC,OAAO,CAAC,cAAc,EAAE,KAAK,CAAC,EAC9B,MAAM,YAAY,CAcnB,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAsC,cAAc,EAAE,CAAC;AAEzF;;;GAGG;AACH,eAAO,MAAM,eAAe,aAI1B,CAAC;AAEH,mFAAmF;AACnF,eAAO,MAAM,yBAAyB,aAWpC,CAAC"}

package/dist/kind-fields.js

@@ -0,0 +1,39 @@
+/** Pack array field for each declarative kind (excluding pack envelope). */
+export const KIND_TO_PACK_FIELD = {
+    agents: "agents",
+    "object-types": "objectTypes",
+    "abstract-types": "abstractTypes",
+    "abstract-bindings": "abstractBindings",
+    "relationship-definitions": "relationshipDefinitions",
+    mappings: "mappings",
+    views: "views",
+    writes: "writes",
+    sources: "sources",
+    services: "services",
+    pipelines: "pipelines",
+    schedules: "schedules",
+};
+export const PACK_DEFINITION_KINDS = Object.keys(KIND_TO_PACK_FIELD);
+/**
+ * Arrays treated as unordered sets for fingerprinting only.
+ * All other arrays preserve order (semantic).
+ */
+export const SET_ARRAY_PATHS = new Set([
+    "capabilities",
+    "concreteObjectTypes",
+    "abstractTypes",
+]);
+/** Fields excluded from equality fingerprints (provenance / install / runtime). */
+export const FINGERPRINT_EXCLUDED_KEYS = new Set([
+    "provenance",
+    "inheritancePath",
+    "selectedAgentId",
+    "definedByAgentId",
+    "overridden",
+    "fingerprint",
+    "installedAt",
+    "runtime",
+    "runtimeStatus",
+    "_system",
+]);
+//# sourceMappingURL=kind-fields.js.map

package/dist/kind-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kind-fields.js","sourceRoot":"","sources":["../src/kind-fields.ts"],"names":[],"mappings":"AAGA,4EAA4E;AAC5E,MAAM,CAAC,MAAM,kBAAkB,GAG3B;IACF,MAAM,EAAE,QAAQ;IAChB,cAAc,EAAE,aAAa;IAC7B,gBAAgB,EAAE,eAAe;IACjC,mBAAmB,EAAE,kBAAkB;IACvC,0BAA0B,EAAE,yBAAyB;IACrD,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;CACvB,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAqB,CAAC;AAEzF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IACrC,cAAc;IACd,qBAAqB;IACrB,eAAe;CAChB,CAAC,CAAC;AAEH,mFAAmF;AACnF,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC;IAC/C,YAAY;IACZ,iBAAiB;IACjB,iBAAiB;IACjB,kBAAkB;IAClB,YAAY;IACZ,aAAa;IACb,aAAa;IACb,SAAS;IACT,eAAe;IACf,SAAS;CACV,CAAC,CAAC"}

package/dist/kinds.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Single registry of supported declarative metadata kinds (Phase 3A).
+ * Operational runs/leases/lineage/jobs are NOT metadata kinds.
+ */
+export declare const METADATA_KIND_IDS: readonly ["agents", "object-types", "abstract-types", "abstract-bindings", "relationship-definitions", "mappings", "views", "writes", "sources", "services", "pipelines", "schedules"];
+export type MetadataKindId = (typeof METADATA_KIND_IDS)[number];
+export type MetadataKindSpec = {
+    id: MetadataKindId;
+    title: string;
+    description: string;
+    /** Catalog / package migration notes */
+    legacyCatalogIds: string[];
+    disposition: "canonical" | "replace-legacy" | "create";
+};
+/** Explicit non-kinds: must never appear as declarative metadata kinds. */
+export declare const FORBIDDEN_OPERATIONAL_KIND_IDS: readonly ["pipeline-runs", "memorix-pipeline-runs", "leases", "lineage", "job-records", "graph-runs", "job-type-runs"];
+export declare const METADATA_KIND_REGISTRY: readonly MetadataKindSpec[];
+export declare function isMetadataKindId(value: string): value is MetadataKindId;
+export declare function isForbiddenOperationalKindId(value: string): boolean;
+export declare function getMetadataKind(id: MetadataKindId): MetadataKindSpec;
+//# sourceMappingURL=kinds.d.ts.map

package/dist/kinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kinds.d.ts","sourceRoot":"","sources":["../src/kinds.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,iBAAiB,wLAapB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,cAAc,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,EAAE,WAAW,GAAG,gBAAgB,GAAG,QAAQ,CAAC;CACxD,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,8BAA8B,wHAQjC,CAAC;AAEX,eAAO,MAAM,sBAAsB,EAAE,SAAS,gBAAgB,EA6GpD,CAAC;AAEX,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,cAAc,GAAG,gBAAgB,CAIpE"}

package/dist/kinds.js

@@ -0,0 +1,147 @@
+/**
+ * Single registry of supported declarative metadata kinds (Phase 3A).
+ * Operational runs/leases/lineage/jobs are NOT metadata kinds.
+ */
+export const METADATA_KIND_IDS = [
+    "agents",
+    "object-types",
+    "abstract-types",
+    "abstract-bindings",
+    "relationship-definitions",
+    "mappings",
+    "views",
+    "writes",
+    "sources",
+    "services",
+    "pipelines",
+    "schedules",
+];
+/** Explicit non-kinds: must never appear as declarative metadata kinds. */
+export const FORBIDDEN_OPERATIONAL_KIND_IDS = [
+    "pipeline-runs",
+    "memorix-pipeline-runs",
+    "leases",
+    "lineage",
+    "job-records",
+    "graph-runs",
+    "job-type-runs",
+];
+export const METADATA_KIND_REGISTRY = [
+    {
+        id: "agents",
+        title: "Agents",
+        description: "Ordinary OO agents; optional parentId; no base/concrete classification.",
+        legacyCatalogIds: ["memorix-agents", "memorix-inventory-policies (agents slice)"],
+        disposition: "create",
+    },
+    {
+        id: "object-types",
+        title: "Object / content types",
+        description: "Concrete object types and their content-type profiles.",
+        legacyCatalogIds: [
+            "memorix-object-type-descriptors",
+            "memorix-entity-descriptors",
+        ],
+        disposition: "replace-legacy",
+    },
+    {
+        id: "abstract-types",
+        title: "Abstract types",
+        description: "Metadata-only abstracts; never materialize abstract records.",
+        legacyCatalogIds: ["memorix-abstract-type-descriptors"],
+        disposition: "replace-legacy",
+    },
+    {
+        id: "abstract-bindings",
+        title: "Abstract ↔ concrete bindings",
+        description: "Union/binding of abstracts to concrete object types.",
+        legacyCatalogIds: ["memorix-abstract-bindings"],
+        disposition: "replace-legacy",
+    },
+    {
+        id: "relationship-definitions",
+        title: "Relationship definitions",
+        description: "Abstract endpoints, directional paths, discovery rules; no physical data-link storage (G4).",
+        legacyCatalogIds: [
+            "memorix-associator-presets",
+            "memorix-associated-properties-registry",
+            "memorix-security-relationship-types",
+        ],
+        disposition: "replace-legacy",
+    },
+    {
+        id: "mappings",
+        title: "Mappings",
+        description: "Purpose-discriminated mappings: source | abstract | completion. Completion execution policy lives on pipelines.",
+        legacyCatalogIds: [
+            "memorix-integration-abstraction-maps",
+            "memorix-completion-mappings",
+        ],
+        disposition: "replace-legacy",
+    },
+    {
+        id: "views",
+        title: "Views",
+        description: "List/item/expansion view definitions.",
+        legacyCatalogIds: [
+            "lists",
+            "memorix-list-descriptors",
+            "memorix-item-descriptors",
+            "memorix-graph-descriptors",
+        ],
+        disposition: "replace-legacy",
+    },
+    {
+        id: "writes",
+        title: "Write definitions",
+        description: "Validated write targets and identity policy hooks.",
+        legacyCatalogIds: ["memorix-write-descriptors"],
+        disposition: "replace-legacy",
+    },
+    {
+        id: "sources",
+        title: "Sources",
+        description: "Memory / fixture / integration source definitions.",
+        legacyCatalogIds: [],
+        disposition: "create",
+    },
+    {
+        id: "services",
+        title: "Services",
+        description: "Logical service capabilities and I/O/invocation contracts; no secrets or deployment/runtime state.",
+        legacyCatalogIds: ["memorix-pipeline-services"],
+        disposition: "replace-legacy",
+    },
+    {
+        id: "pipelines",
+        title: "Pipelines",
+        description: "Declarative pipeline graphs (not run records); may reference services.",
+        legacyCatalogIds: [
+            "memorix-pipeline-definitions",
+            "memorix-pipeline-templates",
+            "memorix-pipeline-steps",
+            "memorix-enrichment-playbooks",
+        ],
+        disposition: "replace-legacy",
+    },
+    {
+        id: "schedules",
+        title: "Schedules",
+        description: "Declarative schedule bindings to pipelines.",
+        legacyCatalogIds: ["memorix-pipeline-schedules"],
+        disposition: "replace-legacy",
+    },
+];
+export function isMetadataKindId(value) {
+    return METADATA_KIND_IDS.includes(value);
+}
+export function isForbiddenOperationalKindId(value) {
+    return FORBIDDEN_OPERATIONAL_KIND_IDS.includes(value);
+}
+export function getMetadataKind(id) {
+    const found = METADATA_KIND_REGISTRY.find((k) => k.id === id);
+    if (!found)
+        throw new Error(`Unknown metadata kind: ${id}`);
+    return found;
+}
+//# sourceMappingURL=kinds.js.map

package/dist/kinds.js.map

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

package/dist/multi-agent-rule.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Multi-agent combination rule — implemented in Phase 3B (`resolve.ts`).
+ */
+export declare const MULTI_AGENT_COMBINATION_RULE: {
+    readonly id: "g3-multi-agent-combination";
+    readonly status: "implemented-phase-3b";
+    readonly steps: readonly ["Resolve every selected agent’s single-parent chain oldest-parent-first (with cycle detection).", "Collapse ancestor/descendant selections: if both an ancestor and a descendant appear in agentIds[], keep the descendant’s chain only.", "Within a chain: child adds new definitions; same kind+id completely replaces the parent definition (no deep merge; no silent removal).", "Combine unrelated effective agents additively.", "Deduplicate the same kind+id only when normalized fingerprints are identical.", "Fail differing definitions from unrelated branches with both provenance paths.", "Never use agentIds[] array order as hidden precedence.", "Validate references only after the entire effective set is composed.", "The same textual ID in different metadata kinds is not a conflict."];
+    readonly ancestorDescendantCollapse: {
+        readonly rule: "When agentIds[] contains both A and B where A is an ancestor of B, resolve B’s parent chain only; A is already covered.";
+        readonly rationale: "Prevents duplicate application of the same inherited definitions when operators select both a parent and a child.";
+    };
+    readonly nonGoals: readonly ["Does not decide relationship storage (G4).", "Does not implement Catalox install/publish.", "Does not execute mappings (mapping checkpoint later).", "Does not compile mappings."];
+};
+export { resolveEffectiveMetadata, resolveMultiAgentMetadata, getRawAgentView, collapseAncestorSelections, resolveParentChain, type DefinitionProvenance, type ConflictReport, type EffectiveDefinition, type EffectiveMetadataResult, type ResolveIssue, type RawAgentView, } from "./resolve.js";
+//# sourceMappingURL=multi-agent-rule.d.ts.map

package/dist/multi-agent-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-agent-rule.d.ts","sourceRoot":"","sources":["../src/multi-agent-rule.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;CAyB/B,CAAC;AAEX,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,eAAe,EACf,0BAA0B,EAC1B,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC"}

package/dist/multi-agent-rule.js

@@ -0,0 +1,30 @@
+/**
+ * Multi-agent combination rule — implemented in Phase 3B (`resolve.ts`).
+ */
+export const MULTI_AGENT_COMBINATION_RULE = {
+    id: "g3-multi-agent-combination",
+    status: "implemented-phase-3b",
+    steps: [
+        "Resolve every selected agent’s single-parent chain oldest-parent-first (with cycle detection).",
+        "Collapse ancestor/descendant selections: if both an ancestor and a descendant appear in agentIds[], keep the descendant’s chain only.",
+        "Within a chain: child adds new definitions; same kind+id completely replaces the parent definition (no deep merge; no silent removal).",
+        "Combine unrelated effective agents additively.",
+        "Deduplicate the same kind+id only when normalized fingerprints are identical.",
+        "Fail differing definitions from unrelated branches with both provenance paths.",
+        "Never use agentIds[] array order as hidden precedence.",
+        "Validate references only after the entire effective set is composed.",
+        "The same textual ID in different metadata kinds is not a conflict.",
+    ],
+    ancestorDescendantCollapse: {
+        rule: "When agentIds[] contains both A and B where A is an ancestor of B, resolve B’s parent chain only; A is already covered.",
+        rationale: "Prevents duplicate application of the same inherited definitions when operators select both a parent and a child.",
+    },
+    nonGoals: [
+        "Does not decide relationship storage (G4).",
+        "Does not implement Catalox install/publish.",
+        "Does not execute mappings (mapping checkpoint later).",
+        "Does not compile mappings.",
+    ],
+};
+export { resolveEffectiveMetadata, resolveMultiAgentMetadata, getRawAgentView, collapseAncestorSelections, resolveParentChain, } from "./resolve.js";
+//# sourceMappingURL=multi-agent-rule.js.map

package/dist/multi-agent-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-agent-rule.js","sourceRoot":"","sources":["../src/multi-agent-rule.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,EAAE,EAAE,4BAA4B;IAChC,MAAM,EAAE,sBAAsB;IAC9B,KAAK,EAAE;QACL,gGAAgG;QAChG,uIAAuI;QACvI,wIAAwI;QACxI,gDAAgD;QAChD,+EAA+E;QAC/E,gFAAgF;QAChF,wDAAwD;QACxD,sEAAsE;QACtE,oEAAoE;KACrE;IACD,0BAA0B,EAAE;QAC1B,IAAI,EAAE,yHAAyH;QAC/H,SAAS,EACP,mHAAmH;KACtH;IACD,QAAQ,EAAE;QACR,4CAA4C;QAC5C,6CAA6C;QAC7C,uDAAuD;QACvD,4BAA4B;KAC7B;CACO,CAAC;AAEX,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,eAAe,EACf,0BAA0B,EAC1B,kBAAkB,GAOnB,MAAM,cAAc,CAAC"}

package/dist/normalize.d.ts

@@ -0,0 +1,26 @@
+import type { MetadataPack } from "./types.js";
+/**
+ * Normalize a Phase-1 ops-pack style bundle into memorix-metadata/1.
+ */
+export declare function normalizeOpsPackBundle(input: {
+    agentId: string;
+    version?: string;
+    agents?: unknown;
+    abstractTypes?: unknown;
+    abstractBindings?: unknown;
+    objectTypes?: unknown;
+    relationshipDefinitions?: unknown;
+    viewDefinitions?: unknown;
+    writeDefinitions?: unknown;
+    sourceMappings?: unknown;
+    pipelineDefinitions?: unknown;
+    sources?: unknown;
+    services?: unknown;
+    schedules?: unknown;
+    format?: string;
+    mappings?: unknown;
+    views?: unknown;
+    writes?: unknown;
+    pipelines?: unknown;
+}): MetadataPack;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,YAAY,EAGb,MAAM,YAAY,CAAC;AA0DpB;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,YAAY,CAyFf"}

package/dist/normalize.js

@@ -0,0 +1,114 @@
+function unwrapArray(value, key) {
+    if (Array.isArray(value))
+        return value;
+    if (value && typeof value === "object" && Array.isArray(value[key])) {
+        return value[key];
+    }
+    return [];
+}
+function normalizeEndpoint(end) {
+    const path = typeof end?.path === "string" && end.path.trim()
+        ? end.path
+        : typeof end?.property === "string"
+            ? end.property
+            : "";
+    return {
+        abstractType: String(end?.abstractType ?? ""),
+        path,
+    };
+}
+function normalizeRelationship(raw) {
+    const r = raw;
+    return {
+        id: String(r.id),
+        name: String(r.name ?? r.id),
+        meaning: String(r.meaning ?? ""),
+        directionality: r.directionality === "undirected" ? "undirected" : "directed",
+        from: normalizeEndpoint(r.from),
+        to: normalizeEndpoint(r.to),
+        discoveryRules: Array.isArray(r.discoveryRules)
+            ? r.discoveryRules
+            : [],
+    };
+}
+function normalizeMapping(raw) {
+    const m = raw;
+    const purpose = m.purpose === "abstract" || m.purpose === "completion" || m.purpose === "source"
+        ? m.purpose
+        : "source";
+    return {
+        id: String(m.id),
+        purpose,
+        sourceId: typeof m.sourceId === "string" ? m.sourceId : undefined,
+        abstractType: typeof m.abstractType === "string" ? m.abstractType : undefined,
+        endpoint: typeof m.endpoint === "string" ? m.endpoint : undefined,
+        objectType: String(m.objectType ?? ""),
+        contentType: String(m.contentType ?? ""),
+        mode: typeof m.mode === "string" ? m.mode : undefined,
+        trigger: typeof m.trigger === "string" ? m.trigger : undefined,
+        map: (m.map && typeof m.map === "object" ? m.map : {}),
+    };
+}
+/**
+ * Normalize a Phase-1 ops-pack style bundle into memorix-metadata/1.
+ */
+export function normalizeOpsPackBundle(input) {
+    if (input.format === "memorix-metadata/1") {
+        return input;
+    }
+    const agentsRaw = Array.isArray(input.agents) ? input.agents : [];
+    const agents = agentsRaw.map((raw) => {
+        const a = raw;
+        const parentId = a.parentId !== undefined
+            ? a.parentId
+            : (a.parentAgentId ?? null);
+        return {
+            id: String(a.id),
+            name: String(a.name ?? a.id),
+            description: typeof a.description === "string" ? a.description : undefined,
+            parentId,
+        };
+    });
+    const abstractTypes = unwrapArray(input.abstractTypes, "abstractTypes");
+    const abstractBindings = unwrapArray(input.abstractBindings, "bindings");
+    const objectTypes = unwrapArray(input.objectTypes, "objectTypes");
+    const relationshipDefinitions = unwrapArray(input.relationshipDefinitions, "relationshipDefinitions").map(normalizeRelationship);
+    const views = (Array.isArray(input.views)
+        ? input.views
+        : unwrapArray(input.viewDefinitions, "viewDefinitions"));
+    const writes = (Array.isArray(input.writes)
+        ? input.writes
+        : unwrapArray(input.writeDefinitions, "writeDefinitions"));
+    const mappings = (Array.isArray(input.mappings)
+        ? input.mappings
+        : unwrapArray(input.sourceMappings, "sourceMappings")).map(normalizeMapping);
+    const pipelines = (Array.isArray(input.pipelines)
+        ? input.pipelines
+        : unwrapArray(input.pipelineDefinitions, "pipelineDefinitions"));
+    let sources = (Array.isArray(input.sources) ? input.sources : unwrapArray(input.sources, "sources"));
+    if (sources.length === 0 &&
+        input.pipelineDefinitions &&
+        typeof input.pipelineDefinitions === "object") {
+        sources = unwrapArray(input.pipelineDefinitions, "sources");
+    }
+    const services = (Array.isArray(input.services) ? input.services : unwrapArray(input.services, "services"));
+    const schedules = (Array.isArray(input.schedules) ? input.schedules : []);
+    return {
+        format: "memorix-metadata/1",
+        agentId: input.agentId,
+        version: input.version,
+        agents,
+        objectTypes,
+        abstractTypes,
+        abstractBindings,
+        relationshipDefinitions,
+        mappings,
+        views,
+        writes,
+        sources,
+        services,
+        pipelines,
+        schedules,
+    };
+}
+//# sourceMappingURL=normalize.js.map

package/dist/normalize.js.map

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

package/dist/resolve.d.ts

@@ -0,0 +1,85 @@
+import type { MetadataKindId } from "./kinds.js";
+import type { AgentDefinition, MetadataPack, ValidationIssue } from "./types.js";
+export type DefinitionProvenance = {
+    kind: MetadataKindId;
+    id: string;
+    /** Agent that authored the winning definition body. */
+    definedByAgentId: string;
+    /** Oldest-parent-first chain ending at the defining agent. */
+    inheritancePath: string[];
+    /** Selected agentIds[] entry that caused this definition to be included. */
+    selectedAgentId: string;
+    fingerprint: string;
+    overridden?: {
+        definedByAgentId: string;
+        inheritancePath: string[];
+        fingerprint: string;
+    };
+};
+export type EffectiveDefinition = {
+    kind: MetadataKindId;
+    id: string;
+    definition: Record<string, unknown>;
+    provenance: DefinitionProvenance;
+};
+export type ConflictReport = {
+    kind: MetadataKindId;
+    id: string;
+    left: DefinitionProvenance;
+    right: DefinitionProvenance;
+    reason: string;
+};
+export type ResolveIssue = {
+    code: string;
+    message: string;
+    agentId?: string;
+    path?: string[];
+};
+export type EffectiveMetadataResult = {
+    ok: boolean;
+    selectedAgentIds: string[];
+    collapsedAgentIds: string[];
+    issues: ResolveIssue[];
+    conflicts: ConflictReport[];
+    referenceIssues: ValidationIssue[];
+    effective: EffectiveDefinition[];
+    /** Composed pack used for post-composition reference validation. */
+    effectivePack: MetadataPack | null;
+};
+export type RawAgentView = {
+    agentId: string;
+    agent: AgentDefinition | null;
+    pack: MetadataPack | null;
+    issues: ResolveIssue[];
+};
+/**
+ * Drop ancestors when a descendant is also selected.
+ * Remaining set is sorted for deterministic processing (not precedence).
+ */
+export declare function collapseAncestorSelections(selectedAgentIds: string[], agents: Map<string, AgentDefinition>): string[];
+/**
+ * Resolve single-parent chain oldest-parent-first.
+ */
+export declare function resolveParentChain(agentId: string, agents: Map<string, AgentDefinition>): {
+    ok: true;
+    chain: string[];
+} | {
+    ok: false;
+    issues: ResolveIssue[];
+};
+/**
+ * Resolve effective metadata for selected agentIds[].
+ * Array order never confers precedence; output is deterministic.
+ */
+export declare function resolveEffectiveMetadata(input: {
+    agentIds: string[];
+    packsByAgentId: Record<string, MetadataPack>;
+}): EffectiveMetadataResult;
+/** Raw (unresolved) view of a single agent's pack. */
+export declare function getRawAgentView(agentId: string, packsByAgentId: Record<string, MetadataPack>): RawAgentView;
+/** @deprecated use resolveEffectiveMetadata */
+export declare function resolveMultiAgentMetadata(input: {
+    agentIds: string[];
+    packsByAgentId: Record<string, MetadataPack>;
+}): EffectiveMetadataResult;
+//# sourceMappingURL=resolve.d.ts.map