@x12i/memorix-docs 1.0.2 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (236) hide show
  1. package/dist/generated/bundle.d.ts +4849 -3
  2. package/dist/generated/bundle.d.ts.map +1 -1
  3. package/dist/generated/bundle.js +7580 -45
  4. package/dist/generated/bundle.js.map +1 -1
  5. package/dist/index.d.ts +2 -2
  6. package/dist/index.d.ts.map +1 -1
  7. package/dist/index.js +6 -4
  8. package/dist/index.js.map +1 -1
  9. package/files/INDEX.md +84 -0
  10. package/files/SEARCH.json +3087 -0
  11. package/files/agent-manifest.json +1785 -0
  12. package/files/apis/memorix-records/overview.md +22 -0
  13. package/files/concepts/abstracts-bindings.md +27 -0
  14. package/files/concepts/agents-inheritance.md +28 -0
  15. package/files/concepts/analysis-objects.md +26 -0
  16. package/files/concepts/composition.md +27 -0
  17. package/files/concepts/decisions-content.md +27 -0
  18. package/files/concepts/effective-metadata.md +27 -0
  19. package/files/concepts/explicit-metadata-installation.md +26 -0
  20. package/files/concepts/intelligence-proposals.md +27 -0
  21. package/files/concepts/mappings-transforms.md +26 -0
  22. package/files/concepts/object-content-category.md +26 -0
  23. package/files/concepts/org-agent-scope.md +27 -0
  24. package/files/concepts/people-union.md +27 -0
  25. package/files/concepts/raw-records.md +26 -0
  26. package/files/concepts/record-revisions.md +26 -0
  27. package/files/concepts/relationship-definitions.md +26 -0
  28. package/files/concepts/relationship-references.md +27 -0
  29. package/files/concepts/resolved-unresolved.md +27 -0
  30. package/files/concepts/sources-and-memory.md +26 -0
  31. package/files/concepts/traversal.md +27 -0
  32. package/files/diagrams/agent-inheritance.md +34 -0
  33. package/files/diagrams/intelligence-journey.md +38 -0
  34. package/files/diagrams/memorix-central-journey.md +51 -0
  35. package/files/diagrams/metadata-lifecycle.md +40 -0
  36. package/files/diagrams/people-union-diagram.md +36 -0
  37. package/files/diagrams/record-content-model.md +43 -0
  38. package/files/diagrams/relationship-traversal.md +40 -0
  39. package/files/diagrams/revision-safe-write.md +39 -0
  40. package/files/examples/analysis-decision-records.md +11 -0
  41. package/files/examples/memorix-record-envelope.md +11 -0
  42. package/files/examples/metadata-pack-install.md +11 -0
  43. package/files/examples/people-abstract-query.md +11 -0
  44. package/files/examples/raw-vs-composed.md +11 -0
  45. package/files/examples/relationship-def-and-ref.md +11 -0
  46. package/files/examples/revision-conflict-response.md +11 -0
  47. package/files/examples/revision-safe-write.md +11 -0
  48. package/files/examples/traversal-resolved-unresolved.md +11 -0
  49. package/files/glossary/abstract.md +9 -0
  50. package/files/glossary/agent.md +9 -0
  51. package/files/glossary/analysis.md +9 -0
  52. package/files/glossary/binding.md +9 -0
  53. package/files/glossary/composition.md +9 -0
  54. package/files/glossary/content-type.md +9 -0
  55. package/files/glossary/data-category.md +9 -0
  56. package/files/glossary/decision.md +9 -0
  57. package/files/glossary/effective-metadata.md +9 -0
  58. package/files/glossary/intelligence-proposal.md +9 -0
  59. package/files/glossary/mapping.md +9 -0
  60. package/files/glossary/memory.md +9 -0
  61. package/files/glossary/object-type.md +9 -0
  62. package/files/glossary/relationship-definition.md +9 -0
  63. package/files/glossary/relationship-reference.md +9 -0
  64. package/files/glossary/revision.md +9 -0
  65. package/files/glossary/scope.md +9 -0
  66. package/files/glossary/source.md +9 -0
  67. package/files/glossary/traversal.md +9 -0
  68. package/files/guides/apply-scope.md +40 -0
  69. package/files/guides/choose-access-method.md +24 -0
  70. package/files/guides/compose-subject-ui.md +24 -0
  71. package/files/guides/define-traverse-relationship.md +26 -0
  72. package/files/guides/diagnose-unresolved.md +24 -0
  73. package/files/guides/evidence-to-decision.md +25 -0
  74. package/files/guides/first-revision-safe-write.md +30 -0
  75. package/files/guides/inspect-effective-metadata.md +30 -0
  76. package/files/guides/query-people-abstract.md +25 -0
  77. package/files/guides/reload-retry-conflict.md +32 -0
  78. package/files/guides/validate-install-pack.md +32 -0
  79. package/files/indexes/books.json +95 -0
  80. package/files/indexes/books.md +17 -0
  81. package/files/indexes/concepts.json +119 -0
  82. package/files/indexes/concepts.md +21 -0
  83. package/files/indexes/diagrams.json +53 -0
  84. package/files/indexes/diagrams.md +10 -0
  85. package/files/indexes/guides.json +71 -0
  86. package/files/indexes/guides.md +13 -0
  87. package/files/indexes/scenarios.json +41 -0
  88. package/files/indexes/scenarios.md +8 -0
  89. package/files/indexes/tutorials.json +47 -0
  90. package/files/indexes/tutorials.md +9 -0
  91. package/files/indexes/use-cases.json +239 -0
  92. package/files/indexes/use-cases.md +41 -0
  93. package/files/knowledge.json +2940 -0
  94. package/files/packs/concept/abstracts-bindings/PACK.md +11 -0
  95. package/files/packs/concept/abstracts-bindings/pack.json +13 -0
  96. package/files/packs/concept/agents-inheritance/PACK.md +11 -0
  97. package/files/packs/concept/agents-inheritance/pack.json +13 -0
  98. package/files/packs/concept/analysis-objects/PACK.md +11 -0
  99. package/files/packs/concept/analysis-objects/pack.json +14 -0
  100. package/files/packs/concept/composition/PACK.md +11 -0
  101. package/files/packs/concept/composition/pack.json +13 -0
  102. package/files/packs/concept/decisions-content/PACK.md +11 -0
  103. package/files/packs/concept/decisions-content/pack.json +13 -0
  104. package/files/packs/concept/effective-metadata/PACK.md +11 -0
  105. package/files/packs/concept/effective-metadata/pack.json +13 -0
  106. package/files/packs/concept/explicit-metadata-installation/PACK.md +11 -0
  107. package/files/packs/concept/explicit-metadata-installation/pack.json +14 -0
  108. package/files/packs/concept/intelligence-proposals/PACK.md +11 -0
  109. package/files/packs/concept/intelligence-proposals/pack.json +13 -0
  110. package/files/packs/concept/mappings-transforms/PACK.md +11 -0
  111. package/files/packs/concept/mappings-transforms/pack.json +13 -0
  112. package/files/packs/concept/object-content-category/PACK.md +11 -0
  113. package/files/packs/concept/object-content-category/pack.json +14 -0
  114. package/files/packs/concept/org-agent-scope/PACK.md +11 -0
  115. package/files/packs/concept/org-agent-scope/pack.json +14 -0
  116. package/files/packs/concept/people-union/PACK.md +11 -0
  117. package/files/packs/concept/people-union/pack.json +13 -0
  118. package/files/packs/concept/raw-records/PACK.md +11 -0
  119. package/files/packs/concept/raw-records/pack.json +14 -0
  120. package/files/packs/concept/record-revisions/PACK.md +11 -0
  121. package/files/packs/concept/record-revisions/pack.json +13 -0
  122. package/files/packs/concept/relationship-definitions/PACK.md +11 -0
  123. package/files/packs/concept/relationship-definitions/pack.json +14 -0
  124. package/files/packs/concept/relationship-references/PACK.md +11 -0
  125. package/files/packs/concept/relationship-references/pack.json +13 -0
  126. package/files/packs/concept/resolved-unresolved/PACK.md +11 -0
  127. package/files/packs/concept/resolved-unresolved/pack.json +13 -0
  128. package/files/packs/concept/sources-and-memory/PACK.md +11 -0
  129. package/files/packs/concept/sources-and-memory/pack.json +13 -0
  130. package/files/packs/concept/traversal/PACK.md +11 -0
  131. package/files/packs/concept/traversal/pack.json +13 -0
  132. package/files/packs/guide/apply-scope/PACK.md +11 -0
  133. package/files/packs/guide/apply-scope/pack.json +13 -0
  134. package/files/packs/guide/choose-access-method/PACK.md +11 -0
  135. package/files/packs/guide/choose-access-method/pack.json +15 -0
  136. package/files/packs/guide/compose-subject-ui/PACK.md +11 -0
  137. package/files/packs/guide/compose-subject-ui/pack.json +13 -0
  138. package/files/packs/guide/define-traverse-relationship/PACK.md +11 -0
  139. package/files/packs/guide/define-traverse-relationship/pack.json +14 -0
  140. package/files/packs/guide/diagnose-unresolved/PACK.md +11 -0
  141. package/files/packs/guide/diagnose-unresolved/pack.json +13 -0
  142. package/files/packs/guide/evidence-to-decision/PACK.md +11 -0
  143. package/files/packs/guide/evidence-to-decision/pack.json +14 -0
  144. package/files/packs/guide/first-revision-safe-write/PACK.md +11 -0
  145. package/files/packs/guide/first-revision-safe-write/pack.json +13 -0
  146. package/files/packs/guide/inspect-effective-metadata/PACK.md +11 -0
  147. package/files/packs/guide/inspect-effective-metadata/pack.json +13 -0
  148. package/files/packs/guide/query-people-abstract/PACK.md +11 -0
  149. package/files/packs/guide/query-people-abstract/pack.json +13 -0
  150. package/files/packs/guide/reload-retry-conflict/PACK.md +11 -0
  151. package/files/packs/guide/reload-retry-conflict/pack.json +13 -0
  152. package/files/packs/guide/validate-install-pack/PACK.md +11 -0
  153. package/files/packs/guide/validate-install-pack/pack.json +13 -0
  154. package/files/packs/scenario/choose-subject-view/PACK.md +11 -0
  155. package/files/packs/scenario/choose-subject-view/pack.json +11 -0
  156. package/files/packs/scenario/pack-valid-not-installed/PACK.md +11 -0
  157. package/files/packs/scenario/pack-valid-not-installed/pack.json +11 -0
  158. package/files/packs/scenario/scope-mismatch/PACK.md +11 -0
  159. package/files/packs/scenario/scope-mismatch/pack.json +11 -0
  160. package/files/packs/scenario/stale-revision-conflict/PACK.md +11 -0
  161. package/files/packs/scenario/stale-revision-conflict/pack.json +11 -0
  162. package/files/packs/scenario/traversal-direction/PACK.md +11 -0
  163. package/files/packs/scenario/traversal-direction/pack.json +11 -0
  164. package/files/packs/scenario/unresolved-relationship/PACK.md +11 -0
  165. package/files/packs/scenario/unresolved-relationship/pack.json +11 -0
  166. package/files/packs/tutorial/analysis-decision-lab/PACK.md +11 -0
  167. package/files/packs/tutorial/analysis-decision-lab/pack.json +14 -0
  168. package/files/packs/tutorial/compare-views/PACK.md +11 -0
  169. package/files/packs/tutorial/compare-views/pack.json +14 -0
  170. package/files/packs/tutorial/conflict-lab/PACK.md +11 -0
  171. package/files/packs/tutorial/conflict-lab/pack.json +13 -0
  172. package/files/packs/tutorial/first-revision-safe-record/PACK.md +11 -0
  173. package/files/packs/tutorial/first-revision-safe-record/pack.json +13 -0
  174. package/files/packs/tutorial/install-pack-lab/PACK.md +11 -0
  175. package/files/packs/tutorial/install-pack-lab/pack.json +13 -0
  176. package/files/packs/tutorial/relationships-lab/PACK.md +11 -0
  177. package/files/packs/tutorial/relationships-lab/pack.json +13 -0
  178. package/files/packs/tutorial/start-with-sample-data/PACK.md +11 -0
  179. package/files/packs/tutorial/start-with-sample-data/pack.json +13 -0
  180. package/files/sample-data/memorix-synthetic-basic.md +13 -0
  181. package/files/scenarios/choose-subject-view.md +36 -0
  182. package/files/scenarios/pack-valid-not-installed.md +33 -0
  183. package/files/scenarios/scope-mismatch.md +44 -0
  184. package/files/scenarios/stale-revision-conflict.md +38 -0
  185. package/files/scenarios/traversal-direction.md +30 -0
  186. package/files/scenarios/unresolved-relationship.md +31 -0
  187. package/files/tutorials/analysis-decision-lab.md +18 -0
  188. package/files/tutorials/compare-views.md +22 -0
  189. package/files/tutorials/conflict-lab.md +18 -0
  190. package/files/tutorials/first-revision-safe-record.md +18 -0
  191. package/files/tutorials/install-pack-lab.md +22 -0
  192. package/files/tutorials/relationships-lab.md +18 -0
  193. package/files/tutorials/start-with-sample-data.md +18 -0
  194. package/files/ui/clients/memorix-studio.md +9 -0
  195. package/files/use-cases/abstract-people-list.md +237 -0
  196. package/files/use-cases/ai-pipeline-fail-closed.md +117 -0
  197. package/files/use-cases/author-pipeline-e2e.md +339 -0
  198. package/files/use-cases/build-callable-service.md +347 -0
  199. package/files/use-cases/builder-acceptance-ops.md +112 -0
  200. package/files/use-cases/choose-access-method.md +111 -0
  201. package/files/use-cases/client-first-read-write.md +374 -0
  202. package/files/use-cases/compose-for-ui.md +97 -0
  203. package/files/use-cases/custom-kind-descriptors.md +137 -0
  204. package/files/use-cases/data-journey-evidence.md +115 -0
  205. package/files/use-cases/discriminated-content-writes.md +152 -0
  206. package/files/use-cases/embed-studio-host.md +165 -0
  207. package/files/use-cases/four-field-links.md +246 -0
  208. package/files/use-cases/http-process-compliance.md +225 -0
  209. package/files/use-cases/install-metadata-pack.md +180 -0
  210. package/files/use-cases/intelligence-propose-install.md +163 -0
  211. package/files/use-cases/knowx-claims-review.md +396 -0
  212. package/files/use-cases/learn-record-envelope.md +233 -0
  213. package/files/use-cases/lists-cursors-pagination.md +196 -0
  214. package/files/use-cases/local-acceptance-g12ops.md +160 -0
  215. package/files/use-cases/memory-hourly-ingest.md +276 -0
  216. package/files/use-cases/metadata-before-write.md +145 -0
  217. package/files/use-cases/migrate-associated-star.md +159 -0
  218. package/files/use-cases/openapi-typed-client.md +78 -0
  219. package/files/use-cases/ops-pack-fixtures.md +168 -0
  220. package/files/use-cases/orient-platform.md +172 -0
  221. package/files/use-cases/pipeline-retry-evidence.md +121 -0
  222. package/files/use-cases/relationship-rebuild-verify.md +128 -0
  223. package/files/use-cases/revision-stale-conflicts.md +194 -0
  224. package/files/use-cases/start-from-zero.md +171 -0
  225. package/files/use-cases/studio-design-types.md +122 -0
  226. package/files/use-cases/studio-explore-subject.md +89 -0
  227. package/files/use-cases/studio-operate-pipelines.md +100 -0
  228. package/files/use-cases/studio-review-intelligence.md +74 -0
  229. package/files/use-cases/studio-scope-isolation.md +67 -0
  230. package/files/use-cases/studio-stale-conflict-ui.md +54 -0
  231. package/files/use-cases/troubleshoot-http-matrix.md +164 -0
  232. package/files/use-cases/trusted-in-process-embed.md +94 -0
  233. package/files/use-cases/workflow-sibling-api.md +212 -0
  234. package/files/visuals/revision-conflict.md +19 -0
  235. package/files/visuals/scope-apply.md +19 -0
  236. package/package.json +4 -3
@@ -0,0 +1,3087 @@
1
+ {
2
+ "version": 1,
3
+ "product": "memorix",
4
+ "generatedAt": "2026-07-26T10:51:49.354Z",
5
+ "records": [
6
+ {
7
+ "id": "org-agent-scope",
8
+ "type": "concept",
9
+ "title": "Organization and agent scope",
10
+ "summary": "Scope selects which organization and agent context reads and writes apply to.",
11
+ "aliases": [],
12
+ "audiences": [
13
+ "developers",
14
+ "builders"
15
+ ],
16
+ "tags": [
17
+ "scope"
18
+ ],
19
+ "goals": [],
20
+ "path": "concepts/org-agent-scope.md",
21
+ "webPath": "/concepts/org-agent-scope",
22
+ "prerequisites": [],
23
+ "related": [
24
+ "agents-inheritance",
25
+ "effective-metadata"
26
+ ],
27
+ "packIds": [
28
+ "concept/org-agent-scope"
29
+ ]
30
+ },
31
+ {
32
+ "id": "agents-inheritance",
33
+ "type": "concept",
34
+ "title": "Agents and inheritance",
35
+ "summary": "Child agents inherit definitions; Studio shows the effective result.",
36
+ "aliases": [],
37
+ "audiences": [
38
+ "developers",
39
+ "builders"
40
+ ],
41
+ "tags": [
42
+ "agents"
43
+ ],
44
+ "goals": [],
45
+ "path": "concepts/agents-inheritance.md",
46
+ "webPath": "/concepts/agents-inheritance",
47
+ "prerequisites": [
48
+ "org-agent-scope"
49
+ ],
50
+ "related": [
51
+ "effective-metadata"
52
+ ],
53
+ "packIds": [
54
+ "concept/agents-inheritance"
55
+ ]
56
+ },
57
+ {
58
+ "id": "sources-and-memory",
59
+ "type": "concept",
60
+ "title": "Sources and Memory",
61
+ "summary": "Sources feed Memory; Memory holds durable product records.",
62
+ "aliases": [],
63
+ "audiences": [
64
+ "developers",
65
+ "builders"
66
+ ],
67
+ "tags": [
68
+ "memory"
69
+ ],
70
+ "goals": [],
71
+ "path": "concepts/sources-and-memory.md",
72
+ "webPath": "/concepts/sources-and-memory",
73
+ "prerequisites": [],
74
+ "related": [
75
+ "raw-records"
76
+ ],
77
+ "packIds": [
78
+ "concept/sources-and-memory"
79
+ ]
80
+ },
81
+ {
82
+ "id": "object-content-category",
83
+ "type": "concept",
84
+ "title": "Object type, content type, and data category",
85
+ "summary": "Identity, payload shape, and category are separate axes.",
86
+ "aliases": [],
87
+ "audiences": [
88
+ "developers"
89
+ ],
90
+ "tags": [
91
+ "model"
92
+ ],
93
+ "goals": [],
94
+ "path": "concepts/object-content-category.md",
95
+ "webPath": "/concepts/object-content-category",
96
+ "prerequisites": [],
97
+ "related": [
98
+ "raw-records",
99
+ "composition"
100
+ ],
101
+ "packIds": [
102
+ "concept/object-content-category"
103
+ ]
104
+ },
105
+ {
106
+ "id": "explicit-metadata-installation",
107
+ "type": "concept",
108
+ "title": "Explicit metadata validation and installation",
109
+ "summary": "Validation does not install; installation requires confirmation.",
110
+ "aliases": [],
111
+ "audiences": [
112
+ "builders",
113
+ "developers"
114
+ ],
115
+ "tags": [
116
+ "metadata"
117
+ ],
118
+ "goals": [],
119
+ "path": "concepts/explicit-metadata-installation.md",
120
+ "webPath": "/concepts/explicit-metadata-installation",
121
+ "prerequisites": [],
122
+ "related": [
123
+ "intelligence-proposals",
124
+ "effective-metadata"
125
+ ],
126
+ "packIds": [
127
+ "concept/explicit-metadata-installation"
128
+ ]
129
+ },
130
+ {
131
+ "id": "effective-metadata",
132
+ "type": "concept",
133
+ "title": "Effective metadata",
134
+ "summary": "The resolved definitions after inheritance and installation.",
135
+ "aliases": [],
136
+ "audiences": [
137
+ "developers",
138
+ "builders"
139
+ ],
140
+ "tags": [
141
+ "metadata"
142
+ ],
143
+ "goals": [],
144
+ "path": "concepts/effective-metadata.md",
145
+ "webPath": "/concepts/effective-metadata",
146
+ "prerequisites": [
147
+ "explicit-metadata-installation",
148
+ "agents-inheritance"
149
+ ],
150
+ "related": [
151
+ "org-agent-scope"
152
+ ],
153
+ "packIds": [
154
+ "concept/effective-metadata"
155
+ ]
156
+ },
157
+ {
158
+ "id": "abstracts-bindings",
159
+ "type": "concept",
160
+ "title": "Abstracts and bindings",
161
+ "summary": "An abstract is a virtual union projected through bindings — not stored rows.",
162
+ "aliases": [],
163
+ "audiences": [
164
+ "developers",
165
+ "builders"
166
+ ],
167
+ "tags": [
168
+ "abstracts"
169
+ ],
170
+ "goals": [],
171
+ "path": "concepts/abstracts-bindings.md",
172
+ "webPath": "/concepts/abstracts-bindings",
173
+ "prerequisites": [],
174
+ "related": [
175
+ "people-union"
176
+ ],
177
+ "packIds": [
178
+ "concept/abstracts-bindings"
179
+ ]
180
+ },
181
+ {
182
+ "id": "people-union",
183
+ "type": "concept",
184
+ "title": "People union",
185
+ "summary": "People combines employees and contractors through explicit bindings.",
186
+ "aliases": [],
187
+ "audiences": [
188
+ "developers",
189
+ "builders"
190
+ ],
191
+ "tags": [
192
+ "abstracts"
193
+ ],
194
+ "goals": [],
195
+ "path": "concepts/people-union.md",
196
+ "webPath": "/concepts/people-union",
197
+ "prerequisites": [
198
+ "abstracts-bindings"
199
+ ],
200
+ "related": [
201
+ "composition"
202
+ ],
203
+ "packIds": [
204
+ "concept/people-union"
205
+ ]
206
+ },
207
+ {
208
+ "id": "mappings-transforms",
209
+ "type": "concept",
210
+ "title": "Mappings and transforms",
211
+ "summary": "Mappings describe how source shapes become Memory content.",
212
+ "aliases": [],
213
+ "audiences": [
214
+ "developers"
215
+ ],
216
+ "tags": [
217
+ "mapping"
218
+ ],
219
+ "goals": [],
220
+ "path": "concepts/mappings-transforms.md",
221
+ "webPath": "/concepts/mappings-transforms",
222
+ "prerequisites": [],
223
+ "related": [
224
+ "raw-records"
225
+ ],
226
+ "packIds": [
227
+ "concept/mappings-transforms"
228
+ ]
229
+ },
230
+ {
231
+ "id": "raw-records",
232
+ "type": "concept",
233
+ "title": "Raw records",
234
+ "summary": "Raw retains the original payload beside envelope metadata.",
235
+ "aliases": [],
236
+ "audiences": [
237
+ "developers",
238
+ "builders"
239
+ ],
240
+ "tags": [
241
+ "records"
242
+ ],
243
+ "goals": [],
244
+ "path": "concepts/raw-records.md",
245
+ "webPath": "/concepts/raw-records",
246
+ "prerequisites": [],
247
+ "related": [
248
+ "composition",
249
+ "object-content-category"
250
+ ],
251
+ "packIds": [
252
+ "concept/raw-records"
253
+ ]
254
+ },
255
+ {
256
+ "id": "composition",
257
+ "type": "concept",
258
+ "title": "Same-subject composition",
259
+ "summary": "Multiple content instances can belong to one subject when composition is explicit.",
260
+ "aliases": [],
261
+ "audiences": [
262
+ "developers",
263
+ "builders"
264
+ ],
265
+ "tags": [
266
+ "composition"
267
+ ],
268
+ "goals": [],
269
+ "path": "concepts/composition.md",
270
+ "webPath": "/concepts/composition",
271
+ "prerequisites": [
272
+ "raw-records"
273
+ ],
274
+ "related": [
275
+ "people-union"
276
+ ],
277
+ "packIds": [
278
+ "concept/composition"
279
+ ]
280
+ },
281
+ {
282
+ "id": "relationship-definitions",
283
+ "type": "concept",
284
+ "title": "Relationship definitions",
285
+ "summary": "A relationship definition is metadata describing allowed links — not a stored edge on a record.",
286
+ "aliases": [],
287
+ "audiences": [
288
+ "developers"
289
+ ],
290
+ "tags": [
291
+ "relationships"
292
+ ],
293
+ "goals": [],
294
+ "path": "concepts/relationship-definitions.md",
295
+ "webPath": "/concepts/relationship-definitions",
296
+ "prerequisites": [],
297
+ "related": [
298
+ "relationship-references",
299
+ "traversal"
300
+ ],
301
+ "packIds": [
302
+ "concept/relationship-definitions"
303
+ ]
304
+ },
305
+ {
306
+ "id": "relationship-references",
307
+ "type": "concept",
308
+ "title": "Stored relationship references",
309
+ "summary": "Records store relationship references that point at targets under a definition.",
310
+ "aliases": [],
311
+ "audiences": [
312
+ "developers"
313
+ ],
314
+ "tags": [
315
+ "relationships"
316
+ ],
317
+ "goals": [],
318
+ "path": "concepts/relationship-references.md",
319
+ "webPath": "/concepts/relationship-references",
320
+ "prerequisites": [
321
+ "relationship-definitions"
322
+ ],
323
+ "related": [
324
+ "resolved-unresolved"
325
+ ],
326
+ "packIds": [
327
+ "concept/relationship-references"
328
+ ]
329
+ },
330
+ {
331
+ "id": "traversal",
332
+ "type": "concept",
333
+ "title": "Forward and inverse traversal",
334
+ "summary": "Traversal follows definitions forward or inverse, optionally expanding targets.",
335
+ "aliases": [],
336
+ "audiences": [
337
+ "developers"
338
+ ],
339
+ "tags": [
340
+ "relationships"
341
+ ],
342
+ "goals": [],
343
+ "path": "concepts/traversal.md",
344
+ "webPath": "/concepts/traversal",
345
+ "prerequisites": [
346
+ "relationship-references"
347
+ ],
348
+ "related": [
349
+ "resolved-unresolved"
350
+ ],
351
+ "packIds": [
352
+ "concept/traversal"
353
+ ]
354
+ },
355
+ {
356
+ "id": "resolved-unresolved",
357
+ "type": "concept",
358
+ "title": "Resolved and unresolved relationships",
359
+ "summary": "Unresolved targets are retained and shown — not silently dropped.",
360
+ "aliases": [],
361
+ "audiences": [
362
+ "developers",
363
+ "builders"
364
+ ],
365
+ "tags": [
366
+ "relationships"
367
+ ],
368
+ "goals": [],
369
+ "path": "concepts/resolved-unresolved.md",
370
+ "webPath": "/concepts/resolved-unresolved",
371
+ "prerequisites": [
372
+ "traversal"
373
+ ],
374
+ "related": [
375
+ "relationship-references"
376
+ ],
377
+ "packIds": [
378
+ "concept/resolved-unresolved"
379
+ ]
380
+ },
381
+ {
382
+ "id": "record-revisions",
383
+ "type": "concept",
384
+ "title": "Record revisions and stale-write conflicts",
385
+ "summary": "Writes carry an expected revision; stale writers cannot overwrite newer data.",
386
+ "aliases": [],
387
+ "audiences": [
388
+ "developers",
389
+ "builders"
390
+ ],
391
+ "tags": [
392
+ "concurrency"
393
+ ],
394
+ "goals": [],
395
+ "path": "concepts/record-revisions.md",
396
+ "webPath": "/concepts/record-revisions",
397
+ "prerequisites": [],
398
+ "related": [
399
+ "raw-records"
400
+ ],
401
+ "packIds": [
402
+ "concept/record-revisions"
403
+ ]
404
+ },
405
+ {
406
+ "id": "analysis-objects",
407
+ "type": "concept",
408
+ "title": "Analysis objects",
409
+ "summary": "Analysis captures evaluated evidence distinct from operational decisions.",
410
+ "aliases": [],
411
+ "audiences": [
412
+ "developers",
413
+ "builders"
414
+ ],
415
+ "tags": [
416
+ "analysis"
417
+ ],
418
+ "goals": [],
419
+ "path": "concepts/analysis-objects.md",
420
+ "webPath": "/concepts/analysis-objects",
421
+ "prerequisites": [],
422
+ "related": [
423
+ "decisions-content",
424
+ "intelligence-proposals"
425
+ ],
426
+ "packIds": [
427
+ "concept/analysis-objects"
428
+ ]
429
+ },
430
+ {
431
+ "id": "decisions-content",
432
+ "type": "concept",
433
+ "title": "Decisions",
434
+ "summary": "Decisions record chosen actions distinct from analysis content.",
435
+ "aliases": [],
436
+ "audiences": [
437
+ "developers",
438
+ "builders"
439
+ ],
440
+ "tags": [
441
+ "decisions"
442
+ ],
443
+ "goals": [],
444
+ "path": "concepts/decisions-content.md",
445
+ "webPath": "/concepts/decisions-content",
446
+ "prerequisites": [
447
+ "analysis-objects"
448
+ ],
449
+ "related": [
450
+ "intelligence-proposals"
451
+ ],
452
+ "packIds": [
453
+ "concept/decisions-content"
454
+ ]
455
+ },
456
+ {
457
+ "id": "intelligence-proposals",
458
+ "type": "concept",
459
+ "title": "Intelligence proposals",
460
+ "summary": "Intelligence may propose metadata or actions but never auto-installs them.",
461
+ "aliases": [],
462
+ "audiences": [
463
+ "builders",
464
+ "developers"
465
+ ],
466
+ "tags": [
467
+ "intelligence"
468
+ ],
469
+ "goals": [],
470
+ "path": "concepts/intelligence-proposals.md",
471
+ "webPath": "/concepts/intelligence-proposals",
472
+ "prerequisites": [
473
+ "explicit-metadata-installation"
474
+ ],
475
+ "related": [
476
+ "explicit-metadata-installation"
477
+ ],
478
+ "packIds": [
479
+ "concept/intelligence-proposals"
480
+ ]
481
+ },
482
+ {
483
+ "id": "apply-scope",
484
+ "type": "guide",
485
+ "title": "Select and apply organization/agent scope",
486
+ "summary": "Set the workspace scope before reading or writing.",
487
+ "aliases": [],
488
+ "audiences": [
489
+ "builders",
490
+ "developers"
491
+ ],
492
+ "tags": [
493
+ "scope"
494
+ ],
495
+ "goals": [],
496
+ "path": "guides/apply-scope.md",
497
+ "webPath": "/guides/apply-scope",
498
+ "prerequisites": [],
499
+ "related": [
500
+ "org-agent-scope"
501
+ ],
502
+ "packIds": [
503
+ "guide/apply-scope"
504
+ ]
505
+ },
506
+ {
507
+ "id": "inspect-effective-metadata",
508
+ "type": "guide",
509
+ "title": "Inspect effective metadata before read/write",
510
+ "summary": "Confirm effective definitions before mutating records.",
511
+ "aliases": [],
512
+ "audiences": [
513
+ "developers",
514
+ "builders"
515
+ ],
516
+ "tags": [
517
+ "metadata"
518
+ ],
519
+ "goals": [],
520
+ "path": "guides/inspect-effective-metadata.md",
521
+ "webPath": "/guides/inspect-effective-metadata",
522
+ "prerequisites": [
523
+ "apply-scope"
524
+ ],
525
+ "related": [
526
+ "effective-metadata"
527
+ ],
528
+ "packIds": [
529
+ "guide/inspect-effective-metadata"
530
+ ]
531
+ },
532
+ {
533
+ "id": "choose-access-method",
534
+ "type": "guide",
535
+ "title": "Choose raw, composed, or abstract access",
536
+ "summary": "Pick the fidelity that matches the caller goal.",
537
+ "aliases": [],
538
+ "audiences": [
539
+ "developers"
540
+ ],
541
+ "tags": [
542
+ "access"
543
+ ],
544
+ "goals": [],
545
+ "path": "guides/choose-access-method.md",
546
+ "webPath": "/guides/choose-access-method",
547
+ "prerequisites": [],
548
+ "related": [
549
+ "raw-records",
550
+ "composition",
551
+ "people-union"
552
+ ],
553
+ "packIds": [
554
+ "guide/choose-access-method"
555
+ ]
556
+ },
557
+ {
558
+ "id": "first-revision-safe-write",
559
+ "type": "guide",
560
+ "title": "Perform a first revision-safe read/write",
561
+ "summary": "Read a record, write with expected revision, verify.",
562
+ "aliases": [],
563
+ "audiences": [
564
+ "developers"
565
+ ],
566
+ "tags": [
567
+ "concurrency"
568
+ ],
569
+ "goals": [],
570
+ "path": "guides/first-revision-safe-write.md",
571
+ "webPath": "/guides/first-revision-safe-write",
572
+ "prerequisites": [],
573
+ "related": [
574
+ "record-revisions"
575
+ ],
576
+ "packIds": [
577
+ "guide/first-revision-safe-write"
578
+ ]
579
+ },
580
+ {
581
+ "id": "reload-retry-conflict",
582
+ "type": "guide",
583
+ "title": "Reload, compare, and retry after a revision conflict",
584
+ "summary": "Recover safely when a stale write is rejected.",
585
+ "aliases": [],
586
+ "audiences": [
587
+ "developers"
588
+ ],
589
+ "tags": [
590
+ "concurrency"
591
+ ],
592
+ "goals": [],
593
+ "path": "guides/reload-retry-conflict.md",
594
+ "webPath": "/guides/reload-retry-conflict",
595
+ "prerequisites": [],
596
+ "related": [
597
+ "record-revisions"
598
+ ],
599
+ "packIds": [
600
+ "guide/reload-retry-conflict"
601
+ ]
602
+ },
603
+ {
604
+ "id": "validate-install-pack",
605
+ "type": "guide",
606
+ "title": "Validate and explicitly install a metadata pack",
607
+ "summary": "Validate first, then confirm installation.",
608
+ "aliases": [],
609
+ "audiences": [
610
+ "builders",
611
+ "developers"
612
+ ],
613
+ "tags": [
614
+ "metadata"
615
+ ],
616
+ "goals": [],
617
+ "path": "guides/validate-install-pack.md",
618
+ "webPath": "/guides/validate-install-pack",
619
+ "prerequisites": [],
620
+ "related": [
621
+ "explicit-metadata-installation"
622
+ ],
623
+ "packIds": [
624
+ "guide/validate-install-pack"
625
+ ]
626
+ },
627
+ {
628
+ "id": "define-traverse-relationship",
629
+ "type": "guide",
630
+ "title": "Define and traverse a relationship",
631
+ "summary": "Author a definition, store a reference, traverse forward/inverse.",
632
+ "aliases": [],
633
+ "audiences": [
634
+ "developers"
635
+ ],
636
+ "tags": [
637
+ "relationships"
638
+ ],
639
+ "goals": [],
640
+ "path": "guides/define-traverse-relationship.md",
641
+ "webPath": "/guides/define-traverse-relationship",
642
+ "prerequisites": [],
643
+ "related": [
644
+ "relationship-definitions",
645
+ "traversal"
646
+ ],
647
+ "packIds": [
648
+ "guide/define-traverse-relationship"
649
+ ]
650
+ },
651
+ {
652
+ "id": "diagnose-unresolved",
653
+ "type": "guide",
654
+ "title": "Diagnose an unresolved relationship target",
655
+ "summary": "Distinguish intentional unresolved from broken targets.",
656
+ "aliases": [],
657
+ "audiences": [
658
+ "developers",
659
+ "builders"
660
+ ],
661
+ "tags": [
662
+ "relationships"
663
+ ],
664
+ "goals": [],
665
+ "path": "guides/diagnose-unresolved.md",
666
+ "webPath": "/guides/diagnose-unresolved",
667
+ "prerequisites": [],
668
+ "related": [
669
+ "resolved-unresolved"
670
+ ],
671
+ "packIds": [
672
+ "guide/diagnose-unresolved"
673
+ ]
674
+ },
675
+ {
676
+ "id": "compose-subject-ui",
677
+ "type": "guide",
678
+ "title": "Compose same-subject content for a UI",
679
+ "summary": "Load composition for a subject the UI will render.",
680
+ "aliases": [],
681
+ "audiences": [
682
+ "developers",
683
+ "builders"
684
+ ],
685
+ "tags": [
686
+ "composition"
687
+ ],
688
+ "goals": [],
689
+ "path": "guides/compose-subject-ui.md",
690
+ "webPath": "/guides/compose-subject-ui",
691
+ "prerequisites": [],
692
+ "related": [
693
+ "composition"
694
+ ],
695
+ "packIds": [
696
+ "guide/compose-subject-ui"
697
+ ]
698
+ },
699
+ {
700
+ "id": "query-people-abstract",
701
+ "type": "guide",
702
+ "title": "Query the People abstract view",
703
+ "summary": "Read employees and contractors through People bindings.",
704
+ "aliases": [],
705
+ "audiences": [
706
+ "developers",
707
+ "builders"
708
+ ],
709
+ "tags": [
710
+ "abstracts"
711
+ ],
712
+ "goals": [],
713
+ "path": "guides/query-people-abstract.md",
714
+ "webPath": "/guides/query-people-abstract",
715
+ "prerequisites": [
716
+ "inspect-effective-metadata"
717
+ ],
718
+ "related": [
719
+ "people-union"
720
+ ],
721
+ "packIds": [
722
+ "guide/query-people-abstract"
723
+ ]
724
+ },
725
+ {
726
+ "id": "evidence-to-decision",
727
+ "type": "guide",
728
+ "title": "Move from evidence to analysis and a decision",
729
+ "summary": "Record analysis, then a distinct decision.",
730
+ "aliases": [],
731
+ "audiences": [
732
+ "developers",
733
+ "builders"
734
+ ],
735
+ "tags": [
736
+ "workflow"
737
+ ],
738
+ "goals": [],
739
+ "path": "guides/evidence-to-decision.md",
740
+ "webPath": "/guides/evidence-to-decision",
741
+ "prerequisites": [],
742
+ "related": [
743
+ "analysis-objects",
744
+ "decisions-content"
745
+ ],
746
+ "packIds": [
747
+ "guide/evidence-to-decision"
748
+ ]
749
+ },
750
+ {
751
+ "id": "scope-mismatch",
752
+ "type": "scenario",
753
+ "title": "Scope does not match the intended workspace",
754
+ "summary": "Detected organization/agent scope differs from the task.",
755
+ "aliases": [],
756
+ "audiences": [
757
+ "builders",
758
+ "developers"
759
+ ],
760
+ "tags": [],
761
+ "goals": [
762
+ "Apply a different scope or stop?"
763
+ ],
764
+ "path": "scenarios/scope-mismatch.md",
765
+ "webPath": "/scenarios/scope-mismatch",
766
+ "prerequisites": [],
767
+ "related": [],
768
+ "packIds": [
769
+ "scenario/scope-mismatch"
770
+ ]
771
+ },
772
+ {
773
+ "id": "stale-revision-conflict",
774
+ "type": "scenario",
775
+ "title": "A write returns a stale-revision conflict",
776
+ "summary": "PATCH/PUT rejected because expected revision was stale.",
777
+ "aliases": [],
778
+ "audiences": [
779
+ "developers"
780
+ ],
781
+ "tags": [],
782
+ "goals": [
783
+ "Reapply from current revision or escalate?"
784
+ ],
785
+ "path": "scenarios/stale-revision-conflict.md",
786
+ "webPath": "/scenarios/stale-revision-conflict",
787
+ "prerequisites": [],
788
+ "related": [],
789
+ "packIds": [
790
+ "scenario/stale-revision-conflict"
791
+ ]
792
+ },
793
+ {
794
+ "id": "unresolved-relationship",
795
+ "type": "scenario",
796
+ "title": "A relationship target is unresolved",
797
+ "summary": "Traversal returns an unresolved target marker.",
798
+ "aliases": [],
799
+ "audiences": [
800
+ "developers",
801
+ "builders"
802
+ ],
803
+ "tags": [],
804
+ "goals": [
805
+ "Repair, wait, or preserve/escalate?"
806
+ ],
807
+ "path": "scenarios/unresolved-relationship.md",
808
+ "webPath": "/scenarios/unresolved-relationship",
809
+ "prerequisites": [],
810
+ "related": [],
811
+ "packIds": [
812
+ "scenario/unresolved-relationship"
813
+ ]
814
+ },
815
+ {
816
+ "id": "pack-valid-not-installed",
817
+ "type": "scenario",
818
+ "title": "A metadata pack is valid but not installed",
819
+ "summary": "Validation succeeded; runtime still on previous effective metadata.",
820
+ "aliases": [],
821
+ "audiences": [
822
+ "builders"
823
+ ],
824
+ "tags": [],
825
+ "goals": [
826
+ "Explicitly install or cancel?"
827
+ ],
828
+ "path": "scenarios/pack-valid-not-installed.md",
829
+ "webPath": "/scenarios/pack-valid-not-installed",
830
+ "prerequisites": [],
831
+ "related": [],
832
+ "packIds": [
833
+ "scenario/pack-valid-not-installed"
834
+ ]
835
+ },
836
+ {
837
+ "id": "choose-subject-view",
838
+ "type": "scenario",
839
+ "title": "A caller needs a subject view",
840
+ "summary": "Choose raw, composition, or abstract based on fidelity needs.",
841
+ "aliases": [],
842
+ "audiences": [
843
+ "developers"
844
+ ],
845
+ "tags": [],
846
+ "goals": [
847
+ "Raw, composed, or abstract?"
848
+ ],
849
+ "path": "scenarios/choose-subject-view.md",
850
+ "webPath": "/scenarios/choose-subject-view",
851
+ "prerequisites": [],
852
+ "related": [],
853
+ "packIds": [
854
+ "scenario/choose-subject-view"
855
+ ]
856
+ },
857
+ {
858
+ "id": "traversal-direction",
859
+ "type": "scenario",
860
+ "title": "Relationship traversal direction and expansion",
861
+ "summary": "Choose forward/inverse and expanded/unexpanded handling.",
862
+ "aliases": [],
863
+ "audiences": [
864
+ "developers"
865
+ ],
866
+ "tags": [],
867
+ "goals": [
868
+ "Which direction and expansion?"
869
+ ],
870
+ "path": "scenarios/traversal-direction.md",
871
+ "webPath": "/scenarios/traversal-direction",
872
+ "prerequisites": [],
873
+ "related": [],
874
+ "packIds": [
875
+ "scenario/traversal-direction"
876
+ ]
877
+ },
878
+ {
879
+ "id": "agent",
880
+ "type": "glossary",
881
+ "title": "Agent",
882
+ "summary": "An inheritance and configuration unit inside an organization.",
883
+ "aliases": [],
884
+ "audiences": [],
885
+ "tags": [],
886
+ "goals": [],
887
+ "path": "glossary/agent.md",
888
+ "prerequisites": [],
889
+ "related": [
890
+ "agents-inheritance"
891
+ ],
892
+ "packIds": []
893
+ },
894
+ {
895
+ "id": "scope",
896
+ "type": "glossary",
897
+ "title": "Scope",
898
+ "summary": "Selected organization and agent context for reads and writes.",
899
+ "aliases": [],
900
+ "audiences": [],
901
+ "tags": [],
902
+ "goals": [],
903
+ "path": "glossary/scope.md",
904
+ "prerequisites": [],
905
+ "related": [
906
+ "org-agent-scope"
907
+ ],
908
+ "packIds": []
909
+ },
910
+ {
911
+ "id": "source",
912
+ "type": "glossary",
913
+ "title": "Source",
914
+ "summary": "Origin that feeds content into Memory.",
915
+ "aliases": [],
916
+ "audiences": [],
917
+ "tags": [],
918
+ "goals": [],
919
+ "path": "glossary/source.md",
920
+ "prerequisites": [],
921
+ "related": [
922
+ "sources-and-memory"
923
+ ],
924
+ "packIds": []
925
+ },
926
+ {
927
+ "id": "memory",
928
+ "type": "glossary",
929
+ "title": "Memory",
930
+ "summary": "Durable store of Memorix records.",
931
+ "aliases": [],
932
+ "audiences": [],
933
+ "tags": [],
934
+ "goals": [],
935
+ "path": "glossary/memory.md",
936
+ "prerequisites": [],
937
+ "related": [
938
+ "sources-and-memory"
939
+ ],
940
+ "packIds": []
941
+ },
942
+ {
943
+ "id": "object-type",
944
+ "type": "glossary",
945
+ "title": "Object type",
946
+ "summary": "Identity kind for a record subject.",
947
+ "aliases": [],
948
+ "audiences": [],
949
+ "tags": [],
950
+ "goals": [],
951
+ "path": "glossary/object-type.md",
952
+ "prerequisites": [],
953
+ "related": [
954
+ "object-content-category"
955
+ ],
956
+ "packIds": []
957
+ },
958
+ {
959
+ "id": "content-type",
960
+ "type": "glossary",
961
+ "title": "Content type",
962
+ "summary": "Shape of a content instance on a subject.",
963
+ "aliases": [],
964
+ "audiences": [],
965
+ "tags": [],
966
+ "goals": [],
967
+ "path": "glossary/content-type.md",
968
+ "prerequisites": [],
969
+ "related": [
970
+ "object-content-category"
971
+ ],
972
+ "packIds": []
973
+ },
974
+ {
975
+ "id": "data-category",
976
+ "type": "glossary",
977
+ "title": "Data category",
978
+ "summary": "Category axis distinct from object and content type.",
979
+ "aliases": [],
980
+ "audiences": [],
981
+ "tags": [],
982
+ "goals": [],
983
+ "path": "glossary/data-category.md",
984
+ "prerequisites": [],
985
+ "related": [
986
+ "object-content-category"
987
+ ],
988
+ "packIds": []
989
+ },
990
+ {
991
+ "id": "abstract",
992
+ "type": "glossary",
993
+ "title": "Abstract",
994
+ "summary": "Virtual projected union over concrete types via bindings.",
995
+ "aliases": [],
996
+ "audiences": [],
997
+ "tags": [],
998
+ "goals": [],
999
+ "path": "glossary/abstract.md",
1000
+ "prerequisites": [],
1001
+ "related": [
1002
+ "abstracts-bindings"
1003
+ ],
1004
+ "packIds": []
1005
+ },
1006
+ {
1007
+ "id": "binding",
1008
+ "type": "glossary",
1009
+ "title": "Binding",
1010
+ "summary": "Maps concrete members into an abstract.",
1011
+ "aliases": [],
1012
+ "audiences": [],
1013
+ "tags": [],
1014
+ "goals": [],
1015
+ "path": "glossary/binding.md",
1016
+ "prerequisites": [],
1017
+ "related": [
1018
+ "abstracts-bindings"
1019
+ ],
1020
+ "packIds": []
1021
+ },
1022
+ {
1023
+ "id": "effective-metadata",
1024
+ "type": "glossary",
1025
+ "title": "Effective metadata",
1026
+ "summary": "Resolved definitions after inheritance and installation.",
1027
+ "aliases": [],
1028
+ "audiences": [],
1029
+ "tags": [],
1030
+ "goals": [],
1031
+ "path": "glossary/effective-metadata.md",
1032
+ "prerequisites": [],
1033
+ "related": [
1034
+ "effective-metadata"
1035
+ ],
1036
+ "packIds": []
1037
+ },
1038
+ {
1039
+ "id": "mapping",
1040
+ "type": "glossary",
1041
+ "title": "Mapping",
1042
+ "summary": "Declared transform from source shape to Memory content.",
1043
+ "aliases": [],
1044
+ "audiences": [],
1045
+ "tags": [],
1046
+ "goals": [],
1047
+ "path": "glossary/mapping.md",
1048
+ "prerequisites": [],
1049
+ "related": [
1050
+ "mappings-transforms"
1051
+ ],
1052
+ "packIds": []
1053
+ },
1054
+ {
1055
+ "id": "composition",
1056
+ "type": "glossary",
1057
+ "title": "Composition",
1058
+ "summary": "Explicit same-subject aggregation of content instances.",
1059
+ "aliases": [],
1060
+ "audiences": [],
1061
+ "tags": [],
1062
+ "goals": [],
1063
+ "path": "glossary/composition.md",
1064
+ "prerequisites": [],
1065
+ "related": [
1066
+ "composition"
1067
+ ],
1068
+ "packIds": []
1069
+ },
1070
+ {
1071
+ "id": "relationship-definition",
1072
+ "type": "glossary",
1073
+ "title": "Relationship definition",
1074
+ "summary": "Metadata describing an allowed relationship kind.",
1075
+ "aliases": [],
1076
+ "audiences": [],
1077
+ "tags": [],
1078
+ "goals": [],
1079
+ "path": "glossary/relationship-definition.md",
1080
+ "prerequisites": [],
1081
+ "related": [
1082
+ "relationship-definitions"
1083
+ ],
1084
+ "packIds": []
1085
+ },
1086
+ {
1087
+ "id": "relationship-reference",
1088
+ "type": "glossary",
1089
+ "title": "Relationship reference",
1090
+ "summary": "Stored link instance on a record.",
1091
+ "aliases": [],
1092
+ "audiences": [],
1093
+ "tags": [],
1094
+ "goals": [],
1095
+ "path": "glossary/relationship-reference.md",
1096
+ "prerequisites": [],
1097
+ "related": [
1098
+ "relationship-references"
1099
+ ],
1100
+ "packIds": []
1101
+ },
1102
+ {
1103
+ "id": "traversal",
1104
+ "type": "glossary",
1105
+ "title": "Traversal",
1106
+ "summary": "Forward or inverse walk of relationship references.",
1107
+ "aliases": [],
1108
+ "audiences": [],
1109
+ "tags": [],
1110
+ "goals": [],
1111
+ "path": "glossary/traversal.md",
1112
+ "prerequisites": [],
1113
+ "related": [
1114
+ "traversal"
1115
+ ],
1116
+ "packIds": []
1117
+ },
1118
+ {
1119
+ "id": "revision",
1120
+ "type": "glossary",
1121
+ "title": "Revision",
1122
+ "summary": "Optimistic concurrency token on a record.",
1123
+ "aliases": [],
1124
+ "audiences": [],
1125
+ "tags": [],
1126
+ "goals": [],
1127
+ "path": "glossary/revision.md",
1128
+ "prerequisites": [],
1129
+ "related": [
1130
+ "record-revisions"
1131
+ ],
1132
+ "packIds": []
1133
+ },
1134
+ {
1135
+ "id": "analysis",
1136
+ "type": "glossary",
1137
+ "title": "Analysis",
1138
+ "summary": "Evaluated evidence content distinct from a decision.",
1139
+ "aliases": [],
1140
+ "audiences": [],
1141
+ "tags": [],
1142
+ "goals": [],
1143
+ "path": "glossary/analysis.md",
1144
+ "prerequisites": [],
1145
+ "related": [
1146
+ "analysis-objects"
1147
+ ],
1148
+ "packIds": []
1149
+ },
1150
+ {
1151
+ "id": "decision",
1152
+ "type": "glossary",
1153
+ "title": "Decision",
1154
+ "summary": "Committed choice recorded separately from analysis.",
1155
+ "aliases": [],
1156
+ "audiences": [],
1157
+ "tags": [],
1158
+ "goals": [],
1159
+ "path": "glossary/decision.md",
1160
+ "prerequisites": [],
1161
+ "related": [
1162
+ "decisions-content"
1163
+ ],
1164
+ "packIds": []
1165
+ },
1166
+ {
1167
+ "id": "intelligence-proposal",
1168
+ "type": "glossary",
1169
+ "title": "Intelligence proposal",
1170
+ "summary": "Suggested change that never auto-installs.",
1171
+ "aliases": [],
1172
+ "audiences": [],
1173
+ "tags": [],
1174
+ "goals": [],
1175
+ "path": "glossary/intelligence-proposal.md",
1176
+ "prerequisites": [],
1177
+ "related": [
1178
+ "intelligence-proposals"
1179
+ ],
1180
+ "packIds": []
1181
+ },
1182
+ {
1183
+ "id": "scope-apply",
1184
+ "type": "visual",
1185
+ "title": "Scope must be applied explicitly before work begins.",
1186
+ "summary": "Wrong scope risks cross-workspace writes.",
1187
+ "aliases": [],
1188
+ "audiences": [],
1189
+ "tags": [],
1190
+ "goals": [],
1191
+ "path": "visuals/scope-apply.md",
1192
+ "prerequisites": [],
1193
+ "related": [
1194
+ "org-agent-scope"
1195
+ ],
1196
+ "packIds": []
1197
+ },
1198
+ {
1199
+ "id": "revision-conflict",
1200
+ "type": "visual",
1201
+ "title": "Stale writers are rejected; the record stays at the newer revision.",
1202
+ "summary": "Revision preconditions preserve newer data.",
1203
+ "aliases": [],
1204
+ "audiences": [],
1205
+ "tags": [],
1206
+ "goals": [],
1207
+ "path": "visuals/revision-conflict.md",
1208
+ "prerequisites": [],
1209
+ "related": [
1210
+ "record-revisions"
1211
+ ],
1212
+ "packIds": []
1213
+ },
1214
+ {
1215
+ "id": "memorix-central-journey",
1216
+ "type": "diagram",
1217
+ "title": "Memorix central product journey",
1218
+ "summary": "Conceptual path from scope through metadata, records, relationships, analysis, and decisions.",
1219
+ "aliases": [],
1220
+ "audiences": [
1221
+ "developers",
1222
+ "builders"
1223
+ ],
1224
+ "tags": [
1225
+ "overview"
1226
+ ],
1227
+ "goals": [],
1228
+ "path": "diagrams/memorix-central-journey.md",
1229
+ "webPath": "/diagrams/memorix-central-journey",
1230
+ "prerequisites": [],
1231
+ "related": [],
1232
+ "packIds": []
1233
+ },
1234
+ {
1235
+ "id": "agent-inheritance",
1236
+ "type": "diagram",
1237
+ "title": "Agent inheritance",
1238
+ "summary": "Parent and child agents resolve into effective definitions.",
1239
+ "aliases": [],
1240
+ "audiences": [],
1241
+ "tags": [],
1242
+ "goals": [],
1243
+ "path": "diagrams/agent-inheritance.md",
1244
+ "webPath": "/diagrams/agent-inheritance",
1245
+ "prerequisites": [],
1246
+ "related": [],
1247
+ "packIds": []
1248
+ },
1249
+ {
1250
+ "id": "metadata-lifecycle",
1251
+ "type": "diagram",
1252
+ "title": "Metadata lifecycle",
1253
+ "summary": "Pack → validate → explicit install → effective resolution → runtime; proposals stay off the auto path.",
1254
+ "aliases": [],
1255
+ "audiences": [],
1256
+ "tags": [],
1257
+ "goals": [],
1258
+ "path": "diagrams/metadata-lifecycle.md",
1259
+ "webPath": "/diagrams/metadata-lifecycle",
1260
+ "prerequisites": [],
1261
+ "related": [],
1262
+ "packIds": []
1263
+ },
1264
+ {
1265
+ "id": "record-content-model",
1266
+ "type": "diagram",
1267
+ "title": "Record and content model",
1268
+ "summary": "Record identity relates to object type, content type, category, raw, snapshots, and composition.",
1269
+ "aliases": [],
1270
+ "audiences": [],
1271
+ "tags": [],
1272
+ "goals": [],
1273
+ "path": "diagrams/record-content-model.md",
1274
+ "webPath": "/diagrams/record-content-model",
1275
+ "prerequisites": [],
1276
+ "related": [],
1277
+ "packIds": []
1278
+ },
1279
+ {
1280
+ "id": "people-union-diagram",
1281
+ "type": "diagram",
1282
+ "title": "People abstract union",
1283
+ "summary": "Employees and contractors bind into the People abstract projection.",
1284
+ "aliases": [],
1285
+ "audiences": [],
1286
+ "tags": [],
1287
+ "goals": [],
1288
+ "path": "diagrams/people-union-diagram.md",
1289
+ "webPath": "/diagrams/people-union-diagram",
1290
+ "prerequisites": [],
1291
+ "related": [],
1292
+ "packIds": []
1293
+ },
1294
+ {
1295
+ "id": "relationship-traversal",
1296
+ "type": "diagram",
1297
+ "title": "Relationship definition to traversal",
1298
+ "summary": "Definition versus stored reference; forward/inverse; resolved versus unresolved.",
1299
+ "aliases": [],
1300
+ "audiences": [],
1301
+ "tags": [],
1302
+ "goals": [],
1303
+ "path": "diagrams/relationship-traversal.md",
1304
+ "webPath": "/diagrams/relationship-traversal",
1305
+ "prerequisites": [],
1306
+ "related": [],
1307
+ "packIds": []
1308
+ },
1309
+ {
1310
+ "id": "revision-safe-write",
1311
+ "type": "diagram",
1312
+ "title": "Revision-safe write flow",
1313
+ "summary": "Load, write with expected revision, success or conflict with reload/retry.",
1314
+ "aliases": [],
1315
+ "audiences": [],
1316
+ "tags": [],
1317
+ "goals": [],
1318
+ "path": "diagrams/revision-safe-write.md",
1319
+ "webPath": "/diagrams/revision-safe-write",
1320
+ "prerequisites": [],
1321
+ "related": [],
1322
+ "packIds": []
1323
+ },
1324
+ {
1325
+ "id": "intelligence-journey",
1326
+ "type": "diagram",
1327
+ "title": "Intelligence journey",
1328
+ "summary": "Evidence can yield analysis, decision, and proposals that still require explicit install.",
1329
+ "aliases": [],
1330
+ "audiences": [],
1331
+ "tags": [],
1332
+ "goals": [],
1333
+ "path": "diagrams/intelligence-journey.md",
1334
+ "webPath": "/diagrams/intelligence-journey",
1335
+ "prerequisites": [],
1336
+ "related": [],
1337
+ "packIds": []
1338
+ },
1339
+ {
1340
+ "id": "start-with-sample-data",
1341
+ "type": "tutorial",
1342
+ "title": "Start Memorix with the sample dataset",
1343
+ "summary": "Load the synthetic dataset and confirm scope.",
1344
+ "aliases": [],
1345
+ "audiences": [
1346
+ "developers",
1347
+ "builders"
1348
+ ],
1349
+ "tags": [],
1350
+ "goals": [],
1351
+ "path": "tutorials/start-with-sample-data.md",
1352
+ "prerequisites": [],
1353
+ "related": [
1354
+ "org-agent-scope"
1355
+ ],
1356
+ "packIds": [
1357
+ "tutorial/start-with-sample-data"
1358
+ ]
1359
+ },
1360
+ {
1361
+ "id": "first-revision-safe-record",
1362
+ "type": "tutorial",
1363
+ "title": "Read and write the first revision-safe record",
1364
+ "summary": "Practice expected-revision writes on sample data.",
1365
+ "aliases": [],
1366
+ "audiences": [
1367
+ "developers"
1368
+ ],
1369
+ "tags": [],
1370
+ "goals": [],
1371
+ "path": "tutorials/first-revision-safe-record.md",
1372
+ "prerequisites": [],
1373
+ "related": [
1374
+ "record-revisions"
1375
+ ],
1376
+ "packIds": [
1377
+ "tutorial/first-revision-safe-record"
1378
+ ]
1379
+ },
1380
+ {
1381
+ "id": "compare-views",
1382
+ "type": "tutorial",
1383
+ "title": "Compare raw, composed, and abstract views",
1384
+ "summary": "See fidelity differences on the same subjects.",
1385
+ "aliases": [],
1386
+ "audiences": [
1387
+ "developers",
1388
+ "builders"
1389
+ ],
1390
+ "tags": [],
1391
+ "goals": [],
1392
+ "path": "tutorials/compare-views.md",
1393
+ "prerequisites": [],
1394
+ "related": [
1395
+ "composition",
1396
+ "people-union"
1397
+ ],
1398
+ "packIds": [
1399
+ "tutorial/compare-views"
1400
+ ]
1401
+ },
1402
+ {
1403
+ "id": "relationships-lab",
1404
+ "type": "tutorial",
1405
+ "title": "Define, store, and traverse relationships",
1406
+ "summary": "Hands-on relationship definition and traversal.",
1407
+ "aliases": [],
1408
+ "audiences": [
1409
+ "developers"
1410
+ ],
1411
+ "tags": [],
1412
+ "goals": [],
1413
+ "path": "tutorials/relationships-lab.md",
1414
+ "prerequisites": [],
1415
+ "related": [
1416
+ "traversal"
1417
+ ],
1418
+ "packIds": [
1419
+ "tutorial/relationships-lab"
1420
+ ]
1421
+ },
1422
+ {
1423
+ "id": "conflict-lab",
1424
+ "type": "tutorial",
1425
+ "title": "Recover from a stale revision conflict",
1426
+ "summary": "Trigger and recover from a conflict using sample data.",
1427
+ "aliases": [],
1428
+ "audiences": [
1429
+ "developers"
1430
+ ],
1431
+ "tags": [],
1432
+ "goals": [],
1433
+ "path": "tutorials/conflict-lab.md",
1434
+ "prerequisites": [],
1435
+ "related": [
1436
+ "record-revisions"
1437
+ ],
1438
+ "packIds": [
1439
+ "tutorial/conflict-lab"
1440
+ ]
1441
+ },
1442
+ {
1443
+ "id": "install-pack-lab",
1444
+ "type": "tutorial",
1445
+ "title": "Validate and explicitly install a metadata pack",
1446
+ "summary": "Practice validation versus confirmation.",
1447
+ "aliases": [],
1448
+ "audiences": [
1449
+ "builders"
1450
+ ],
1451
+ "tags": [],
1452
+ "goals": [],
1453
+ "path": "tutorials/install-pack-lab.md",
1454
+ "prerequisites": [],
1455
+ "related": [
1456
+ "explicit-metadata-installation"
1457
+ ],
1458
+ "packIds": [
1459
+ "tutorial/install-pack-lab"
1460
+ ]
1461
+ },
1462
+ {
1463
+ "id": "analysis-decision-lab",
1464
+ "type": "tutorial",
1465
+ "title": "Move from records to analysis and a decision",
1466
+ "summary": "Create analysis then a distinct decision on sample evidence.",
1467
+ "aliases": [],
1468
+ "audiences": [
1469
+ "developers",
1470
+ "builders"
1471
+ ],
1472
+ "tags": [],
1473
+ "goals": [],
1474
+ "path": "tutorials/analysis-decision-lab.md",
1475
+ "prerequisites": [],
1476
+ "related": [
1477
+ "analysis-objects",
1478
+ "decisions-content"
1479
+ ],
1480
+ "packIds": [
1481
+ "tutorial/analysis-decision-lab"
1482
+ ]
1483
+ },
1484
+ {
1485
+ "id": "memorix-record-envelope",
1486
+ "type": "example",
1487
+ "title": "memorix-record/2 envelope",
1488
+ "summary": "Show identity, revision, and content envelope fields.",
1489
+ "aliases": [],
1490
+ "audiences": [
1491
+ "developers"
1492
+ ],
1493
+ "tags": [],
1494
+ "goals": [],
1495
+ "path": "examples/memorix-record-envelope.md",
1496
+ "prerequisites": [],
1497
+ "related": [
1498
+ "raw-records",
1499
+ "record-revisions"
1500
+ ],
1501
+ "packIds": []
1502
+ },
1503
+ {
1504
+ "id": "revision-safe-write",
1505
+ "type": "example",
1506
+ "title": "Revision-safe write",
1507
+ "summary": "Write with expected revision.",
1508
+ "aliases": [],
1509
+ "audiences": [
1510
+ "developers"
1511
+ ],
1512
+ "tags": [],
1513
+ "goals": [],
1514
+ "path": "examples/revision-safe-write.md",
1515
+ "prerequisites": [],
1516
+ "related": [
1517
+ "record-revisions"
1518
+ ],
1519
+ "packIds": []
1520
+ },
1521
+ {
1522
+ "id": "revision-conflict-response",
1523
+ "type": "example",
1524
+ "title": "Revision conflict response and retry",
1525
+ "summary": "Show conflict payload and retry input.",
1526
+ "aliases": [],
1527
+ "audiences": [
1528
+ "developers"
1529
+ ],
1530
+ "tags": [],
1531
+ "goals": [],
1532
+ "path": "examples/revision-conflict-response.md",
1533
+ "prerequisites": [],
1534
+ "related": [
1535
+ "record-revisions"
1536
+ ],
1537
+ "packIds": []
1538
+ },
1539
+ {
1540
+ "id": "raw-vs-composed",
1541
+ "type": "example",
1542
+ "title": "Raw versus composed subject responses",
1543
+ "summary": "Compare fidelity of raw and composition.",
1544
+ "aliases": [],
1545
+ "audiences": [],
1546
+ "tags": [],
1547
+ "goals": [],
1548
+ "path": "examples/raw-vs-composed.md",
1549
+ "prerequisites": [],
1550
+ "related": [
1551
+ "raw-records",
1552
+ "composition"
1553
+ ],
1554
+ "packIds": []
1555
+ },
1556
+ {
1557
+ "id": "people-abstract-query",
1558
+ "type": "example",
1559
+ "title": "People abstract query/result",
1560
+ "summary": "Demonstrate union projection.",
1561
+ "aliases": [],
1562
+ "audiences": [],
1563
+ "tags": [],
1564
+ "goals": [],
1565
+ "path": "examples/people-abstract-query.md",
1566
+ "prerequisites": [],
1567
+ "related": [
1568
+ "people-union"
1569
+ ],
1570
+ "packIds": []
1571
+ },
1572
+ {
1573
+ "id": "relationship-def-and-ref",
1574
+ "type": "example",
1575
+ "title": "Relationship definition and stored reference",
1576
+ "summary": "Contrast metadata definition with stored ref.",
1577
+ "aliases": [],
1578
+ "audiences": [],
1579
+ "tags": [],
1580
+ "goals": [],
1581
+ "path": "examples/relationship-def-and-ref.md",
1582
+ "prerequisites": [],
1583
+ "related": [
1584
+ "relationship-definitions",
1585
+ "relationship-references"
1586
+ ],
1587
+ "packIds": []
1588
+ },
1589
+ {
1590
+ "id": "traversal-resolved-unresolved",
1591
+ "type": "example",
1592
+ "title": "Forward/inverse traversal with resolved and unresolved targets",
1593
+ "summary": "Show both target states.",
1594
+ "aliases": [],
1595
+ "audiences": [],
1596
+ "tags": [],
1597
+ "goals": [],
1598
+ "path": "examples/traversal-resolved-unresolved.md",
1599
+ "prerequisites": [],
1600
+ "related": [
1601
+ "traversal",
1602
+ "resolved-unresolved"
1603
+ ],
1604
+ "packIds": []
1605
+ },
1606
+ {
1607
+ "id": "metadata-pack-install",
1608
+ "type": "example",
1609
+ "title": "Metadata-pack validation and explicit installation",
1610
+ "summary": "Evidence that validate ≠ install.",
1611
+ "aliases": [],
1612
+ "audiences": [],
1613
+ "tags": [],
1614
+ "goals": [],
1615
+ "path": "examples/metadata-pack-install.md",
1616
+ "prerequisites": [],
1617
+ "related": [
1618
+ "explicit-metadata-installation"
1619
+ ],
1620
+ "packIds": []
1621
+ },
1622
+ {
1623
+ "id": "analysis-decision-records",
1624
+ "type": "example",
1625
+ "title": "Analysis and decision records",
1626
+ "summary": "Keep analysis and decision content types distinct.",
1627
+ "aliases": [],
1628
+ "audiences": [],
1629
+ "tags": [],
1630
+ "goals": [],
1631
+ "path": "examples/analysis-decision-records.md",
1632
+ "prerequisites": [],
1633
+ "related": [
1634
+ "analysis-objects",
1635
+ "decisions-content"
1636
+ ],
1637
+ "packIds": []
1638
+ },
1639
+ {
1640
+ "id": "memorix-synthetic-basic",
1641
+ "type": "sample-data",
1642
+ "title": "memorix-synthetic-basic",
1643
+ "summary": "Deterministic synthetic Memorix subjects for docs, screenshots, and tutorials.",
1644
+ "aliases": [],
1645
+ "audiences": [],
1646
+ "tags": [],
1647
+ "goals": [],
1648
+ "path": "sample-data/memorix-synthetic-basic.md",
1649
+ "prerequisites": [],
1650
+ "related": [],
1651
+ "packIds": []
1652
+ },
1653
+ {
1654
+ "id": "memorix-studio",
1655
+ "type": "ui-client",
1656
+ "title": "Memorix Studio",
1657
+ "summary": "Service-oriented UI for designing, operating, and exploring Memorix.",
1658
+ "aliases": [],
1659
+ "audiences": [
1660
+ "builders",
1661
+ "developers"
1662
+ ],
1663
+ "tags": [],
1664
+ "goals": [],
1665
+ "path": "ui/clients/memorix-studio.md",
1666
+ "prerequisites": [],
1667
+ "related": [],
1668
+ "packIds": []
1669
+ },
1670
+ {
1671
+ "id": "memorix-records",
1672
+ "type": "api",
1673
+ "title": "Memorix records API",
1674
+ "summary": "Read and conditionally write Memorix records with revision preconditions.",
1675
+ "aliases": [],
1676
+ "audiences": [
1677
+ "developers"
1678
+ ],
1679
+ "tags": [],
1680
+ "goals": [],
1681
+ "path": "apis/memorix-records/overview.md",
1682
+ "prerequisites": [],
1683
+ "related": [
1684
+ "record-revisions",
1685
+ "first-revision-safe-write"
1686
+ ],
1687
+ "packIds": []
1688
+ },
1689
+ {
1690
+ "id": "start-from-zero",
1691
+ "type": "use-case",
1692
+ "title": "Start Memorix from zero",
1693
+ "summary": "Install docs for your agents, set scope, run the stack, and walk the tutorials to the core loop.",
1694
+ "aliases": [],
1695
+ "audiences": [
1696
+ "developers",
1697
+ "builders"
1698
+ ],
1699
+ "tags": [
1700
+ "getting-started",
1701
+ "tutorials",
1702
+ "start-here"
1703
+ ],
1704
+ "goals": [
1705
+ "Install docs for your agents, set scope, run the stack, and walk the tutorials to the core loop."
1706
+ ],
1707
+ "path": "use-cases/start-from-zero.md",
1708
+ "webPath": "/use-cases#start-from-zero",
1709
+ "prerequisites": [],
1710
+ "related": [
1711
+ "00-platform-overview",
1712
+ "11-agent-packs-and-ops"
1713
+ ],
1714
+ "packIds": [
1715
+ "use-case/start-from-zero"
1716
+ ]
1717
+ },
1718
+ {
1719
+ "id": "orient-platform",
1720
+ "type": "use-case",
1721
+ "title": "Orient on Memorix after G12",
1722
+ "summary": "Understand surfaces, packages, hard rules, and which ebook to open next.",
1723
+ "aliases": [],
1724
+ "audiences": [
1725
+ "developers",
1726
+ "builders"
1727
+ ],
1728
+ "tags": [
1729
+ "platform",
1730
+ "start-here"
1731
+ ],
1732
+ "goals": [
1733
+ "Understand surfaces, packages, hard rules, and which ebook to open next."
1734
+ ],
1735
+ "path": "use-cases/orient-platform.md",
1736
+ "webPath": "/use-cases#orient-platform",
1737
+ "prerequisites": [],
1738
+ "related": [
1739
+ "00-platform-overview"
1740
+ ],
1741
+ "packIds": [
1742
+ "use-case/orient-platform"
1743
+ ]
1744
+ },
1745
+ {
1746
+ "id": "learn-record-envelope",
1747
+ "type": "use-case",
1748
+ "title": "Learn the memorix-record/2 envelope",
1749
+ "summary": "Internalize OT/CT, composition, discriminators, and what must not live on the record.",
1750
+ "aliases": [],
1751
+ "audiences": [
1752
+ "developers"
1753
+ ],
1754
+ "tags": [
1755
+ "format",
1756
+ "record"
1757
+ ],
1758
+ "goals": [
1759
+ "Internalize OT/CT, composition, discriminators, and what must not live on the record."
1760
+ ],
1761
+ "path": "use-cases/learn-record-envelope.md",
1762
+ "webPath": "/use-cases#learn-record-envelope",
1763
+ "prerequisites": [],
1764
+ "related": [
1765
+ "01-format-for-dummies"
1766
+ ],
1767
+ "packIds": [
1768
+ "use-case/learn-record-envelope"
1769
+ ]
1770
+ },
1771
+ {
1772
+ "id": "client-first-read-write",
1773
+ "type": "use-case",
1774
+ "title": "Product backend first safe read/write",
1775
+ "summary": "Call /api/data correctly with scope, revision preconditions, and explicit compose.",
1776
+ "aliases": [],
1777
+ "audiences": [
1778
+ "developers"
1779
+ ],
1780
+ "tags": [
1781
+ "http",
1782
+ "client",
1783
+ "data"
1784
+ ],
1785
+ "goals": [
1786
+ "Call /api/data correctly with scope, revision preconditions, and explicit compose."
1787
+ ],
1788
+ "path": "use-cases/client-first-read-write.md",
1789
+ "webPath": "/use-cases#client-first-read-write",
1790
+ "prerequisites": [],
1791
+ "related": [
1792
+ "03-lists-queries-pagination"
1793
+ ],
1794
+ "packIds": [
1795
+ "use-case/client-first-read-write"
1796
+ ]
1797
+ },
1798
+ {
1799
+ "id": "choose-access-method",
1800
+ "type": "use-case",
1801
+ "title": "Choose the right access method",
1802
+ "summary": "Map a task to best / acceptable / forbidden calls using the patterns matrix.",
1803
+ "aliases": [],
1804
+ "audiences": [
1805
+ "developers"
1806
+ ],
1807
+ "tags": [
1808
+ "patterns",
1809
+ "http"
1810
+ ],
1811
+ "goals": [
1812
+ "Map a task to best / acceptable / forbidden calls using the patterns matrix."
1813
+ ],
1814
+ "path": "use-cases/choose-access-method.md",
1815
+ "webPath": "/use-cases#choose-access-method",
1816
+ "prerequisites": [],
1817
+ "related": [
1818
+ "02-runtime-data-client",
1819
+ "03-lists-queries-pagination"
1820
+ ],
1821
+ "packIds": [
1822
+ "use-case/choose-access-method"
1823
+ ]
1824
+ },
1825
+ {
1826
+ "id": "lists-cursors-pagination",
1827
+ "type": "use-case",
1828
+ "title": "List, filter, and paginate correctly",
1829
+ "summary": "Use cursors, pageInfo, and query grammar without inventing offsets.",
1830
+ "aliases": [],
1831
+ "audiences": [
1832
+ "developers"
1833
+ ],
1834
+ "tags": [
1835
+ "lists",
1836
+ "cursor",
1837
+ "http"
1838
+ ],
1839
+ "goals": [
1840
+ "Use cursors, pageInfo, and query grammar without inventing offsets."
1841
+ ],
1842
+ "path": "use-cases/lists-cursors-pagination.md",
1843
+ "webPath": "/use-cases#lists-cursors-pagination",
1844
+ "prerequisites": [],
1845
+ "related": [
1846
+ "02-runtime-data-client",
1847
+ "04-data-access-patterns"
1848
+ ],
1849
+ "packIds": [
1850
+ "use-case/lists-cursors-pagination"
1851
+ ]
1852
+ },
1853
+ {
1854
+ "id": "compose-for-ui",
1855
+ "type": "use-case",
1856
+ "title": "Compose a subject for a UI view",
1857
+ "summary": "Use explicit composition instead of N+1 gets for a subject screen.",
1858
+ "aliases": [],
1859
+ "audiences": [
1860
+ "developers"
1861
+ ],
1862
+ "tags": [
1863
+ "compose",
1864
+ "ui",
1865
+ "http"
1866
+ ],
1867
+ "goals": [
1868
+ "Use explicit composition instead of N+1 gets for a subject screen."
1869
+ ],
1870
+ "path": "use-cases/compose-for-ui.md",
1871
+ "webPath": "/use-cases#compose-for-ui",
1872
+ "prerequisites": [],
1873
+ "related": [
1874
+ "01-format-for-dummies"
1875
+ ],
1876
+ "packIds": [
1877
+ "use-case/compose-for-ui"
1878
+ ]
1879
+ },
1880
+ {
1881
+ "id": "abstract-people-list",
1882
+ "type": "use-case",
1883
+ "title": "Multi-type abstract list (People)",
1884
+ "summary": "List across concrete types via abstracts and reverse-map writes.",
1885
+ "aliases": [],
1886
+ "audiences": [
1887
+ "developers"
1888
+ ],
1889
+ "tags": [
1890
+ "abstracts",
1891
+ "metadata",
1892
+ "http"
1893
+ ],
1894
+ "goals": [
1895
+ "List across concrete types via abstracts and reverse-map writes."
1896
+ ],
1897
+ "path": "use-cases/abstract-people-list.md",
1898
+ "webPath": "/use-cases#abstract-people-list",
1899
+ "prerequisites": [],
1900
+ "related": [
1901
+ "04-data-access-patterns"
1902
+ ],
1903
+ "packIds": [
1904
+ "use-case/abstract-people-list"
1905
+ ]
1906
+ },
1907
+ {
1908
+ "id": "metadata-before-write",
1909
+ "type": "use-case",
1910
+ "title": "Discover effective metadata before writing",
1911
+ "summary": "Load views/writes from /api/metadata so clients do not invent shapes.",
1912
+ "aliases": [],
1913
+ "audiences": [
1914
+ "developers"
1915
+ ],
1916
+ "tags": [
1917
+ "metadata",
1918
+ "http"
1919
+ ],
1920
+ "goals": [
1921
+ "Load views/writes from /api/metadata so clients do not invent shapes."
1922
+ ],
1923
+ "path": "use-cases/metadata-before-write.md",
1924
+ "webPath": "/use-cases#metadata-before-write",
1925
+ "prerequisites": [],
1926
+ "related": [
1927
+ "10-intelligence"
1928
+ ],
1929
+ "packIds": [
1930
+ "use-case/metadata-before-write"
1931
+ ]
1932
+ },
1933
+ {
1934
+ "id": "revision-stale-conflicts",
1935
+ "type": "use-case",
1936
+ "title": "Handle revision / stale conflicts",
1937
+ "summary": "Patch with revision preconditions and recover when another writer won.",
1938
+ "aliases": [],
1939
+ "audiences": [
1940
+ "developers"
1941
+ ],
1942
+ "tags": [
1943
+ "revisions",
1944
+ "conflicts",
1945
+ "http"
1946
+ ],
1947
+ "goals": [
1948
+ "Patch with revision preconditions and recover when another writer won."
1949
+ ],
1950
+ "path": "use-cases/revision-stale-conflicts.md",
1951
+ "webPath": "/use-cases#revision-stale-conflicts",
1952
+ "prerequisites": [],
1953
+ "related": [
1954
+ "01-format-for-dummies"
1955
+ ],
1956
+ "packIds": [
1957
+ "use-case/revision-stale-conflicts"
1958
+ ]
1959
+ },
1960
+ {
1961
+ "id": "discriminated-content-writes",
1962
+ "type": "use-case",
1963
+ "title": "Write analysis / decision / narrative content",
1964
+ "summary": "Use discriminators correctly for sibling content types.",
1965
+ "aliases": [],
1966
+ "audiences": [
1967
+ "developers"
1968
+ ],
1969
+ "tags": [
1970
+ "discriminators",
1971
+ "writes",
1972
+ "http"
1973
+ ],
1974
+ "goals": [
1975
+ "Use discriminators correctly for sibling content types."
1976
+ ],
1977
+ "path": "use-cases/discriminated-content-writes.md",
1978
+ "webPath": "/use-cases#discriminated-content-writes",
1979
+ "prerequisites": [],
1980
+ "related": [
1981
+ "09-workflow-and-studio"
1982
+ ],
1983
+ "packIds": [
1984
+ "use-case/discriminated-content-writes"
1985
+ ]
1986
+ },
1987
+ {
1988
+ "id": "memory-hourly-ingest",
1989
+ "type": "use-case",
1990
+ "title": "Ingest an external system on a schedule",
1991
+ "summary": "Land exact provider payloads in Memory, then map/write via pipeline.",
1992
+ "aliases": [],
1993
+ "audiences": [
1994
+ "developers"
1995
+ ],
1996
+ "tags": [
1997
+ "memory",
1998
+ "ingest",
1999
+ "pipelines"
2000
+ ],
2001
+ "goals": [
2002
+ "Land exact provider payloads in Memory, then map/write via pipeline."
2003
+ ],
2004
+ "path": "use-cases/memory-hourly-ingest.md",
2005
+ "webPath": "/use-cases#memory-hourly-ingest",
2006
+ "prerequisites": [],
2007
+ "related": [
2008
+ "07-services"
2009
+ ],
2010
+ "packIds": [
2011
+ "use-case/memory-hourly-ingest"
2012
+ ]
2013
+ },
2014
+ {
2015
+ "id": "four-field-links",
2016
+ "type": "use-case",
2017
+ "title": "Link subjects with four-field relationships",
2018
+ "summary": "Define relationships, expand on read, never store associated* on records.",
2019
+ "aliases": [],
2020
+ "audiences": [
2021
+ "developers"
2022
+ ],
2023
+ "tags": [
2024
+ "relationships",
2025
+ "links"
2026
+ ],
2027
+ "goals": [
2028
+ "Define relationships, expand on read, never store associated* on records."
2029
+ ],
2030
+ "path": "use-cases/four-field-links.md",
2031
+ "webPath": "/use-cases#four-field-links",
2032
+ "prerequisites": [],
2033
+ "related": [
2034
+ "01-format-for-dummies"
2035
+ ],
2036
+ "packIds": [
2037
+ "use-case/four-field-links"
2038
+ ]
2039
+ },
2040
+ {
2041
+ "id": "relationship-rebuild-verify",
2042
+ "type": "use-case",
2043
+ "title": "Rebuild and verify relationship links",
2044
+ "summary": "Run discover / verify / rebuild / cleanup through the relationship engine.",
2045
+ "aliases": [],
2046
+ "audiences": [
2047
+ "developers"
2048
+ ],
2049
+ "tags": [
2050
+ "relationships",
2051
+ "ops"
2052
+ ],
2053
+ "goals": [
2054
+ "Run discover / verify / rebuild / cleanup through the relationship engine."
2055
+ ],
2056
+ "path": "use-cases/relationship-rebuild-verify.md",
2057
+ "webPath": "/use-cases#relationship-rebuild-verify",
2058
+ "prerequisites": [],
2059
+ "related": [
2060
+ "11-agent-packs-and-ops"
2061
+ ],
2062
+ "packIds": [
2063
+ "use-case/relationship-rebuild-verify"
2064
+ ]
2065
+ },
2066
+ {
2067
+ "id": "install-metadata-pack",
2068
+ "type": "use-case",
2069
+ "title": "Author and install a metadata pack",
2070
+ "summary": "Shape agents/OT/CT/abstracts and install/publish deliberately — never auto.",
2071
+ "aliases": [],
2072
+ "audiences": [
2073
+ "developers"
2074
+ ],
2075
+ "tags": [
2076
+ "metadata",
2077
+ "install"
2078
+ ],
2079
+ "goals": [
2080
+ "Shape agents/OT/CT/abstracts and install/publish deliberately — never auto."
2081
+ ],
2082
+ "path": "use-cases/install-metadata-pack.md",
2083
+ "webPath": "/use-cases#install-metadata-pack",
2084
+ "prerequisites": [],
2085
+ "related": [
2086
+ "11-agent-packs-and-ops",
2087
+ "10-intelligence"
2088
+ ],
2089
+ "packIds": [
2090
+ "use-case/install-metadata-pack"
2091
+ ]
2092
+ },
2093
+ {
2094
+ "id": "custom-kind-descriptors",
2095
+ "type": "use-case",
2096
+ "title": "Store custom UI kind descriptors",
2097
+ "summary": "Use kindDeclarations / extensions for client-owned tabs without a new engine.",
2098
+ "aliases": [],
2099
+ "audiences": [
2100
+ "developers"
2101
+ ],
2102
+ "tags": [
2103
+ "metadata",
2104
+ "kinds",
2105
+ "ui"
2106
+ ],
2107
+ "goals": [
2108
+ "Use kindDeclarations / extensions for client-owned tabs without a new engine."
2109
+ ],
2110
+ "path": "use-cases/custom-kind-descriptors.md",
2111
+ "webPath": "/use-cases#custom-kind-descriptors",
2112
+ "prerequisites": [],
2113
+ "related": [
2114
+ "09-workflow-and-studio"
2115
+ ],
2116
+ "packIds": [
2117
+ "use-case/custom-kind-descriptors"
2118
+ ]
2119
+ },
2120
+ {
2121
+ "id": "build-callable-service",
2122
+ "type": "use-case",
2123
+ "title": "Build a service Memorix pipelines invoke",
2124
+ "summary": "Decide you need a service, define it, implement handlers, bind, and invoke from a step.",
2125
+ "aliases": [],
2126
+ "audiences": [
2127
+ "developers"
2128
+ ],
2129
+ "tags": [
2130
+ "services",
2131
+ "pipelines"
2132
+ ],
2133
+ "goals": [
2134
+ "Decide you need a service, define it, implement handlers, bind, and invoke from a step."
2135
+ ],
2136
+ "path": "use-cases/build-callable-service.md",
2137
+ "webPath": "/use-cases#build-callable-service",
2138
+ "prerequisites": [],
2139
+ "related": [
2140
+ "08-pipelines"
2141
+ ],
2142
+ "packIds": [
2143
+ "use-case/build-callable-service"
2144
+ ]
2145
+ },
2146
+ {
2147
+ "id": "http-process-compliance",
2148
+ "type": "use-case",
2149
+ "title": "HTTP process compliance (ports / health / live)",
2150
+ "summary": "Wire core-service, ports-manager, and api-live-view for any process that binds HTTP.",
2151
+ "aliases": [],
2152
+ "audiences": [
2153
+ "developers"
2154
+ ],
2155
+ "tags": [
2156
+ "ports",
2157
+ "core-service",
2158
+ "http"
2159
+ ],
2160
+ "goals": [
2161
+ "Wire core-service, ports-manager, and api-live-view for any process that binds HTTP."
2162
+ ],
2163
+ "path": "use-cases/http-process-compliance.md",
2164
+ "webPath": "/use-cases#http-process-compliance",
2165
+ "prerequisites": [],
2166
+ "related": [
2167
+ "13-migration-troubleshooting"
2168
+ ],
2169
+ "packIds": [
2170
+ "use-case/http-process-compliance"
2171
+ ]
2172
+ },
2173
+ {
2174
+ "id": "author-pipeline-e2e",
2175
+ "type": "use-case",
2176
+ "title": "Author and run a pipeline end-to-end",
2177
+ "summary": "Define steps, execute under g12ops*, and observe runs/artifacts.",
2178
+ "aliases": [],
2179
+ "audiences": [
2180
+ "developers"
2181
+ ],
2182
+ "tags": [
2183
+ "pipelines",
2184
+ "ops"
2185
+ ],
2186
+ "goals": [
2187
+ "Define steps, execute under g12ops*, and observe runs/artifacts."
2188
+ ],
2189
+ "path": "use-cases/author-pipeline-e2e.md",
2190
+ "webPath": "/use-cases#author-pipeline-e2e",
2191
+ "prerequisites": [],
2192
+ "related": [
2193
+ "07-services",
2194
+ "11-agent-packs-and-ops"
2195
+ ],
2196
+ "packIds": [
2197
+ "use-case/author-pipeline-e2e"
2198
+ ]
2199
+ },
2200
+ {
2201
+ "id": "ai-pipeline-fail-closed",
2202
+ "type": "use-case",
2203
+ "title": "AI pipeline steps fail closed",
2204
+ "summary": "Add AI steps without silent invention; keep validation and retries honest.",
2205
+ "aliases": [],
2206
+ "audiences": [
2207
+ "developers"
2208
+ ],
2209
+ "tags": [
2210
+ "pipelines",
2211
+ "ai"
2212
+ ],
2213
+ "goals": [
2214
+ "Add AI steps without silent invention; keep validation and retries honest."
2215
+ ],
2216
+ "path": "use-cases/ai-pipeline-fail-closed.md",
2217
+ "webPath": "/use-cases#ai-pipeline-fail-closed",
2218
+ "prerequisites": [],
2219
+ "related": [
2220
+ "10-intelligence"
2221
+ ],
2222
+ "packIds": [
2223
+ "use-case/ai-pipeline-fail-closed"
2224
+ ]
2225
+ },
2226
+ {
2227
+ "id": "pipeline-retry-evidence",
2228
+ "type": "use-case",
2229
+ "title": "Retry a failed pipeline step with evidence",
2230
+ "summary": "Operate failed attempts, retry safely, and keep artifacts for forensics.",
2231
+ "aliases": [],
2232
+ "audiences": [
2233
+ "developers"
2234
+ ],
2235
+ "tags": [
2236
+ "pipelines",
2237
+ "ops",
2238
+ "retry"
2239
+ ],
2240
+ "goals": [
2241
+ "Operate failed attempts, retry safely, and keep artifacts for forensics."
2242
+ ],
2243
+ "path": "use-cases/pipeline-retry-evidence.md",
2244
+ "webPath": "/use-cases#pipeline-retry-evidence",
2245
+ "prerequisites": [],
2246
+ "related": [
2247
+ "09-workflow-and-studio"
2248
+ ],
2249
+ "packIds": [
2250
+ "use-case/pipeline-retry-evidence"
2251
+ ]
2252
+ },
2253
+ {
2254
+ "id": "embed-studio-host",
2255
+ "type": "use-case",
2256
+ "title": "Embed Studio in a host app",
2257
+ "summary": "Map scope bar to HTTP headers and embed the sole product UI correctly.",
2258
+ "aliases": [],
2259
+ "audiences": [
2260
+ "developers"
2261
+ ],
2262
+ "tags": [
2263
+ "studio",
2264
+ "embedding"
2265
+ ],
2266
+ "goals": [
2267
+ "Map scope bar to HTTP headers and embed the sole product UI correctly."
2268
+ ],
2269
+ "path": "use-cases/embed-studio-host.md",
2270
+ "webPath": "/use-cases#embed-studio-host",
2271
+ "prerequisites": [],
2272
+ "related": [
2273
+ "00-platform-overview"
2274
+ ],
2275
+ "packIds": [
2276
+ "use-case/embed-studio-host"
2277
+ ]
2278
+ },
2279
+ {
2280
+ "id": "workflow-sibling-api",
2281
+ "type": "use-case",
2282
+ "title": "Work with workflow sibling content via API",
2283
+ "summary": "Treat workflow as sibling content under /api/workflow, not a separate product.",
2284
+ "aliases": [],
2285
+ "audiences": [
2286
+ "developers"
2287
+ ],
2288
+ "tags": [
2289
+ "workflow",
2290
+ "http"
2291
+ ],
2292
+ "goals": [
2293
+ "Treat workflow as sibling content under /api/workflow, not a separate product."
2294
+ ],
2295
+ "path": "use-cases/workflow-sibling-api.md",
2296
+ "webPath": "/use-cases#workflow-sibling-api",
2297
+ "prerequisites": [],
2298
+ "related": [
2299
+ "01-format-for-dummies"
2300
+ ],
2301
+ "packIds": [
2302
+ "use-case/workflow-sibling-api"
2303
+ ]
2304
+ },
2305
+ {
2306
+ "id": "intelligence-propose-install",
2307
+ "type": "use-case",
2308
+ "title": "Intelligence propose → human install",
2309
+ "summary": "Profile and propose metadata, then install only via deliberate human action.",
2310
+ "aliases": [],
2311
+ "audiences": [
2312
+ "developers"
2313
+ ],
2314
+ "tags": [
2315
+ "intelligence",
2316
+ "metadata"
2317
+ ],
2318
+ "goals": [
2319
+ "Profile and propose metadata, then install only via deliberate human action."
2320
+ ],
2321
+ "path": "use-cases/intelligence-propose-install.md",
2322
+ "webPath": "/use-cases#intelligence-propose-install",
2323
+ "prerequisites": [],
2324
+ "related": [
2325
+ "04-data-access-patterns"
2326
+ ],
2327
+ "packIds": [
2328
+ "use-case/intelligence-propose-install"
2329
+ ]
2330
+ },
2331
+ {
2332
+ "id": "ops-pack-fixtures",
2333
+ "type": "use-case",
2334
+ "title": "Package ops fixtures and acceptance harness",
2335
+ "summary": "Build or extend an agent pack with g12ops* acceptance, goldens, and harness commands.",
2336
+ "aliases": [],
2337
+ "audiences": [
2338
+ "developers"
2339
+ ],
2340
+ "tags": [
2341
+ "ops-pack",
2342
+ "fixtures",
2343
+ "acceptance"
2344
+ ],
2345
+ "goals": [
2346
+ "Build or extend an agent pack with g12ops* acceptance, goldens, and harness commands."
2347
+ ],
2348
+ "path": "use-cases/ops-pack-fixtures.md",
2349
+ "webPath": "/use-cases#ops-pack-fixtures",
2350
+ "prerequisites": [],
2351
+ "related": [
2352
+ "00-platform-overview"
2353
+ ],
2354
+ "packIds": [
2355
+ "use-case/ops-pack-fixtures"
2356
+ ]
2357
+ },
2358
+ {
2359
+ "id": "knowx-claims-review",
2360
+ "type": "use-case",
2361
+ "title": "Build KnowX claims with human review",
2362
+ "summary": "Model NODE/EDGE claims with provenance and run the fixture path without live AI.",
2363
+ "aliases": [],
2364
+ "audiences": [
2365
+ "developers"
2366
+ ],
2367
+ "tags": [
2368
+ "knowx",
2369
+ "provenance"
2370
+ ],
2371
+ "goals": [
2372
+ "Model NODE/EDGE claims with provenance and run the fixture path without live AI."
2373
+ ],
2374
+ "path": "use-cases/knowx-claims-review.md",
2375
+ "webPath": "/use-cases#knowx-claims-review",
2376
+ "prerequisites": [],
2377
+ "related": [
2378
+ "06-relationships-and-memory",
2379
+ "08-pipelines"
2380
+ ],
2381
+ "packIds": [
2382
+ "use-case/knowx-claims-review"
2383
+ ]
2384
+ },
2385
+ {
2386
+ "id": "migrate-associated-star",
2387
+ "type": "use-case",
2388
+ "title": "Migrate associated* present format to V2",
2389
+ "summary": "Reject associated* payloads and migrate envelopes with memorix-format tooling.",
2390
+ "aliases": [],
2391
+ "audiences": [
2392
+ "developers"
2393
+ ],
2394
+ "tags": [
2395
+ "migration",
2396
+ "format"
2397
+ ],
2398
+ "goals": [
2399
+ "Reject associated* payloads and migrate envelopes with memorix-format tooling."
2400
+ ],
2401
+ "path": "use-cases/migrate-associated-star.md",
2402
+ "webPath": "/use-cases#migrate-associated-star",
2403
+ "prerequisites": [],
2404
+ "related": [
2405
+ "01-format-for-dummies"
2406
+ ],
2407
+ "packIds": [
2408
+ "use-case/migrate-associated-star"
2409
+ ]
2410
+ },
2411
+ {
2412
+ "id": "troubleshoot-http-matrix",
2413
+ "type": "use-case",
2414
+ "title": "Troubleshoot runtime HTTP failures",
2415
+ "summary": "Use the failure matrix and escalate packet when stuck.",
2416
+ "aliases": [],
2417
+ "audiences": [
2418
+ "developers"
2419
+ ],
2420
+ "tags": [
2421
+ "troubleshooting",
2422
+ "http"
2423
+ ],
2424
+ "goals": [
2425
+ "Use the failure matrix and escalate packet when stuck."
2426
+ ],
2427
+ "path": "use-cases/troubleshoot-http-matrix.md",
2428
+ "webPath": "/use-cases#troubleshoot-http-matrix",
2429
+ "prerequisites": [],
2430
+ "related": [
2431
+ "02-runtime-data-client"
2432
+ ],
2433
+ "packIds": [
2434
+ "use-case/troubleshoot-http-matrix"
2435
+ ]
2436
+ },
2437
+ {
2438
+ "id": "trusted-in-process-embed",
2439
+ "type": "use-case",
2440
+ "title": "Embed Memorix engines in a trusted host",
2441
+ "summary": "Know when in-process packages are allowed vs remote HTTP-only clients.",
2442
+ "aliases": [],
2443
+ "audiences": [
2444
+ "developers"
2445
+ ],
2446
+ "tags": [
2447
+ "embedding",
2448
+ "packages"
2449
+ ],
2450
+ "goals": [
2451
+ "Know when in-process packages are allowed vs remote HTTP-only clients."
2452
+ ],
2453
+ "path": "use-cases/trusted-in-process-embed.md",
2454
+ "webPath": "/use-cases#trusted-in-process-embed",
2455
+ "prerequisites": [],
2456
+ "related": [
2457
+ "07-services"
2458
+ ],
2459
+ "packIds": [
2460
+ "use-case/trusted-in-process-embed"
2461
+ ]
2462
+ },
2463
+ {
2464
+ "id": "data-journey-evidence",
2465
+ "type": "use-case",
2466
+ "title": "Use data-journey matrix and evidence APIs",
2467
+ "summary": "Drive Explore/evidence UIs via /api/data-journey without inventing coverage rules.",
2468
+ "aliases": [],
2469
+ "audiences": [
2470
+ "developers"
2471
+ ],
2472
+ "tags": [
2473
+ "data-journey",
2474
+ "evidence",
2475
+ "http"
2476
+ ],
2477
+ "goals": [
2478
+ "Drive Explore/evidence UIs via /api/data-journey without inventing coverage rules."
2479
+ ],
2480
+ "path": "use-cases/data-journey-evidence.md",
2481
+ "webPath": "/use-cases#data-journey-evidence",
2482
+ "prerequisites": [],
2483
+ "related": [
2484
+ "03-lists-queries-pagination"
2485
+ ],
2486
+ "packIds": [
2487
+ "use-case/data-journey-evidence"
2488
+ ]
2489
+ },
2490
+ {
2491
+ "id": "local-acceptance-g12ops",
2492
+ "type": "use-case",
2493
+ "title": "Run local acceptance on g12ops*",
2494
+ "summary": "Bring up the stack with ops-pack and prove the ops narrative in an isolated org.",
2495
+ "aliases": [],
2496
+ "audiences": [
2497
+ "developers"
2498
+ ],
2499
+ "tags": [
2500
+ "acceptance",
2501
+ "ops",
2502
+ "local"
2503
+ ],
2504
+ "goals": [
2505
+ "Bring up the stack with ops-pack and prove the ops narrative in an isolated org."
2506
+ ],
2507
+ "path": "use-cases/local-acceptance-g12ops.md",
2508
+ "webPath": "/use-cases#local-acceptance-g12ops",
2509
+ "prerequisites": [],
2510
+ "related": [
2511
+ "13-migration-troubleshooting"
2512
+ ],
2513
+ "packIds": [
2514
+ "use-case/local-acceptance-g12ops"
2515
+ ]
2516
+ },
2517
+ {
2518
+ "id": "openapi-typed-client",
2519
+ "type": "use-case",
2520
+ "title": "Orient on OpenAPI / typed clients",
2521
+ "summary": "Find OpenAPI generation workflow and keep clients aligned with the service.",
2522
+ "aliases": [],
2523
+ "audiences": [
2524
+ "developers"
2525
+ ],
2526
+ "tags": [
2527
+ "openapi",
2528
+ "client"
2529
+ ],
2530
+ "goals": [
2531
+ "Find OpenAPI generation workflow and keep clients aligned with the service."
2532
+ ],
2533
+ "path": "use-cases/openapi-typed-client.md",
2534
+ "webPath": "/use-cases#openapi-typed-client",
2535
+ "prerequisites": [],
2536
+ "related": [
2537
+ "02-runtime-data-client"
2538
+ ],
2539
+ "packIds": [
2540
+ "use-case/openapi-typed-client"
2541
+ ]
2542
+ },
2543
+ {
2544
+ "id": "studio-design-types",
2545
+ "type": "use-case",
2546
+ "title": "Design object and content types in Studio",
2547
+ "summary": "Change product shape in Design without shipping engine code.",
2548
+ "aliases": [],
2549
+ "audiences": [
2550
+ "builders"
2551
+ ],
2552
+ "tags": [
2553
+ "studio",
2554
+ "design",
2555
+ "metadata"
2556
+ ],
2557
+ "goals": [
2558
+ "Change product shape in Design without shipping engine code."
2559
+ ],
2560
+ "path": "use-cases/studio-design-types.md",
2561
+ "webPath": "/use-cases#studio-design-types",
2562
+ "prerequisites": [],
2563
+ "related": [
2564
+ "01-format-for-dummies"
2565
+ ],
2566
+ "packIds": [
2567
+ "use-case/studio-design-types"
2568
+ ]
2569
+ },
2570
+ {
2571
+ "id": "studio-operate-pipelines",
2572
+ "type": "use-case",
2573
+ "title": "Operate pipelines in Studio",
2574
+ "summary": "Run, retry, and inspect pipeline health from Operate.",
2575
+ "aliases": [],
2576
+ "audiences": [
2577
+ "builders"
2578
+ ],
2579
+ "tags": [
2580
+ "studio",
2581
+ "pipelines",
2582
+ "operate"
2583
+ ],
2584
+ "goals": [
2585
+ "Run, retry, and inspect pipeline health from Operate."
2586
+ ],
2587
+ "path": "use-cases/studio-operate-pipelines.md",
2588
+ "webPath": "/use-cases#studio-operate-pipelines",
2589
+ "prerequisites": [],
2590
+ "related": [
2591
+ "07-services"
2592
+ ],
2593
+ "packIds": [
2594
+ "use-case/studio-operate-pipelines"
2595
+ ]
2596
+ },
2597
+ {
2598
+ "id": "studio-explore-subject",
2599
+ "type": "use-case",
2600
+ "title": "Explore a composed subject in Studio",
2601
+ "summary": "Read composition vs relationships visually in Explore.",
2602
+ "aliases": [],
2603
+ "audiences": [
2604
+ "builders"
2605
+ ],
2606
+ "tags": [
2607
+ "studio",
2608
+ "explore"
2609
+ ],
2610
+ "goals": [
2611
+ "Read composition vs relationships visually in Explore."
2612
+ ],
2613
+ "path": "use-cases/studio-explore-subject.md",
2614
+ "webPath": "/use-cases#studio-explore-subject",
2615
+ "prerequisites": [],
2616
+ "related": [
2617
+ "06-relationships-and-memory"
2618
+ ],
2619
+ "packIds": [
2620
+ "use-case/studio-explore-subject"
2621
+ ]
2622
+ },
2623
+ {
2624
+ "id": "studio-review-intelligence",
2625
+ "type": "use-case",
2626
+ "title": "Review intelligence proposals in Studio",
2627
+ "summary": "Accept evidence, reject bad proposals, install only deliberately.",
2628
+ "aliases": [],
2629
+ "audiences": [
2630
+ "builders"
2631
+ ],
2632
+ "tags": [
2633
+ "studio",
2634
+ "intelligence"
2635
+ ],
2636
+ "goals": [
2637
+ "Accept evidence, reject bad proposals, install only deliberately."
2638
+ ],
2639
+ "path": "use-cases/studio-review-intelligence.md",
2640
+ "webPath": "/use-cases#studio-review-intelligence",
2641
+ "prerequisites": [],
2642
+ "related": [
2643
+ "05-metadata-agents-abstracts"
2644
+ ],
2645
+ "packIds": [
2646
+ "use-case/studio-review-intelligence"
2647
+ ]
2648
+ },
2649
+ {
2650
+ "id": "studio-stale-conflict-ui",
2651
+ "type": "use-case",
2652
+ "title": "Resolve stale conflicts from the UI",
2653
+ "summary": "Recognize revision conflicts and recover without losing the other writer’s work blindly.",
2654
+ "aliases": [],
2655
+ "audiences": [
2656
+ "builders"
2657
+ ],
2658
+ "tags": [
2659
+ "studio",
2660
+ "conflicts"
2661
+ ],
2662
+ "goals": [
2663
+ "Recognize revision conflicts and recover without losing the other writer’s work blindly."
2664
+ ],
2665
+ "path": "use-cases/studio-stale-conflict-ui.md",
2666
+ "webPath": "/use-cases#studio-stale-conflict-ui",
2667
+ "prerequisites": [],
2668
+ "related": [
2669
+ "09-workflow-and-studio"
2670
+ ],
2671
+ "packIds": [
2672
+ "use-case/studio-stale-conflict-ui"
2673
+ ]
2674
+ },
2675
+ {
2676
+ "id": "studio-scope-isolation",
2677
+ "type": "use-case",
2678
+ "title": "Keep workspaces isolated via the scope bar",
2679
+ "summary": "Never mix orgs/workspaces; treat scope as the product boundary.",
2680
+ "aliases": [],
2681
+ "audiences": [
2682
+ "builders"
2683
+ ],
2684
+ "tags": [
2685
+ "studio",
2686
+ "scope",
2687
+ "isolation"
2688
+ ],
2689
+ "goals": [
2690
+ "Never mix orgs/workspaces; treat scope as the product boundary."
2691
+ ],
2692
+ "path": "use-cases/studio-scope-isolation.md",
2693
+ "webPath": "/use-cases#studio-scope-isolation",
2694
+ "prerequisites": [],
2695
+ "related": [
2696
+ "11-agent-packs-and-ops"
2697
+ ],
2698
+ "packIds": [
2699
+ "use-case/studio-scope-isolation"
2700
+ ]
2701
+ },
2702
+ {
2703
+ "id": "builder-acceptance-ops",
2704
+ "type": "use-case",
2705
+ "title": "Acceptance tour on the ops narrative",
2706
+ "summary": "Walk WI-100 / employees success path in Studio without API deep-dive.",
2707
+ "aliases": [],
2708
+ "audiences": [
2709
+ "builders"
2710
+ ],
2711
+ "tags": [
2712
+ "acceptance",
2713
+ "ops",
2714
+ "studio"
2715
+ ],
2716
+ "goals": [
2717
+ "Walk WI-100 / employees success path in Studio without API deep-dive."
2718
+ ],
2719
+ "path": "use-cases/builder-acceptance-ops.md",
2720
+ "webPath": "/use-cases#builder-acceptance-ops",
2721
+ "prerequisites": [],
2722
+ "related": [
2723
+ "08-pipelines"
2724
+ ],
2725
+ "packIds": [
2726
+ "use-case/builder-acceptance-ops"
2727
+ ]
2728
+ },
2729
+ {
2730
+ "id": "00-platform-overview",
2731
+ "type": "book",
2732
+ "title": "Platform Overview",
2733
+ "summary": "Surfaces, packages, hard rules, and where to start — developers and builders twins.",
2734
+ "aliases": [
2735
+ "CASE FILE · MRX-00"
2736
+ ],
2737
+ "audiences": [
2738
+ "developers",
2739
+ "builders"
2740
+ ],
2741
+ "tags": [
2742
+ "platform",
2743
+ "g12",
2744
+ "start-here"
2745
+ ],
2746
+ "goals": [],
2747
+ "path": "books/00-platform-overview/",
2748
+ "webPath": "/books/00-platform-overview",
2749
+ "prerequisites": [],
2750
+ "related": [],
2751
+ "packIds": []
2752
+ },
2753
+ {
2754
+ "id": "01-format-for-dummies",
2755
+ "type": "book",
2756
+ "title": "Format for Dummies",
2757
+ "summary": "Mental model of the record envelope — OT/CT, composition, discriminators, and what is not stored on the record.",
2758
+ "aliases": [
2759
+ "CASE FILE · MRX-01"
2760
+ ],
2761
+ "audiences": [
2762
+ "developers",
2763
+ "builders"
2764
+ ],
2765
+ "tags": [
2766
+ "format",
2767
+ "record",
2768
+ "envelope"
2769
+ ],
2770
+ "goals": [],
2771
+ "path": "books/01-format-for-dummies/",
2772
+ "webPath": "/books/01-format-for-dummies",
2773
+ "prerequisites": [],
2774
+ "related": [],
2775
+ "packIds": []
2776
+ },
2777
+ {
2778
+ "id": "02-runtime-data-client",
2779
+ "type": "book",
2780
+ "title": "Runtime Data Client",
2781
+ "summary": "Connection, scope, exact reads, writes, compose, abstracts, and client anti-patterns through Memorix Service / OpenAPI.",
2782
+ "aliases": [
2783
+ "CASE FILE · MRX-02"
2784
+ ],
2785
+ "audiences": [
2786
+ "developers"
2787
+ ],
2788
+ "tags": [
2789
+ "http",
2790
+ "client",
2791
+ "data"
2792
+ ],
2793
+ "goals": [],
2794
+ "path": "books/02-runtime-data-client/",
2795
+ "webPath": "/books/02-runtime-data-client",
2796
+ "prerequisites": [],
2797
+ "related": [],
2798
+ "packIds": []
2799
+ },
2800
+ {
2801
+ "id": "03-lists-queries-pagination",
2802
+ "type": "book",
2803
+ "title": "Lists, Queries, Pagination",
2804
+ "summary": "List contracts, query grammar, cursors, page size, and multi-resource listing without foot-guns.",
2805
+ "aliases": [
2806
+ "CASE FILE · MRX-03"
2807
+ ],
2808
+ "audiences": [
2809
+ "developers"
2810
+ ],
2811
+ "tags": [
2812
+ "lists",
2813
+ "cursor",
2814
+ "query"
2815
+ ],
2816
+ "goals": [],
2817
+ "path": "books/03-lists-queries-pagination/",
2818
+ "webPath": "/books/03-lists-queries-pagination",
2819
+ "prerequisites": [],
2820
+ "related": [],
2821
+ "packIds": []
2822
+ },
2823
+ {
2824
+ "id": "04-data-access-patterns",
2825
+ "type": "book",
2826
+ "title": "Data Access Patterns",
2827
+ "summary": "Decision matrix — best / acceptable / forbidden access methods for real client tasks.",
2828
+ "aliases": [
2829
+ "CASE FILE · MRX-04"
2830
+ ],
2831
+ "audiences": [
2832
+ "developers"
2833
+ ],
2834
+ "tags": [
2835
+ "patterns",
2836
+ "matrix",
2837
+ "http"
2838
+ ],
2839
+ "goals": [],
2840
+ "path": "books/04-data-access-patterns/",
2841
+ "webPath": "/books/04-data-access-patterns",
2842
+ "prerequisites": [],
2843
+ "related": [],
2844
+ "packIds": []
2845
+ },
2846
+ {
2847
+ "id": "05-metadata-agents-abstracts",
2848
+ "type": "book",
2849
+ "title": "Metadata, Agents, Abstracts & Mappings",
2850
+ "summary": "Agents, OT/CT, virtual abstracts, mappings, install/publish — never auto-install from intelligence.",
2851
+ "aliases": [
2852
+ "CASE FILE · MRX-05"
2853
+ ],
2854
+ "audiences": [
2855
+ "developers",
2856
+ "builders"
2857
+ ],
2858
+ "tags": [
2859
+ "metadata",
2860
+ "abstracts",
2861
+ "agents"
2862
+ ],
2863
+ "goals": [],
2864
+ "path": "books/05-metadata-agents-abstracts/",
2865
+ "webPath": "/books/05-metadata-agents-abstracts",
2866
+ "prerequisites": [],
2867
+ "related": [],
2868
+ "packIds": []
2869
+ },
2870
+ {
2871
+ "id": "06-relationships-and-memory",
2872
+ "type": "book",
2873
+ "title": "Relationships & Memory",
2874
+ "summary": "Exact Memory ingest and relationship engine links — never associated* payloads on records.",
2875
+ "aliases": [
2876
+ "CASE FILE · MRX-06"
2877
+ ],
2878
+ "audiences": [
2879
+ "developers",
2880
+ "builders"
2881
+ ],
2882
+ "tags": [
2883
+ "relationships",
2884
+ "memory",
2885
+ "links"
2886
+ ],
2887
+ "goals": [],
2888
+ "path": "books/06-relationships-and-memory/",
2889
+ "webPath": "/books/06-relationships-and-memory",
2890
+ "prerequisites": [],
2891
+ "related": [],
2892
+ "packIds": []
2893
+ },
2894
+ {
2895
+ "id": "07-services",
2896
+ "type": "book",
2897
+ "title": "Building Services",
2898
+ "summary": "When to build a service, handlers, pipeline invoke, and core-service / ports-manager / api-live-view.",
2899
+ "aliases": [
2900
+ "CASE FILE · MRX-07"
2901
+ ],
2902
+ "audiences": [
2903
+ "developers",
2904
+ "builders"
2905
+ ],
2906
+ "tags": [
2907
+ "services",
2908
+ "ports",
2909
+ "handlers"
2910
+ ],
2911
+ "goals": [],
2912
+ "path": "books/07-services/",
2913
+ "webPath": "/books/07-services",
2914
+ "prerequisites": [],
2915
+ "related": [],
2916
+ "packIds": []
2917
+ },
2918
+ {
2919
+ "id": "08-pipelines",
2920
+ "type": "book",
2921
+ "title": "Building Pipelines",
2922
+ "summary": "Pipeline definition, step kinds, AI fail-closed, operations, and the complete ops tutorial.",
2923
+ "aliases": [
2924
+ "CASE FILE · MRX-08"
2925
+ ],
2926
+ "audiences": [
2927
+ "developers",
2928
+ "builders"
2929
+ ],
2930
+ "tags": [
2931
+ "pipelines",
2932
+ "steps",
2933
+ "ops"
2934
+ ],
2935
+ "goals": [],
2936
+ "path": "books/08-pipelines/",
2937
+ "webPath": "/books/08-pipelines",
2938
+ "prerequisites": [],
2939
+ "related": [],
2940
+ "packIds": []
2941
+ },
2942
+ {
2943
+ "id": "09-workflow-and-studio",
2944
+ "type": "book",
2945
+ "title": "Workflow & Studio",
2946
+ "summary": "Design · Operate · Explore — scope bar ≡ headers, workflow siblings, embedding guidance. Builders primary.",
2947
+ "aliases": [
2948
+ "CASE FILE · MRX-09"
2949
+ ],
2950
+ "audiences": [
2951
+ "developers",
2952
+ "builders"
2953
+ ],
2954
+ "tags": [
2955
+ "studio",
2956
+ "workflow",
2957
+ "ui"
2958
+ ],
2959
+ "goals": [],
2960
+ "path": "books/09-workflow-and-studio/",
2961
+ "webPath": "/books/09-workflow-and-studio",
2962
+ "prerequisites": [],
2963
+ "related": [],
2964
+ "packIds": []
2965
+ },
2966
+ {
2967
+ "id": "10-intelligence",
2968
+ "type": "book",
2969
+ "title": "Structural Intelligence",
2970
+ "summary": "Profile data, proposals with evidence, human install boundary.",
2971
+ "aliases": [
2972
+ "CASE FILE · MRX-10"
2973
+ ],
2974
+ "audiences": [
2975
+ "developers",
2976
+ "builders"
2977
+ ],
2978
+ "tags": [
2979
+ "intelligence",
2980
+ "proposals"
2981
+ ],
2982
+ "goals": [],
2983
+ "path": "books/10-intelligence/",
2984
+ "webPath": "/books/10-intelligence",
2985
+ "prerequisites": [],
2986
+ "related": [],
2987
+ "packIds": []
2988
+ },
2989
+ {
2990
+ "id": "11-agent-packs-and-ops",
2991
+ "type": "book",
2992
+ "title": "Agent Packs & Ops",
2993
+ "summary": "Pack layout, harness, g12ops* acceptance, custom kinds, golden V2 validation.",
2994
+ "aliases": [
2995
+ "CASE FILE · MRX-11"
2996
+ ],
2997
+ "audiences": [
2998
+ "developers",
2999
+ "builders"
3000
+ ],
3001
+ "tags": [
3002
+ "ops-pack",
3003
+ "fixtures",
3004
+ "acceptance"
3005
+ ],
3006
+ "goals": [],
3007
+ "path": "books/11-agent-packs-and-ops/",
3008
+ "webPath": "/books/11-agent-packs-and-ops",
3009
+ "prerequisites": [],
3010
+ "related": [],
3011
+ "packIds": []
3012
+ },
3013
+ {
3014
+ "id": "12-knowx",
3015
+ "type": "book",
3016
+ "title": "Building KnowX",
3017
+ "summary": "KnowX nodes/edges as content types, review siblings, runnable fixture path (no live AI required).",
3018
+ "aliases": [
3019
+ "CASE FILE · MRX-12"
3020
+ ],
3021
+ "audiences": [
3022
+ "developers",
3023
+ "builders"
3024
+ ],
3025
+ "tags": [
3026
+ "knowx",
3027
+ "provenance",
3028
+ "claims"
3029
+ ],
3030
+ "goals": [],
3031
+ "path": "books/12-knowx/",
3032
+ "webPath": "/books/12-knowx",
3033
+ "prerequisites": [],
3034
+ "related": [],
3035
+ "packIds": []
3036
+ },
3037
+ {
3038
+ "id": "13-migration-troubleshooting",
3039
+ "type": "book",
3040
+ "title": "Migration & Troubleshooting",
3041
+ "summary": "associated* rejection, stale revisions, HTTP failure matrix, escalate packets.",
3042
+ "aliases": [
3043
+ "CASE FILE · MRX-13"
3044
+ ],
3045
+ "audiences": [
3046
+ "developers",
3047
+ "builders"
3048
+ ],
3049
+ "tags": [
3050
+ "migration",
3051
+ "troubleshooting",
3052
+ "v2"
3053
+ ],
3054
+ "goals": [],
3055
+ "path": "books/13-migration-troubleshooting/",
3056
+ "webPath": "/books/13-migration-troubleshooting",
3057
+ "prerequisites": [],
3058
+ "related": [],
3059
+ "packIds": []
3060
+ },
3061
+ {
3062
+ "id": "14-getting-started-and-tutorials",
3063
+ "type": "book",
3064
+ "title": "Getting Started & Tutorials",
3065
+ "summary": "Start here — install @x12i/memorix-docs for agents, set scope, best-practice pipeline order, and hands-on tutorials.",
3066
+ "aliases": [
3067
+ "CASE FILE · MRX-14"
3068
+ ],
3069
+ "audiences": [
3070
+ "developers",
3071
+ "builders"
3072
+ ],
3073
+ "tags": [
3074
+ "getting-started",
3075
+ "tutorials",
3076
+ "install",
3077
+ "start-here"
3078
+ ],
3079
+ "goals": [],
3080
+ "path": "books/14-getting-started-and-tutorials/",
3081
+ "webPath": "/books/14-getting-started-and-tutorials",
3082
+ "prerequisites": [],
3083
+ "related": [],
3084
+ "packIds": []
3085
+ }
3086
+ ]
3087
+ }