@x12i/memorix-format 2.2.2 → 2.3.2

package/dist/v2/migrate-present.d.ts

@@ -0,0 +1,47 @@
+import { type MemorixRecordV2 } from "./types.js";
+export type MigratePresentToV2Options = {
+    objectType: string;
+    contentType: string;
+    dataCategory: "entity" | "event" | "knowledge";
+    /** Defaults to 1 when absent on present records. */
+    revision?: number;
+    /** ISO timestamps fallback when _system lacks them. */
+    now?: string;
+    /**
+     * Strip associated* from the V2 record (default true).
+     * Extracted relationship candidates are always produced regardless.
+     */
+    dropAssociated?: boolean;
+    /** Issuer for primary identifier when not inferable. */
+    defaultIssuer?: string;
+    /**
+     * Optional map of legacy associated* property → relationshipDefinitionId.
+     * Unmapped properties stay pending-metadata-resolution.
+     */
+    associatedPropertyMap?: Record<string, string>;
+};
+export type ExtractedRelationship = {
+    sourceRecordId: string;
+    legacyProperty: string;
+    targetRecordId: string | null;
+    relationshipDefinitionId: string | null;
+    status: "mapped" | "pending-metadata-resolution" | "quarantined-missing-recordId";
+    /** Business payload keys dropped from the association item (never copied into V2). */
+    droppedPayloadKeys?: string[];
+};
+export type MigratePresentToV2Result = {
+    /** True when a V2 envelope was produced (may still need validateMemorixRecordV2). */
+    ok: boolean;
+    v2: MemorixRecordV2;
+    extractedRelationships: ExtractedRelationship[];
+    warnings: string[];
+};
+/**
+ * Convert a present (or legacy→present) record into memorix-record/2 plus
+ * out-of-band extracted relationship candidates.
+ */
+export declare function migratePresentToV2(input: unknown, options: MigratePresentToV2Options): MigratePresentToV2Result;
+/** Convenience: return only the V2 record (relationships discarded — prefer migratePresentToV2). */
+export declare function migratePresentToV2Record(input: unknown, options: MigratePresentToV2Options): MemorixRecordV2;
+export declare function migratePresentRecordsToV2(inputs: unknown[], options: MigratePresentToV2Options): MigratePresentToV2Result[];
+//# sourceMappingURL=migrate-present.d.ts.map

package/dist/v2/migrate-present.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-present.d.ts","sourceRoot":"","sources":["../../src/v2/migrate-present.ts"],"names":[],"mappings":"AAQA,OAAO,EAA4B,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAE5E,MAAM,MAAM,yBAAyB,GAAG;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,QAAQ,GAAG,OAAO,GAAG,WAAW,CAAC;IAC/C,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,MAAM,EACF,QAAQ,GACR,6BAA6B,GAC7B,8BAA8B,CAAC;IACnC,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,qFAAqF;IACrF,EAAE,EAAE,OAAO,CAAC;IACZ,EAAE,EAAE,eAAe,CAAC;IACpB,sBAAsB,EAAE,qBAAqB,EAAE,CAAC;IAChD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AA2HF;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,yBAAyB,GACjC,wBAAwB,CAsH1B;AAED,oGAAoG;AACpG,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,yBAAyB,GACjC,eAAe,CAEjB;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,EAAE,EACjB,OAAO,EAAE,yBAAyB,GACjC,wBAAwB,EAAE,CAE5B"}

package/dist/v2/migrate-present.js

@@ -0,0 +1,225 @@
+/**
+ * Migrate present Memorix envelopes → memorix-record/2.
+ *
+ * Copied associated* payloads are stripped from the V2 record, but every
+ * resolvable target recordId is preserved out-of-band in extractedRelationships.
+ * Physical relationship storage is NOT written here (Gate G4).
+ */
+import { migrateMemorixRecord } from "../migrate.js";
+import { MEMORIX_RECORD_FORMAT_V2 } from "./types.js";
+function isPlainObject(v) {
+    return v !== null && typeof v === "object" && !Array.isArray(v);
+}
+function asObject(v) {
+    return isPlainObject(v) ? { ...v } : {};
+}
+function stringify(v) {
+    if (typeof v === "string" && v.trim())
+        return v.trim();
+    if (typeof v === "number" || typeof v === "boolean")
+        return String(v);
+    return undefined;
+}
+const LIGHTWEIGHT_REF_KEYS = new Set([
+    "recordId",
+    "relationshipId",
+    "relationshipDefinitionId",
+]);
+function primaryFromExtIdentifier(ext, recordId, defaultIssuer, warnings) {
+    const kind = stringify(ext.kind) ?? "recordId";
+    const kindNamed = stringify(ext[kind]);
+    const value = kindNamed ??
+        stringify(ext.value) ??
+        stringify(ext.key)?.split(":").slice(1).join(":") ??
+        recordId;
+    if (!kindNamed && !stringify(ext.value) && warnings) {
+        warnings.push(`Primary identifier kind '${kind}' had no kind-named value; fell back to '${value}'.`);
+    }
+    const primary = {
+        kind,
+        value,
+    };
+    const issuer = stringify(ext.issuer) ?? defaultIssuer;
+    if (issuer)
+        primary.issuer = issuer;
+    const normalized = stringify(ext.normalizedValue);
+    if (normalized)
+        primary.normalizedValue = normalized;
+    return primary;
+}
+function extractTargetRecordId(item) {
+    return (stringify(item.recordId) ??
+        stringify(item.targetRecordId) ??
+        stringify(item.id) ??
+        null);
+}
+function extractRelationshipsFromPresent(present, sourceRecordId, associatedPropertyMap) {
+    const extracted = [];
+    const warnings = [];
+    for (const [key, value] of Object.entries(present)) {
+        if (!key.startsWith("associated"))
+            continue;
+        if (!Array.isArray(value)) {
+            warnings.push(`Legacy property ${key} is not an array; skipped extraction.`);
+            continue;
+        }
+        const defId = associatedPropertyMap?.[key] ?? null;
+        for (const raw of value) {
+            if (!isPlainObject(raw)) {
+                extracted.push({
+                    sourceRecordId,
+                    legacyProperty: key,
+                    targetRecordId: null,
+                    relationshipDefinitionId: defId,
+                    status: "quarantined-missing-recordId",
+                });
+                warnings.push(`Non-object item under ${key}; quarantined.`);
+                continue;
+            }
+            const targetRecordId = extractTargetRecordId(raw);
+            const droppedPayloadKeys = Object.keys(raw).filter((k) => !LIGHTWEIGHT_REF_KEYS.has(k));
+            if (!targetRecordId) {
+                extracted.push({
+                    sourceRecordId,
+                    legacyProperty: key,
+                    targetRecordId: null,
+                    relationshipDefinitionId: defId,
+                    status: "quarantined-missing-recordId",
+                    droppedPayloadKeys: droppedPayloadKeys.length ? droppedPayloadKeys : undefined,
+                });
+                warnings.push(`Association under ${key} lacks target recordId; quarantined for metadata-assisted migration.`);
+                continue;
+            }
+            extracted.push({
+                sourceRecordId,
+                legacyProperty: key,
+                targetRecordId,
+                relationshipDefinitionId: defId,
+                status: defId ? "mapped" : "pending-metadata-resolution",
+                droppedPayloadKeys: droppedPayloadKeys.length ? droppedPayloadKeys : undefined,
+            });
+        }
+    }
+    if (extracted.length > 0) {
+        warnings.push("Relationship storage authoritative model is Gate G4 Candidate C (central per-category collections); extracted relationships were not persisted on the V2 record. Option A lightweight roots remain format-valid but are not authoritative storage.");
+    }
+    return { extracted, warnings };
+}
+/**
+ * Convert a present (or legacy→present) record into memorix-record/2 plus
+ * out-of-band extracted relationship candidates.
+ */
+export function migratePresentToV2(input, options) {
+    const warnings = [];
+    const present = migrateMemorixRecord(input);
+    const now = options.now ?? new Date().toISOString();
+    const recordId = stringify(present.recordId) ?? "unknown";
+    if (!stringify(present.recordId)) {
+        warnings.push("recordId missing on input; used 'unknown'.");
+    }
+    const conceptIn = asObject(present.concept);
+    const ext = asObject(conceptIn._extIdentifier);
+    const title = stringify(conceptIn.title) ?? recordId;
+    const sysIn = asObject(present._system);
+    if (!stringify(sysIn.createdAt)) {
+        warnings.push(`createdAt missing; defaulted to ${now}.`);
+    }
+    if (!stringify(sysIn.modifiedAt) && !stringify(sysIn.createdAt)) {
+        warnings.push(`modifiedAt missing; defaulted to createdAt/now.`);
+    }
+    const createdAt = stringify(sysIn.createdAt) ?? now;
+    const modifiedAt = stringify(sysIn.modifiedAt) ?? createdAt;
+    const observedAt = stringify(sysIn.observedAt);
+    const state = stringify(sysIn.state) === "archived" ||
+        stringify(sysIn.state) === "superseded" ||
+        stringify(sysIn.state) === "active"
+        ? stringify(sysIn.state)
+        : "active";
+    const lifecycle = Array.isArray(sysIn.lifecycle) ? sysIn.lifecycle : undefined;
+    const provenance = isPlainObject(sysIn.provenance) ? sysIn.provenance : undefined;
+    const { extracted, warnings: relWarnings } = extractRelationshipsFromPresent(present, recordId, options.associatedPropertyMap);
+    warnings.push(...relWarnings);
+    const dropAssociated = options.dropAssociated !== false;
+    if (dropAssociated) {
+        for (const key of Object.keys(present)) {
+            if (key.startsWith("associated"))
+                delete present[key];
+        }
+    }
+    const allowBuckets = options.contentType === "snapshots" || options.contentType === "knowledge";
+    // Capture unrecognized non-associated open roots that are not snapshot buckets / core.
+    const known = new Set([
+        "recordId",
+        "concept",
+        "data",
+        "_system",
+        "_id",
+        "analytics",
+        "enrichment",
+        "insights",
+        "format",
+        "revision",
+        "objectType",
+        "contentType",
+        "dataCategory",
+    ]);
+    for (const key of Object.keys(present)) {
+        if (key.startsWith("associated"))
+            continue;
+        if (key.startsWith("_") && key !== "_system" && key !== "_id") {
+            warnings.push(`Unrecognized machine root '${key}' was dropped (not migrated onto subject).`);
+            delete present[key];
+        }
+        else if (!known.has(key) && !key.startsWith("_")) {
+            warnings.push(`Unrecognized root '${key}' was dropped from V2 migration.`);
+            delete present[key];
+        }
+    }
+    const out = {
+        format: MEMORIX_RECORD_FORMAT_V2,
+        recordId,
+        revision: options.revision ?? 1,
+        objectType: options.objectType,
+        contentType: options.contentType,
+        dataCategory: options.dataCategory,
+        concept: {
+            title,
+            identifiers: {
+                primary: primaryFromExtIdentifier(ext, recordId, options.defaultIssuer, warnings),
+            },
+        },
+        data: asObject(present.data),
+        _system: {
+            state,
+            createdAt,
+            modifiedAt,
+            ...(observedAt ? { observedAt } : {}),
+            ...(lifecycle && lifecycle.length > 0
+                ? { lifecycle: lifecycle }
+                : {}),
+            ...(provenance && Object.keys(provenance).length > 0 ? { provenance } : {}),
+        },
+    };
+    if (allowBuckets) {
+        for (const bucket of ["analytics", "enrichment", "insights"]) {
+            const val = present[bucket];
+            if (isPlainObject(val) && Object.keys(val).length > 0) {
+                out[bucket] = val;
+            }
+        }
+    }
+    return {
+        ok: true,
+        v2: out,
+        extractedRelationships: extracted,
+        warnings,
+    };
+}
+/** Convenience: return only the V2 record (relationships discarded — prefer migratePresentToV2). */
+export function migratePresentToV2Record(input, options) {
+    return migratePresentToV2(input, options).v2;
+}
+export function migratePresentRecordsToV2(inputs, options) {
+    return inputs.map((input) => migratePresentToV2(input, options));
+}
+//# sourceMappingURL=migrate-present.js.map

package/dist/v2/migrate-present.js.map

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

package/dist/v2/profiles.d.ts

@@ -0,0 +1,9 @@
+import type { ContentTypeProfileV2 } from "./types.js";
+export declare const DATA_CATEGORIES: readonly ["entity", "event", "knowledge"];
+export declare const RECORD_STATES: readonly ["active", "archived", "superseded"];
+/** Fixed envelope roots for memorix-record/2. */
+export declare const V2_FIXED_ROOTS: readonly ["format", "recordId", "revision", "objectType", "contentType", "dataCategory", "concept", "data", "_system", "_id"];
+export declare const V2_SNAPSHOT_BUCKETS: readonly ["analytics", "enrichment", "insights"];
+export declare const BUILTIN_CONTENT_PROFILES: Record<string, ContentTypeProfileV2>;
+export declare function resolveContentProfile(contentType: string | undefined, override?: ContentTypeProfileV2): ContentTypeProfileV2;
+//# sourceMappingURL=profiles.d.ts.map

package/dist/v2/profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/v2/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,eAAO,MAAM,eAAe,2CAA4C,CAAC;AACzE,eAAO,MAAM,aAAa,+CAAgD,CAAC;AAE3E,iDAAiD;AACjD,eAAO,MAAM,cAAc,+HAWjB,CAAC;AAEX,eAAO,MAAM,mBAAmB,kDAAmD,CAAC;AAEpF,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAoCzE,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,oBAAoB,CAStB"}

package/dist/v2/profiles.js

@@ -0,0 +1,63 @@
+export const DATA_CATEGORIES = ["entity", "event", "knowledge"];
+export const RECORD_STATES = ["active", "archived", "superseded"];
+/** Fixed envelope roots for memorix-record/2. */
+export const V2_FIXED_ROOTS = [
+    "format",
+    "recordId",
+    "revision",
+    "objectType",
+    "contentType",
+    "dataCategory",
+    "concept",
+    "data",
+    "_system",
+    "_id",
+];
+export const V2_SNAPSHOT_BUCKETS = ["analytics", "enrichment", "insights"];
+export const BUILTIN_CONTENT_PROFILES = {
+    raw: { contentType: "raw", allowSnapshotBuckets: false },
+    snapshots: { contentType: "snapshots", allowSnapshotBuckets: true },
+    discovery: {
+        contentType: "discovery",
+        allowSnapshotBuckets: false,
+        discriminator: {
+            path: "data.discoveryType",
+            required: false,
+            defaultValue: "default",
+        },
+    },
+    analysis: {
+        contentType: "analysis",
+        allowSnapshotBuckets: false,
+        discriminator: {
+            path: "data.analysisType",
+            required: false,
+            defaultValue: "default",
+        },
+    },
+    decisions: {
+        contentType: "decisions",
+        allowSnapshotBuckets: false,
+        discriminator: {
+            path: "data.decisionType",
+            required: false,
+            defaultValue: "default",
+        },
+    },
+    workflow: { contentType: "workflow", allowSnapshotBuckets: false },
+    context: { contentType: "context", allowSnapshotBuckets: false },
+    /** Relationships sibling content — format-valid; authoritative storage is G4 Candidate C (central collections). */
+    relationships: { contentType: "relationships", allowSnapshotBuckets: false },
+    events: { contentType: "events", allowSnapshotBuckets: false },
+    knowledge: { contentType: "knowledge", allowSnapshotBuckets: true },
+};
+export function resolveContentProfile(contentType, override) {
+    if (override)
+        return override;
+    const ct = contentType?.trim() || "snapshots";
+    return (BUILTIN_CONTENT_PROFILES[ct] ?? {
+        contentType: ct,
+        allowSnapshotBuckets: ct === "snapshots",
+    });
+}
+//# sourceMappingURL=profiles.js.map

package/dist/v2/profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../src/v2/profiles.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAU,CAAC;AACzE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,YAAY,CAAU,CAAC;AAE3E,iDAAiD;AACjD,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,QAAQ;IACR,UAAU;IACV,UAAU;IACV,YAAY;IACZ,aAAa;IACb,cAAc;IACd,SAAS;IACT,MAAM;IACN,SAAS;IACT,KAAK;CACG,CAAC;AAEX,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,WAAW,EAAE,YAAY,EAAE,UAAU,CAAU,CAAC;AAEpF,MAAM,CAAC,MAAM,wBAAwB,GAAyC;IAC5E,GAAG,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE;IACxD,SAAS,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,oBAAoB,EAAE,IAAI,EAAE;IACnE,SAAS,EAAE;QACT,WAAW,EAAE,WAAW;QACxB,oBAAoB,EAAE,KAAK;QAC3B,aAAa,EAAE;YACb,IAAI,EAAE,oBAAoB;YAC1B,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,SAAS;SACxB;KACF;IACD,QAAQ,EAAE;QACR,WAAW,EAAE,UAAU;QACvB,oBAAoB,EAAE,KAAK;QAC3B,aAAa,EAAE;YACb,IAAI,EAAE,mBAAmB;YACzB,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,SAAS;SACxB;KACF;IACD,SAAS,EAAE;QACT,WAAW,EAAE,WAAW;QACxB,oBAAoB,EAAE,KAAK;QAC3B,aAAa,EAAE;YACb,IAAI,EAAE,mBAAmB;YACzB,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,SAAS;SACxB;KACF;IACD,QAAQ,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,oBAAoB,EAAE,KAAK,EAAE;IAClE,OAAO,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,oBAAoB,EAAE,KAAK,EAAE;IAChE,mHAAmH;IACnH,aAAa,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE,oBAAoB,EAAE,KAAK,EAAE;IAC5E,MAAM,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE;IAC9D,SAAS,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,oBAAoB,EAAE,IAAI,EAAE;CACpE,CAAC;AAEF,MAAM,UAAU,qBAAqB,CACnC,WAA+B,EAC/B,QAA+B;IAE/B,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,EAAE,GAAG,WAAW,EAAE,IAAI,EAAE,IAAI,WAAW,CAAC;IAC9C,OAAO,CACL,wBAAwB,CAAC,EAAE,CAAC,IAAI;QAC9B,WAAW,EAAE,EAAE;QACf,oBAAoB,EAAE,EAAE,KAAK,WAAW;KACzC,CACF,CAAC;AACJ,CAAC"}

package/dist/v2/revision.d.ts

@@ -0,0 +1,24 @@
+import type { MemorixLifecycleEvent, MemorixRecordV2 } from "./types.js";
+/**
+ * Revision vs lifecycle contract helpers (Gate G2 evidence).
+ * Writers own persistence; these pure helpers document expected mutation rules.
+ */
+export type RevisionCheckResult = {
+    ok: boolean;
+    reason?: string;
+};
+/** Reject stale expected revision (optimistic concurrency). */
+export declare function checkExpectedRevision(current: Pick<MemorixRecordV2, "revision">, expectedRevision: number): RevisionCheckResult;
+/** Next revision after a successful mutation. */
+export declare function nextRevision(current: number): number;
+/**
+ * Apply a successful mutation: always bumps revision; appends lifecycle only when provided.
+ * A revision may change with no lifecycle entry.
+ */
+export declare function applySuccessfulMutation(record: MemorixRecordV2, args: {
+    expectedRevision: number;
+    modifiedAt: string;
+    lifecycleEvent?: MemorixLifecycleEvent;
+    data?: Record<string, unknown>;
+}): MemorixRecordV2;
+//# sourceMappingURL=revision.d.ts.map

package/dist/v2/revision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revision.d.ts","sourceRoot":"","sources":["../../src/v2/revision.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEzE;;;GAGG;AAEH,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,+DAA+D;AAC/D,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,EAC1C,gBAAgB,EAAE,MAAM,GACvB,mBAAmB,CAWrB;AAED,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE;IACJ,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,GACA,eAAe,CAkBjB"}

package/dist/v2/revision.js

@@ -0,0 +1,44 @@
+/** Reject stale expected revision (optimistic concurrency). */
+export function checkExpectedRevision(current, expectedRevision) {
+    if (!Number.isInteger(expectedRevision) || expectedRevision < 1) {
+        return { ok: false, reason: "expectedRevision must be an integer >= 1" };
+    }
+    if (current.revision !== expectedRevision) {
+        return {
+            ok: false,
+            reason: `stale revision: expected ${expectedRevision}, current ${current.revision}`,
+        };
+    }
+    return { ok: true };
+}
+/** Next revision after a successful mutation. */
+export function nextRevision(current) {
+    if (!Number.isInteger(current) || current < 1) {
+        throw new Error("current revision must be an integer >= 1");
+    }
+    return current + 1;
+}
+/**
+ * Apply a successful mutation: always bumps revision; appends lifecycle only when provided.
+ * A revision may change with no lifecycle entry.
+ */
+export function applySuccessfulMutation(record, args) {
+    const check = checkExpectedRevision(record, args.expectedRevision);
+    if (!check.ok) {
+        throw new Error(check.reason);
+    }
+    const lifecycle = args.lifecycleEvent
+        ? [...(record._system.lifecycle ?? []), args.lifecycleEvent]
+        : record._system.lifecycle;
+    return {
+        ...record,
+        revision: nextRevision(record.revision),
+        ...(args.data ? { data: args.data } : {}),
+        _system: {
+            ...record._system,
+            modifiedAt: args.modifiedAt,
+            ...(lifecycle && lifecycle.length > 0 ? { lifecycle } : { lifecycle: undefined }),
+        },
+    };
+}
+//# sourceMappingURL=revision.js.map

package/dist/v2/revision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revision.js","sourceRoot":"","sources":["../../src/v2/revision.ts"],"names":[],"mappings":"AAYA,+DAA+D;AAC/D,MAAM,UAAU,qBAAqB,CACnC,OAA0C,EAC1C,gBAAwB;IAExB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,IAAI,gBAAgB,GAAG,CAAC,EAAE,CAAC;QAChE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,0CAA0C,EAAE,CAAC;IAC3E,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,KAAK,gBAAgB,EAAE,CAAC;QAC1C,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,4BAA4B,gBAAgB,aAAa,OAAO,CAAC,QAAQ,EAAE;SACpF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,OAAO,GAAG,CAAC,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAuB,EACvB,IAKC;IAED,MAAM,KAAK,GAAG,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACnE,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc;QACnC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC;QAC5D,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;IAC7B,OAAO;QACL,GAAG,MAAM;QACT,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC;QACvC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,OAAO,EAAE;YACP,GAAG,MAAM,CAAC,OAAO;YACjB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,GAAG,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;SAClF;KACF,CAAC;AACJ,CAAC"}

package/dist/v2/types.d.ts

@@ -0,0 +1,94 @@
+/** memorix-record/2 — canonical contract (Gate G2). */
+export declare const MEMORIX_RECORD_FORMAT_V2: "memorix-record/2";
+export type MemorixRecordFormatV2 = typeof MEMORIX_RECORD_FORMAT_V2;
+export type MemorixDataCategory = "entity" | "event" | "knowledge";
+export type MemorixRecordState = "active" | "archived" | "superseded";
+export type MemorixIdentifier = {
+    kind: string;
+    value: string;
+    issuer?: string;
+    normalizedValue?: string;
+};
+export type MemorixConceptV2 = {
+    title: string;
+    identifiers: {
+        primary: MemorixIdentifier;
+        alternates?: MemorixIdentifier[];
+    };
+};
+export type MemorixLifecycleEvent = {
+    process: string;
+    processedAt: string;
+};
+export type MemorixSystemBlockV2 = {
+    state: MemorixRecordState;
+    createdAt: string;
+    modifiedAt: string;
+    observedAt?: string;
+    lifecycle?: MemorixLifecycleEvent[];
+    provenance?: Record<string, unknown>;
+};
+/**
+ * Snapshot-only optional buckets. Omit when unused — never emit empty `{}`.
+ * Not allowed on non-snapshot content types.
+ */
+export type MemorixSnapshotBuckets = {
+    analytics?: Record<string, unknown>;
+    enrichment?: Record<string, unknown>;
+    insights?: Record<string, unknown>;
+};
+export type MemorixRecordV2 = {
+    format: MemorixRecordFormatV2;
+    recordId: string;
+    revision: number;
+    objectType: string;
+    contentType: string;
+    dataCategory: MemorixDataCategory;
+    concept: MemorixConceptV2;
+    data: Record<string, unknown>;
+    analytics?: Record<string, unknown>;
+    enrichment?: Record<string, unknown>;
+    insights?: Record<string, unknown>;
+    _system: MemorixSystemBlockV2;
+    /** Storage-only; ignored by format law. */
+    _id?: string;
+};
+export type ContentDiscriminator = {
+    path: string;
+    required: boolean;
+    defaultValue?: string;
+    allowedValues?: string[];
+};
+export type ContentTypeProfileV2 = {
+    contentType: string;
+    /** When true, analytics/enrichment/insights may appear (if non-empty). */
+    allowSnapshotBuckets: boolean;
+    discriminator?: ContentDiscriminator;
+    /** Extra allowed root keys beyond the fixed envelope (rare). */
+    allowedExtraRoots?: string[];
+};
+export type ValidateV2Options = {
+    /** Expected objectType (warn/error if mismatch when set). */
+    objectType?: string;
+    /** Expected contentType. */
+    contentType?: string;
+    /** Profile overrides built-in content-type rules. */
+    profile?: ContentTypeProfileV2;
+    /** When true, unknown roots are errors (default true). */
+    rejectUnknownRoots?: boolean;
+    /** Require discriminator when profile declares one. */
+    enforceDiscriminator?: boolean;
+};
+export type ValidationSeverity = "error" | "warning";
+export type ValidationIssue = {
+    path: string;
+    code: string;
+    message: string;
+    severity: ValidationSeverity;
+};
+export type ValidateV2Result = {
+    ok: boolean;
+    issues: ValidationIssue[];
+    record?: MemorixRecordV2;
+};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/v2/types.js

@@ -0,0 +1,3 @@
+/** memorix-record/2 — canonical contract (Gate G2). */
+export const MEMORIX_RECORD_FORMAT_V2 = "memorix-record/2";
+//# sourceMappingURL=types.js.map

package/dist/v2/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/v2/types.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,MAAM,CAAC,MAAM,wBAAwB,GAAG,kBAA2B,CAAC"}

package/dist/v2/validate.d.ts

@@ -0,0 +1,8 @@
+import { type ValidateV2Options, type ValidateV2Result } from "./types.js";
+/**
+ * Validate a memorix-record/2 document.
+ * Empty optional snapshot buckets must be omitted (not `{}`).
+ */
+export declare function validateMemorixRecordV2(input: unknown, options?: ValidateV2Options): ValidateV2Result;
+export declare function validateMemorixRecordsV2(inputs: unknown[], options?: ValidateV2Options): ValidateV2Result[];
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/v2/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAEtB,MAAM,YAAY,CAAC;AAoCpB;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,CAkSlB;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,OAAO,EAAE,EACjB,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,EAAE,CAEpB"}