@x12i/memorix-format 1.0.0 → 2.0.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## 2.0.0
+
+Breaking relative to 1.0.0:
+
+- Depends on **`@x12i/memorix-base-format@^1.0.0`** for the fixed skeleton (`recordId`, `concept`, `data`, `_*`) and unnamed open buckets.
+- Product rules (`associated*`, `analytics` / `enrichment` / `insights` meanings, SCOPE) live only in this package as profiles / layered checks.
+- `classifyRootKey` comes from base — `associatedData` / `analytics` are simply **open**, not special base categories.
+- CLI adds `--profile`, directory validation; prefers requirement IDs (`ASSOC-2`, `SCOPE-2`, …).
+- Re-exports base APIs (`validateMemorixBaseRecord`, `parseContentTypeMeta`, …).
+
+## 1.0.0
+
+Initial release (monolithic validator with forced product naming mixed into envelope checks).

package/README.md

@@ -1,13 +1,18 @@
 # @x12i/memorix-format
 
-Memorix record format as an npm package: **types**, **validator**, **CLI**, and the **specification docs**.
+Memorix **product** record format — profiles and conventions on top of
+[`@x12i/memorix-base-format`](https://www.npmjs.com/package/@x12i/memorix-base-format).
 
-Canonical envelope: [docs/memorix-format.md](./docs/memorix-format.md).
+| Package | Owns |
+|---|---|
+| `@x12i/memorix-base-format` | Fixed skeleton: `recordId`, `concept`, `data`, `_…`; unnamed open buckets; ContentTypeMeta |
+| `@x12i/memorix-format` | Memorix open-bucket meanings, `associated*` rules, snapshot SCOPE, built-in profiles |
 
 ## Install
 
 ```bash
 npm install @x12i/memorix-format
+# pulls @x12i/memorix-base-format
 ```
 
 ## SDK
@@ -15,76 +20,33 @@ npm install @x12i/memorix-format
 ```ts
 import {
   validateMemorixRecord,
-  inspectMemorixRecord,
-  buildConceptIdentifier,
-  buildAssociatedPropertyName,
+  validateMemorixBaseRecord,
+  classifyRootKey,
+  snapshotsContentTypeMeta,
 } 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",
+// Product validation (base + ASSOC/SCOPE + optional profile)
+validateMemorixRecord(record, {
+  profile: "snapshots",
   objectType: "vulnerabilities",
-  contentType: "analysis",
+  contentType: "snapshots",
 });
-```
-
-### 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
+// Base only (no product vocabulary)
+validateMemorixBaseRecord(record);
+classifyRootKey("associatedData"); // "open"
 ```
 
-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
+## CLI
 
 ```bash
-cd memorix-format
-npm install
-npm test
-npm run build
+npx memorix-format validate ./record.json --profile=snapshots --object-type=assets
+npx memorix-format validate ./dir/ --content-type=events
+npx memorix-format profiles
+npx memorix-format docs memorix-format-requirements.md
 ```
 
-## Publish
+## Migration from 1.0.0
 
-```bash
-cd memorix-format
-npm run build && npm test
-npm publish --access public
-```
+See [CHANGELOG.md](./CHANGELOG.md). Envelope validation moved to base-format;
+this package no longer pretends product bucket names are part of the base law.

package/dist/associated.d.ts

@@ -1,3 +1,28 @@
+/**
+ * Memorix product open-bucket helpers.
+ * Base envelope rules live in @x12i/memorix-base-format — do not reimplement them here.
+ */
+export declare const LEGACY_ASSOCIATED_NAMES: Set<string>;
+export declare const KNOWN_OPEN_BUCKETS: {
+    analytics: {
+        kind: "rollup";
+        shape: "object";
+    };
+    enrichment: {
+        kind: "sourced";
+        shape: "object";
+    };
+    insights: {
+        kind: "interpretive";
+        shape: "object";
+    };
+};
+export declare const DEFAULT_TOP_ASSOCIATED_ITEMS = 5;
+export declare function isAssociatedPropertyName(name: string): boolean;
+export declare function isLegacyAssociatedPropertyName(name: string): boolean;
+export declare function isEnrichmentAssociatedPropertyName(name: string): boolean;
+export declare function isTopAssociatedPropertyName(name: string): boolean;
+export declare function pascalCaseObjectType(value: string): string;
 export type AssociatedPropertyNameInput = {
     form: "content";
     objectType: string;
@@ -21,18 +46,6 @@ export type AssociatedPropertyNameInput = {
     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

@@ -1 +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"}
+{"version":3,"file":"associated.d.ts","sourceRoot":"","sources":["../src/associated.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,uBAAuB,aAQlC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;CAI9B,CAAC;AAEF,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExE;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,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,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,2BAA2B,GAAG,MAAM,CAmBtF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAElF"}

package/dist/associated.js

@@ -1,34 +1,49 @@
-import { LEGACY_ASSOCIATED_NAMES } from "./constants.js";
-import { pascalCaseObjectType } from "./utils.js";
-/** True when a root key is an associated* property. */
+/**
+ * Memorix product open-bucket helpers.
+ * Base envelope rules live in @x12i/memorix-base-format — do not reimplement them here.
+ */
+export const LEGACY_ASSOCIATED_NAMES = new Set([
+    "associatedData",
+    "associatedDiscovery",
+    "associatedAnalysis",
+    "associatedSiblings",
+    "associatedChildren",
+    "associatedAssets",
+    "associatedSubnets",
+]);
+export const KNOWN_OPEN_BUCKETS = {
+    analytics: { kind: "rollup", shape: "object" },
+    enrichment: { kind: "sourced", shape: "object" },
+    insights: { kind: "interpretive", shape: "object" },
+};
+export const DEFAULT_TOP_ASSOCIATED_ITEMS = 5;
 export function isAssociatedPropertyName(name) {
     return name.startsWith("associated");
 }
-/** True when the property name follows the enrichment association convention. */
+export function isLegacyAssociatedPropertyName(name) {
+    return LEGACY_ASSOCIATED_NAMES.has(name);
+}
 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);
+export function pascalCaseObjectType(value) {
+    return value
+        .split(/[-_]/)
+        .filter(Boolean)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join("");
 }
-/** 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 "content":
+            return `associated${topPrefix}${objectSegment}${pascalCaseObjectType(input.contentType)}`;
+        case "snapshotsRootProperty":
+            return `associated${topPrefix}${objectSegment}Snapshots${pascalCaseObjectType(input.rootProperty)}`;
         case "enrichment":
             return `associated${topPrefix}${objectSegment}Enrichment`;
         case "concepts":
@@ -36,24 +51,12 @@ export function buildAssociatedPropertyName(input) {
         case "recordIds":
             return `associated${topPrefix}${objectSegment}RecordIds`;
         default: {
-            const _exhaustive = input;
-            throw new Error(`Unsupported associated property name input: ${JSON.stringify(_exhaustive)}`);
+            const _e = input;
+            throw new Error(`Unsupported input: ${JSON.stringify(_e)}`);
         }
     }
 }
-/** 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();
+    return Object.keys(record).filter(isAssociatedPropertyName).sort();
 }
 //# sourceMappingURL=associated.js.map

package/dist/associated.js.map

@@ -1 +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"}
+{"version":3,"file":"associated.js","sourceRoot":"","sources":["../src/associated.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,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,kBAAkB,GAAG;IAChC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,KAAK,EAAE,QAAiB,EAAE;IAChE,UAAU,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE,KAAK,EAAE,QAAiB,EAAE;IAClE,QAAQ,EAAE,EAAE,IAAI,EAAE,cAAuB,EAAE,KAAK,EAAE,QAAiB,EAAE;CACtE,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAE9C,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,IAAY;IACzD,OAAO,uBAAuB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,IAAY;IAC7D,OAAO,iDAAiD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,IAAY;IACtD,OAAO,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,KAAK;SACT,KAAK,CAAC,MAAM,CAAC;SACb,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC3D,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AASD,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;YACZ,OAAO,aAAa,SAAS,GAAG,aAAa,GAAG,oBAAoB,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5F,KAAK,uBAAuB;YAC1B,OAAO,aAAa,SAAS,GAAG,aAAa,YAAY,oBAAoB,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;QACtG,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,EAAE,GAAU,KAAK,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAA+B;IACtE,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC,IAAI,EAAE,CAAC;AACrE,CAAC"}

package/dist/cli.js

@@ -1,10 +1,11 @@
 #!/usr/bin/env node
-import { readFileSync, existsSync, readdirSync } from "node:fs";
+import { existsSync, readdirSync, readFileSync, statSync } 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";
+import { inspectMemorixBaseRecord, parseContentTypeMeta, parseRecordsJson, } from "@x12i/memorix-base-format";
+import { BUILTIN_PROFILES } from "./profiles.js";
+import { validateMemorixRecord } from "./validate.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const require = createRequire(import.meta.url);
 function packageVersion() {
@@ -17,10 +18,7 @@ function packageVersion() {
     }
 }
 function docsDir() {
-    const candidates = [
-        join(__dirname, "..", "docs"),
-        join(process.cwd(), "docs"),
-    ];
+    const candidates = [join(__dirname, "..", "docs"), join(process.cwd(), "docs")];
     for (const dir of candidates) {
         if (existsSync(dir))
             return dir;
@@ -30,26 +28,24 @@ function docsDir() {
 function printHelp() {
     console.log(`memorix-format <command> [options]
 
-Memorix record format SDK + CLI (validate, inspect, docs).
+Memorix product format (layers on @x12i/memorix-base-format).
 
 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 [path|-]   Validate with base + Memorix profile rules
+  inspect  [path|-]   Summarize root categories (via base)
+  docs [name]         List or print packaged docs
+  profiles            List built-in Memorix profiles
+  version
+  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
+Options:
+  --profile=<name>      Built-in profile: ${BUILTIN_PROFILES.join(" | ")}
+  --object-type=<name>  Object type for profile resolution
+  --content-type=<ct>   SCOPE hint (non-snapshots reject known buckets / associated*)
+  --meta=<file>         Custom ContentTypeMeta JSON (overrides --profile)
+  --allow-legacy        Warn on retired roots
+  --strict
+  --json
 `);
 }
 function readFlag(args, name) {
@@ -60,15 +56,58 @@ function readFlag(args, name) {
 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 loadMeta(args) {
+    const path = readFlag(args, "meta");
+    if (!path)
+        return undefined;
+    const parsed = parseContentTypeMeta(JSON.parse(readFileSync(resolve(path), "utf8")));
+    if (!parsed.ok || !parsed.meta) {
+        throw new Error(`Invalid --meta: ${parsed.issues.map((i) => i.message).join("; ")}`);
+    }
+    return parsed.meta;
 }
-function buildValidateOptions(args) {
+function collectInputFiles(pathArg) {
+    if (!pathArg || pathArg === "-")
+        return ["-"];
+    const abs = resolve(pathArg);
+    if (!existsSync(abs))
+        throw new Error(`Path not found: ${abs}`);
+    const st = statSync(abs);
+    if (st.isFile())
+        return [abs];
+    if (!st.isDirectory())
+        throw new Error(`Not a file or directory: ${abs}`);
+    const out = [];
+    const walk = (dir) => {
+        for (const name of readdirSync(dir)) {
+            const p = join(dir, name);
+            const s = statSync(p);
+            if (s.isDirectory())
+                walk(p);
+            else if (name.endsWith(".json") || name.endsWith(".ndjson"))
+                out.push(p);
+        }
+    };
+    walk(abs);
+    return out.sort();
+}
+function readFileOrStdin(path) {
+    if (path === "-")
+        return readFileSync(0, "utf8");
+    return readFileSync(path, "utf8");
+}
+function buildOptions(args) {
+    const profileRaw = readFlag(args, "profile");
+    const profile = profileRaw && BUILTIN_PROFILES.includes(profileRaw)
+        ? profileRaw
+        : undefined;
+    if (profileRaw && !profile) {
+        throw new Error(`Unknown --profile=${profileRaw}; use ${BUILTIN_PROFILES.join("|")}`);
+    }
     return {
+        meta: loadMeta(args),
+        profile,
+        objectType: readFlag(args, "object-type"),
         contentType: readFlag(args, "content-type"),
         allowLegacyEnvelope: hasFlag(args, "allow-legacy"),
         strict: hasFlag(args, "strict"),
@@ -76,76 +115,87 @@ function buildValidateOptions(args) {
 }
 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;
+    let options;
     try {
-        records = parseRecordsJson(readInput(file));
+        options = buildOptions(args);
     }
     catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        console.error(`Failed to parse input: ${message}`);
+        console.error(err instanceof Error ? err.message : String(err));
         return 2;
     }
-    if (records.length === 0) {
-        console.error("No records found in input");
+    let files;
+    try {
+        files = collectInputFiles(positional[0]);
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
         return 2;
     }
-    const results = records.map((r, i) => ({
-        index: i,
-        ...validateMemorixRecord(r, options),
-    }));
-    const ok = results.every((r) => r.ok);
+    if (files.length === 0) {
+        console.error("No .json / .ndjson files found");
+        return 2;
+    }
+    const rows = [];
+    for (const file of files) {
+        let records;
+        try {
+            records = parseRecordsJson(readFileOrStdin(file));
+        }
+        catch (err) {
+            console.error(`Failed to parse ${file}: ${err instanceof Error ? err.message : String(err)}`);
+            return 2;
+        }
+        for (let i = 0; i < records.length; i++) {
+            const r = validateMemorixRecord(records[i], options);
+            rows.push({ file, index: i, ok: r.ok, recordId: r.recordId, issues: r.issues });
+        }
+    }
+    if (rows.length === 0) {
+        console.error("No records found");
+        return 2;
+    }
+    const ok = rows.every((r) => r.ok);
     if (asJson) {
-        console.log(JSON.stringify({ ok, count: results.length, results }, null, 2));
+        console.log(JSON.stringify({ ok, count: rows.length, results: rows }, 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 r of rows) {
+            console.log(`${r.ok ? "OK" : "FAIL"}  ${r.file}#${r.index} ${r.recordId ?? ""}`.trimEnd());
             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}`);
+        console.log(`${ok ? "Passed" : "Failed"}: ${rows.filter((r) => r.ok).length}/${rows.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;
+    let files;
     try {
-        records = parseRecordsJson(readInput(file));
+        files = collectInputFiles(positional[0]);
     }
     catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        console.error(`Failed to parse input: ${message}`);
+        console.error(err instanceof Error ? err.message : String(err));
         return 2;
     }
-    const inspections = records.map((r, i) => ({
-        index: i,
-        ...inspectMemorixRecord(r),
-    }));
+    const inspections = [];
+    for (const file of files) {
+        const records = parseRecordsJson(readFileOrStdin(file));
+        for (let i = 0; i < records.length; i++) {
+            inspections.push({ file, index: i, ...inspectMemorixBaseRecord(records[i]) });
+        }
+    }
     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(", ")}`);
+    else {
+        for (const row of inspections) {
+            console.log(`#${row.file}:${row.index} recordId=${row.recordId ?? "(missing)"}`);
+            console.log(`  open: ${row.categories.open.join(", ") || "(none)"}`);
+        }
     }
     return 0;
 }
@@ -153,11 +203,11 @@ function runDocs(args) {
     const dir = docsDir();
     const name = args.find((a) => !a.startsWith("--"));
     if (!existsSync(dir)) {
-        console.error(`Docs directory not found: ${dir}`);
+        console.error(`Docs not found: ${dir}`);
         return 1;
     }
     if (!name) {
-        console.log(`Packaged Memorix format docs (${dir}):`);
+        console.log(`Packaged memorix-format docs (${dir}):`);
         for (const file of readdirSync(dir).sort()) {
             if (file.endsWith(".md"))
                 console.log(`  ${file}`);
@@ -168,7 +218,6 @@ function runDocs(args) {
     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"));
@@ -184,6 +233,10 @@ async function main(argv) {
         console.log(packageVersion());
         return 0;
     }
+    if (cmd === "profiles") {
+        console.log(BUILTIN_PROFILES.join("\n"));
+        return 0;
+    }
     if (cmd === "validate")
         return runValidate(args);
     if (cmd === "inspect")
@@ -194,6 +247,5 @@ async function main(argv) {
     printHelp();
     return 2;
 }
-const exitCode = await main(process.argv.slice(2));
-process.exit(exitCode);
+process.exit(await main(process.argv.slice(2)));
 //# sourceMappingURL=cli.js.map