@wildo-ai/framework-knowledge 1.1.3 → 1.1.5

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 (841) hide show
  1. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  2. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  3. package/dist/esm/framework-knowledge.definitions.js +349 -17
  4. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  5. package/dist/esm/framework-knowledge.loader.d.ts +19 -0
  6. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  7. package/dist/esm/framework-knowledge.loader.js +47 -1
  8. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  9. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  10. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
  11. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  12. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +125 -0
  13. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
  14. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
  15. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
  16. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
  17. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  18. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +326 -8
  19. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  20. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +5 -3
  21. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  22. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +21 -14
  23. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
  25. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
  26. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
  27. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
  28. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
  29. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
  30. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
  31. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
  32. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
  33. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
  34. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
  35. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
  36. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
  37. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +10 -5
  39. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
  41. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
  42. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
  43. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
  44. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
  45. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
  47. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +67 -0
  49. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
  50. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
  51. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
  52. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
  53. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
  54. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
  55. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
  56. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
  57. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
  58. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +71 -0
  60. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
  61. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
  62. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
  63. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
  64. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
  65. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
  66. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
  67. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
  68. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
  69. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
  70. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
  71. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
  72. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
  74. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +171 -1
  76. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +146 -1
  78. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
  80. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
  81. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
  82. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
  83. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
  84. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  85. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +172 -4
  86. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  87. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
  88. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  89. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +8 -7
  90. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  91. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
  92. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  93. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +22 -3
  94. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  95. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +5 -3
  96. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +21 -12
  98. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  99. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +192 -27
  100. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  101. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +172 -33
  102. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  103. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +2 -1
  104. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  105. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +6 -2
  106. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  107. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +182 -5
  108. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  109. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +191 -5
  110. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  111. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +2 -1
  112. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  113. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +3 -2
  114. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  115. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +154 -0
  116. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
  117. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
  118. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
  119. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
  120. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
  121. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
  122. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
  123. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
  124. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  125. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +2 -1
  126. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  127. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
  128. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  129. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +6 -2
  130. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  131. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
  132. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  133. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +2 -1
  134. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  135. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
  136. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  137. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -3
  138. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  139. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +32 -4
  140. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  141. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +27 -3
  142. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  143. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -2
  144. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  145. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +4 -2
  146. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  147. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
  148. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
  149. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
  150. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
  151. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
  152. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  153. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +18 -4
  154. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
  156. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  157. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -4
  158. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  159. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +6 -5
  160. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  161. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +18 -17
  162. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  163. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  164. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
  165. package/dist/knowledge/manifest.json +9 -8
  166. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
  167. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
  168. package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
  169. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
  170. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
  171. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
  172. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
  173. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
  174. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
  175. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
  176. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
  177. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
  178. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
  179. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
  180. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
  181. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
  182. package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
  183. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
  184. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
  185. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
  186. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
  187. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
  188. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
  189. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
  190. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
  191. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
  192. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
  193. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
  194. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
  195. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
  196. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
  197. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
  198. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
  199. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
  200. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
  201. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
  202. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
  203. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
  204. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
  205. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
  206. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
  207. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
  208. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
  209. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
  210. package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
  211. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
  212. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
  213. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
  214. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
  215. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
  216. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
  217. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
  218. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
  219. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
  220. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
  221. package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
  222. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
  223. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
  224. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
  225. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
  226. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
  227. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
  228. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
  229. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
  230. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
  231. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
  232. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
  233. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
  234. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
  235. package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
  236. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
  237. package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
  238. package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
  239. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
  240. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
  241. package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
  242. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
  243. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
  244. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
  245. package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
  246. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
  247. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
  248. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
  249. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
  250. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
  251. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  252. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  253. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
  254. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
  255. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
  256. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
  257. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
  258. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
  259. package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
  260. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
  261. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
  262. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
  263. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
  264. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
  265. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
  266. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
  267. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
  268. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
  269. package/dist/knowledge/references/acp.execution-profile.md +266 -0
  270. package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
  271. package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
  272. package/dist/knowledge/references/acp.permission-escalation.md +37 -0
  273. package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
  274. package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
  275. package/dist/knowledge/references/application-maturity.config.md +319 -0
  276. package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
  277. package/dist/knowledge/references/assertions.specification.config.md +1 -1
  278. package/dist/knowledge/references/brand.asset.config.md +8 -16
  279. package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
  280. package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
  281. package/dist/knowledge/references/brand.snapshot.config.md +16 -2
  282. package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
  283. package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
  284. package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
  285. package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
  286. package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
  287. package/dist/knowledge/references/capability-composition.config.md +155 -0
  288. package/dist/knowledge/references/cli.market.utils.md +1 -0
  289. package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
  290. package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
  291. package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
  292. package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
  293. package/dist/knowledge/references/engine.saas-website.config.md +22 -10
  294. package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
  295. package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
  296. package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
  297. package/dist/knowledge/references/example.config.design-system.full.md +3 -0
  298. package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
  299. package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
  300. package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
  301. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
  302. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
  303. package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
  304. package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
  305. package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
  306. package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
  307. package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
  308. package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
  309. package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
  310. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
  311. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
  312. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
  313. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
  314. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
  315. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
  316. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
  317. package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
  318. package/dist/knowledge/references/example.worker.node-route.md +94 -0
  319. package/dist/knowledge/references/experience-plan.config.md +311 -0
  320. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
  321. package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
  322. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
  323. package/dist/knowledge/references/integration-plan.config.md +185 -0
  324. package/dist/knowledge/references/market.alternative.config.md +1 -1
  325. package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
  326. package/dist/knowledge/references/market.channel.config.md +3 -3
  327. package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
  328. package/dist/knowledge/references/market.gain.config.md +1 -1
  329. package/dist/knowledge/references/market.icp.config.md +2 -2
  330. package/dist/knowledge/references/market.job.config.md +1 -1
  331. package/dist/knowledge/references/market.message-template.config.md +2 -2
  332. package/dist/knowledge/references/market.objection.config.md +1 -1
  333. package/dist/knowledge/references/market.pain.config.md +1 -1
  334. package/dist/knowledge/references/market.persona.config.md +2 -2
  335. package/dist/knowledge/references/market.proof.config.md +1 -1
  336. package/dist/knowledge/references/market.snapshot.validation.md +15 -0
  337. package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
  338. package/dist/knowledge/references/market.trigger.config.md +1 -1
  339. package/dist/knowledge/references/minions.tick-contract.md +83 -0
  340. package/dist/knowledge/references/placement-plan.config.md +369 -0
  341. package/dist/knowledge/references/platform.config.application-database.md +5 -2
  342. package/dist/knowledge/references/platform.config.backing-services.md +0 -21
  343. package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
  344. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
  345. package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
  346. package/dist/knowledge/references/platform.config.saas.md +261 -9
  347. package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
  348. package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
  349. package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
  350. package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
  351. package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
  352. package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
  353. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
  354. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
  355. package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
  356. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
  357. package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
  358. package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
  359. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
  360. package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
  361. package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
  362. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
  363. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
  364. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
  365. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
  366. package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
  367. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
  368. package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
  369. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
  370. package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
  371. package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
  372. package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
  373. package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
  374. package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
  375. package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
  376. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
  377. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
  378. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
  379. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
  380. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
  381. package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
  382. package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
  383. package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
  384. package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
  385. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
  386. package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
  387. package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
  388. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
  389. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
  390. package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
  391. package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
  392. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
  393. package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
  394. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
  395. package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
  396. package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
  397. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
  398. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
  399. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
  400. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
  401. package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
  402. package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
  403. package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
  404. package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
  405. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
  406. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
  407. package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
  408. package/dist/knowledge/references/saas.models.config.registration.md +188 -0
  409. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
  410. package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
  411. package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
  412. package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
  413. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
  414. package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
  415. package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
  416. package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
  417. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
  418. package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
  419. package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
  420. package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
  421. package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
  422. package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
  423. package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
  424. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
  425. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
  426. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
  427. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
  428. package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
  429. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
  430. package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
  431. package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
  432. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
  433. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
  434. package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
  435. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
  436. package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
  437. package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
  438. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
  439. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
  440. package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
  441. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
  442. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
  443. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
  444. package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
  445. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
  446. package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
  447. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
  448. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
  449. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
  450. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
  451. package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
  452. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
  453. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
  454. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
  455. package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
  456. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
  457. package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
  458. package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
  459. package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
  460. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
  461. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
  462. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
  463. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
  464. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
  465. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
  466. package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
  467. package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
  468. package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
  469. package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
  470. package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
  471. package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
  472. package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
  473. package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
  474. package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
  475. package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
  476. package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
  477. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
  478. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
  479. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
  480. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
  481. package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
  482. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
  483. package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
  484. package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
  485. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
  486. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
  487. package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
  488. package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
  489. package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
  490. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
  491. package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
  492. package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
  493. package/dist/knowledge/references/saas.website.consent.context.md +162 -0
  494. package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
  495. package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
  496. package/dist/knowledge/references/saas.website.page.context.md +4 -3
  497. package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
  498. package/dist/knowledge/references/saas.website.section.context.md +3 -2
  499. package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
  500. package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
  501. package/dist/knowledge/references/website-plan.config.md +205 -0
  502. package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
  503. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
  504. package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
  505. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
  506. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
  507. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
  508. package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
  509. package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
  510. package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
  511. package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
  512. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
  513. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
  514. package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
  515. package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
  516. package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
  517. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
  518. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
  519. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
  520. package/dist/knowledge/references/zod.factories.address.md +118 -0
  521. package/dist/knowledge/references/zod.factories.code.md +2 -0
  522. package/dist/knowledge/references/zod.factories.duration.md +2 -0
  523. package/dist/knowledge/references/zod.factories.money.md +2 -0
  524. package/dist/knowledge/references/zod.factories.phone.md +14 -1
  525. package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
  526. package/dist/knowledge/registries/framework-topics.json +1215 -11
  527. package/dist/knowledge/registries/playbooks.json +454 -50
  528. package/dist/knowledge/registries/source-tags.json +3153 -1043
  529. package/dist/knowledge/rules/database-migration-obligation.md +110 -0
  530. package/dist/knowledge/rules/live-context-door.md +108 -0
  531. package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
  532. package/dist/knowledge/skills/INDEX.md +46 -11
  533. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
  534. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
  535. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
  536. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
  537. package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
  538. package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
  539. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
  540. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
  541. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
  542. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
  543. package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
  544. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
  545. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
  546. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
  547. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
  548. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
  549. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
  550. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
  551. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
  552. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
  553. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
  554. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
  555. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
  556. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
  557. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
  558. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
  559. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
  560. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
  561. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
  562. package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
  563. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
  564. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
  565. package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
  566. package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
  567. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
  568. package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
  569. package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
  570. package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
  571. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
  572. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
  573. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
  574. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
  575. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
  576. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
  577. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
  578. package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
  579. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
  580. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
  581. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
  582. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
  583. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
  584. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
  585. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
  586. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
  587. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
  588. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
  589. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
  590. package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
  591. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
  592. package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
  593. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
  594. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
  595. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
  596. package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
  597. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
  598. package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
  599. package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
  600. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
  601. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
  602. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
  603. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
  604. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
  605. package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
  606. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
  607. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
  608. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
  609. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
  610. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
  611. package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
  612. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
  613. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
  614. package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
  615. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
  616. package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
  617. package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
  618. package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
  619. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
  620. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
  621. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
  622. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
  623. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
  624. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
  625. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
  626. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
  627. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
  628. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
  629. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
  630. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
  631. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
  632. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
  633. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
  634. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
  635. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
  636. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
  637. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
  638. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
  639. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
  640. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
  641. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
  642. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
  643. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
  644. package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
  645. package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
  646. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
  647. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
  648. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
  649. package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
  650. package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
  651. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
  652. package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
  653. package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
  654. package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
  655. package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
  656. package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
  657. package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
  658. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
  659. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
  660. package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
  661. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
  662. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
  663. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
  664. package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
  665. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
  666. package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
  667. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
  668. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
  669. package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
  670. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
  671. package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
  672. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
  673. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
  674. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
  675. package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
  676. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
  677. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
  678. package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
  679. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
  680. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
  681. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
  682. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
  683. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
  684. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
  685. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
  686. package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
  687. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
  688. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
  689. package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
  690. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
  691. package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
  692. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
  693. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
  694. package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
  695. package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
  696. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
  697. package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
  698. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
  699. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
  700. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
  701. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
  702. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
  703. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
  704. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
  705. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
  706. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
  707. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
  708. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
  709. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
  710. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
  711. package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
  712. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
  713. package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
  714. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
  715. package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
  716. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
  717. package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
  718. package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
  719. package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
  720. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
  721. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
  722. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
  723. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
  724. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
  725. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
  726. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
  727. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
  728. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
  729. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
  730. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
  731. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
  732. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
  733. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
  734. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
  735. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
  736. package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
  737. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
  738. package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
  739. package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
  740. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
  741. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
  742. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
  743. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
  744. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
  745. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
  746. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
  747. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
  748. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
  749. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
  750. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
  751. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
  752. package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
  753. package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
  754. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
  755. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
  756. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
  757. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
  758. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
  759. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
  760. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
  761. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
  762. package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
  763. package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
  764. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
  765. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
  766. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
  767. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
  768. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
  769. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
  770. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
  771. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
  772. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
  773. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
  774. package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
  775. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
  776. package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
  777. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
  778. package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
  779. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
  780. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
  781. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
  782. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
  783. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
  784. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
  785. package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
  786. package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
  787. package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
  788. package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
  789. package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
  790. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
  791. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
  792. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
  793. package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
  794. package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
  795. package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
  796. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
  797. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
  798. package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
  799. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
  800. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
  801. package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
  802. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
  803. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
  804. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
  805. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
  806. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
  807. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
  808. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
  809. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
  810. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
  811. package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
  812. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
  813. package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
  814. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
  815. package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
  816. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
  817. package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
  818. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
  819. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
  820. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
  821. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
  822. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
  823. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
  824. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
  825. package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
  826. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
  827. package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
  828. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
  829. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
  830. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
  831. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
  832. package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
  833. package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
  834. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
  835. package/dist/knowledge/topic-index.json +5335 -1010
  836. package/dist/tsconfig.build.tsbuildinfo +1 -1
  837. package/dist/tsconfig.tsbuildinfo +1 -1
  838. package/package.json +4 -4
  839. package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
  840. package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
  841. /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
@@ -0,0 +1,785 @@
1
+ # `systemsOfRecord` — the deployments this application reads its own rows out of
2
+
3
+ A **system of record** is somebody else's deployment holding rows your application treats as its own
4
+ — your company's Odoo, your S/4HANA, the Dynamics your operations team lives in. You declare it once,
5
+ by NAME, and resources bind it by that name.
6
+
7
+ Read this when:
8
+
9
+ - a resource's rows live in an ERP, a CRM or a partner system and will stay there;
10
+ - you have two deployments of the same vendor and need both;
11
+ - an integration should act as the APPLICATION rather than as a customer who connected their account;
12
+ - a boot refusal names a system of record, a vendor facet, a dialect or a missing slot.
13
+
14
+ ## It is not a provider, and the difference decides where everything goes
15
+
16
+ | | a system of record | a provider |
17
+ |---|---|---|
18
+ | whose deployment | yours | the vendor's |
19
+ | whose credential | your deployment's service key | often a PERSON's, connected by them |
20
+ | chosen how | named by an instance a resource binds | selected through the capability plane |
21
+ | whose rows | your own business rows | the vendor's, reached per operation |
22
+
23
+ Declaring one under `providers` instead would put it into a selection mechanism nothing consults,
24
+ and — the reason that matters — a provider's environment-variable names live in its module, so one
25
+ provider ref can only ever be ONE deployment.
26
+
27
+ ## Three places, and only the first is a decision
28
+
29
+ 1. **`wildo.saas.config.ts`** declares the instance: its vendor, its dialect, optionally its
30
+ credential kind. Nothing here is an address or a secret.
31
+ 2. **`wildo.infra.<env>.config.ts`** says WHERE it is in that environment — or `{ enabled: false }`
32
+ when that environment has no access to it at all, which a developer laptop and a staging with no
33
+ ERP genuinely do not. Silence is NOT that declaration: an instance you declare and this file omits
34
+ is refused, because "no access here" and "somebody forgot" need opposite behaviours.
35
+ 3. **`secrets.json`** holds the credential under `systemsOfRecordEnv`, keyed by the DERIVED variable
36
+ name.
37
+
38
+ You never author a variable name. They are derived as `WILDO_SOR_<NAME>__<SLOT>` — so renaming an
39
+ instance renames its variables, and `wildo config sync` reports every slot that went missing.
40
+
41
+ ## Rows belong to the organization that owns the application
42
+
43
+ Which is why declaring a system of record requires an organization type carrying `ownsApplication`,
44
+ and why a bound resource must be ORGANIZATIONS-scoped with a `REQUIRES_CONTEXT` primary-scope
45
+ relationship and no foreign key. Rows read out of the system are STAMPED with that organization's id,
46
+ so the engine's ordinary per-row tenant gate decides who may see them — with no exemption, and with
47
+ nothing about your tenants sent to a remote that has never heard of them.
48
+
49
+ ## Choosing a vendor: a named facet, or the generic `odata` one
50
+
51
+ Declaring an instance names a VENDOR, and the vendor is what supplies the facet — the record that
52
+ says which dialects the system speaks, which credential kinds its service identity takes, and which
53
+ address slots you must fill. Facets ship in the provider catalogue (`@wildo-ai/providers`), not in
54
+ the engine, which is why a vendor your application does not depend on costs it nothing.
55
+
56
+ **Prefer a named vendor whenever one exists.** A named facet carries the corrections that vendor
57
+ needs — the header its key travels in, the token endpoint's shape, the query options its API refuses
58
+ — and choosing it means you supply values rather than decisions.
59
+
60
+ **`odata` is the generic one**, and it is the answer for the case an internal tool actually meets
61
+ most: your own OData v4 service, a bespoke middleware, an ERP surface nobody catalogued. It names no
62
+ vendor, so it can narrow nothing, and the consequence is the one thing to know before choosing it —
63
+ **it offers four credential kinds and therefore asks you which**, where a named facet with one kind
64
+ asks you nothing at all.
65
+
66
+ A vendor no facet describes is refused at boot, naming it. That refusal cannot tell a misspelling
67
+ from a package you have not installed, so it says both.
68
+
69
+ ### Which vendors have a facet today
70
+
71
+ `odata` (generic v4) · `microsoft-dataverse` · `microsoft-dynamics-365-business-central` ·
72
+ `netsuite` · `odoo` · `salesforce` · `sap-s4hana`.
73
+
74
+ Two things a facet can tell you that are worth reading BEFORE you bind a resource to it:
75
+
76
+ **How it pages.** A vendor that pages by CONTINUATION (Dataverse, Salesforce) cannot be addressed by
77
+ page number — page N costs N requests, and the engine refuses past twenty pages rather than walking
78
+ indefinitely. A collection you expect people to page deeply into wants a filter, not a facet.
79
+
80
+ **What it cannot do.** `sap-s4hana` offers HTTP Basic alone, because its preferred client-certificate
81
+ arrangement is a transport credential the engine has no channel for yet. `salesforce` and `netsuite`
82
+ are REST_JSON, which means **no external-data pipelines and no declared `sortFields`** — they are
83
+ read-through only, and a LIST serves the query's own order. None of that is a defect to report; it is
84
+ what those facets say about themselves.
85
+
86
+ ## How the engine proves who it is — the credential kinds
87
+
88
+ A system of record spends the APPLICATION's own service identity. There is never a person, never a
89
+ consent screen and never a refresh token: those belong to the connected-accounts lane, which a system
90
+ of record cannot reach.
91
+
92
+ The kind is usually DERIVED. When the vendor's facet offers exactly one, you declare nothing — being
93
+ asked to choose between one option is being asked a question the mechanism already holds the answer
94
+ to. You name a kind only when your vendor offers several, and boot tells you so by listing them.
95
+
96
+ | kind | what YOU supply | where the credential travels |
97
+ |---|---|---|
98
+ | `odoo-api-key-in-args` | `apiKey`, plus the vendor's `database` and `login` | inside the JSON-RPC arguments |
99
+ | `api-key-header` | `apiKey` | a header the VENDOR names — you never choose it |
100
+ | `api-key-query` | `apiKey` | a query parameter the vendor names. Weaker: a URL reaches access logs |
101
+ | `basic` | `username` (address) and `password` (secret) | `Authorization: Basic` |
102
+ | `oauth2-client-credentials-secret` | `clientId`, `tokenUrl`, `clientSecret`, optionally `scope` / `audience` | a minted bearer token |
103
+ | `oauth2-client-credentials-certificate` | the above minus the secret, plus `privateKeyPem` and either `certificateKeyId` or `certificatePem` | a minted bearer token, obtained with a signed assertion |
104
+ | `oauth2-jwt-bearer` | `clientId`, `tokenUrl`, `subject`, `privateKeyPem` | a minted bearer token, obtained with a signed assertion |
105
+
106
+ ### Which half goes in which file
107
+
108
+ An **identity** slot is an address — `clientId`, a BASIC `username`, Odoo's `login` — and lives in
109
+ the infra env config, where it is diffable and reviewable. A **proof** slot is a secret and lives in
110
+ `secrets.json`. So a credential's two halves are authored in two files, deliberately and
111
+ consistently: the thing an operator most often needs to check is never the thing that must never be
112
+ printed.
113
+
114
+ A PEM slot always ends in `Pem`, and that is not decoration — the name is what the CI secret
115
+ collector matches to un-escape a multi-line value.
116
+
117
+ ### Tokens, and what you do not have to think about
118
+
119
+ For the three OAuth kinds the engine obtains a token on the first read, keeps ONE per instance, and
120
+ re-mints it a minute before it expires. Concurrent first reads share a single mint. A call refused
121
+ with 401 buys exactly one more attempt with a fresh token and then fails — a second 401 means the
122
+ credential itself is wrong, and re-minting cannot fix that.
123
+
124
+ Two backend replicas hold two tokens. Every vendor this was checked against issues a token per
125
+ request rather than invalidating the previous one, so that is ordinary rather than a problem.
126
+
127
+ ### Refusals you will meet at BOOT rather than at the first read
128
+
129
+ An encrypted private key (supply an unencrypted one — the secret channel is the protection, and a
130
+ passphrase stored beside the key it protects protects nothing); a certificate outside its validity
131
+ window; a BASIC username containing `:`, which RFC 7617 makes the delimiter, so the credential would
132
+ decode to a different pair than you typed. Each is refused where the material is known, because a
133
+ certificate that expired last week should not first be noticed by one of your users.
134
+
135
+ `wildo config sync` warns thirty days before a certificate expires. That warning is the only thing
136
+ between you and every read of a bound resource failing at once on a morning nobody chose.
137
+
138
+ ### The pace
139
+
140
+ An instance may declare `maxRequestsPerMinute`, and every resource bound to it shares that one
141
+ window — because the vendor sees ONE identity per instance however many resources you bind. A
142
+ binding's own `remoteCallSemantics.maxRequestsPerMinute` still applies, as a ceiling UNDER it: that
143
+ is how you stop a pipeline load starving your interactive reads. Declaring neither means no local
144
+ limit, which is the honest default — the framework does not know your contract with the vendor.
145
+
146
+ ### mTLS is not available yet
147
+
148
+ A client certificate as the TRANSPORT credential (as opposed to as an assertion signer, above) needs
149
+ the outbound request seam widened and is tracked separately. A vendor that accepts nothing else
150
+ cannot be declared a system of record today, and the refusal says so by name rather than failing at
151
+ the first read.
152
+
153
+ ## Import Origins
154
+
155
+ - `@wildo-ai/saas-models`
156
+
157
+ ## Source Excerpts
158
+
159
+ ### Origin Package: `@wildo-ai/saas-models`
160
+
161
+ ```typescript
162
+ /**
163
+ * The charset law for an instance name, exported because the environment-variable derivation and
164
+ * every tool that parses a derived name back into a `(name, slot)` pair depend on it: a name may
165
+ * not contain `_`, so the `__` delimiter is unambiguous (#1055 R4).
166
+ */
167
+ export const SYSTEM_OF_RECORD_NAME_PATTERN = /^[a-z][a-z0-9-]*$/;
168
+
169
+ /** 32 characters, because the name is a stem of an environment-variable name rather than a label. */
170
+ export const SYSTEM_OF_RECORD_NAME_MAX_LENGTH = 32;
171
+
172
+ export const SystemOfRecordNameSchema = z
173
+ .string()
174
+ .regex(SYSTEM_OF_RECORD_NAME_PATTERN, 'A system-of-record name is lower-kebab-case, starting with a letter.')
175
+ .max(SYSTEM_OF_RECORD_NAME_MAX_LENGTH);
176
+
177
+ /** ONE declared instance. */
178
+ export const SystemOfRecordDeclarationSchema = z.strictObject({
179
+ /**
180
+ * Which vendor this is an instance of — the `vendor` of a facet the deployment ships (engine-shipped
181
+ * today, package-shipped once #1057 lands). Refused at boot when no facet answers to it, rather
182
+ * than here, because the facet map is not in scope in `wildo.saas.config.ts`.
183
+ */
184
+ vendor: z.string().regex(/^[a-z][a-z0-9-]*$/, 'A vendor id is lower-kebab-case.').max(40),
185
+
186
+ /**
187
+ * How this instance is READ. Declared per instance rather than taken from the facet because a
188
+ * vendor may speak several dialects — a service reachable over both OData v4 and a bespoke REST
189
+ * surface is one vendor and two ways in. The facet's `dialects` is the closed set this must belong
190
+ * to, checked at boot.
191
+ */
192
+ dialect: z.enum(HttpApiTransportDialect),
193
+
194
+ /**
195
+ * How the engine proves who it is.
196
+ *
197
+ * OPTIONAL, and the absence is DERIVED rather than defaulted: when the instance's facet offers
198
+ * exactly one credential kind there is nothing for an author to decide, so the registry takes it;
199
+ * when a facet offers more than one and the instance names none, boot refuses and lists them.
200
+ * The framework derives before it asks: a declaration with one legal value is a question whose
201
+ * answer the mechanism already holds.
202
+ *
203
+ * This stays additive when #1056 widens the catalogue: an instance that omitted the field is
204
+ * refused on the day its facet gains a second kind, which is exactly the day its author acquires a
205
+ * real decision.
206
+ */
207
+ credential: z.strictObject({ kind: z.enum(SystemOfRecordCredentialKind) }).optional(),
208
+
209
+ /**
210
+ * The pace this deployment may call the instance at, across EVERY resource bound to it (#1056 §3).
211
+ *
212
+ * Per INSTANCE because that is the unit the vendor accounts for: two resources bound to one
213
+ * Dataverse are one application user to Dataverse, so two independent per-binding budgets would
214
+ * each believe they were within a limit the pair together exceeds.
215
+ *
216
+ * A binding's own `remoteCallSemantics.maxRequestsPerMinute` stays, and becomes a CEILING UNDER
217
+ * this one: it answers a different question — how much of the shared allowance may ONE resource
218
+ * take — which matters when a pipeline load and an interactive read share an instance. Both are
219
+ * consumed for every call, and a call proceeds only if both have room.
220
+ *
221
+ * Omitted means unlimited HERE, which is the honest default: the framework does not know the
222
+ * vendor's contract, and inventing a number would either throttle a deployment that paid for more
223
+ * or fail to protect one that has less.
224
+ */
225
+ maxRequestsPerMinute: z.number().int().min(1).max(600_000).optional(),
226
+
227
+ /**
228
+ * Whether THIS deployment's data is partitioned, and its rows therefore confined to organization
229
+ * units of the owner organization (#1058).
230
+ *
231
+ * ## The reservation this replaces
232
+ *
233
+ * #1055 declared this field `z.never()` and refused it by name, because accepting a declaration the
234
+ * mechanism could not honour would let an author believe their rows were narrowed while every
235
+ * member still saw every row. That refusal did its job and is now lifted.
236
+ *
237
+ * ## Why the VENDOR says how and the INSTANCE says whether
238
+ *
239
+ * How a vendor partitions — which field, what shape, what codec — is a property of the vendor and
240
+ * lives on its facet. Whether a given deployment's data is partitioned is a property of the
241
+ * deployment: a single-company Odoo has a `company_id` on every row and nothing to confine, and
242
+ * asking its operator to restate the field name would be asking a question the facet answers.
243
+ *
244
+ * Opting in against a facet that declares no partitioning is refused at boot, naming the vendor —
245
+ * the alternative is a `true` that does nothing, which is the shape the reservation existed to
246
+ * prevent in the first place.
247
+ */
248
+ partition: z.boolean().optional(),
249
+ });
250
+ export type SystemOfRecordDeclaration = z.infer<typeof SystemOfRecordDeclarationSchema>;
251
+
252
+ /**
253
+ * Every instance this application declares, keyed by name.
254
+ *
255
+ * Optional as a whole: an application that reads nothing out of another system declares nothing, and
256
+ * declaring this block is what ENABLES the external-data lane (#1055 D3) rather than an engine
257
+ * capability flag — the lane has no meaning without an instance to point at.
258
+ */
259
+ export const SystemsOfRecordConfigSchema = z
260
+ .record(SystemOfRecordNameSchema, SystemOfRecordDeclarationSchema)
261
+ .superRefine((systemsOfRecord, ctx) => {
262
+ if (Object.keys(systemsOfRecord).length === 0) {
263
+ ctx.addIssue({
264
+ code: 'custom',
265
+ path: [],
266
+ message:
267
+ 'An empty `systemsOfRecord` declares nothing and enables nothing. Omit the block entirely, or declare the '
268
+ + 'instance the application reads.',
269
+ });
270
+ }
271
+ });
272
+ export type SystemsOfRecordConfig = z.infer<typeof SystemsOfRecordConfigSchema>;
273
+ ```
274
+
275
+ ### Origin Package: `@wildo-ai/saas-models`
276
+
277
+ ```typescript
278
+ /**
279
+ * One input an instance must supply — an address slot (non-secret, authored in the infra env
280
+ * config) or a secret slot (authored in `secrets.json`). Both halves share this shape because both
281
+ * derive an environment-variable name the same way; what differs is WHERE the value is authored and
282
+ * whether it is ever printed.
283
+ */
284
+ export const SystemOfRecordSlotSchema = z.strictObject({
285
+ /**
286
+ * lowerCamelCase, and nothing else — see the module header. Becomes the `<SLOT>` half of
287
+ * `WILDO_SOR_<NAME>__<SLOT>` by upper-snake-casing.
288
+ */
289
+ slug: z
290
+ .string()
291
+ .regex(SYSTEM_OF_RECORD_SLOT_SLUG_PATTERN, 'A slot slug is lowerCamelCase with no separators.')
292
+ .max(40)
293
+ .refine((slug) => slug !== SYSTEM_OF_RECORD_ENABLED_SLOT, {
294
+ error:
295
+ `"${SYSTEM_OF_RECORD_ENABLED_SLOT}" is reserved: the environment builder emits `
296
+ + `${deriveSystemOfRecordEnabledEnvVarName('example')} itself to say an environment has no access to an instance. `
297
+ + 'A slot of that name would make "declared absent" indistinguishable from an address whose value happens to be false.',
298
+ }),
299
+ /**
300
+ * Whether an instance MUST supply it. A missing required slot refuses at `wildo config sync` and
301
+ * again at boot (#1055 E4) — the remedy is authoring a value, which needs no running companion,
302
+ * so refusing is legitimate there.
303
+ */
304
+ required: z.boolean(),
305
+ /** What an operator must put in it. Printed by sync and by the secrets report. */
306
+ description: z.string().min(1),
307
+ });
308
+ export type SystemOfRecordSlot = z.infer<typeof SystemOfRecordSlotSchema>;
309
+
310
+ /**
311
+ * A slot list that cannot be order-dependent or ambiguous: sorted by slug, slugs unique.
312
+ *
313
+ * Mirrors `ProviderSecretContractShapeSchema`, and for the same reason — these lists are compared,
314
+ * reported and (once #1057 lands) contributed by independently-versioned packages, so two facets
315
+ * declaring the same slots in different orders must not be two different things.
316
+ */
317
+ const systemOfRecordSlotListSchema = (label: string) =>
318
+ z.array(SystemOfRecordSlotSchema).superRefine((slots, context) => {
319
+ const seen = new Set<string>();
320
+ for (const [index, slot] of slots.entries()) {
321
+ if (seen.has(slot.slug)) {
322
+ context.addIssue({ code: 'custom', path: [index, 'slug'], message: `Duplicate ${label} slot "${slot.slug}".` });
323
+ }
324
+ seen.add(slot.slug);
325
+ if (index > 0 && slots[index - 1]!.slug.localeCompare(slot.slug) >= 0) {
326
+ context.addIssue({ code: 'custom', path: [index, 'slug'], message: `${label} slots must be sorted by slug.` });
327
+ }
328
+ }
329
+ });
330
+
331
+ /**
332
+ * What ONE credential kind needs, independent of vendor (#1055 R15).
333
+ *
334
+ * The kind owns its secrets and any address slot that exists only because the kind was chosen — a
335
+ * future `OAUTH2_CLIENT_CREDENTIALS` owns `tokenUrl`, which no vendor would declare if it were
336
+ * reached with a static key. `ODOO_API_KEY_IN_ARGS` needs no address slot of its own, and that is
337
+ * the seam rather than an omission: its `database` and `login` inputs identify WHICH Odoo and WHICH
338
+ * user, so they belong to the vendor and would survive a second Odoo credential kind.
339
+ */
340
+ export const SystemOfRecordCredentialKindContractSchema = z.strictObject({
341
+ addressSlots: systemOfRecordSlotListSchema('credential address'),
342
+ secretSlots: systemOfRecordSlotListSchema('credential secret'),
343
+ });
344
+ export type SystemOfRecordCredentialKindContract = z.infer<typeof SystemOfRecordCredentialKindContractSchema>;
345
+
346
+ /**
347
+ * Every credential kind's inputs. Engine-owned and CLOSED, keyed by the enum so a member added
348
+ * without a contract is a compile error rather than a boot surprise.
349
+ *
350
+ * ## Which half a slot lands in, since the answer is not "is it secret"
351
+ *
352
+ * The split follows the precedent #1055 set with Odoo's `login`: **an identity slot is an ADDRESS
353
+ * slot and a proof slot is a SECRET slot.** A `clientId` and a BASIC `username` are not
354
+ * confidential — they name WHICH client and WHICH user — and putting them in `secrets.json` would
355
+ * hide, from every diff and every environment review, the one thing an operator most often needs to
356
+ * check. What must never be printed is the half that PROVES the identity.
357
+ *
358
+ * The consequence is that a credential's two halves are authored in two files. That is deliberate
359
+ * and it is the same shape Odoo already has (`login` in the infra config, `apiKey` in the secrets),
360
+ * so an operator meets one convention rather than two.
361
+ *
362
+ * ## Required-ness that a static list cannot express
363
+ *
364
+ * Three slots are declared `required: false` here and are made required by the FACET's offer, which
365
+ * is the only place that knows: `certificateKeyId` when the vendor's assertion header policy is
366
+ * {@link SystemOfRecordAssertionHeaderPolicy.KEY_ID_SUPPLIED}, `certificatePem` when it is
367
+ * `X509_THUMBPRINT_DERIVED`, and `subject` for the JWT-bearer grant's `sub`. The join is performed
368
+ * ONCE, in {@link resolveSystemOfRecordInstanceSlots}, rather than by each of the five readers of
369
+ * "what does this instance need" — which is the enumeration failure
370
+ * `invariant-call-site-enumeration.md` exists to stop.
371
+ */
372
+ export const SYSTEM_OF_RECORD_CREDENTIAL_KIND_CONTRACTS: Readonly<Record<SystemOfRecordCredentialKind, SystemOfRecordCredentialKindContract>> = {
373
+ [SystemOfRecordCredentialKind.ODOO_API_KEY_IN_ARGS]: {
374
+ addressSlots: [],
375
+ secretSlots: [
376
+ {
377
+ slug: 'apiKey',
378
+ required: true,
379
+ description:
380
+ 'Odoo external-API key (Settings → Users → API Keys). It replaces the password in '
381
+ + '`common.authenticate` and rides as a positional argument of every `execute_kw` call.',
382
+ },
383
+ ],
384
+ },
385
+
386
+ [SystemOfRecordCredentialKind.API_KEY_HEADER]: {
387
+ addressSlots: [],
388
+ secretSlots: [
389
+ {
390
+ slug: 'apiKey',
391
+ required: true,
392
+ description:
393
+ 'The static key this deployment presents. It travels in the header the vendor facet names — '
394
+ + 'the operator never chooses the header, only supplies the key.',
395
+ },
396
+ ],
397
+ },
398
+
399
+ [SystemOfRecordCredentialKind.API_KEY_QUERY]: {
400
+ addressSlots: [],
401
+ secretSlots: [
402
+ {
403
+ slug: 'apiKey',
404
+ required: true,
405
+ description:
406
+ 'The static key this deployment presents, appended as the query parameter the vendor facet '
407
+ + 'names. Weaker than a header — a URL reaches access logs and proxy logs — so prefer a '
408
+ + 'header kind when the vendor offers one.',
409
+ },
410
+ ],
411
+ },
412
+
413
+ [SystemOfRecordCredentialKind.BASIC]: {
414
+ addressSlots: [
415
+ {
416
+ slug: 'username',
417
+ required: true,
418
+ description:
419
+ 'The user this deployment authenticates as (SAP calls it a communication user). It names an '
420
+ + 'identity rather than proving one, so it is authored in the environment config beside the '
421
+ + 'base URL. It may not contain ":" — RFC 7617 makes the colon the delimiter.',
422
+ },
423
+ ],
424
+ secretSlots: [
425
+ { slug: 'password', required: true, description: "That user's password. Half of one credential; rotate it with the username only if the vendor requires." },
426
+ ],
427
+ },
428
+
429
+ [SystemOfRecordCredentialKind.OAUTH2_CLIENT_CREDENTIALS_SECRET]: {
430
+ addressSlots: [
431
+ { slug: 'audience', required: false, description: 'The `audience` / `resource` parameter, when the vendor requires one to scope the token (Entra names the resource; Salesforce does not).' },
432
+ { slug: 'clientId', required: true, description: 'The registered application (client) id. Names WHICH client, so it is addressing rather than proof.' },
433
+ { slug: 'scope', required: false, description: 'Space-delimited scopes to request. Omitted when the vendor derives them from the client registration.' },
434
+ { slug: 'tokenUrl', required: true, description: "The token endpoint's absolute URL. Kind-owned: no vendor would declare it if the instance were reached with a static key." },
435
+ ],
436
+ secretSlots: [
437
+ { slug: 'clientSecret', required: true, description: 'The client secret issued with the client id. This is the half that proves the identity, and the only half that is never printed.' },
438
+ ],
439
+ },
440
+
441
+ [SystemOfRecordCredentialKind.OAUTH2_CLIENT_CREDENTIALS_CERTIFICATE]: {
442
+ addressSlots: [
443
+ { slug: 'audience', required: false, description: 'The `audience` / `resource` parameter when the vendor requires one.' },
444
+ {
445
+ slug: 'certificateKeyId',
446
+ required: false,
447
+ description:
448
+ 'The key id the vendor assigned to this certificate, placed in the assertion\'s protected '
449
+ + 'header as `kid` (NetSuite issues one at upload). REQUIRED when the vendor facet declares '
450
+ + 'the key-id header policy; unused otherwise.',
451
+ },
452
+ {
453
+ slug: 'certificatePem',
454
+ required: false,
455
+ description:
456
+ 'The PUBLIC certificate in PEM, used to derive the `x5t` thumbprint the assertion header '
457
+ + 'carries. REQUIRED when the vendor facet declares the thumbprint header policy; unused '
458
+ + 'otherwise. Public material, so it is an address slot rather than a secret.',
459
+ },
460
+ { slug: 'clientId', required: true, description: 'The registered application (client) id — the assertion\'s `iss` and `sub`.' },
461
+ { slug: 'scope', required: false, description: 'Space-delimited scopes to request.' },
462
+ { slug: 'tokenUrl', required: true, description: "The token endpoint's absolute URL, and the assertion's `aud`." },
463
+ ],
464
+ secretSlots: [
465
+ {
466
+ slug: 'privateKeyPem',
467
+ required: true,
468
+ description:
469
+ 'The UNENCRYPTED PKCS#8 private key, in PEM, that signs the client assertion. An '
470
+ + 'encrypted key is refused by name: the secret channel is the protection, and a passphrase '
471
+ + 'stored beside the key it protects protects nothing.',
472
+ },
473
+ ],
474
+ },
475
+
476
+ [SystemOfRecordCredentialKind.OAUTH2_JWT_BEARER]: {
477
+ addressSlots: [
478
+ { slug: 'audience', required: false, description: 'The assertion\'s `aud`, when it differs from the token endpoint (Salesforce wants the login host).' },
479
+ { slug: 'clientId', required: true, description: 'The connected app\'s consumer key — the assertion\'s `iss`.' },
480
+ { slug: 'scope', required: false, description: 'Space-delimited scopes to request.' },
481
+ {
482
+ slug: 'subject',
483
+ required: false,
484
+ description:
485
+ 'The user the assertion is made FOR — its `sub`. REQUIRED for this grant and declared '
486
+ + 'optional here only because the facet\'s offer is what asserts it; a service account\'s '
487
+ + 'username on the vendor side.',
488
+ },
489
+ { slug: 'tokenUrl', required: true, description: "The token endpoint's absolute URL." },
490
+ ],
491
+ secretSlots: [
492
+ { slug: 'privateKeyPem', required: true, description: 'The UNENCRYPTED PKCS#8 private key, in PEM, that signs the assertion. An encrypted key is refused by name.' },
493
+ ],
494
+ },
495
+ };
496
+
497
+ /**
498
+ * How a vendor wants a client assertion's PROTECTED HEADER built (#1056 R2).
499
+ *
500
+ * A generic "sign it with the private key" is rejected by both vendors that want an assertion, and
501
+ * they want DIFFERENT things — which is why this is a facet policy rather than an engine constant.
502
+ */
503
+ export enum SystemOfRecordAssertionHeaderPolicy {
504
+ /** `kid` carries a key id the VENDOR assigned when the certificate was uploaded (NetSuite). */
505
+ KEY_ID_SUPPLIED = 'key-id-supplied',
506
+ /**
507
+ * `x5t` carries the base64url SHA-1 thumbprint of the certificate, DERIVED by the engine from the
508
+ * supplied `certificatePem` (Microsoft Entra's certificate credential).
509
+ *
510
+ * SHA-1 is not a security choice here: `x5t` is defined as a SHA-1 thumbprint (RFC 7515 §4.1.7)
511
+ * and is an identifier for locating a key, never an integrity proof.
512
+ * spec-cite: RFC 7515 §4.1.7 ("x5t" (X.509 Certificate SHA-1 Thumbprint) Header Parameter).
513
+ */
514
+ X509_THUMBPRINT_DERIVED = 'x509-thumbprint-derived',
515
+ }
516
+
517
+ /**
518
+ * Where a client's id and secret travel on a client-credentials token request.
519
+ *
520
+ * RFC 6749 §2.3.1 permits BOTH and says a server MUST support the Basic header while it MAY support
521
+ * the body form — and real vendors differ, so the choice cannot be an engine default.
522
+ * spec-cite: RFC 6749 §2.3.1 (Client Password).
523
+ */
524
+ export enum SystemOfRecordClientAuthenticationPlacement {
525
+ /** `client_id` and `client_secret` as form fields in the request body. */
526
+ REQUEST_BODY = 'request-body',
527
+ /** `Authorization: Basic base64(client_id ":" client_secret)`. */
528
+ BASIC_HEADER = 'basic-header',
529
+ }
530
+
531
+ /**
532
+ * The algorithms an assertion may be signed with. Asymmetric ONLY, and that is the point: a
533
+ * symmetric `HS*` assertion is signed with a shared secret, which makes the assertion no stronger
534
+ * than the secret it was supposed to replace, and `none` is not an algorithm.
535
+ */
536
+ export enum SystemOfRecordAssertionSigningAlgorithm {
537
+ RS256 = 'RS256',
538
+ RS384 = 'RS384',
539
+ RS512 = 'RS512',
540
+ PS256 = 'PS256',
541
+ ES256 = 'ES256',
542
+ ES384 = 'ES384',
543
+ ES512 = 'ES512',
544
+ }
545
+
546
+ /**
547
+ * How long to treat a token as valid when the answer carries no `expires_in` (#1056 R3).
548
+ *
549
+ * A FACET property rather than a per-kind engine constant, because two vendors of the SAME kind
550
+ * disagree: NetSuite's answer states `expires_in` is always 3600, while Salesforce's
551
+ * client-credentials answer is reported to omit it. A per-kind constant would have to be wrong for
552
+ * one of them.
553
+ */
554
+ const tokenLifetimeFallbackSecondsSchema = z.number().int().min(30).max(86_400);
555
+
556
+ /**
557
+ * ONE credential kind as ONE vendor offers it — the kind, plus everything about it that varies by
558
+ * VENDOR and not by deployment.
559
+ *
560
+ * A discriminated union rather than a kind list beside a policy map, so a policy cannot exist
561
+ * without its kind and a kind cannot be offered without the policy it needs. `API_KEY_HEADER` with
562
+ * no header name is unrepresentable here; under a parallel map it would parse and fail at the first
563
+ * read.
564
+ */
565
+ export const SystemOfRecordCredentialOfferSchema = z.discriminatedUnion('kind', [
566
+ z.strictObject({ kind: z.literal(SystemOfRecordCredentialKind.ODOO_API_KEY_IN_ARGS).systemEnum('SystemOfRecordCredentialKind') }),
567
+
568
+ z.strictObject({
569
+ kind: z.literal(SystemOfRecordCredentialKind.API_KEY_HEADER).systemEnum('SystemOfRecordCredentialKind'),
570
+ /** The header the key travels in — `Authorization`, `X-API-Key`, `apikey`, whatever the vendor reads. */
571
+ headerName: z.string().regex(/^[A-Za-z0-9!#$%&'*+.^_`|~-]+$/, 'A header name is an RFC 9110 token.').max(64),
572
+ /** What precedes the key in the header value, INCLUDING its trailing space (`"Bearer "`). Omitted when the key stands alone. */
573
+ valuePrefix: z.string().max(32).optional(),
574
+ }),
575
+
576
+ z.strictObject({
577
+ kind: z.literal(SystemOfRecordCredentialKind.API_KEY_QUERY).systemEnum('SystemOfRecordCredentialKind'),
578
+ /** The query parameter the key is appended as. */
579
+ parameterName: z.string().regex(/^[A-Za-z0-9_.-]+$/, 'A query parameter name is alphanumeric with -._').max(64),
580
+ }),
581
+
582
+ z.strictObject({ kind: z.literal(SystemOfRecordCredentialKind.BASIC).systemEnum('SystemOfRecordCredentialKind') }),
583
+
584
+ z.strictObject({
585
+ kind: z.literal(SystemOfRecordCredentialKind.OAUTH2_CLIENT_CREDENTIALS_SECRET).systemEnum('SystemOfRecordCredentialKind'),
586
+ clientAuthentication: z.enum(SystemOfRecordClientAuthenticationPlacement),
587
+ tokenLifetimeFallbackSeconds: tokenLifetimeFallbackSecondsSchema,
588
+ }),
589
+
590
+ z.strictObject({
591
+ kind: z.literal(SystemOfRecordCredentialKind.OAUTH2_CLIENT_CREDENTIALS_CERTIFICATE).systemEnum('SystemOfRecordCredentialKind'),
592
+ assertionHeaderPolicy: z.enum(SystemOfRecordAssertionHeaderPolicy),
593
+ assertionSigningAlgorithm: z.enum(SystemOfRecordAssertionSigningAlgorithm),
594
+ /** How long the ASSERTION is valid — minutes, not hours; it is consumed once at the token endpoint. */
595
+ assertionLifetimeSeconds: z.number().int().min(30).max(600),
596
+ tokenLifetimeFallbackSeconds: tokenLifetimeFallbackSecondsSchema,
597
+ }),
598
+
599
+ z.strictObject({
600
+ kind: z.literal(SystemOfRecordCredentialKind.OAUTH2_JWT_BEARER).systemEnum('SystemOfRecordCredentialKind'),
601
+ assertionSigningAlgorithm: z.enum(SystemOfRecordAssertionSigningAlgorithm),
602
+ assertionLifetimeSeconds: z.number().int().min(30).max(600),
603
+ tokenLifetimeFallbackSeconds: tokenLifetimeFallbackSecondsSchema,
604
+ }),
605
+ ]);
606
+ export type SystemOfRecordCredentialOffer = z.infer<typeof SystemOfRecordCredentialOfferSchema>;
607
+
608
+ /**
609
+ * How a vendor's OData service pages a COLLECTION READ (#1292).
610
+ *
611
+ * A vendor property rather than a dialect constant, and the reason is one large implementation: the
612
+ * Microsoft Dataverse Web API refuses `$skip` outright, while OData v4 defines it and a conformant
613
+ * service serves it. A per-dialect default would have to be wrong for one of them — the same
614
+ * argument #1056 R3 settled for the token-lifetime fallback.
615
+ *
616
+ * spec-cite: OData Version 4.01 Part 1: Protocol §11.2.6 ("$top and $skip") for the default; Microsoft
617
+ * Learn, "Query data using the Web API"
618
+ * (https://learn.microsoft.com/en-us/power-apps/developer/data-platform/webapi/query-data-web-api) for
619
+ * the refusal — that page enumerates the query options the Web API does not support.
620
+ */
621
+ export enum SystemOfRecordODataListPaging {
622
+ /**
623
+ * `$top` + `$skip` — one request for any page, which is what a page-numbered contract wants.
624
+ *
625
+ * The default, because it is what OData v4 defines and what an uncatalogued service serves.
626
+ */
627
+ SKIP = 'skip',
628
+ /**
629
+ * `@odata.nextLink` only: the service hands back a continuation URL and refuses to be addressed by
630
+ * offset.
631
+ *
632
+ * The consequence is structural rather than a detail — a cursor has no page NUMBER, so page N costs
633
+ * N requests. The engine walks forward and refuses past a bound rather than pretending otherwise.
634
+ */
635
+ NEXT_LINK_ONLY = 'next-link-only',
636
+ }
637
+
638
+ /**
639
+ * HOW a vendor partitions the data one deployment holds (#1058).
640
+ *
641
+ * Inside ONE corporate, a system of record usually holds several partitions — Odoo companies, SAP
642
+ * company codes, Dynamics business units, NetSuite subsidiaries. They are not tenants: they all
643
+ * belong to the operator, which is why they map onto ORGANIZATION UNITS of the owner organization
644
+ * rather than onto organizations (#1049 Q3).
645
+ */
646
+ export enum SystemOfRecordPartitionKind {
647
+ /**
648
+ * A FIELD on every row carries the partition (Odoo `company_id`, NetSuite `subsidiary`). The only
649
+ * kind supported today: it is filterable, so the confinement can be PUSHED DOWN and a caller never
650
+ * receives rows of a partition they may not see.
651
+ */
652
+ FIELD = 'field',
653
+ /**
654
+ * The partition is a PATH SEGMENT of the request (Business Central's `/companies({id})/customers`).
655
+ *
656
+ * Declared so a facet can be HONEST about a vendor this engine cannot confine yet, and refused by
657
+ * name where a partition is opted into. A path segment is chosen before the request is built, so it
658
+ * cannot express "these three companies" in one read — the confinement would have to fan out into
659
+ * one request per unit, which is a different mechanism rather than a different predicate.
660
+ */
661
+ PATH_SEGMENT = 'path-segment',
662
+ }
663
+
664
+ /**
665
+ * The SHAPE a partition value arrives in — the difference between a number and a pair.
666
+ *
667
+ * Odoo answers a many2one as `[id, display_name]`: `company_id: [10, "Acme"]` on a read, and `false`
668
+ * when unset. A reader that took the whole array as the key would match nothing, and one that took
669
+ * `row.company_id` as a scalar would stamp `"10,Acme"`. The shape is declared because the engine
670
+ * cannot tell a pair from a two-element list by looking.
671
+ *
672
+ * spec-cite: Odoo 18.0 developer documentation, "External API" — a many2one is returned as an
673
+ * `[id, display_name]` pair under both *Read records* and *Search and read*.
674
+ */
675
+ export enum SystemOfRecordPartitionValueShape {
676
+ /** The field holds the key directly (an integer, a GUID, a string). */
677
+ SCALAR = 'scalar',
678
+ /** Odoo's many2one: `[id, label]`, and `false` when unset. The id is the key. */
679
+ MANY2ONE_PAIR = 'many2one-pair',
680
+ }
681
+
682
+ /**
683
+ * What a vendor's partitioning IS — declared by the FACET, opted into by the INSTANCE.
684
+ *
685
+ * The split is the same one every other vendor fact takes: how a vendor partitions is a property of
686
+ * the vendor, and WHETHER this deployment's data is partitioned is a property of the deployment. A
687
+ * single-company Odoo has a `company_id` on every row and nothing to confine.
688
+ */
689
+ export const SystemOfRecordPartitionSupportSchema = z.strictObject({
690
+ kind: z.enum(SystemOfRecordPartitionKind),
691
+ /** The remote field carrying the partition key (`company_id`, `subsidiary`, `CompanyCode`). */
692
+ remoteField: z.string().min(1).max(120),
693
+ /**
694
+ * How a key is spelled on the wire. Reused from the KEY component vocabulary rather than given its
695
+ * own: a partition key is addressed exactly as a key component is — decoded from an operator's
696
+ * authored string, compiled into a remote predicate — and two vocabularies for one job would drift.
697
+ */
698
+ codec: z.enum(HttpApiKeyComponentCodec),
699
+ valueShape: z.enum(SystemOfRecordPartitionValueShape),
700
+ });
701
+ export type SystemOfRecordPartitionSupport = z.infer<typeof SystemOfRecordPartitionSupportSchema>;
702
+
703
+ /**
704
+ * What a vendor is, as a system of record. Parsed rather than trusted because #1057 lets a PACKAGE
705
+ * ship one — a record produced by one package version and read by another.
706
+ */
707
+ export const SystemOfRecordVendorFacetSchema = z.strictObject({
708
+ /** The vendor's stable identifier, named by an instance's `vendor`. Same charset law as an instance name. */
709
+ vendor: z.string().regex(/^[a-z][a-z0-9-]*$/, 'A vendor id is lower-kebab-case.').max(40),
710
+ /**
711
+ * The dialects this vendor can be READ through. An instance's `dialect` must be one of them, and
712
+ * a binding's `dialect` must equal its instance's — both refused at boot registration, where the
713
+ * declaration and the facet are finally in the same scope.
714
+ */
715
+ dialects: z.array(z.enum(HttpApiTransportDialect)).min(1),
716
+ /**
717
+ * The vendor's own address slots — non-secret, authored per instance in the infra env config. The
718
+ * base URL is registration-scoped and is never credential material.
719
+ */
720
+ addressSlots: systemOfRecordSlotListSchema('vendor address'),
721
+ /**
722
+ * The credential kinds this vendor offers, each carrying THIS vendor's policy for it. The instance
723
+ * chooses one kind; a kind no offer names is refused.
724
+ *
725
+ * Reshaped from a bare `credentialKinds: Kind[]` in #1056. A list of kinds could say that a vendor
726
+ * accepts a header-borne API key and could not say WHICH header — so either the operator was asked
727
+ * (a question the vendor already answers, `derive-before-you-ask.md`) or the engine guessed. An
728
+ * offer is the kind and its vendor policy as one indivisible thing.
729
+ */
730
+ credentialOffers: z.array(SystemOfRecordCredentialOfferSchema).min(1),
731
+ /**
732
+ * How a COLLECTION READ pages against this vendor (#1292). Meaningful only for the OData dialects.
733
+ *
734
+ * OPTIONAL rather than defaulted, and the difference is not cosmetic: `.default()` would make the
735
+ * field REQUIRED on the parsed type, so every facet — Odoo's JSON-RPC included — would have to
736
+ * state an answer to a question about a dialect it does not speak. Absent means "not an OData
737
+ * concern, or the conformant default", and {@link resolveSystemOfRecordODataListPaging} is the one
738
+ * place that turns absence into `SKIP`.
739
+ */
740
+ odataListPaging: z.enum(SystemOfRecordODataListPaging).optional(),
741
+ /**
742
+ * How this vendor partitions one deployment's data (#1058), when it does.
743
+ *
744
+ * ABSENT means the vendor has no partition concept the engine can confine on — which is a real
745
+ * answer rather than an unfinished one, and the reason an instance opting into `partition` against
746
+ * such a facet is refused by name rather than silently doing nothing.
747
+ */
748
+ partition: SystemOfRecordPartitionSupportSchema.optional(),
749
+ }).superRefine((facet, context) => {
750
+ const seenDialects = new Set<string>();
751
+ for (const [index, dialect] of facet.dialects.entries()) {
752
+ if (seenDialects.has(dialect)) {
753
+ context.addIssue({ code: 'custom', path: ['dialects', index], message: `Duplicate dialects member "${dialect}".` });
754
+ }
755
+ seenDialects.add(dialect);
756
+ }
757
+
758
+ // One vendor may not offer the same kind twice: the instance names a KIND, so two offers of one
759
+ // kind would make the policy the engine reads depend on array order.
760
+ const seenKinds = new Set<string>();
761
+ for (const [index, offer] of facet.credentialOffers.entries()) {
762
+ if (seenKinds.has(offer.kind)) {
763
+ context.addIssue({ code: 'custom', path: ['credentialOffers', index], message: `Duplicate credentialOffers member "${offer.kind}".` });
764
+ }
765
+ seenKinds.add(offer.kind);
766
+ }
767
+
768
+ // A vendor address slug that a kind also declares would make the derived environment variable
769
+ // ambiguous about who owns the value, so the two namespaces are checked against each other here
770
+ // rather than at the instance, where the failure would read as an authoring mistake.
771
+ const vendorSlugs = new Set(facet.addressSlots.map((slot) => slot.slug));
772
+ for (const offer of facet.credentialOffers) {
773
+ for (const slot of SYSTEM_OF_RECORD_CREDENTIAL_KIND_CONTRACTS[offer.kind].addressSlots) {
774
+ if (vendorSlugs.has(slot.slug)) {
775
+ context.addIssue({
776
+ code: 'custom',
777
+ path: ['addressSlots'],
778
+ message: `Address slot "${slot.slug}" is declared by this vendor AND by credential kind "${offer.kind}" — one slot has one owner.`,
779
+ });
780
+ }
781
+ }
782
+ }
783
+ });
784
+ export type SystemOfRecordVendorFacet = z.infer<typeof SystemOfRecordVendorFacetSchema>;
785
+ ```