@x12i/memorix-format 1.0.0

package/README.md

@@ -0,0 +1,90 @@
+# @x12i/memorix-format
+
+Memorix record format as an npm package: **types**, **validator**, **CLI**, and the **specification docs**.
+
+Canonical envelope: [docs/memorix-format.md](./docs/memorix-format.md).
+
+## Install
+
+```bash
+npm install @x12i/memorix-format
+```
+
+## SDK
+
+```ts
+import {
+  validateMemorixRecord,
+  inspectMemorixRecord,
+  buildConceptIdentifier,
+  buildAssociatedPropertyName,
+} from "@x12i/memorix-format";
+
+const result = validateMemorixRecord(record, { contentType: "snapshots" });
+if (!result.ok) {
+  console.error(result.issues);
+}
+
+const id = buildConceptIdentifier("ipAddress", "10.100.18.64");
+const prop = buildAssociatedPropertyName({
+  form: "content",
+  objectType: "vulnerabilities",
+  contentType: "analysis",
+});
+```
+
+### Exports
+
+| Import | Purpose |
+|---|---|
+| `@x12i/memorix-format` | Types, validate, inspect, concept + associated helpers |
+| `@x12i/memorix-format/validate` | Validator only |
+| `@x12i/memorix-format/types` | Type-only surface |
+
+### Validation rules (clean envelope)
+
+- Required: `recordId`, `concept` (with `identifier` + `title`), `data` (object)
+- `concept.identifier` requires `kind`, kind-named value, and `identifierKey`
+- `analytics` / `enrichment` / `insights` must be objects when present
+- `associated*` properties must be arrays of objects (omit when empty)
+- Legacy roots (`identity`, root `lifecycle`, `sourceFacts`, …) are errors unless `--allow-legacy`
+- With `--content-type` other than `snapshots`, associated*/analytics/enrichment/insights are rejected
+
+## CLI
+
+```bash
+npx memorix-format validate ./record.json
+npx memorix-format validate ./records.ndjson --content-type=snapshots --json
+npx memorix-format inspect ./record.json
+npx memorix-format docs
+npx memorix-format docs memorix-format.md
+```
+
+Exit codes: `0` ok, `1` validation failed, `2` usage/parse error.
+
+## Packaged documentation
+
+| Doc | Topic |
+|---|---|
+| [memorix-format.md](./docs/memorix-format.md) | Canonical clean record envelope |
+| [memorix-format-additions.md](./docs/memorix-format-additions.md) | `data` / `associatedData` / `analytics` / `insights` semantics |
+| [association-format.md](./docs/association-format.md) | `associated*` naming and materialization |
+| [memorix-workflow-format.md](./docs/memorix-workflow-format.md) | `memorix-workflow/1` |
+| [memorix-format-for-dummies-association-corrections.md](./docs/memorix-format-for-dummies-association-corrections.md) | Association corrections |
+
+## Develop
+
+```bash
+cd memorix-format
+npm install
+npm test
+npm run build
+```
+
+## Publish
+
+```bash
+cd memorix-format
+npm run build && npm test
+npm publish --access public
+```

package/dist/associated.d.ts

@@ -0,0 +1,38 @@
+export type AssociatedPropertyNameInput = {
+    form: "content";
+    objectType: string;
+    contentType: string;
+    top?: boolean;
+} | {
+    form: "snapshotsRootProperty";
+    objectType: string;
+    rootProperty: string;
+    top?: boolean;
+} | {
+    form: "enrichment";
+    objectType: string;
+    top?: boolean;
+} | {
+    form: "concepts";
+    objectType: string;
+    top?: boolean;
+} | {
+    form: "recordIds";
+    objectType: string;
+    top?: boolean;
+};
+/** True when a root key is an associated* property. */
+export declare function isAssociatedPropertyName(name: string): boolean;
+/** True when the property name follows the enrichment association convention. */
+export declare function isEnrichmentAssociatedPropertyName(name: string): boolean;
+/** True when the property name follows the ranked top association convention. */
+export declare function isTopAssociatedPropertyName(name: string): boolean;
+/** True for known legacy short associated names. */
+export declare function isLegacyAssociatedPropertyName(name: string): boolean;
+/** Build canonical v2 associated property name. */
+export declare function buildAssociatedPropertyName(input: AssociatedPropertyNameInput): string;
+/** Validate v2 associated property name conventions (throws on hard errors). */
+export declare function assertAssociatedPropertyName(name: string): void;
+/** List associated* keys present on a record root. */
+export declare function listAssociatedProperties(record: Record<string, unknown>): string[];
+//# sourceMappingURL=associated.d.ts.map

package/dist/associated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"associated.d.ts","sourceRoot":"","sources":["../src/associated.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,2BAA2B,GACnC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1F;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE7D,uDAAuD;AACvD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,iFAAiF;AACjF,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExE;AAED,iFAAiF;AACjF,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,oDAAoD;AACpD,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED,mDAAmD;AACnD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,2BAA2B,GAAG,MAAM,CAuBtF;AAED,gFAAgF;AAChF,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAO/D;AAED,sDAAsD;AACtD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAIlF"}

package/dist/associated.js

@@ -0,0 +1,59 @@
+import { LEGACY_ASSOCIATED_NAMES } from "./constants.js";
+import { pascalCaseObjectType } from "./utils.js";
+/** True when a root key is an associated* property. */
+export function isAssociatedPropertyName(name) {
+    return name.startsWith("associated");
+}
+/** True when the property name follows the enrichment association convention. */
+export function isEnrichmentAssociatedPropertyName(name) {
+    return /^associated(?:Top)?[A-Z][A-Za-z0-9]*Enrichment$/.test(name);
+}
+/** True when the property name follows the ranked top association convention. */
+export function isTopAssociatedPropertyName(name) {
+    return name.startsWith("associatedTop");
+}
+/** True for known legacy short associated names. */
+export function isLegacyAssociatedPropertyName(name) {
+    return LEGACY_ASSOCIATED_NAMES.has(name);
+}
+/** Build canonical v2 associated property name. */
+export function buildAssociatedPropertyName(input) {
+    const objectSegment = pascalCaseObjectType(input.objectType);
+    const topPrefix = input.top ? "Top" : "";
+    switch (input.form) {
+        case "content": {
+            const contentSegment = pascalCaseObjectType(input.contentType);
+            return `associated${topPrefix}${objectSegment}${contentSegment}`;
+        }
+        case "snapshotsRootProperty": {
+            const rootSegment = pascalCaseObjectType(input.rootProperty);
+            return `associated${topPrefix}${objectSegment}Snapshots${rootSegment}`;
+        }
+        case "enrichment":
+            return `associated${topPrefix}${objectSegment}Enrichment`;
+        case "concepts":
+            return `associated${topPrefix}${objectSegment}Concepts`;
+        case "recordIds":
+            return `associated${topPrefix}${objectSegment}RecordIds`;
+        default: {
+            const _exhaustive = input;
+            throw new Error(`Unsupported associated property name input: ${JSON.stringify(_exhaustive)}`);
+        }
+    }
+}
+/** Validate v2 associated property name conventions (throws on hard errors). */
+export function assertAssociatedPropertyName(name) {
+    if (!name.startsWith("associated")) {
+        throw new Error(`Associated property must start with "associated": ${name}`);
+    }
+    if (name.includes("RecordsIds")) {
+        throw new Error(`Use "RecordIds" not "RecordsIds": ${name}`);
+    }
+}
+/** List associated* keys present on a record root. */
+export function listAssociatedProperties(record) {
+    return Object.keys(record)
+        .filter(isAssociatedPropertyName)
+        .sort();
+}
+//# sourceMappingURL=associated.js.map

package/dist/associated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"associated.js","sourceRoot":"","sources":["../src/associated.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AASlD,uDAAuD;AACvD,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACvC,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,kCAAkC,CAAC,IAAY;IAC7D,OAAO,iDAAiD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtE,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,2BAA2B,CAAC,IAAY;IACtD,OAAO,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AAC1C,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,8BAA8B,CAAC,IAAY;IACzD,OAAO,uBAAuB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,2BAA2B,CAAC,KAAkC;IAC5E,MAAM,aAAa,GAAG,oBAAoB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACzC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,cAAc,GAAG,oBAAoB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC/D,OAAO,aAAa,SAAS,GAAG,aAAa,GAAG,cAAc,EAAE,CAAC;QACnE,CAAC;QACD,KAAK,uBAAuB,CAAC,CAAC,CAAC;YAC7B,MAAM,WAAW,GAAG,oBAAoB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YAC7D,OAAO,aAAa,SAAS,GAAG,aAAa,YAAY,WAAW,EAAE,CAAC;QACzE,CAAC;QACD,KAAK,YAAY;YACf,OAAO,aAAa,SAAS,GAAG,aAAa,YAAY,CAAC;QAC5D,KAAK,UAAU;YACb,OAAO,aAAa,SAAS,GAAG,aAAa,UAAU,CAAC;QAC1D,KAAK,WAAW;YACd,OAAO,aAAa,SAAS,GAAG,aAAa,WAAW,CAAC;QAC3D,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GAAU,KAAK,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,+CAA+C,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAChG,CAAC;IACH,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,4BAA4B,CAAC,IAAY;IACvD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,qDAAqD,IAAI,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,wBAAwB,CAAC,MAA+B;IACtE,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;SACvB,MAAM,CAAC,wBAAwB,CAAC;SAChC,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,199 @@
+#!/usr/bin/env node
+import { readFileSync, existsSync, readdirSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createRequire } from "node:module";
+import { inspectMemorixRecord } from "./inspect.js";
+import { parseRecordsJson, validateMemorixRecord } from "./validate.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+function packageVersion() {
+    try {
+        const pkg = require(join(__dirname, "..", "package.json"));
+        return pkg.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+function docsDir() {
+    const candidates = [
+        join(__dirname, "..", "docs"),
+        join(process.cwd(), "docs"),
+    ];
+    for (const dir of candidates) {
+        if (existsSync(dir))
+            return dir;
+    }
+    return candidates[0];
+}
+function printHelp() {
+    console.log(`memorix-format <command> [options]
+
+Memorix record format SDK + CLI (validate, inspect, docs).
+
+Commands:
+  validate [file|-]   Validate JSON / JSON array / NDJSON records
+  inspect  [file|-]   Summarize buckets and associated properties
+  docs [name]         List packaged specs, or print one by basename
+  version             Print package version
+  help                Show this help
+
+Validate / inspect options:
+  --content-type=<ct>       Hint content type (enforces snapshot-only buckets)
+  --allow-legacy            Warn on legacy 2.0 roots instead of erroring
+  --strict                  Fail on warnings as well as errors
+  --json                    Machine-readable JSON output
+
+Examples:
+  memorix-format validate ./record.json
+  memorix-format validate - --content-type=snapshots < records.ndjson
+  memorix-format inspect ./record.json --json
+  memorix-format docs memorix-format.md
+`);
+}
+function readFlag(args, name) {
+    const prefix = `--${name}=`;
+    const hit = args.find((a) => a.startsWith(prefix));
+    return hit?.slice(prefix.length);
+}
+function hasFlag(args, name) {
+    return args.includes(`--${name}`);
+}
+function readInput(pathArg) {
+    const path = pathArg && pathArg !== "-" ? resolve(pathArg) : null;
+    if (path) {
+        return readFileSync(path, "utf8");
+    }
+    return readFileSync(0, "utf8");
+}
+function buildValidateOptions(args) {
+    return {
+        contentType: readFlag(args, "content-type"),
+        allowLegacyEnvelope: hasFlag(args, "allow-legacy"),
+        strict: hasFlag(args, "strict"),
+    };
+}
+function runValidate(args) {
+    const positional = args.filter((a) => !a.startsWith("--"));
+    const file = positional[0];
+    const options = buildValidateOptions(args);
+    const asJson = hasFlag(args, "json");
+    let records;
+    try {
+        records = parseRecordsJson(readInput(file));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`Failed to parse input: ${message}`);
+        return 2;
+    }
+    if (records.length === 0) {
+        console.error("No records found in input");
+        return 2;
+    }
+    const results = records.map((r, i) => ({
+        index: i,
+        ...validateMemorixRecord(r, options),
+    }));
+    const ok = results.every((r) => r.ok);
+    if (asJson) {
+        console.log(JSON.stringify({ ok, count: results.length, results }, null, 2));
+    }
+    else {
+        for (const r of results) {
+            const label = r.recordId ?? `#${r.index}`;
+            if (r.ok) {
+                console.log(`OK  ${label}`);
+            }
+            else {
+                console.log(`FAIL ${label}`);
+            }
+            for (const issue of r.issues) {
+                console.log(`  [${issue.severity}] ${issue.path}: ${issue.message} (${issue.code})`);
+            }
+        }
+        console.log(`${ok ? "Passed" : "Failed"}: ${results.filter((r) => r.ok).length}/${results.length}`);
+    }
+    return ok ? 0 : 1;
+}
+function runInspect(args) {
+    const positional = args.filter((a) => !a.startsWith("--"));
+    const file = positional[0];
+    const asJson = hasFlag(args, "json");
+    let records;
+    try {
+        records = parseRecordsJson(readInput(file));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`Failed to parse input: ${message}`);
+        return 2;
+    }
+    const inspections = records.map((r, i) => ({
+        index: i,
+        ...inspectMemorixRecord(r),
+    }));
+    if (asJson) {
+        console.log(JSON.stringify({ count: inspections.length, records: inspections }, null, 2));
+        return 0;
+    }
+    for (const row of inspections) {
+        console.log(`#${row.index} recordId=${row.recordId ?? "(missing)"} concept=${row.conceptKind ?? "-"} title=${row.conceptTitle ?? "-"}`);
+        console.log(`  buckets: data=${row.buckets.data} analytics=${row.buckets.analytics} enrichment=${row.buckets.enrichment} insights=${row.buckets.insights} _system=${row.buckets.system}`);
+        console.log(`  associated: ${row.associatedProperties.length ? row.associatedProperties.join(", ") : "(none)"}`);
+        if (row.legacyRoots.length)
+            console.log(`  legacy roots: ${row.legacyRoots.join(", ")}`);
+        if (row.unknownRoots.length)
+            console.log(`  unknown roots: ${row.unknownRoots.join(", ")}`);
+    }
+    return 0;
+}
+function runDocs(args) {
+    const dir = docsDir();
+    const name = args.find((a) => !a.startsWith("--"));
+    if (!existsSync(dir)) {
+        console.error(`Docs directory not found: ${dir}`);
+        return 1;
+    }
+    if (!name) {
+        console.log(`Packaged Memorix format docs (${dir}):`);
+        for (const file of readdirSync(dir).sort()) {
+            if (file.endsWith(".md"))
+                console.log(`  ${file}`);
+        }
+        return 0;
+    }
+    const base = name.endsWith(".md") ? name : `${name}.md`;
+    const path = join(dir, base);
+    if (!existsSync(path)) {
+        console.error(`Doc not found: ${base}`);
+        console.error(`Available: ${readdirSync(dir).filter((f) => f.endsWith(".md")).join(", ")}`);
+        return 1;
+    }
+    process.stdout.write(readFileSync(path, "utf8"));
+    return 0;
+}
+async function main(argv) {
+    const [cmd, ...args] = argv;
+    if (!cmd || cmd === "help" || cmd === "--help" || cmd === "-h") {
+        printHelp();
+        return cmd ? 0 : 1;
+    }
+    if (cmd === "version" || cmd === "--version" || cmd === "-v") {
+        console.log(packageVersion());
+        return 0;
+    }
+    if (cmd === "validate")
+        return runValidate(args);
+    if (cmd === "inspect")
+        return runInspect(args);
+    if (cmd === "docs")
+        return runDocs(args);
+    console.error(`Unknown command: ${cmd}`);
+    printHelp();
+    return 2;
+}
+const exitCode = await main(process.argv.slice(2));
+process.exit(exitCode);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/concept.d.ts

@@ -0,0 +1,16 @@
+import type { JsonObject, MemorixConceptIdentifier } from "./types.js";
+/**
+ * Build deterministic identity string from an identifier object.
+ * Joins kind and value fields with ":" (e.g. ipAddress:10.100.18.64).
+ */
+export declare function buildIdentityString(identifier: Record<string, unknown>): string | null;
+/** Build a clean concept identifier with identifierKey. */
+export declare function buildConceptIdentifier(kind: string, value: string, extra?: Record<string, string>): MemorixConceptIdentifier;
+/** Read logical record id (clean root, then legacy identity block). */
+export declare function readRecordId(record: JsonObject): string;
+export declare function readConceptIdentifier(record: JsonObject): {
+    kind: string;
+    value: string;
+} | null;
+export declare function readConceptTitle(record: JsonObject): string | undefined;
+//# sourceMappingURL=concept.d.ts.map

package/dist/concept.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concept.d.ts","sourceRoot":"","sources":["../src/concept.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAGvE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAYtF;AAED,2DAA2D;AAC3D,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACjC,wBAAwB,CAU1B;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAYvD;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAmBxC;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAOvE"}

package/dist/concept.js

@@ -0,0 +1,75 @@
+import { isPlainObject, stringifyId } from "./utils.js";
+/**
+ * Build deterministic identity string from an identifier object.
+ * Joins kind and value fields with ":" (e.g. ipAddress:10.100.18.64).
+ */
+export function buildIdentityString(identifier) {
+    const kind = stringifyId(identifier.kind);
+    if (!kind)
+        return null;
+    if (identifier[kind] != null) {
+        return `${kind}:${String(identifier[kind])}`;
+    }
+    const parts = Object.keys(identifier)
+        .filter((key) => key !== "kind" && key !== "identifierKey")
+        .sort()
+        .map((key) => String(identifier[key]));
+    if (parts.length === 0)
+        return null;
+    return [kind, ...parts].join(":");
+}
+/** Build a clean concept identifier with identifierKey. */
+export function buildConceptIdentifier(kind, value, extra = {}) {
+    const identifier = {
+        kind,
+        [kind]: value,
+        ...extra,
+        identifierKey: "",
+    };
+    const key = buildIdentityString(identifier);
+    identifier.identifierKey = key ?? `${kind}:${value}`;
+    return identifier;
+}
+/** Read logical record id (clean root, then legacy identity block). */
+export function readRecordId(record) {
+    const root = stringifyId(record.recordId);
+    if (root)
+        return root;
+    const identity = record.identity;
+    if (isPlainObject(identity)) {
+        return (stringifyId(identity.recordId) ??
+            stringifyId(identity.targetId) ??
+            "");
+    }
+    return stringifyId(record._id) ?? "";
+}
+export function readConceptIdentifier(record) {
+    const concept = record.concept;
+    if (!isPlainObject(concept))
+        return null;
+    const identifier = concept.identifier;
+    if (isPlainObject(identifier)) {
+        const kind = stringifyId(identifier.kind);
+        if (kind && identifier[kind] != null) {
+            return { kind, value: String(identifier[kind]) };
+        }
+    }
+    // Legacy concept.name
+    const name = concept.name;
+    if (typeof name === "string" && name.trim()) {
+        const kind = stringifyId(concept.kind) ?? "name";
+        return { kind, value: name.trim() };
+    }
+    return null;
+}
+export function readConceptTitle(record) {
+    const concept = record.concept;
+    if (!isPlainObject(concept))
+        return undefined;
+    const title = stringifyId(concept.title);
+    if (title)
+        return title;
+    const id = readConceptIdentifier(record);
+    return id?.value;
+}
+//# sourceMappingURL=concept.js.map

package/dist/concept.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,21 @@
+/** Canonical clean-envelope field names. */
+export declare const RECORD_ID_FIELD: "recordId";
+export declare const CONCEPT_FIELD: "concept";
+export declare const DATA_FIELD: "data";
+export declare const ANALYTICS_FIELD: "analytics";
+export declare const ENRICHMENT_FIELD: "enrichment";
+export declare const INSIGHTS_FIELD: "insights";
+export declare const SYSTEM_FIELD: "_system";
+export declare const GRAPH_RUNS_FIELD: "_system._graphRuns";
+export declare const JOB_TYPE_RUNS_FIELD: "_system._jobTypeRuns";
+export declare const SYSTEM_LIFECYCLE_FIELD: "_system.lifecycle";
+/** Reserved root keys that are not associated* properties. */
+export declare const CANONICAL_ROOT_KEYS: Set<string>;
+/** Legacy Memorix 2.0 roots removed from the clean envelope. */
+export declare const LEGACY_ROOT_KEYS: Set<string>;
+/** Snapshot-only consumption buckets (clean format + additions appendix). */
+export declare const SNAPSHOT_ONLY_BUCKETS: readonly ["analytics", "enrichment", "insights"];
+/** Known legacy short associated property names. */
+export declare const LEGACY_ASSOCIATED_NAMES: Set<string>;
+export declare const DEFAULT_TOP_ASSOCIATED_ITEMS = 5;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,eAAO,MAAM,eAAe,EAAG,UAAmB,CAAC;AACnD,eAAO,MAAM,aAAa,EAAG,SAAkB,CAAC;AAChD,eAAO,MAAM,UAAU,EAAG,MAAe,CAAC;AAC1C,eAAO,MAAM,eAAe,EAAG,WAAoB,CAAC;AACpD,eAAO,MAAM,gBAAgB,EAAG,YAAqB,CAAC;AACtD,eAAO,MAAM,cAAc,EAAG,UAAmB,CAAC;AAClD,eAAO,MAAM,YAAY,EAAG,SAAkB,CAAC;AAE/C,eAAO,MAAM,gBAAgB,EAAG,oBAA6B,CAAC;AAC9D,eAAO,MAAM,mBAAmB,EAAG,sBAA+B,CAAC;AACnE,eAAO,MAAM,sBAAsB,EAAG,mBAA4B,CAAC;AAEnE,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB,aAS9B,CAAC;AAEH,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,aAO3B,CAAC;AAEH,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB,kDAIxB,CAAC;AAEX,oDAAoD;AACpD,eAAO,MAAM,uBAAuB,aAQlC,CAAC;AAEH,eAAO,MAAM,4BAA4B,IAAI,CAAC"}

package/dist/constants.js

@@ -0,0 +1,49 @@
+/** Canonical clean-envelope field names. */
+export const RECORD_ID_FIELD = "recordId";
+export const CONCEPT_FIELD = "concept";
+export const DATA_FIELD = "data";
+export const ANALYTICS_FIELD = "analytics";
+export const ENRICHMENT_FIELD = "enrichment";
+export const INSIGHTS_FIELD = "insights";
+export const SYSTEM_FIELD = "_system";
+export const GRAPH_RUNS_FIELD = "_system._graphRuns";
+export const JOB_TYPE_RUNS_FIELD = "_system._jobTypeRuns";
+export const SYSTEM_LIFECYCLE_FIELD = "_system.lifecycle";
+/** Reserved root keys that are not associated* properties. */
+export const CANONICAL_ROOT_KEYS = new Set([
+    "_id",
+    RECORD_ID_FIELD,
+    CONCEPT_FIELD,
+    DATA_FIELD,
+    ANALYTICS_FIELD,
+    ENRICHMENT_FIELD,
+    INSIGHTS_FIELD,
+    SYSTEM_FIELD,
+]);
+/** Legacy Memorix 2.0 roots removed from the clean envelope. */
+export const LEGACY_ROOT_KEYS = new Set([
+    "identity",
+    "lifecycle",
+    "sourceFacts",
+    "index",
+    "_graphRuns",
+    "_jobTypeRuns",
+]);
+/** Snapshot-only consumption buckets (clean format + additions appendix). */
+export const SNAPSHOT_ONLY_BUCKETS = [
+    ANALYTICS_FIELD,
+    ENRICHMENT_FIELD,
+    INSIGHTS_FIELD,
+];
+/** Known legacy short associated property names. */
+export const LEGACY_ASSOCIATED_NAMES = new Set([
+    "associatedData",
+    "associatedDiscovery",
+    "associatedAnalysis",
+    "associatedSiblings",
+    "associatedChildren",
+    "associatedAssets",
+    "associatedSubnets",
+]);
+export const DEFAULT_TOP_ASSOCIATED_ITEMS = 5;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,CAAC,MAAM,eAAe,GAAG,UAAmB,CAAC;AACnD,MAAM,CAAC,MAAM,aAAa,GAAG,SAAkB,CAAC;AAChD,MAAM,CAAC,MAAM,UAAU,GAAG,MAAe,CAAC;AAC1C,MAAM,CAAC,MAAM,eAAe,GAAG,WAAoB,CAAC;AACpD,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAqB,CAAC;AACtD,MAAM,CAAC,MAAM,cAAc,GAAG,UAAmB,CAAC;AAClD,MAAM,CAAC,MAAM,YAAY,GAAG,SAAkB,CAAC;AAE/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAA6B,CAAC;AAC9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,sBAA+B,CAAC;AACnE,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAA4B,CAAC;AAEnE,8DAA8D;AAC9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IACzC,KAAK;IACL,eAAe;IACf,aAAa;IACb,UAAU;IACV,eAAe;IACf,gBAAgB;IAChB,cAAc;IACd,YAAY;CACb,CAAC,CAAC;AAEH,gEAAgE;AAChE,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IACtC,UAAU;IACV,WAAW;IACX,aAAa;IACb,OAAO;IACP,YAAY;IACZ,cAAc;CACf,CAAC,CAAC;AAEH,6EAA6E;AAC7E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,eAAe;IACf,gBAAgB;IAChB,cAAc;CACN,CAAC;AAEX,oDAAoD;AACpD,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC;IAC7C,gBAAgB;IAChB,qBAAqB;IACrB,oBAAoB;IACpB,oBAAoB;IACpB,oBAAoB;IACpB,kBAAkB;IAClB,mBAAmB;CACpB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export type { JsonObject, MemorixConcept, MemorixConceptIdentifier, MemorixContentTypeHint, MemorixLifecycleEvent, MemorixRecord, MemorixSystemBlock, RecordInspection, ValidateRecordOptions, ValidateRecordResult, ValidationIssue, ValidationSeverity, } from "./types.js";
+export { ANALYTICS_FIELD, CANONICAL_ROOT_KEYS, CONCEPT_FIELD, DATA_FIELD, DEFAULT_TOP_ASSOCIATED_ITEMS, ENRICHMENT_FIELD, GRAPH_RUNS_FIELD, INSIGHTS_FIELD, JOB_TYPE_RUNS_FIELD, LEGACY_ASSOCIATED_NAMES, LEGACY_ROOT_KEYS, RECORD_ID_FIELD, SNAPSHOT_ONLY_BUCKETS, SYSTEM_FIELD, SYSTEM_LIFECYCLE_FIELD, } from "./constants.js";
+export { assertAssociatedPropertyName, buildAssociatedPropertyName, isAssociatedPropertyName, isEnrichmentAssociatedPropertyName, isLegacyAssociatedPropertyName, isTopAssociatedPropertyName, listAssociatedProperties, } from "./associated.js";
+export type { AssociatedPropertyNameInput } from "./associated.js";
+export { buildConceptIdentifier, buildIdentityString, readConceptIdentifier, readConceptTitle, readRecordId, } from "./concept.js";
+export { inspectMemorixRecord } from "./inspect.js";
+export { parseRecordsJson, validateMemorixRecord, validateMemorixRecords, } from "./validate.js";
+export { isPlainObject, pascalCaseObjectType, stringifyId } from "./utils.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,YAAY,EACV,UAAU,EACV,cAAc,EACd,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,4BAA4B,EAC5B,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,wBAAwB,EACxB,kCAAkC,EAClC,8BAA8B,EAC9B,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAEnE,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { ANALYTICS_FIELD, CANONICAL_ROOT_KEYS, CONCEPT_FIELD, DATA_FIELD, DEFAULT_TOP_ASSOCIATED_ITEMS, ENRICHMENT_FIELD, GRAPH_RUNS_FIELD, INSIGHTS_FIELD, JOB_TYPE_RUNS_FIELD, LEGACY_ASSOCIATED_NAMES, LEGACY_ROOT_KEYS, RECORD_ID_FIELD, SNAPSHOT_ONLY_BUCKETS, SYSTEM_FIELD, SYSTEM_LIFECYCLE_FIELD, } from "./constants.js";
+export { assertAssociatedPropertyName, buildAssociatedPropertyName, isAssociatedPropertyName, isEnrichmentAssociatedPropertyName, isLegacyAssociatedPropertyName, isTopAssociatedPropertyName, listAssociatedProperties, } from "./associated.js";
+export { buildConceptIdentifier, buildIdentityString, readConceptIdentifier, readConceptTitle, readRecordId, } from "./concept.js";
+export { inspectMemorixRecord } from "./inspect.js";
+export { parseRecordsJson, validateMemorixRecord, validateMemorixRecords, } from "./validate.js";
+export { isPlainObject, pascalCaseObjectType, stringifyId } from "./utils.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":"AAeA,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,4BAA4B,EAC5B,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,wBAAwB,EACxB,kCAAkC,EAClC,8BAA8B,EAC9B,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/inspect.d.ts

@@ -0,0 +1,4 @@
+import type { RecordInspection } from "./types.js";
+/** Summarize which format buckets and associated properties a record uses. */
+export declare function inspectMemorixRecord(input: unknown): RecordInspection;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../src/inspect.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAc,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG/D,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CA8CrE"}