@x12i/memorix-metadata 3.1.0 → 3.2.1

package/examples/knowx/normalized/pack.json

@@ -172,7 +172,7 @@
       "name": "Content",
       "dataCategory": "knowledge",
       "abstractTypes": [
-        "KnowXContent"
+        "Content"
       ],
       "notes": "Ingested documents (raw/snapshots) plus free-floating KnowX knowledge items (knowx NODE/EDGE with own recordId). Entity NODE facets stay on people/work-items.",
       "contentTypes": [
@@ -311,7 +311,7 @@
           "required": false
         },
         {
-          "id": "knowxEdgesFrom",
+          "id": "contentEdgesFrom",
           "valueType": "array",
           "required": false
         }
@@ -352,9 +352,9 @@
               "concreteValueType": "string"
             },
             {
-              "abstractProperty": "knowxEdgesFrom",
+              "abstractProperty": "contentEdgesFrom",
               "contentType": "relationships",
-              "propertyPath": "data.nav.knowxEdgesFrom"
+              "propertyPath": "data.nav.contentEdgesFrom"
             }
           ]
         }
@@ -384,7 +384,7 @@
           "required": false
         },
         {
-          "id": "knowxEdgesTo",
+          "id": "contentEdgesTo",
           "valueType": "array",
           "required": false
         }
@@ -413,9 +413,9 @@
               "concreteValueType": "string"
             },
             {
-              "abstractProperty": "knowxEdgesTo",
+              "abstractProperty": "contentEdgesTo",
               "contentType": "relationships",
-              "propertyPath": "data.nav.knowxEdgesTo"
+              "propertyPath": "data.nav.contentEdgesTo"
             }
           ]
         }
@@ -423,9 +423,9 @@
       "union": false
     },
     {
-      "id": "KnowXContent",
-      "name": "KnowX Content",
-      "meaning": "Canonical ingested document representation (Markdown + provenance). Knowledge claims are derived from content; post-processing uses content types on this OT (raw → snapshots).",
+      "id": "Content",
+      "name": "Content",
+      "meaning": "Canonical ingested documents and derived knowledge items (Markdown + provenance). Knowledge claims are derived from content; content is the source of claims, not the claims themselves.",
       "category": "knowledge",
       "properties": [
         {
@@ -677,21 +677,22 @@
           ]
         }
       ],
-      "union": false
+      "union": false,
+      "notes": "Content abstract ↔ content OT. Domain noun — not product-branded. Documents (raw/snapshots) and derived knowledge items (knowx) share this abstract; writers always target concrete content types on the OT."
     }
   ],
   "relationshipDefinitions": [
     {
       "id": "knowx-same-as",
-      "name": "KnowX same as",
-      "meaning": "Two KnowX claims refer to the same underlying assertion",
+      "name": "Same as",
+      "meaning": "Two knowledge claims refer to the same underlying assertion",
       "directionality": "undirected",
       "from": {
-        "abstractType": "KnowXContent",
+        "abstractType": "Content",
         "path": "sameAs"
       },
       "to": {
-        "abstractType": "KnowXContent",
+        "abstractType": "Content",
         "path": "sameAs"
       },
       "discoveryRules": [
@@ -704,15 +705,15 @@
     },
     {
       "id": "knowx-supports",
-      "name": "KnowX supports",
-      "meaning": "One KnowX claim supports another",
+      "name": "Supports",
+      "meaning": "One knowledge claim supports another",
       "directionality": "directed",
       "from": {
-        "abstractType": "KnowXContent",
+        "abstractType": "Content",
         "path": "supports"
       },
       "to": {
-        "abstractType": "KnowXContent",
+        "abstractType": "Content",
         "path": "supportedBy"
       },
       "discoveryRules": [
@@ -725,15 +726,15 @@
     },
     {
       "id": "knowx-contradicts",
-      "name": "KnowX contradicts",
-      "meaning": "Two KnowX claims contradict each other",
+      "name": "Contradicts",
+      "meaning": "Two knowledge claims contradict each other",
       "directionality": "directed",
       "from": {
-        "abstractType": "KnowXContent",
+        "abstractType": "Content",
         "path": "contradicts"
       },
       "to": {
-        "abstractType": "KnowXContent",
+        "abstractType": "Content",
         "path": "contradictedBy"
       },
       "discoveryRules": [
@@ -746,15 +747,15 @@
     },
     {
       "id": "knowx-derived-from",
-      "name": "KnowX derived from claim",
-      "meaning": "A KnowX claim is derived from another KnowX claim",
+      "name": "Derived from claim",
+      "meaning": "A knowledge claim is derived from another knowledge claim",
       "directionality": "directed",
       "from": {
-        "abstractType": "KnowXContent",
+        "abstractType": "Content",
         "path": "derivedFrom"
       },
       "to": {
-        "abstractType": "KnowXContent",
+        "abstractType": "Content",
         "path": "derivedClaims"
       },
       "discoveryRules": [
@@ -767,15 +768,15 @@
     },
     {
       "id": "knowx-derived-from-content",
-      "name": "KnowX derived from content",
-      "meaning": "A KnowX claim is derived from ingested content",
+      "name": "Derived from content",
+      "meaning": "A knowledge claim is derived from ingested content",
       "directionality": "directed",
       "from": {
-        "abstractType": "KnowXContent",
+        "abstractType": "Content",
         "path": "derivedFromContent"
       },
       "to": {
-        "abstractType": "KnowXContent",
+        "abstractType": "Content",
         "path": "derivedKnowledge"
       },
       "discoveryRules": [
@@ -788,16 +789,16 @@
     },
     {
       "id": "knowx-edge-from",
-      "name": "KnowX edge from",
-      "meaning": "A KnowX EDGE claim starts at an entity",
+      "name": "Edge from",
+      "meaning": "A knowledge EDGE claim starts at an entity",
       "directionality": "directed",
       "from": {
-        "abstractType": "KnowXContent",
+        "abstractType": "Content",
         "path": "edgeFrom"
       },
       "to": {
         "abstractType": "People",
-        "path": "knowxEdgesFrom"
+        "path": "contentEdgesFrom"
       },
       "discoveryRules": [
         {
@@ -809,16 +810,16 @@
     },
     {
       "id": "knowx-edge-to",
-      "name": "KnowX edge to",
-      "meaning": "A KnowX EDGE claim ends at an entity",
+      "name": "Edge to",
+      "meaning": "A knowledge EDGE claim ends at an entity",
       "directionality": "directed",
       "from": {
-        "abstractType": "KnowXContent",
+        "abstractType": "Content",
         "path": "edgeTo"
       },
       "to": {
         "abstractType": "WorkItems",
-        "path": "knowxEdgesTo"
+        "path": "contentEdgesTo"
       },
       "discoveryRules": [
         {
@@ -835,7 +836,7 @@
   "sources": [
     {
       "id": "knowx-source",
-      "name": "KnowX knowledge source",
+      "name": "Knowledge source",
       "kind": "rest",
       "baseUrlEnv": "KNOWX_SOURCE_URL",
       "defaultBaseUrl": "http://127.0.0.1:5104",
@@ -883,7 +884,7 @@
     },
     {
       "id": "knowx-managed",
-      "name": "KnowX Knowledge Drive (managed)",
+      "name": "Knowledge Drive (managed)",
       "kind": "knowx-managed",
       "connectorRef": "knowx-managed",
       "endpoints": [
@@ -930,8 +931,8 @@
   "services": [
     {
       "id": "knowx-folder-pull",
-      "name": "KnowX folder connector pull",
-      "description": "Runs the remote-hosted knowx-folder defineConnector (collectStream + fullScanHash). Lands exact file raw only — does not extract Markdown or derive Knowledge. Connector-adjacent worker — not agent vocabulary.",
+      "name": "Folder connector pull",
+      "description": "Runs the remote-hosted knowx-folder defineConnector (collectStream + fullScanHash). Lands exact file raw only — does not extract Markdown or derive knowledge. Connector-adjacent worker — not agent vocabulary.",
       "role": "connector",
       "capabilities": [
         "analyze"
@@ -976,7 +977,7 @@
     },
     {
       "id": "knowx-managed-pull",
-      "name": "KnowX managed Knowledge Drive pull",
+      "name": "Managed drive pull",
       "description": "Runs the remote-hosted knowx-managed defineConnector over managed upload events / item versions. Lands exact bytes as content/raw via collectStream. Connector-adjacent worker — not agent vocabulary.",
       "role": "connector",
       "capabilities": [
@@ -1017,8 +1018,8 @@
     },
     {
       "id": "knowx-promote-content",
-      "name": "KnowX promote content",
-      "description": "Reads landed content/raw file envelopes, runs format→Markdown extractors, writes KnowXContent snapshots. Connector-pipeline step — promotes concrete raw onto the KnowXContent abstract member.",
+      "name": "Promote content",
+      "description": "Reads landed content/raw file envelopes, runs format→Markdown extractors, writes Content snapshots. Connector-pipeline step — promotes concrete raw onto the Content abstract member.",
       "role": "connector",
       "capabilities": [
         "analyze"
@@ -1047,13 +1048,13 @@
       "outputs": [
         {
           "id": "contentDrafts",
-          "abstractType": "KnowXContent",
-          "description": "Canonical ContentRecordData drafts on KnowXContent"
+          "abstractType": "Content",
+          "description": "Canonical ContentRecordData drafts on Content"
         },
         {
           "id": "contentIds",
-          "abstractType": "KnowXContent",
-          "description": "Promoted KnowXContent record ids"
+          "abstractType": "Content",
+          "description": "Promoted Content record ids"
         }
       ],
       "invocation": {
@@ -1063,8 +1064,8 @@
     },
     {
       "id": "knowx-extract",
-      "name": "KnowX extract",
-      "description": "Extract KnowX NODE/EDGE knowledge-item drafts from KnowXContent (text + knowledge source, or promoted content). Each draft includes data.identity.category (claim|fact|opinion|assumption). Returns drafts only — does not persist. Pipeline write-record applies knowx content. When aiService is bound and AI_SKILLS_URL is set, Memorix invokes Catalox skill knowx.extract via ai-services/1. Fallback: KnowX worker; test-only KNOWX_AI_SIM=1 routes to APS AI sim (:5112).",
+      "name": "Extract knowledge",
+      "description": "Extract NODE/EDGE knowledge-item drafts from Content (text + knowledge source, or promoted content). Each draft includes data.identity.category (claim|fact|opinion|assumption). Returns drafts only — does not persist. Pipeline write-record applies knowx content. When aiService is bound and AI_SKILLS_URL is set, Memorix invokes Catalox skill knowx.extract via ai-services/1. Fallback: pack worker; test-only KNOWX_AI_SIM=1 routes to APS AI sim (:5112).",
       "role": "agent",
       "capabilities": [
         "analyze"
@@ -1076,33 +1077,33 @@
         {
           "id": "text",
           "control": true,
-          "description": "Input text to analyze (inline string or resolved from KnowXContent)"
+          "description": "Input text to analyze (inline string or resolved from Content)"
         },
         {
           "id": "knowledgeSource",
-          "abstractType": "KnowXContent",
-          "description": "Exact source bytes / provenance envelope for KnowXContent"
+          "abstractType": "Content",
+          "description": "Exact source bytes / provenance envelope for Content"
         },
         {
           "id": "contentId",
-          "abstractType": "KnowXContent",
-          "description": "Promoted KnowXContent record id — open via Explore"
+          "abstractType": "Content",
+          "description": "Promoted Content record id — open via Explore"
         },
         {
           "id": "contentIds",
-          "abstractType": "KnowXContent",
-          "description": "Batch of promoted KnowXContent ids"
+          "abstractType": "Content",
+          "description": "Batch of promoted Content ids"
         },
         {
           "id": "contentDrafts",
-          "abstractType": "KnowXContent",
+          "abstractType": "Content",
           "description": "In-pipeline ContentRecordData from knowx-promote-content"
         }
       ],
       "outputs": [
         {
           "id": "knowxDrafts",
-          "abstractType": "KnowXContent",
+          "abstractType": "Content",
           "description": "Array of knowx knowledge-item drafts (NODE/EDGE + data.identity.category claim|fact|opinion|assumption) with mandatory provenance and content lineage"
         }
       ],
@@ -1118,10 +1119,108 @@
         "notes": "Worker fallback when AI_SKILLS_URL unset / compile cannot resolve skill origin. KNOWX_EXTRACT_WORKER_URL honored only when KNOWX_AI_SIM=1 (test-only)."
       }
     },
+    {
+      "id": "knowx-retrieval-index",
+      "name": "Index / candidates (candidate-retrieval)",
+      "description": "Companion step for @x12i/candidate-retrival-service (MEMORIX_RETRIEVAL_URL, default local :6560). (1) POST /v1/candidates for open knowx drafts so associate sees corpus-scale priors, (2) POST /v1/index/upsert for knowx drafts (knowx.knowledge) and Content snapshots (knowx.snapshot). Soft-skips when URL unset or companion down — associate then falls back to Explore.",
+      "role": "agent",
+      "capabilities": [
+        "analyze"
+      ],
+      "memorixAccess": [],
+      "inputs": [
+        {
+          "id": "knowxDrafts",
+          "abstractType": "Content",
+          "description": "Drafts from knowx-extract / write path (candidates + upsert)"
+        },
+        {
+          "id": "contentDrafts",
+          "abstractType": "Content",
+          "description": "Optional Content snapshot drafts from knowx-promote-content (knowx.snapshot upsert)"
+        },
+        {
+          "id": "fetchCandidates",
+          "control": true,
+          "description": "When false, index only (no /v1/candidates). Default true when knowxDrafts present."
+        }
+      ],
+      "outputs": [
+        {
+          "id": "existingKnowx",
+          "abstractType": "Content",
+          "description": "Ranked prior knowx from /v1/candidates for associate (self-ids excluded)"
+        },
+        {
+          "id": "retrieval",
+          "control": true,
+          "description": "enabled / upserted / warnings for ops"
+        },
+        {
+          "id": "indexedRecordIds",
+          "control": true,
+          "description": "recordId / contentId list submitted for upsert"
+        }
+      ],
+      "invocation": {
+        "kind": "worker",
+        "operation": "knowx-retrieval-index",
+        "notes": "Requires MEMORIX_RETRIEVAL_URL (or CANDIDATE_RETRIEVAL_URL) pointing at the candidate-retrieval companion."
+      }
+    },
+    {
+      "id": "knowx-graphify",
+      "name": "Knowledge graph analyze (graphifier)",
+      "description": "Adapter for @x12i/memorix-graphifier (MEMORIX_GRAPHIFIER_URL, default local :7500). Maps KnowX pipeline bags (extract/promote/write) to graphifier items[], POSTs memorix-capability/1 analyze, returns graphDraft/patchPlan. Soft-skips when URL unset or companion down unless MEMORIX_GRAPHIFIER_REQUIRED=1. Persistence is platform write-record (create-or-update) after this step.",
+      "role": "agent",
+      "capabilities": [
+        "analyze"
+      ],
+      "memorixAccess": [],
+      "inputs": [
+        {
+          "id": "knowxDrafts",
+          "abstractType": "Content",
+          "description": "Drafts from knowx-extract / write path (structured items for graphifier)"
+        },
+        {
+          "id": "contentDrafts",
+          "abstractType": "Content",
+          "description": "Optional Content snapshot drafts from knowx-promote-content"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "graphDraft",
+          "control": true,
+          "description": "Deterministic nodes/edges draft from memorix-graphifier"
+        },
+        {
+          "id": "patchPlan",
+          "control": true,
+          "description": "Graph patch plan + sourceRefs (not applied by this step)"
+        },
+        {
+          "id": "graphify",
+          "control": true,
+          "description": "enabled / itemCount / warnings for ops"
+        },
+        {
+          "id": "diagnostics",
+          "control": true,
+          "description": "Remote worker diagnostics"
+        }
+      ],
+      "invocation": {
+        "kind": "worker",
+        "operation": "knowx-graphify",
+        "notes": "KnowX control-plane adapter; remote target is memorix-graphifier via MEMORIX_GRAPHIFIER_URL (alias GRAPHIFIER_URL)."
+      }
+    },
     {
       "id": "knowx-associate-knowledge",
-      "name": "KnowX associate knowledge",
-      "description": "Classify extracted drafts against existing KnowXContent scope: known, novel, contradicts. When aiService is bound, Memorix invokes Catalox skill knowx.associate-knowledge and pushes existingKnowx from Explore. Worker fallback fetches via memorix callback or accepts pushed existingKnowx. Returns classification buckets + candidate knowledge relationship plans. Does not persist.",
+      "name": "Associate knowledge",
+      "description": "Classify extracted drafts against existing Content scope: known, novel, contradicts. Prefer existingKnowx from knowx-retrieval-index (/v1/candidates). When aiService is bound, Memorix invokes Catalox skill knowx.associate-knowledge and may also push explore/catalog. Worker fallback uses pushed existingKnowx or Explore list. Returns classification buckets + candidate knowledge relationship plans. Does not persist.",
       "role": "agent",
       "capabilities": [
         "analyze"
@@ -1132,25 +1231,25 @@
       "inputs": [
         {
           "id": "knowxDrafts",
-          "abstractType": "KnowXContent",
+          "abstractType": "Content",
           "description": "Drafts from knowx-extract"
         },
         {
           "id": "existingKnowx",
-          "abstractType": "KnowXContent",
-          "description": "Optional pushed existing KnowXContent for offline/fixture runs"
+          "abstractType": "Content",
+          "description": "Optional: pipeline output from knowx-retrieval-index, fixtures, or Explore push"
         }
       ],
       "outputs": [
         {
           "id": "classification",
-          "abstractType": "KnowXContent",
+          "abstractType": "Content",
           "description": "known / novel / contradicts buckets"
         },
         {
           "id": "relationshipPlans",
-          "abstractType": "KnowXContent",
-          "description": "Candidate knowledge relationship plans on KnowXContent"
+          "abstractType": "Content",
+          "description": "Candidate knowledge relationship plans on Content"
         }
       ],
       "aiService": {
@@ -1166,8 +1265,8 @@
     },
     {
       "id": "knowx-associate-entities",
-      "name": "KnowX associate entities",
-      "description": "Plan EDGE endpoint relationships for novel drafts against entity abstracts (People, WorkItems) and KnowXContent. Does not persist.",
+      "name": "Associate entities",
+      "description": "Plan EDGE endpoint relationships for novel drafts against entity abstracts (People, WorkItems) and Content. Does not persist.",
       "role": "agent",
       "capabilities": [
         "analyze"
@@ -1178,7 +1277,7 @@
       "inputs": [
         {
           "id": "novelDrafts",
-          "abstractType": "KnowXContent",
+          "abstractType": "Content",
           "description": "Novel drafts from associate-knowledge classification"
         }
       ],
@@ -1186,7 +1285,7 @@
         {
           "id": "entityRelationshipPlans",
           "abstractType": "People",
-          "description": "EDGE endpoint relationship plans toward People, WorkItems, and KnowXContent abstracts"
+          "description": "EDGE endpoint relationship plans toward People, WorkItems, and Content abstracts"
         }
       ],
       "invocation": {
@@ -1212,9 +1311,9 @@
     },
     {
       "id": "knowx-ingest-associate",
-      "name": "KnowX ingest then associate knowledge and entities",
+      "name": "Ingest then associate knowledge and entities",
       "trigger": "explicit",
-      "description": "extract → write knowx → associate-knowledge → relationship-write → associate-entities → relationship-write. Services do not persist; write-record and relationship-write do.",
+      "description": "extract → write knowx → retrieval-index (candidate-retrieval upsert + candidates) → graphify (memorix-graphifier draft) → write-graph (persist) → write-graph-links + index-graph → associate-knowledge → relationship-write → associate-entities → relationship-write. Services do not persist; write-record and relationship-write do.",
       "steps": [
         {
           "id": "extract",
@@ -1235,17 +1334,111 @@
             }
           ]
         },
+        {
+          "id": "index-knowx",
+          "kind": "analyze",
+          "serviceId": "knowx-retrieval-index",
+          "dependsOn": [
+            "write-knowx"
+          ],
+          "inputs": [
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            },
+            {
+              "fromStep": "write-knowx",
+              "key": "write-knowx"
+            }
+          ],
+          "notes": "POST /v1/candidates for associate + /v1/index/upsert (knowx.knowledge). Soft-skip when MEMORIX_RETRIEVAL_URL unset."
+        },
+        {
+          "id": "graphify",
+          "kind": "analyze",
+          "serviceId": "knowx-graphify",
+          "dependsOn": [
+            "index-knowx"
+          ],
+          "inputs": [
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            },
+            {
+              "fromStep": "write-knowx",
+              "key": "write-knowx"
+            }
+          ],
+          "notes": "Remote memorix-graphifier analyze (graphDraft/patchPlan). Soft-skip when MEMORIX_GRAPHIFIER_URL unset/down. Platform write-record applies the draft."
+        },
+        {
+          "id": "write-graph",
+          "kind": "write-record",
+          "contentType": "snapshots",
+          "portConfig": {
+            "mode": "graphifier",
+            "objectType": "content",
+            "contentType": "snapshots",
+            "edgeDefinitionId": "knowx-derived-from"
+          },
+          "dependsOn": [
+            "graphify"
+          ],
+          "inputs": [
+            {
+              "fromStep": "graphify",
+              "key": "graphify"
+            }
+          ],
+          "notes": "Applies memorix-graphifier patchPlan/graphDraft (mode graphifier) → content/snapshots Knowledge graph artifact. Empty graph when companion soft-skips is a no-op success."
+        },
+        {
+          "id": "write-graph-links",
+          "kind": "relationship-write",
+          "dependsOn": [
+            "write-graph"
+          ],
+          "inputs": [
+            {
+              "fromStep": "write-graph",
+              "key": "write-graph"
+            }
+          ],
+          "notes": "Materializes graphDraft.edges as relationshipPlans when endpoints resolve to sourceRefs/recordIds (from write-graph)."
+        },
+        {
+          "id": "index-graph",
+          "kind": "analyze",
+          "serviceId": "knowx-retrieval-index",
+          "dependsOn": [
+            "write-graph"
+          ],
+          "inputs": [
+            {
+              "fromStep": "write-graph",
+              "key": "write-graph"
+            }
+          ],
+          "notes": "CRS knowx.snapshot upsert for knowledge-graph contentDrafts from write-graph. Soft-skip when CRS unset/down."
+        },
         {
           "id": "associate-knowledge",
           "kind": "analyze",
           "serviceId": "knowx-associate-knowledge",
           "dependsOn": [
-            "write-knowx"
+            "index-knowx",
+            "write-graph-links",
+            "index-graph"
           ],
           "inputs": [
             {
               "fromStep": "extract",
               "key": "extract"
+            },
+            {
+              "fromStep": "index-knowx",
+              "key": "index-knowx"
             }
           ]
         },
@@ -1295,9 +1488,9 @@
     },
     {
       "id": "knowx-ingest-content-source",
-      "name": "KnowX folder connector ingest then derive Knowledge",
+      "name": "Folder connector ingest then derive knowledge",
       "trigger": "explicit",
-      "description": "knowx-folder-pull (exact raw via CF collectStream) → knowx-promote-content (format→Markdown snapshots) → knowx-extract → write knowx → associate-knowledge → relationship-write → associate-entities → relationship-write.",
+      "description": "knowx-folder-pull → promote-content → index-snapshots (CRS knowx.snapshot) → extract → write knowx → index-knowx (CRS candidates + knowx.knowledge) → graphify (memorix-graphifier) → write-graph → write-graph-links + index-graph → associate-knowledge → relationship-write → associate-entities → relationship-write.",
       "steps": [
         {
           "id": "folder-pull",
@@ -1318,12 +1511,27 @@
             }
           ]
         },
+        {
+          "id": "index-snapshots",
+          "kind": "analyze",
+          "serviceId": "knowx-retrieval-index",
+          "dependsOn": [
+            "promote-content"
+          ],
+          "inputs": [
+            {
+              "fromStep": "promote-content",
+              "key": "promote-content"
+            }
+          ],
+          "notes": "Index Content snapshots only (knowx.snapshot; no knowxDrafts → no candidates). Soft-skip when CRS unset/down."
+        },
         {
           "id": "extract",
           "kind": "analyze",
           "serviceId": "knowx-extract",
           "dependsOn": [
-            "promote-content"
+            "index-snapshots"
           ],
           "inputs": [
             {
@@ -1346,12 +1554,110 @@
             }
           ]
         },
+        {
+          "id": "index-knowx",
+          "kind": "analyze",
+          "serviceId": "knowx-retrieval-index",
+          "dependsOn": [
+            "write-knowx"
+          ],
+          "inputs": [
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            },
+            {
+              "fromStep": "write-knowx",
+              "key": "write-knowx"
+            },
+            {
+              "fromStep": "promote-content",
+              "key": "promote-content"
+            }
+          ],
+          "notes": "POST /v1/candidates for associate + upsert knowx + re-touch snapshots."
+        },
+        {
+          "id": "graphify",
+          "kind": "analyze",
+          "serviceId": "knowx-graphify",
+          "dependsOn": [
+            "index-knowx"
+          ],
+          "inputs": [
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            },
+            {
+              "fromStep": "write-knowx",
+              "key": "write-knowx"
+            },
+            {
+              "fromStep": "promote-content",
+              "key": "promote-content"
+            }
+          ],
+          "notes": "Remote memorix-graphifier analyze from promote + extract bags. Soft-skip when graphifier unset/down. write-graph applies draft."
+        },
+        {
+          "id": "write-graph",
+          "kind": "write-record",
+          "contentType": "snapshots",
+          "portConfig": {
+            "mode": "graphifier",
+            "objectType": "content",
+            "contentType": "snapshots",
+            "edgeDefinitionId": "knowx-derived-from"
+          },
+          "dependsOn": [
+            "graphify"
+          ],
+          "inputs": [
+            {
+              "fromStep": "graphify",
+              "key": "graphify"
+            }
+          ],
+          "notes": "Applies memorix-graphifier patchPlan/graphDraft (mode graphifier) → content/snapshots graph artifact."
+        },
+        {
+          "id": "write-graph-links",
+          "kind": "relationship-write",
+          "dependsOn": [
+            "write-graph"
+          ],
+          "inputs": [
+            {
+              "fromStep": "write-graph",
+              "key": "write-graph"
+            }
+          ],
+          "notes": "Materializes graphDraft.edges as relationshipPlans when endpoints resolve to sourceRefs/recordIds (from write-graph)."
+        },
+        {
+          "id": "index-graph",
+          "kind": "analyze",
+          "serviceId": "knowx-retrieval-index",
+          "dependsOn": [
+            "write-graph"
+          ],
+          "inputs": [
+            {
+              "fromStep": "write-graph",
+              "key": "write-graph"
+            }
+          ],
+          "notes": "CRS knowx.snapshot upsert for knowledge-graph contentDrafts from write-graph. Soft-skip when CRS unset/down."
+        },
         {
           "id": "associate-knowledge",
           "kind": "analyze",
           "serviceId": "knowx-associate-knowledge",
           "dependsOn": [
-            "write-knowx"
+            "index-knowx",
+            "write-graph-links",
+            "index-graph"
           ],
           "inputs": [
             {
@@ -1361,6 +1667,10 @@
             {
               "fromStep": "write-knowx",
               "key": "write-knowx"
+            },
+            {
+              "fromStep": "index-knowx",
+              "key": "index-knowx"
             }
           ]
         },
@@ -1414,9 +1724,9 @@
     },
     {
       "id": "knowx-ingest-managed-item",
-      "name": "KnowX managed Drive item ingest then derive Knowledge",
+      "name": "Managed Drive item ingest then derive knowledge",
       "trigger": "explicit",
-      "description": "knowx-managed-pull (exact raw via CF collectStream) → knowx-promote-content → knowx-extract → write knowx → associate-knowledge → relationship-write → associate-entities → relationship-write.",
+      "description": "knowx-managed-pull → promote-content → index-snapshots (CRS) → extract → write knowx → index-knowx (CRS candidates + upsert) → graphify (memorix-graphifier) → write-graph → write-graph-links + index-graph → associate-knowledge → relationship-write → associate-entities → relationship-write.",
       "steps": [
         {
           "id": "managed-pull",
@@ -1437,12 +1747,27 @@
             }
           ]
         },
+        {
+          "id": "index-snapshots",
+          "kind": "analyze",
+          "serviceId": "knowx-retrieval-index",
+          "dependsOn": [
+            "promote-content"
+          ],
+          "inputs": [
+            {
+              "fromStep": "promote-content",
+              "key": "promote-content"
+            }
+          ],
+          "notes": "Index Content snapshots only (knowx.snapshot; no knowxDrafts → no candidates). Soft-skip when CRS unset/down."
+        },
         {
           "id": "extract",
           "kind": "analyze",
           "serviceId": "knowx-extract",
           "dependsOn": [
-            "promote-content"
+            "index-snapshots"
           ],
           "inputs": [
             {
@@ -1465,12 +1790,110 @@
             }
           ]
         },
+        {
+          "id": "index-knowx",
+          "kind": "analyze",
+          "serviceId": "knowx-retrieval-index",
+          "dependsOn": [
+            "write-knowx"
+          ],
+          "inputs": [
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            },
+            {
+              "fromStep": "write-knowx",
+              "key": "write-knowx"
+            },
+            {
+              "fromStep": "promote-content",
+              "key": "promote-content"
+            }
+          ],
+          "notes": "POST /v1/candidates for associate + upsert knowx + re-touch snapshots."
+        },
+        {
+          "id": "graphify",
+          "kind": "analyze",
+          "serviceId": "knowx-graphify",
+          "dependsOn": [
+            "index-knowx"
+          ],
+          "inputs": [
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            },
+            {
+              "fromStep": "write-knowx",
+              "key": "write-knowx"
+            },
+            {
+              "fromStep": "promote-content",
+              "key": "promote-content"
+            }
+          ],
+          "notes": "Remote memorix-graphifier analyze from promote + extract bags. Soft-skip when graphifier unset/down. write-graph applies draft."
+        },
+        {
+          "id": "write-graph",
+          "kind": "write-record",
+          "contentType": "snapshots",
+          "portConfig": {
+            "mode": "graphifier",
+            "objectType": "content",
+            "contentType": "snapshots",
+            "edgeDefinitionId": "knowx-derived-from"
+          },
+          "dependsOn": [
+            "graphify"
+          ],
+          "inputs": [
+            {
+              "fromStep": "graphify",
+              "key": "graphify"
+            }
+          ],
+          "notes": "Applies memorix-graphifier patchPlan/graphDraft (mode graphifier) → content/snapshots graph artifact."
+        },
+        {
+          "id": "write-graph-links",
+          "kind": "relationship-write",
+          "dependsOn": [
+            "write-graph"
+          ],
+          "inputs": [
+            {
+              "fromStep": "write-graph",
+              "key": "write-graph"
+            }
+          ],
+          "notes": "Materializes graphDraft.edges as relationshipPlans when endpoints resolve to sourceRefs/recordIds (from write-graph)."
+        },
+        {
+          "id": "index-graph",
+          "kind": "analyze",
+          "serviceId": "knowx-retrieval-index",
+          "dependsOn": [
+            "write-graph"
+          ],
+          "inputs": [
+            {
+              "fromStep": "write-graph",
+              "key": "write-graph"
+            }
+          ],
+          "notes": "CRS knowx.snapshot upsert for knowledge-graph contentDrafts from write-graph. Soft-skip when CRS unset/down."
+        },
         {
           "id": "associate-knowledge",
           "kind": "analyze",
           "serviceId": "knowx-associate-knowledge",
           "dependsOn": [
-            "write-knowx"
+            "index-knowx",
+            "write-graph-links",
+            "index-graph"
           ],
           "inputs": [
             {
@@ -1480,6 +1903,10 @@
             {
               "fromStep": "write-knowx",
               "key": "write-knowx"
+            },
+            {
+              "fromStep": "index-knowx",
+              "key": "index-knowx"
             }
           ]
         },