@x12i/memorix-format

Canonical memorix-record/2 validation, migration, and CLI for Memorix.

Object / content types belong in agent metadata — this package is the envelope SoT (shape of every stored subject content document), not product vocabulary.

Install

npm install @x12i/[email protected]

| Audience | Use this package? | |----------|-------------------| | Remote app | Optional — validate offline / in CI | | Platform / writers / pipelines | Yes |

API status

| API | Status | |-----|--------| | validateMemorixRecordV2, CLI validate-v2 / migrate-to-v2 | Current SoT for platform work | | Present-envelope helpers | Migration / compat only |

Exports: . · ./validate · ./profiles · ./types · ./v2

Quick V2 example

{
  "format": "memorix-record/2",
  "recordId": "wi-100",
  "revision": 3,
  "objectType": "work-items",
  "contentType": "snapshots",
  "dataCategory": "entity",
  "concept": {
    "title": "Prepare quarterly operations review",
    "identifiers": {
      "primary": { "kind": "workItemId", "value": "WI-100", "issuer": "opx-source" }
    }
  },
  "data": { "status": "in-progress", "priority": "normal" },
  "_system": {
    "state": "active",
    "createdAt": "2026-01-10T10:00:00.000Z",
    "modifiedAt": "2026-01-15T12:00:00.000Z"
  }
}

npx memorix-format validate-v2 examples/v2
npx memorix-format migrate-to-v2 ./present.json \
  --object-type=work-items --content-type=snapshots --data-category=entity

import { validateMemorixRecordV2 } from "@x12i/memorix-format/v2";

const result = validateMemorixRecordV2(doc);
if (!result.ok) throw new Error(result.errors.join("; "));

Hard rules (format)

• V2 rejects copied related-record payloads in the document.
• Authoritative navigation between subjects is four-field relationship links (@x12i/memorix-relationships), not embedded associated*.

Docs

• docs/memorix-record-v2.md · meta/
• Ebook: Format for Dummies
• Hub: https://docs.memorix.x12i.com

npm test