@x12i/memorix-format 1.0.0 → 2.1.0

package/dist/validate.js

@@ -1,211 +1,70 @@
-import { ANALYTICS_FIELD, CANONICAL_ROOT_KEYS, ENRICHMENT_FIELD, INSIGHTS_FIELD, LEGACY_ROOT_KEYS, SNAPSHOT_ONLY_BUCKETS, } from "./constants.js";
-import { isAssociatedPropertyName, isLegacyAssociatedPropertyName } from "./associated.js";
-import { buildIdentityString, readRecordId } from "./concept.js";
-import { isPlainObject, stringifyId } from "./utils.js";
+import { validateMemorixBaseRecord, } from "@x12i/memorix-base-format";
+import { isAssociatedPropertyName, isLegacyAssociatedPropertyName, KNOWN_OPEN_BUCKETS, } from "./associated.js";
+import { resolveMemorixProfile } from "./profiles.js";
 function issue(path, code, message, severity = "error") {
     return { path, code, message, severity };
 }
-function validateConcept(concept, issues) {
-    if (!isPlainObject(concept)) {
-        issues.push(issue("concept", "concept.required", "concept must be a plain object"));
-        return;
-    }
-    const title = stringifyId(concept.title);
-    if (!title) {
-        issues.push(issue("concept.title", "concept.title.required", "concept.title must be a non-empty string"));
-    }
-    if (concept.name !== undefined) {
-        issues.push(issue("concept.name", "concept.name.legacy", 'concept.name is removed in the clean format; use concept.identifier + concept.title', "warning"));
-    }
-    const identifier = concept.identifier;
-    if (!isPlainObject(identifier)) {
-        issues.push(issue("concept.identifier", "concept.identifier.required", "concept.identifier must be a plain object"));
-        return;
-    }
-    const kind = stringifyId(identifier.kind);
-    if (!kind) {
-        issues.push(issue("concept.identifier.kind", "concept.identifier.kind.required", "concept.identifier.kind must be a non-empty string"));
-        return;
-    }
-    if (identifier[kind] == null || String(identifier[kind]).trim() === "") {
-        issues.push(issue(`concept.identifier.${kind}`, "concept.identifier.value.required", `concept.identifier.${kind} must be present for kind "${kind}"`));
-    }
-    const identifierKey = stringifyId(identifier.identifierKey);
-    if (!identifierKey) {
-        issues.push(issue("concept.identifier.identifierKey", "concept.identifier.identifierKey.required", "concept.identifier.identifierKey is required"));
-    }
-    else {
-        const expected = buildIdentityString(identifier);
-        if (expected && identifierKey !== expected) {
-            issues.push(issue("concept.identifier.identifierKey", "concept.identifier.identifierKey.mismatch", `identifierKey should be "${expected}", got "${identifierKey}"`, "warning"));
-        }
-    }
-    for (const [key, value] of Object.entries(identifier)) {
-        if (typeof value !== "string") {
-            issues.push(issue(`concept.identifier.${key}`, "concept.identifier.value.type", `concept.identifier.${key} must be a string`));
-        }
-    }
-}
-function validateAssociatedProperty(name, value, issues) {
-    if (value === undefined)
-        return;
-    if (!Array.isArray(value)) {
-        issues.push(issue(name, "associated.array", `${name} must be an array of objects (omit when empty)`));
-        return;
-    }
-    if (value.length === 0) {
-        issues.push(issue(name, "associated.empty", `${name} should be omitted when empty`, "warning"));
-    }
-    for (let i = 0; i < value.length; i++) {
-        const item = value[i];
-        if (!isPlainObject(item)) {
-            issues.push(issue(`${name}[${i}]`, "associated.item.object", `${name}[${i}] must be a plain object`));
-        }
-    }
-    if (isLegacyAssociatedPropertyName(name)) {
-        issues.push(issue(name, "associated.legacy_name", `${name} is a legacy associated name; prefer associated<ObjectType><ContentType>`, "warning"));
-    }
-}
-function validateObjectBucket(name, value, issues) {
-    if (value === undefined)
-        return;
-    if (!isPlainObject(value)) {
-        issues.push(issue(name, `${name}.object`, `${name} must be a plain object`));
-        return;
-    }
-    if (Object.keys(value).length === 0) {
-        issues.push(issue(name, `${name}.empty`, `${name} should be omitted when empty`, "warning"));
-    }
-}
-function validateSystem(system, issues) {
-    if (system === undefined)
-        return;
-    if (!isPlainObject(system)) {
-        issues.push(issue("_system", "system.object", "_system must be a plain object"));
-        return;
-    }
-    const lifecycle = system.lifecycle;
-    if (lifecycle !== undefined) {
-        if (!Array.isArray(lifecycle)) {
-            issues.push(issue("_system.lifecycle", "system.lifecycle.array", "_system.lifecycle must be an array"));
-        }
-        else {
-            if (lifecycle.length === 0) {
-                issues.push(issue("_system.lifecycle", "system.lifecycle.empty", "_system.lifecycle should be omitted when empty", "warning"));
-            }
-            for (let i = 0; i < lifecycle.length; i++) {
-                const entry = lifecycle[i];
-                if (!isPlainObject(entry)) {
-                    issues.push(issue(`_system.lifecycle[${i}]`, "system.lifecycle.entry", `_system.lifecycle[${i}] must be an object`));
-                    continue;
-                }
-                if (!stringifyId(entry.process)) {
-                    issues.push(issue(`_system.lifecycle[${i}].process`, "system.lifecycle.process", "lifecycle entry requires process"));
-                }
-                if (!stringifyId(entry.processedAt)) {
-                    issues.push(issue(`_system.lifecycle[${i}].processedAt`, "system.lifecycle.processedAt", "lifecycle entry requires processedAt"));
-                }
-            }
-        }
-    }
-    for (const mapKey of ["_graphRuns", "_jobTypeRuns"]) {
-        const map = system[mapKey];
-        if (map !== undefined && !isPlainObject(map)) {
-            issues.push(issue(`_system.${mapKey}`, `system.${mapKey}.object`, `_system.${mapKey} must be a plain object`));
-        }
-    }
+function isPlainObject(v) {
+    return v !== null && typeof v === "object" && !Array.isArray(v);
 }
 /**
- * Validate a Memorix record against the clean envelope contract.
- * Does not require Mongo or Catalox — pure shape validation.
+ * Memorix product validation = base envelope + optional profile meta + ASSOC/SCOPE rules.
  */
 export function validateMemorixRecord(input, options = {}) {
-    const issues = [];
+    const meta = options.meta ??
+        (options.profile
+            ? resolveMemorixProfile(options.profile, options.objectType ?? "generic")
+            : undefined);
+    const base = validateMemorixBaseRecord(input, {
+        ...options,
+        meta,
+    });
+    const issues = [...base.issues];
     if (!isPlainObject(input)) {
-        return {
-            ok: false,
-            issues: [issue("$", "record.object", "record must be a plain JSON object")],
-        };
-    }
-    const record = input;
-    const recordId = readRecordId(record) || undefined;
-    const rootRecordId = stringifyId(record.recordId);
-    if (!rootRecordId) {
-        issues.push(issue("recordId", "recordId.required", "recordId must be a non-empty string"));
+        return base;
     }
-    if (!isPlainObject(record.data)) {
-        issues.push(issue("data", "data.required", "data must be a plain object"));
-    }
-    validateConcept(record.concept, issues);
-    validateObjectBucket(ANALYTICS_FIELD, record.analytics, issues);
-    validateObjectBucket(ENRICHMENT_FIELD, record.enrichment, issues);
-    validateObjectBucket(INSIGHTS_FIELD, record.insights, issues);
-    validateSystem(record._system, issues);
     const contentType = options.contentType?.trim();
     const isSnapshot = !contentType || contentType === "snapshots";
-    if (!isSnapshot) {
-        for (const bucket of SNAPSHOT_ONLY_BUCKETS) {
-            if (record[bucket] !== undefined) {
-                issues.push(issue(bucket, "snapshot_only.bucket", `${bucket} is snapshot-only by default (contentType=${contentType})`));
-            }
-        }
-    }
-    for (const key of Object.keys(record)) {
+    for (const key of Object.keys(input)) {
         if (isAssociatedPropertyName(key)) {
+            const value = input[key];
+            if (value !== undefined) {
+                if (!Array.isArray(value)) {
+                    issues.push(issue(key, "ASSOC-2", `${key} MUST be an array`));
+                }
+                else if (value.length === 0) {
+                    issues.push(issue(key, "ASSOC-3", `${key} MUST be omitted when empty`));
+                }
+                else {
+                    for (let i = 0; i < value.length; i++) {
+                        if (!isPlainObject(value[i])) {
+                            issues.push(issue(`${key}[${i}]`, "ASSOC-5", `${key}[${i}] must be a plain object`));
+                        }
+                    }
+                }
+                if (isLegacyAssociatedPropertyName(key)) {
+                    issues.push(issue(key, "ASSOC-1", `${key} is a legacy associated name; prefer associated<ObjectType><ContentType>`, "warning"));
+                }
+            }
             if (!isSnapshot) {
-                issues.push(issue(key, "snapshot_only.associated", `${key} is snapshot-only by default (contentType=${contentType})`));
+                issues.push(issue(key, "SCOPE-2", `${key} is snapshot-oriented by default (contentType=${contentType})`));
             }
-            validateAssociatedProperty(key, record[key], issues);
-            continue;
         }
-        if (CANONICAL_ROOT_KEYS.has(key))
-            continue;
-        if (LEGACY_ROOT_KEYS.has(key)) {
-            if (options.allowLegacyEnvelope) {
-                issues.push(issue(key, "legacy.root", `${key} is a legacy 2.0 root field`, "warning"));
-            }
-            else {
-                issues.push(issue(key, "legacy.root.forbidden", `${key} is not part of the clean envelope (set allowLegacyEnvelope to warn instead)`));
+    }
+    if (!isSnapshot) {
+        for (const bucket of Object.keys(KNOWN_OPEN_BUCKETS)) {
+            if (input[bucket] !== undefined) {
+                issues.push(issue(bucket, "SCOPE-2", `${bucket} SHOULD be omitted on non-snapshot content types unless opted in`));
             }
-            continue;
         }
-        issues.push(issue(key, "root.unknown", `unexpected root key "${key}"`, "warning"));
     }
     const hasError = issues.some((i) => i.severity === "error");
     const hasWarning = issues.some((i) => i.severity === "warning");
     const ok = options.strict ? !hasError && !hasWarning : !hasError;
-    return { ok, issues, recordId };
+    return { ok, issues, recordId: base.recordId };
 }
-/** Validate many records; returns per-record results plus aggregate ok. */
 export function validateMemorixRecords(records, options = {}) {
     const results = records.map((r) => validateMemorixRecord(r, options));
     return { ok: results.every((r) => r.ok), results };
 }
-/** Parse JSON text that is either one object or an array / NDJSON stream. */
-export function parseRecordsJson(text) {
-    const trimmed = text.trim();
-    if (!trimmed)
-        return [];
-    if (trimmed.startsWith("[")) {
-        const parsed = JSON.parse(trimmed);
-        if (!Array.isArray(parsed)) {
-            throw new Error("Expected a JSON array of records");
-        }
-        return parsed;
-    }
-    if (trimmed.startsWith("{")) {
-        // Prefer single object; if multiple JSON objects on separate lines, treat as NDJSON.
-        const lines = trimmed.split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
-        if (lines.length > 1 && lines.every((l) => l.startsWith("{"))) {
-            return lines.map((line) => JSON.parse(line));
-        }
-        return [JSON.parse(trimmed)];
-    }
-    // NDJSON without leading [
-    return trimmed
-        .split(/\r?\n/)
-        .map((l) => l.trim())
-        .filter(Boolean)
-        .map((line) => JSON.parse(line));
-}
 //# sourceMappingURL=validate.js.map

package/dist/validate.js.map

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

package/docs/memorix-format-requirements.md

@@ -0,0 +1,52 @@
+# Memorix Format — Requirements (product layer)
+
+**Package:** `@x12i/memorix-format`  
+**Depends on:** `@x12i/memorix-base-format` (fixed skeleton — do not re-state ENV/ID/DATA/SYS here).
+
+This document covers **Memorix product** open-bucket conventions. Base envelope MUST be satisfied first (`TOOL-3`: layer checks on base).
+
+---
+
+## Known open buckets (when present)
+
+**BUCKET-5.**
+
+| Bucket | MUST contain | MUST NOT contain |
+|---|---|---|
+| `analytics` | Numeric rollups | The underlying list of records |
+| `enrichment` | External / prior-system values as received | Interpreted judgments |
+| `insights` | Judgments, scores, recommendations | Anything a reader would mistake for a stored native fact |
+
+These names are **Memorix declarations**, not base-reserved keys. Base classifies them as open buckets.
+
+---
+
+## Associated properties
+
+**ASSOC-1.** Keys matching Memorix association patterns (`associated…`, legacy short names, `associatedTop…`, `associated…Enrichment`, custom `associated` prefix).
+
+**ASSOC-2.** When present, MUST be an array.
+
+**ASSOC-3.** MUST be omitted when empty — never `[]`.
+
+**ASSOC-5.** Items MUST be plain objects (linked payloads), not full envelopes.
+
+**ASSOC-6.** Resolution MUST be snapshot-first (see association-format.md). Enforced by associator tooling, documented here.
+
+---
+
+## Snapshot vs minimal (SCOPE)
+
+**SCOPE-1.** Full open-bucket set SHOULD appear primarily on snapshots.
+
+**SCOPE-2.** Non-snapshot content types MUST include `recordId` + `data`; SHOULD omit `analytics` / `insights` / most `associated*` unless opted in via ContentTypeMeta.
+
+**SCOPE-3.** Readers MUST treat missing optional buckets as N/A, not error.
+
+---
+
+## Validator
+
+**TOOL-3.** `validateMemorixRecord` = `validateMemorixBaseRecord` + profile/ASSOC/SCOPE.
+
+Built-in profiles: `snapshots`, `minimal` (`--profile=`).

package/docs/memorix-format.md

@@ -1,6 +1,8 @@
 # Memorix Record Format
 
-> Packaged as **`@x12i/memorix-format`** (types, validator, CLI).
+> **Package split (2.0):** Core envelope → [`@x12i/memorix-base-format`](https://www.npmjs.com/package/@x12i/memorix-base-format).  
+> Product open buckets / associations → this package (`@x12i/memorix-format`).  
+> Requirements: [memorix-format-requirements.md](./memorix-format-requirements.md).
 
 ## Purpose
 

package/examples/valid-snapshot.json

@@ -1,5 +1,4 @@
 {
-  "_id": "6914a132880706529ece3da1",
   "recordId": "69d216ed358778e93215787e",
   "concept": {
     "identifier": {
@@ -10,22 +9,14 @@
     "title": "Oracle WebLogic Server RCE (CVE-2020-14882)"
   },
   "data": {
-    "name": "Oracle WebLogic Server RCE (CVE-2020-14882)",
     "cveId": "CVE-2020-14882",
-    "severity": "critical",
-    "pluginId": 142594
+    "severity": "critical"
   },
   "associatedData": [
-    { "assetIp": "10.100.24.31", "hostname": "BGAK105-002" },
-    { "assetIp": "10.100.24.41", "hostname": "BGAK105-003" }
+    { "assetIp": "10.100.24.31", "hostname": "BGAK105-002" }
   ],
   "analytics": {
-    "affectedAssets": { "total": 2 }
-  },
-  "enrichment": {
-    "cvss": { "baseScore": 9.8 },
-    "epss": { "epss": 0.94454 },
-    "kev": { "isKnownExploited": true }
+    "affectedAssets": { "total": 1 }
   },
   "insights": {
     "exploitability": { "level": "HIGH", "confidence": 0.92 }

package/meta/associated-conventions.json

@@ -0,0 +1,59 @@
+{
+  "$schemaNote": "Associated* naming conventions + legacy short names. No objectType bindings.",
+  "version": "2.1.0",
+  "prefix": "associated",
+  "defaultTopMaxItems": 5,
+  "legacyNames": [
+    "associatedData",
+    "associatedDiscovery",
+    "associatedAnalysis",
+    "associatedSiblings",
+    "associatedChildren",
+    "associatedAssets",
+    "associatedSubnets"
+  ],
+  "namingForms": [
+    {
+      "form": "content",
+      "pattern": "associated[Top?]<ObjectType><ContentType>",
+      "kind": "linked-payloads",
+      "shape": "array-of-objects"
+    },
+    {
+      "form": "enrichment",
+      "pattern": "associated[Top?]<ObjectType>Enrichment",
+      "kind": "linked-payloads",
+      "shape": "array-of-objects"
+    },
+    {
+      "form": "snapshotsRootProperty",
+      "pattern": "associated[Top?]<ObjectType>Snapshots<RootProperty>",
+      "kind": "linked-payloads",
+      "shape": "array-of-objects"
+    },
+    {
+      "form": "concepts",
+      "pattern": "associated[Top?]<ObjectType>Concepts",
+      "kind": "linked-payloads",
+      "shape": "array-of-objects"
+    },
+    {
+      "form": "recordIds",
+      "pattern": "associated[Top?]<ObjectType>RecordIds",
+      "kind": "linked-payloads",
+      "shape": "array-of-objects"
+    },
+    {
+      "form": "customDomain",
+      "pattern": "associated<CustomName>",
+      "kind": "linked-payloads",
+      "shape": "array-of-objects",
+      "examples": ["associatedTopology", "associatedCompliance"]
+    }
+  ],
+  "rules": {
+    "ASSOC-2": "when present MUST be an array",
+    "ASSOC-3": "MUST be omitted when empty — never []",
+    "ASSOC-6": "resolution MUST be snapshot-first (match *-snapshots, then content by recordId)"
+  }
+}

package/meta/content-type-profiles.json

@@ -0,0 +1,27 @@
+{
+  "$schemaNote": "Content-type profiles (policies). objectType is filled by the caller — never hardcoded here.",
+  "version": "2.1.0",
+  "profiles": {
+    "snapshots": {
+      "contentType": "snapshots",
+      "collectionPostfix": "snapshots",
+      "openBucketsRef": "open-buckets.json",
+      "policy": {
+        "unknownOpenBuckets": "allow",
+        "emptyBuckets": "reject"
+      },
+      "read": {
+        "missingOptionalIsNa": true
+      }
+    },
+    "minimal": {
+      "policy": {
+        "unknownOpenBuckets": "warn",
+        "emptyBuckets": "reject"
+      },
+      "read": {
+        "missingOptionalIsNa": true
+      }
+    }
+  }
+}

package/meta/content-types.json

@@ -0,0 +1,68 @@
+{
+  "$schemaNote": "Content-type vocabulary used by Memorix. Not object types. Aligned with managed Catalox entity descriptors + product vocabulary.",
+  "version": "2.1.0",
+  "canonicalContentType": "snapshots",
+  "contentTypes": {
+    "snapshots": {
+      "profile": "snapshots",
+      "description": "Full readable object view — may carry known open buckets and associated*"
+    },
+    "discovery": {
+      "profile": "minimal",
+      "description": "Discovery / Q&A style content"
+    },
+    "analysis": {
+      "profile": "minimal",
+      "description": "Analysis content"
+    },
+    "decisions": {
+      "profile": "minimal",
+      "description": "Decision content",
+      "collectionPostfixVariants": ["decision", "decisions"]
+    },
+    "scoped": {
+      "profile": "minimal",
+      "description": "Scoped slice"
+    },
+    "legacy": {
+      "profile": "minimal",
+      "description": "Quarantined / legacy slice"
+    },
+    "narratives": {
+      "profile": "minimal",
+      "description": "Narrative records"
+    },
+    "narrative-steps": {
+      "profile": "minimal",
+      "description": "Narrative step records"
+    },
+    "workflow": {
+      "profile": "workflow",
+      "description": "Product workflow overlay (memorix-workflow/1) — not the snapshot envelope"
+    },
+    "extrated": {
+      "profile": "minimal",
+      "description": "Extracted document content (managed key spelling as in Catalox descriptors)"
+    },
+    "chunks": {
+      "profile": "minimal",
+      "description": "Document chunks"
+    },
+    "ai-processing": {
+      "profile": "minimal",
+      "description": "Product vocabulary — optional CT"
+    },
+    "context": {
+      "profile": "minimal",
+      "description": "Product vocabulary — optional CT"
+    },
+    "suggested-plans": {
+      "profile": "minimal",
+      "description": "Product vocabulary — optional CT"
+    },
+    "suggested-actions": {
+      "profile": "minimal",
+      "description": "Product vocabulary — optional CT"
+    }
+  }
+}

package/meta/inventory/managed-descriptors.json

@@ -0,0 +1,77 @@
+{
+  "$schemaNote": "INVENTORY ONLY — derived from managed Catalox entity descriptors (memorix-retrieval/catalox-seeds). Not format law. Not agent packs. Used to keep format meta aligned with live managed objects. Regenerate when descriptors change.",
+  "version": "2.1.0",
+  "source": "memorix-retrieval/catalox-seeds/inputs/entity-descriptors/*.json",
+  "scannedAt": "2026-07-21",
+  "alsoScanned": [
+    {
+      "source": "ebooks/memorix-seed/entity-descriptors/*.json",
+      "note": "Demo domain — same CT/open-bucket conventions; no new format vocabulary"
+    }
+  ],
+  "managedObjectTypes": [
+    "assets",
+    "content-documents",
+    "knowledge-playbooks",
+    "subnets",
+    "topology-zones",
+    "vulnerabilities",
+    "vulnerabilities-groups"
+  ],
+  "contentTypesObserved": [
+    "analysis",
+    "chunks",
+    "decisions",
+    "discovery",
+    "extrated",
+    "legacy",
+    "narrative-steps",
+    "narratives",
+    "scoped",
+    "snapshots",
+    "workflow"
+  ],
+  "contentTypeNotes": [
+    {
+      "contentType": "decisions",
+      "note": "Some descriptors use collection postfix 'decision' (singular) while the contentTypes key is 'decisions'"
+    },
+    {
+      "contentType": "extrated",
+      "note": "Spelling as managed in content-documents descriptor (key/postfix/collection)"
+    }
+  ],
+  "associatedPropertiesObserved": [
+    "associatedAssetsSnapshots",
+    "associatedSubnetsAnalysis",
+    "associatedSubnetsDiscovery",
+    "associatedSubnetsSnapshots",
+    "associatedTopVulnerabilitiesAnalysis",
+    "associatedTopology",
+    "associatedTopologyZonesAnalysis",
+    "associatedTopologyZonesSnapshots",
+    "associatedVulnerabilitiesAnalysis",
+    "associatedVulnerabilitiesDecisions",
+    "associatedVulnerabilitiesDiscovery",
+    "associatedVulnerabilitiesGroupsAnalysis",
+    "associatedVulnerabilitiesGroupsDiscovery",
+    "associatedVulnerabilitiesGroupsEnrichment",
+    "associatedVulnerabilitiesGroupsSnapshots"
+  ],
+  "customRootPropertiesObserved": [
+    {
+      "name": "possiblePaths",
+      "kind": "custom",
+      "shape": "object",
+      "objectTypes": ["subnets"],
+      "note": "Declared on subnets descriptors as managed rootProperty — open bucket, not base-reserved and not a product-known open bucket"
+    }
+  ],
+  "platformOpenBucketsObservedInProductDocs": ["analytics", "enrichment", "insights"],
+  "alignmentChecks": {
+    "allContentTypesCoveredInContentTypesJson": true,
+    "platformOpenBucketsPresentInOpenBucketsJson": ["analytics", "enrichment", "insights"],
+    "associatedNamesFollowPrefixConvention": true,
+    "noObjectTypesInFormatLawJson": true
+  }
+}

package/meta/open-buckets.json

@@ -0,0 +1,24 @@
+{
+  "$schemaNote": "Memorix product open buckets — content-type level, no objectType. Kind meanings for snapshots.",
+  "version": "2.1.0",
+  "openBuckets": {
+    "analytics": {
+      "kind": "rollup",
+      "shape": "object",
+      "title": "Analytics",
+      "description": "Numeric rollups about linked lists"
+    },
+    "enrichment": {
+      "kind": "sourced",
+      "shape": "object",
+      "title": "Enrichment",
+      "description": "External / prior-system sourced values as received"
+    },
+    "insights": {
+      "kind": "interpretive",
+      "shape": "object",
+      "title": "Insights",
+      "description": "Interpreted judgments, scores, recommendations"
+    }
+  }
+}