@wildo-ai/framework-knowledge 1.1.11 → 1.1.13

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 (812) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
  3. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
  4. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
  5. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
  6. package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
  7. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
  8. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
  9. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
  10. package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
  11. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  12. package/dist/esm/framework-knowledge.definitions.js +180 -32
  13. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  14. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  15. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  16. package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
  17. package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
  18. package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
  19. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  20. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  21. package/dist/esm/index.d.ts.map +1 -1
  22. package/dist/esm/index.js.map +1 -1
  23. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
  24. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
  31. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  32. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
  35. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
  45. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
  47. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
  50. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
  52. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
  54. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +30 -3
  56. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +87 -16
  58. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  61. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
  62. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  63. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
  64. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  65. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
  66. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
  68. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  69. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  71. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
  72. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
  74. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
  76. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
  78. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  80. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
  81. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
  82. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  83. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
  84. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
  85. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
  86. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
  88. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  89. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  90. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
  91. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  92. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
  93. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  94. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
  95. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
  96. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
  99. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
  101. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  103. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
  104. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  105. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  106. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
  107. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  108. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
  109. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  110. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
  111. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
  113. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  114. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
  115. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  116. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
  117. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  118. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
  119. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
  121. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  122. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
  123. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  124. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
  125. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
  127. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  129. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
  130. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  131. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
  132. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  133. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
  134. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  135. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  136. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  137. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
  138. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  139. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
  140. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  141. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  142. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  143. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  144. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
  145. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  146. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  147. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  148. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
  149. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  150. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  151. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  153. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
  154. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  156. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
  157. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  158. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
  159. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  160. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
  161. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  162. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
  163. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  164. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
  165. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  166. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
  167. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  168. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
  169. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  170. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
  171. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
  172. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
  173. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
  174. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
  175. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  176. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
  177. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  178. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
  179. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  180. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
  181. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  182. package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
  183. package/dist/esm/source-anchor-grammar.js.map +1 -1
  184. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  185. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  186. package/dist/knowledge/manifest.json +7 -7
  187. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
  188. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
  189. package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
  190. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
  191. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  192. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  193. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
  194. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
  195. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
  196. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
  197. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
  198. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
  199. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
  200. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
  201. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
  202. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  203. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  204. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
  205. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
  206. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
  207. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
  208. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
  209. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -8
  210. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
  211. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
  212. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +19 -2
  213. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
  214. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
  215. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
  216. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
  217. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
  218. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
  219. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
  220. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
  221. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
  222. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
  223. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
  224. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
  225. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
  226. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
  227. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
  228. package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
  229. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
  230. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
  231. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
  232. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  233. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  234. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
  235. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
  236. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
  237. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
  238. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
  239. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
  240. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
  241. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
  242. package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
  243. package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
  244. package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
  245. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
  246. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
  247. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
  248. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
  249. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
  250. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
  251. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
  252. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
  253. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
  254. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
  255. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
  256. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
  257. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
  258. package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
  259. package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
  260. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
  261. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
  262. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
  263. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
  264. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
  265. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
  266. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
  267. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
  268. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  269. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  270. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
  271. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +14 -0
  272. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +11 -7
  273. package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
  274. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
  275. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
  276. package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
  277. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
  278. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
  279. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
  280. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
  281. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
  282. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
  283. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
  284. package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
  285. package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
  286. package/dist/knowledge/references/application-maturity.config.md +70 -1
  287. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
  288. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
  289. package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
  290. package/dist/knowledge/references/brand.name-screening.config.md +30 -3
  291. package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
  292. package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
  293. package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
  294. package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
  295. package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
  296. package/dist/knowledge/references/companion.market.generation-service.md +46 -5
  297. package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
  298. package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
  299. package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
  300. package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
  301. package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
  302. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
  303. package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
  304. package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
  305. package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
  306. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
  307. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
  308. package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
  309. package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
  310. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
  311. package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
  312. package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
  313. package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
  314. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
  315. package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +21 -0
  316. package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
  317. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
  318. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
  319. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
  320. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
  321. package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
  322. package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
  323. package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
  324. package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
  325. package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
  326. package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
  327. package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
  328. package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
  329. package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
  330. package/dist/knowledge/references/example.website.section.stats.md +1 -1
  331. package/dist/knowledge/references/experience-plan.config.md +111 -1
  332. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
  333. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
  334. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
  335. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
  336. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
  337. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
  338. package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
  339. package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
  340. package/dist/knowledge/references/integration-plan.config.md +7 -7
  341. package/dist/knowledge/references/placement-plan.config.md +19 -0
  342. package/dist/knowledge/references/platform.config.backing-services.md +9 -11
  343. package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
  344. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
  345. package/dist/knowledge/references/platform.config.infrastructure-host.md +1 -1
  346. package/dist/knowledge/references/platform.config.platform-key-management.md +89 -10
  347. package/dist/knowledge/references/platform.config.saas.md +20 -18
  348. package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
  349. package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
  350. package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
  351. package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
  352. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
  353. package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
  354. package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
  355. package/dist/knowledge/references/requirements.engine-substance.md +38 -0
  356. package/dist/knowledge/references/requirements.functional-requirement.config.md +11 -0
  357. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +15 -4
  358. package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
  359. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +49 -2
  360. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
  361. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
  362. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
  363. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  364. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
  365. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
  366. package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
  367. package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
  368. package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
  369. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
  370. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
  371. package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
  372. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
  373. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
  374. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +435 -2
  375. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
  376. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
  377. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
  378. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
  379. package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
  380. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
  381. package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
  382. package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
  383. package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
  384. package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
  385. package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
  386. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
  387. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
  388. package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
  389. package/dist/knowledge/references/saas.frontend.chart-dashboard.md +133 -0
  390. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
  391. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
  392. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
  393. package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
  394. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
  395. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
  396. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
  397. package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
  398. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
  399. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
  400. package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
  401. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
  402. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
  403. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
  404. package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
  405. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
  406. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
  407. package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
  408. package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
  409. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
  410. package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
  411. package/dist/knowledge/references/saas.models.chart-dashboard-tile-sizes.md +40 -0
  412. package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
  413. package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
  414. package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
  415. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
  416. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
  417. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
  418. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
  419. package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
  420. package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
  421. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
  422. package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
  423. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
  424. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
  425. package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails-environment.md +52 -0
  426. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
  427. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
  428. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
  429. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
  430. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
  431. package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
  432. package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
  433. package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
  434. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
  435. package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
  436. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
  437. package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
  438. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
  439. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
  440. package/dist/knowledge/references/saas.models.organization-dashboard-layout.md +61 -0
  441. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
  442. package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
  443. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
  444. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
  445. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
  446. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
  447. package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
  448. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
  449. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
  450. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
  451. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
  452. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
  453. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
  454. package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
  455. package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
  456. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
  457. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
  458. package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
  459. package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
  460. package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
  461. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
  462. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
  463. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
  464. package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
  465. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
  466. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
  467. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
  468. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
  469. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
  470. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
  471. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
  472. package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
  473. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
  474. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
  475. package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
  476. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
  477. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
  478. package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
  479. package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
  480. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
  481. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
  482. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
  483. package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
  484. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
  485. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
  486. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
  487. package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
  488. package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
  489. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
  490. package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
  491. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
  492. package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
  493. package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
  494. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
  495. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
  496. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
  497. package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
  498. package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
  499. package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
  500. package/dist/knowledge/references/service-method.config.md +35 -2
  501. package/dist/knowledge/references/vision.constraint.config.md +4 -2
  502. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
  503. package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
  504. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
  505. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
  506. package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
  507. package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
  508. package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
  509. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
  510. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
  511. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
  512. package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
  513. package/dist/knowledge/references/zod.factories.code.md +4 -4
  514. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  515. package/dist/knowledge/references/zod.factories.money.md +4 -4
  516. package/dist/knowledge/references/zod.factories.phone.md +4 -4
  517. package/dist/knowledge/references/zod.factories.year-month.md +79 -0
  518. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  519. package/dist/knowledge/registries/framework-topics.json +455 -2
  520. package/dist/knowledge/registries/playbooks.json +51 -39
  521. package/dist/knowledge/registries/source-tags.json +2505 -1627
  522. package/dist/knowledge/rules/database-migration-obligation.md +6 -7
  523. package/dist/knowledge/rules/live-context-door.md +1 -1
  524. package/dist/knowledge/skills/INDEX.md +3 -1
  525. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
  526. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
  527. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
  528. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
  529. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
  530. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
  531. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
  532. package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
  533. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
  534. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
  535. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
  536. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
  537. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
  538. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
  539. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
  540. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
  541. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  542. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
  543. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
  544. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
  545. package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
  546. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
  547. package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
  548. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
  549. package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
  550. package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +90 -0
  551. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
  552. package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
  553. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
  554. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
  555. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
  556. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
  557. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
  558. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
  559. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
  560. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
  561. package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
  562. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
  563. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
  564. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
  565. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
  566. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
  567. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
  568. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
  569. package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
  570. package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
  571. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
  572. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
  573. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
  574. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
  575. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
  576. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +240 -9
  577. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
  578. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
  579. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
  580. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
  581. package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
  582. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
  583. package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
  584. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
  585. package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
  586. package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
  587. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
  588. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
  589. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
  590. package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
  591. package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +78 -0
  592. package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
  593. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
  594. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
  595. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
  596. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
  597. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
  598. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +13 -3
  599. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
  600. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +34 -11
  601. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
  602. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
  603. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +188 -10
  604. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
  605. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
  606. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
  607. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
  608. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
  609. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +447 -8
  610. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
  611. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
  612. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
  613. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +13 -3
  614. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
  615. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
  616. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +13 -3
  617. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
  618. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
  619. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -1
  620. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +6 -5
  621. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +50 -14
  622. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
  623. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
  624. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
  625. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
  626. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
  627. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
  628. package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
  629. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
  630. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
  631. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
  632. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
  633. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
  634. package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
  635. package/dist/knowledge/skills/infra-environment-config/SKILL.md +149 -77
  636. package/dist/knowledge/skills/infra-environment-config/references/framework-agent-content-guardrails-environment-api.md +67 -0
  637. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
  638. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
  639. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +1 -1
  640. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +89 -10
  641. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
  642. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
  643. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
  644. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
  645. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
  646. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
  647. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
  648. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
  649. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
  650. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
  651. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
  652. package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
  653. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
  654. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
  655. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
  656. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
  657. package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
  658. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
  659. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
  660. package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
  661. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
  662. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
  663. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
  664. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
  665. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
  666. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
  667. package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -15
  668. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
  669. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
  670. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
  671. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
  672. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
  673. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
  674. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
  675. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
  676. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
  677. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
  678. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
  679. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
  680. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
  681. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
  682. package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
  683. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
  684. package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
  685. package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
  686. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
  687. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
  688. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
  689. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
  690. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
  691. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +34 -7
  692. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
  693. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
  694. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
  695. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +28 -2
  696. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
  697. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
  698. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
  699. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
  700. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
  701. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
  702. package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
  703. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
  704. package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
  705. package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
  706. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
  707. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
  708. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
  709. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
  710. package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
  711. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
  712. package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
  713. package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
  714. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
  715. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
  716. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
  717. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
  718. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
  719. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
  720. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
  721. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
  722. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
  723. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
  724. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
  725. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
  726. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
  727. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
  728. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
  729. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
  730. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
  731. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  732. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
  733. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
  734. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
  735. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
  736. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
  737. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
  738. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
  739. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
  740. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
  741. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
  742. package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
  743. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
  744. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
  745. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
  746. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
  747. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
  748. package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
  749. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
  750. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
  751. package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
  752. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
  753. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
  754. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
  755. package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
  756. package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
  757. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
  758. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
  759. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
  760. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
  761. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
  762. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
  763. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
  764. package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
  765. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
  766. package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
  767. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
  768. package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
  769. package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
  770. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
  771. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
  772. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  773. package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
  774. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
  775. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
  776. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
  777. package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +371 -0
  778. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
  779. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
  780. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
  781. package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
  782. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
  783. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
  784. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
  785. package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
  786. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
  787. package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
  788. package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
  789. package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
  790. package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
  791. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
  792. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
  793. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
  794. package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
  795. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
  796. package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
  797. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
  798. package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
  799. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
  800. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
  801. package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
  802. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
  803. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
  804. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
  805. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
  806. package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
  807. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
  808. package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
  809. package/dist/knowledge/topic-index.json +2422 -723
  810. package/dist/tsconfig.build.tsbuildinfo +1 -1
  811. package/package.json +6 -6
  812. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -39,22 +39,11 @@ export type ResourceConfiguration<
39
39
  * 1. This field (if specified)
40
40
  * 2. `appConfig.database.defaultAdapter` (fallback)
41
41
  *
42
- * A value disagreeing with the application default is admitted at registration ONLY when
43
- * {@link ResourceConfiguration.persistenceAdapterIsolation} is declared beside it.
42
+ * A transactional value disagreeing with the application default is refused at registration:
43
+ * an application uses one transactional store (#3328).
44
44
  */
45
45
  persistenceAdapter?: PersistenceAdapterType,
46
46
 
47
- /**
48
- * This resource's declared relationship to cross-adapter atomic write boundaries; see the
49
- * authoring-side declaration and {@link ResourcePersistenceAdapterIsolation} for the full
50
- * rationale.
51
- *
52
- * Carried through to the resolved config UNMATERIALISED (no default is substituted) because
53
- * absence is semantically load-bearing here: the registry's admission asks whether the author
54
- * MADE the claim, and a materialised default would answer that question for them.
55
- */
56
- persistenceAdapterIsolation?: ResourcePersistenceAdapterIsolationType,
57
-
58
47
  /**
59
48
  * The external HTTP-API binding — present exactly when `persistenceAdapter` is `HTTP_API`
60
49
  * (factory-enforced both ways). See the authoring-side declaration for the full contract.
@@ -93,9 +82,9 @@ export type ResourceConfiguration<
93
82
 
94
83
  /**
95
84
  * Declares this resource as the application's SUBJECT-ERASURE REQUEST LANE and binds the fields an
96
- * evidence collector reads. Omitted ⇒ this resource is not that lane, which is the honest default:
97
- * most resources are not, and an application that never built an erasure lane has declared none
98
- * rather than failed a control. See {@link ResourceSubjectErasureLane}.
85
+ * evidence collector reads. Omitted ⇒ this resource is not that lane, the default for every resource
86
+ * but one: since #2296 the engine's `dataSubjectRequests` declares it in every application, and the
87
+ * evidence door refuses an application where a second resource does. See {@link ResourceSubjectErasureLane}.
99
88
  */
100
89
  subjectErasureLane?: ResourceSubjectErasureLane,
101
90
 
@@ -131,6 +120,9 @@ export type ResourceConfiguration<
131
120
  /** Resolved retention-class binding, exactly as declared (undefined when the resource binds no class). */
132
121
  retentionBinding?: ResourceRetentionBinding,
133
122
 
123
+ /** Resolved row-lifetime declaration, exactly as declared (undefined when the lifetime is derived). */
124
+ rowLifetime?: ResourceRowLifetimeDeclaration,
125
+
134
126
  /** Resolved portability default (undefined when the resource declared no `portabilityPolicy` — an
135
127
  * Art. 15 export is unaffected, an Art. 20 export refuses on any field that also lacks its own
136
128
  * `.portabilityProvenance()`). */
@@ -139,6 +131,12 @@ export type ResourceConfiguration<
139
131
  /** Resolved others'-data fields a subject export withholds (#2903); undefined when none are declared. */
140
132
  subjectExportOthersDataFields?: readonly string[],
141
133
 
134
+ /** Resolved per-edge others'-data fields, keyed by the edge's foreign key; undefined when none are declared. */
135
+ subjectExportOthersDataFieldsByForeignKey?: Readonly<Record<string, readonly string[]>>,
136
+
137
+ /** Resolved person columns a USER's access export reads (#2958); undefined when none are declared. */
138
+ subjectExportPersonColumns?: SubjectExportPersonColumns,
139
+
142
140
  /** Resolved `workUnit` declaration (#1598): `true` when every row of this resource is a case. */
143
141
  workUnit?: boolean,
144
142
 
@@ -67,8 +67,8 @@ export type ResourcesRegistry = {
67
67
  organizationUnitNarrowing: Readonly<Partial<Record<ResourceType, OrganizationUnitNarrowingDeclaration>>>;
68
68
  /**
69
69
  * Resources confining the roles they declare to the rows their holder owns (#2547), keyed by resource type, validated at
70
- * boot. A declared role's organization-wide grant reaches only the rows whose owner field names its holder; every other
71
- * role keeps its reach. Never an admission: the operation's roles still decide who may call it. Empty by default. See
70
+ * boot. A declared role's organization-wide grant reaches only the rows whose owner field names its holder, and the same
71
+ * role held on a unit supplies no unit (#3068); every other role keeps its reach. Never an admission: the operation's roles still decide who may call it. Empty by default. See
72
72
  * `OrganizationOwnRowsDeclaration`.
73
73
  */
74
74
  organizationOwnRows: Readonly<Partial<Record<ResourceType, OrganizationOwnRowsDeclaration>>>;
@@ -77,6 +77,15 @@ export interface ResourceRetentionPolicy {
77
77
  * reach RETAINED rows only, and the write refuses any field this list does not name. A field named here may not be
78
78
  * personal data (no `.dataCategories()`, no `.impersonalizeWith()`), may not be `.excludeFromUpdate()`, and may not
79
79
  * be the primary key or a retention marker: the build refuses each of those.
80
+ *
81
+ * ## Closing a retained record (#1841)
82
+ *
83
+ * A resource bound `RetentionStartPoint.CLOSURE_EVENT` may name its closure field here, the one `.excludeFromUpdate()`
84
+ * field allowed (on a closure clock that decorator means server-owned, not immutable). A record still OPEN when its
85
+ * subject is erased can then be closed: its own close operation, finding the row RETAINED, calls
86
+ * `SystemAccessBackendService.closeRetainedRecordAsSystem`, which writes the closure date only where it is still null.
87
+ * The retention-class sweep then deletes the row at closure + period. This is what lets a statutory record declare a
88
+ * period counted from the end of a contract or a matter; without it the build refuses that combination.
80
89
  */
81
90
  retainedRowCompletion?: ResourceRetainedRowCompletion;
82
91
  }
@@ -103,5 +112,17 @@ export interface ResourceStatutoryRetention {
103
112
  * claim nobody can check.
104
113
  */
105
114
  rationale: string;
115
+ /**
116
+ * WHY these rows stay in use after their owner goes, for a resource whose teardown edges do not restrict them.
117
+ *
118
+ * The default, and the right answer for almost every statutory record, is restriction: every owning edge authors
119
+ * `IMPERSONALIZE_AND_RETAIN`, and startup refuses anything else. A few records cannot be frozen, because work still
120
+ * arrives for them after the owner has gone: a billing provider's webhooks and reconciliation reach an invoice long
121
+ * after its customer left. Declaring this keeps the edges as they are and states why, in words a reader can dispute.
122
+ * Required non-empty when present. It changes nothing about the period, which still ends the rows. Because such rows
123
+ * are never restricted, their handlers close them through ordinary writes, so a `CLOSURE_EVENT` binding is accepted
124
+ * with it (#1841).
125
+ */
126
+ staysInUseBecause?: string;
106
127
  }
107
128
  ```
@@ -70,26 +70,28 @@ export enum ResourceSystemAccessMode {
70
70
  /**
71
71
  * Declares that THIS resource is the application's subject-erasure request lane, and how to read it.
72
72
  *
73
- * ## Why the application declares it rather than the framework knowing it
73
+ * ## Who declares it, and why it is still a declaration
74
74
  *
75
- * The erasure lane is application-owned — four of the five marked sites for
76
- * `WILDO.PRIVACY.SUBJECT_ERASURE` are in an application, not the engine — and its evidence demand
77
- * (`evidence-requirement:subject-erasure-execution-record`) says so in terms: *"the row's schema and
78
- * status vocabulary are the application's, so a collector queries it against that application's
79
- * specification"*, and its verification step adds *"do NOT assert a specific channel vocabulary:
80
- * that is one application's modelling choice"*.
75
+ * Since #2296 the lane is the ENGINE's: the core resource `dataSubjectRequests`, which every application
76
+ * has, carries this declaration, and the evidence door refuses an application where a second resource
77
+ * declares one. An application does not declare its own. (Before #2296 the lane was an application's to
78
+ * build, which is why this declaration exists at all: Your Application' `accountErasureRequests` was the
79
+ * first declarer and was harvested into the engine.)
81
80
  *
82
- * So a collector may not know that a request is raised through a field called `channel` carrying a
83
- * value called `SUBJECT`. It has to be TOLD, by the application, in a form it can read. Before this
84
- * existed, three clauses of that demand had a durable row holding every fact they wanted and no way
85
- * to find it (#1209): not a missing control, a control nobody could point at.
81
+ * It stays a DECLARATION rather than the door reading the engine's fields by name, because the door
82
+ * and the collector read the lane through it and never through the engine's vocabulary: they count the
83
+ * field and value the declaration names (`evidence-requirement:subject-erasure-execution-record` asks
84
+ * them to), so their reading follows the resource and cannot drift from it. Before this existed, three
85
+ * clauses of that demand had a durable row holding every fact they wanted and no way to find it
86
+ * (#1209): not a missing control, a control nobody could point at.
86
87
  *
87
88
  * ## It binds FIELDS, never values the framework invents
88
89
  *
89
- * Every member below names something the application already authored. The one value the
90
- * declaration carries — {@link ResourceSubjectErasureLane.raisedBy}`.subjectValue` — is the
91
- * application's OWN enum member, quoted back so a reader can tell the two populations apart. The
92
- * framework supplies no vocabulary here and must never grow one.
90
+ * Every member below names something the declaring resource already has. The one value the
91
+ * declaration carries — {@link ResourceSubjectErasureLane.raisedBy}`.subjectValue` — is that
92
+ * resource's OWN enum member (`DataSubjectRequestChannel.SELF` on the engine's lane), quoted back so a
93
+ * reader can tell the two populations apart. The declaration supplies no vocabulary of its own and must
94
+ * never grow one.
93
95
  *
94
96
  * ## What is deliberately NOT declared
95
97
  *
@@ -160,6 +162,21 @@ export type ResourceSubjectErasureLane = {
160
162
  },
161
163
  /** The scheduled operation that executes due requests. Its `cronExpression` IS the declared schedule. */
162
164
  executionOperationIdentifier: string,
165
+ /**
166
+ * How a row says it is an ERASURE request at all, when the declaring resource also records requests for other rights
167
+ * (#2296: the engine's `dataSubjectRequests` carries access and portability requests beside erasure). The same shape
168
+ * as {@link withdrawnMarker}, and for the same reason: the vocabulary is the resource's.
169
+ *
170
+ * A collector counts only the rows carrying it. Without it, an export request — answered at intake, with a
171
+ * `completedAt` and no erasure — would be counted as an erasure executed, which is the false evidence this lane
172
+ * exists to prevent. Omitting it is a positive claim that every row of the resource is an erasure request.
173
+ */
174
+ erasureMarker?: {
175
+ /** The field carrying it. Must be a persisted field of this resource. */
176
+ fieldName: string,
177
+ /** The value of that field meaning the row is an erasure request. */
178
+ erasureValue: string,
179
+ },
163
180
  };
164
181
 
165
182
  export type ResourceSystemAccessPolicy = {
@@ -110,16 +110,17 @@ export enum ResourceOperationFrontendSurface {
110
110
  }
111
111
 
112
112
  /**
113
- * Display mode for resource operation action bars — controls operation bar density.
114
- * SUMMARY = compact row actions (icon-only, in list/table rows).
113
+ * Display mode for resource operation action bars — which surface the actions are drawn on, and so how many stay in
114
+ * view. Every direct action shows its words by default (`DEFAULT_ACTION_LABEL_DISPLAY_MODE`, #3066); the rest wait in
115
+ * the `…` menu, which shows words too.
115
116
  *
116
117
  * Note: "summary" here is about *UI density*, not API data shape (see DataMode.SUMMARY)
117
118
  * or FK rendering (see ForeignKeyDisplayMode.SUMMARY).
118
119
  */
119
120
  export enum ResourceOperationDisplayMode {
120
- /** In a list/table row — compact, icon-only, includes "View Details" */
121
+ /** In a list/table row — one direct action beside the record's name (none on a phone), the rest in `…`. The row itself opens the record, so it offers no "View Details". */
121
122
  SUMMARY = 'summary',
122
- /** In a full read/detail view — can show inline labels */
123
+ /** In a full read/detail view (the record header) — three direct actions (one on a phone), the rest in `…`. */
123
124
  DETAIL = 'detail',
124
125
  }
125
126
  ```
@@ -29,17 +29,28 @@
29
29
  * - `relatedPrimaryScope` — `ResourcePrimaryScope.ORGANIZATIONS` for a role a member holds inside one
30
30
  * organization, `ResourcePrimaryScope.APPLICATION` for an application-wide role. Any other scope is
31
31
  * ignored at startup with a warning, and the role grants nothing.
32
+ * - `seesOrganizationPeople` — `true` admits the role's holders to the organization's people: the member directory's
33
+ * SEARCH, the people picker behind every user reference (`/organizations/:organizationId/users/search`) and
34
+ * colleagues' names on records. Those three ask ONE question, the directory's SEARCH roles (`ORG_MEMBER` and up),
35
+ * and a role declaring this is counted among them, as is every role inheriting from it. Read only on a role whose
36
+ * `relatedPrimaryScope` is `ORGANIZATIONS`. Absent means refused: a role that does not inherit `ORG_MEMBER` (a field
37
+ * technician inheriting `ORG_GUEST`) sees nobody unless it declares this.
32
38
  *
33
39
  * Declaring a role is one of three steps. An organization role must also be listed in
34
40
  * `organizationTypes.<type>.availableOrgRoles` of `wildo.saas.config.ts` (or no member can be given
35
41
  * it), and it must be named in the `roles` of the operation variants it unlocks (or holding it changes
36
- * nothing). People receive it through the engine's members screen and invitations.
42
+ * nothing). People receive it through the engine's members screen and invitations, from an owner or
43
+ * administrator whose role covers everything it confers: its `inheritFrom` chain, and every operation,
44
+ * approval or decision route, reference constraint, system-of-record action and agent or flow launch gate naming it
45
+ * (`resolveCustomRolesWithinAuthority`). Named alone where administrators are not admitted (an operation
46
+ * they cannot call, a decision route only it answers), it is grantable by the platform super-administrator only.
37
47
  */
38
48
  export const RoleDefinitionSchema = z.object({
39
49
  role: RolesSchema,
40
50
  inheritFrom: RolesSchema.optional(),
41
51
  isSystemRole: z.boolean().default(false),
42
52
  relatedPrimaryScope : z.enum(ResourcePrimaryScope),
53
+ seesOrganizationPeople: z.boolean().optional(),
43
54
  });
44
55
 
45
56
 
@@ -61,6 +61,12 @@ export const DEFAULT_ORGANIZATION_ROLES: RolesConfiguration = {
61
61
  isSystemRole: true,
62
62
  relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
63
63
  },
64
+ // No `inheritFrom`: handler-only, confers no operation; the signature notification handler only triggers a re-read (#2293).
65
+ [CORE_ORG_ROLES.ORG_SIGNATURE_PROVIDER_EVENTS]: {
66
+ role: CORE_ORG_ROLES.ORG_SIGNATURE_PROVIDER_EVENTS,
67
+ isSystemRole: true,
68
+ relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
69
+ },
64
70
  // No `inheritFrom` on any delegated capability (#1631): each confers exactly the operations that name it, and
65
71
  // inheriting anything would make a lent capability's reach a function of what that role grows into later.
66
72
  [CORE_ORG_ROLES.ORG_DELEGATED_INVITE_MEMBERS]: {
@@ -40,6 +40,11 @@ export interface SchemaFamilyConfig<
40
40
  * built. The client tells the variants apart by this field, and a response that withheld it from every variant
41
41
  * could not be parsed by anyone. Remove the declaration; if the value really is sensitive, it cannot be the
42
42
  * discriminator.
43
+ *
44
+ * A `.default(value)` on the base field means a record that leaves the discriminator out IS a `value` record: the
45
+ * family's union, and every create request derived from it, fill it in, so a client may omit the field exactly as
46
+ * the published schema says. An update never fills it: a partial update that leaves the discriminator out keeps the
47
+ * record's own variant.
43
48
  */
44
49
  field: TDiscriminatorField;
45
50
  /**
@@ -206,12 +211,22 @@ export function createSchemaFamily<
206
211
  // Build discriminated union - use any to avoid Zod 4 type complexity
207
212
  const allVariantSchemas: z.ZodObject<z.ZodRawShape>[] = [];
208
213
 
214
+ // The default the base field declares is what a record that omits the discriminator IS (#2076). Each union member's
215
+ // literal replaces the base field, so the member holding that value must carry the default itself, in the one shape a
216
+ // Zod 4 discriminated union can route an absent key by: see `withDeclaredFamilyDiscriminatorDefault`. Only the UNION
217
+ // members carry it; `variants` and `inheritenceSchemaDefinition` describe one variant each, where the literal names it.
218
+ const declaredDiscriminatorDefault = declaredFamilyDiscriminatorDefault(baseShape[discriminator.field]);
219
+ const unionMemberDiscriminator = (value: string) => withDeclaredFamilyDiscriminatorDefault(
220
+ discriminatorLiteralFor(discriminator.field, value, baseShape[discriminator.field], resolvedBaseValues),
221
+ declaredDiscriminatorDefault,
222
+ );
223
+
209
224
  // Add base schemas for baseValues
210
225
  // Mark discriminator field with isDiscriminator decorator so it's distinguished from non-discriminator literals
211
226
  for (const value of resolvedBaseValues || []) {
212
227
  allVariantSchemas.push(
213
228
  base.extend({
214
- [discriminator.field]: discriminatorLiteralFor(discriminator.field, value, baseShape[discriminator.field], resolvedBaseValues)
229
+ [discriminator.field]: unionMemberDiscriminator(value)
215
230
  }) as z.ZodObject<z.ZodRawShape>
216
231
  );
217
232
  }
@@ -221,7 +236,7 @@ export function createSchemaFamily<
221
236
  for (const [value, schema] of Object.entries(extendedVariants)) {
222
237
  allVariantSchemas.push(
223
238
  schema.extend({
224
- [discriminator.field]: discriminatorLiteralFor(discriminator.field, value, baseShape[discriminator.field], resolvedBaseValues)
239
+ [discriminator.field]: unionMemberDiscriminator(value)
225
240
  }) as z.ZodObject<z.ZodRawShape>
226
241
  );
227
242
  }
@@ -25,8 +25,27 @@ export enum SystemOfRecordActionCallShape {
25
25
  * argument, which is how Odoo addresses a recordset method such as `action_post`.
26
26
  *
27
27
  * spec-cite: Odoo 18.0 developer documentation, External API — "Calling methods" (the execute_kw argument layout).
28
+ *
29
+ * Spoken over `ODOO_JSONRPC` only: `execute_kw` is a function of the `object` service at `/jsonrpc`, which Odoo removes
30
+ * at Online 21.1 and Odoo 22. An instance on JSON-2 declares {@link ODOO_JSON2_METHOD} instead (#3391).
28
31
  */
29
32
  ODOO_EXECUTE_KW = 'odoo-execute-kw',
33
+ /**
34
+ * Odoo's External JSON-2 API (#3391): `POST /json/2/<model>/<method>` with a body of NAMED parameters — any public
35
+ * model method, the same as `execute_kw`, with the credential in an `Authorization: bearer` header. A record-targeted
36
+ * call names the record ids in the body's `ids` member, which is how JSON-2 addresses a recordset method such as
37
+ * `action_post`.
38
+ *
39
+ * A shape of its own rather than `ODOO_EXECUTE_KW` reused, because the two place an input differently and only one of
40
+ * them can say where: JSON-2 has no positional arguments, so an input that `execute_kw` passed by POSITION (`create`'s
41
+ * `vals`) must be given the parameter's NAME (`vals_list`), and `execute_kw` has no such field to carry it.
42
+ *
43
+ * spec-cite: Odoo 19.0 developer documentation, External JSON-2 API
44
+ * (https://www.odoo.com/documentation/19.0/developer/reference/external_api.html), "Request" — the body members `ids`
45
+ * ("An array of record ids on which to execute the method. Empty or omitted when calling an @api.model-decorated
46
+ * method."), `context`, and `param` ("As many time as needed, the method's parameters.").
47
+ */
48
+ ODOO_JSON2_METHOD = 'odoo-json2-method',
30
49
  /**
31
50
  * An OData v4 BOUND action: `POST <EntitySet>(<key>)/<Namespace>.<Action>`, parameters in the JSON body.
32
51
  *
@@ -47,6 +66,7 @@ export enum SystemOfRecordActionCallShape {
47
66
  */
48
67
  export const SYSTEM_OF_RECORD_ACTION_CALL_SHAPE_DIALECT: Readonly<Record<SystemOfRecordActionCallShape, HttpApiTransportDialect>> = Object.freeze({
49
68
  [SystemOfRecordActionCallShape.ODOO_EXECUTE_KW]: HttpApiTransportDialect.ODOO_JSONRPC,
69
+ [SystemOfRecordActionCallShape.ODOO_JSON2_METHOD]: HttpApiTransportDialect.ODOO_JSON2,
50
70
  [SystemOfRecordActionCallShape.ODATA_BOUND_ACTION]: HttpApiTransportDialect.ODATA,
51
71
  [SystemOfRecordActionCallShape.ODATA_UNBOUND_ACTION]: HttpApiTransportDialect.ODATA,
52
72
  });
@@ -76,6 +96,36 @@ export enum SystemOfRecordOdooActionInputPlacement {
76
96
  NONE = 'none',
77
97
  }
78
98
 
99
+ /**
100
+ * Where an Odoo JSON-2 action's validated input goes in the request body (#3391). The counterpart of
101
+ * {@link SystemOfRecordOdooActionInputPlacement}, with POSITIONAL replaced by a NAMED parameter: JSON-2 binds every body
102
+ * member to the method's signature by name and has no positional form.
103
+ *
104
+ * spec-cite: Odoo 19.0 developer documentation, External JSON-2 API, "Migrating from XML-RPC / JSON-RPC" — "All the
105
+ * arguments are named; there is no way in JSON-2 to call a function with positional arguments."
106
+ */
107
+ export enum SystemOfRecordOdooJson2ActionInputPlacement {
108
+ /**
109
+ * Each member of the input object is one of the method's named parameters. The default, and the counterpart of
110
+ * `KEYWORD_ARGUMENTS`: a recordset method's options are its parameters.
111
+ */
112
+ NAMED_PARAMETERS = 'named-parameters',
113
+ /**
114
+ * The whole input object is the value of ONE named parameter, `inputParameter`: the body is
115
+ * `{ "<inputParameter>": <input> }`. The counterpart of `POSITIONAL`, and `create` is the canonical case: its signature
116
+ * is `create(self, vals_list)`, and Odoo's `model_create_multi` accepts one mapping there and treats it as a list of
117
+ * one, so `{ "vals_list": { …values… } }` creates one record. JSON-2 answers a created recordset as its ids, so that
118
+ * call answers `[<id>]`, a list, where `execute_kw('create', [vals])` answered the bare id.
119
+ *
120
+ * spec-cite: Odoo 19.0 source, `odoo/orm/decorators.py` `model_create_multi` ("if isinstance(vals_list, Mapping):
121
+ * vals_list = [vals_list]") and `addons/rpc/controllers/json2.py` `web_json_2_rpc` ("if isinstance(result, BaseModel):
122
+ * result = result.ids") — https://github.com/odoo/odoo/tree/19.0.
123
+ */
124
+ SINGLE_PARAMETER = 'single-parameter',
125
+ /** The method takes nothing beyond its records (`action_post`, `button_confirm`). The declared input must then be empty. */
126
+ NONE = 'none',
127
+ }
128
+
79
129
  /**
80
130
  * How a RECORD-FREE action relates to the instance's partitions (#1058), required at boot when the instance is
81
131
  * partitioned. A record-targeted action needs none: the record it reads first carries its partition.
@@ -104,7 +154,8 @@ export const SystemOfRecordActionPartitionStanceSchema = z.discriminatedUnion('k
104
154
  kind: z.literal(SystemOfRecordActionPartitionStanceKind.MEMBER_UNIT_PARTITION),
105
155
  /**
106
156
  * The REMOTE parameter the placed partition value is written into (`company_id`): a key of the Odoo keyword
107
- * arguments or of the positional input object, or a member of the OData body. The caller's input may not carry it.
157
+ * arguments or of the positional input object (`execute_kw`), a named parameter or a member of the single-parameter
158
+ * object (JSON-2), or a member of the OData body. The caller's input may not carry it.
108
159
  */
109
160
  parameter: z.string().min(1).max(120),
110
161
  }),
@@ -124,6 +175,19 @@ export const SystemOfRecordActionCallSchema = z.discriminatedUnion('shape', [
124
175
  model: z.string().regex(/^[a-z_][a-z0-9_.]*$/, 'An Odoo model name is dotted snake_case.').max(120).optional(),
125
176
  inputPlacement: z.enum(SystemOfRecordOdooActionInputPlacement).default(SystemOfRecordOdooActionInputPlacement.KEYWORD_ARGUMENTS),
126
177
  }),
178
+ z.strictObject({
179
+ shape: z.literal(SystemOfRecordActionCallShape.ODOO_JSON2_METHOD),
180
+ /** The model method, in Odoo's own spelling (`action_post`, `create`) — the last segment of `/json/2/<model>/<method>`. */
181
+ method: z.string().regex(/^[a-z_][a-z0-9_]*$/, 'An Odoo method name is snake_case.').max(120),
182
+ /** As for `ODOO_EXECUTE_KW`: for a RECORD-FREE action only; absent means the binding's `entityRef`. */
183
+ model: z.string().regex(/^[a-z_][a-z0-9_.]*$/, 'An Odoo model name is dotted snake_case.').max(120).optional(),
184
+ inputPlacement: z.enum(SystemOfRecordOdooJson2ActionInputPlacement).default(SystemOfRecordOdooJson2ActionInputPlacement.NAMED_PARAMETERS),
185
+ /**
186
+ * The method parameter the whole input becomes, for `SINGLE_PARAMETER` only (`vals_list` for `create`). Required with
187
+ * that placement and refused with any other, so a declaration cannot name a parameter nothing is sent in.
188
+ */
189
+ inputParameter: z.string().regex(/^[a-z_][a-z0-9_]*$/, 'An Odoo parameter name is snake_case.').max(120).optional(),
190
+ }),
127
191
  z.strictObject({
128
192
  shape: z.literal(SystemOfRecordActionCallShape.ODATA_BOUND_ACTION),
129
193
  /** The namespace-qualified action name (`Microsoft.Dynamics.CRM.WinOpportunity`). */
@@ -32,6 +32,8 @@ export const HTTP_API_DIALECT_CAPABILITIES: { readonly [dialect in HttpApiTransp
32
32
  [HttpApiTransportDialect.ODATA_V2]: { translatesSort: true, sendsRowWrites: false },
33
33
  // `search_read`'s `order`; `execute_kw` create / write / unlink (#1724).
34
34
  [HttpApiTransportDialect.ODOO_JSONRPC]: { translatesSort: true, sendsRowWrites: true },
35
+ // The same `order` and the same create / write / unlink, sent as `POST /json/2/<model>/<method>` (#3391).
36
+ [HttpApiTransportDialect.ODOO_JSON2]: { translatesSort: true, sendsRowWrites: true },
35
37
  // No sort translation (the compiler refuses every sort); the binding's declared method and path per verb (#1728).
36
38
  [HttpApiTransportDialect.REST_JSON]: { translatesSort: false, sendsRowWrites: true },
37
39
  });
@@ -114,7 +116,7 @@ export function systemOfRecordBindingCapabilities(facet: SystemOfRecordVendorFac
114
116
  writesRows: writeRefusal === undefined,
115
117
  ...(writeRefusal === undefined ? {} : { writeRefusal }),
116
118
  partitions: systemOfRecordPartitionIsConfinable(facet.partition),
117
- incrementalExtractionModes: (facet.incrementalExtractionModes ?? []).filter((mode) => EXTERNAL_DATA_INCREMENTAL_MODE_DIALECT[mode] === dialect),
119
+ incrementalExtractionModes: (facet.incrementalExtractionModes ?? []).filter((mode) => EXTERNAL_DATA_INCREMENTAL_MODE_DIALECTS[mode].includes(dialect)),
118
120
  actionCallShapes: (facet.actionCallShapes ?? []).filter((shape) => SYSTEM_OF_RECORD_ACTION_CALL_SHAPE_DIALECT[shape] === dialect),
119
121
  };
120
122
  }
@@ -165,6 +165,22 @@ export enum SystemOfRecordErrorCode {
165
165
  */
166
166
  CREDENTIAL_MATERIAL_UNUSABLE = 'SYSTEM_OF_RECORD_CREDENTIAL_MATERIAL_UNUSABLE',
167
167
 
168
+ /**
169
+ * REQUEST — the system of record REFUSED the instance's static credential (#3456): an API key, a key in the query,
170
+ * a BASIC password, or Odoo's in-args key. Odoo's JSON-RPC answers `common.authenticate` with `false`; Odoo's
171
+ * JSON-2 and any vendor reading a header key answer `401`.
172
+ *
173
+ * Told apart from an unreachable or failing system of record because the remedy is a different person's work: the
174
+ * operator ROTATES the credential (the context's `rotate` names the environment variables to replace) and restarts;
175
+ * nothing in the application or the vendor is broken. A static key cannot be re-minted, so no retry can fix it. An Odoo
176
+ * 19+ key expires within three months, so on Odoo this is also what an EXPIRED key looks like.
177
+ *
178
+ * Answered as `CONFIGURATION`, whose context reaches the server log and not the client: the instance's slot names are
179
+ * the operator's business. A token-minting credential refused AFTER a fresh mint is {@link TOKEN_UNAVAILABLE}'s family,
180
+ * not this one.
181
+ */
182
+ CREDENTIAL_REFUSED = 'SYSTEM_OF_RECORD_CREDENTIAL_REFUSED',
183
+
168
184
  /**
169
185
  * BOOT — the instance opts into partitioning and its vendor declares none (#1058).
170
186
  *
@@ -98,6 +98,14 @@ export const SystemOfRecordDeclarationSchema = z.strictObject({
98
98
  * splitting it between the instances' `maxRequestsPerMinute`. Both were rejected on that ground.
99
99
  * The cost, stated: two instances against one vendor account are paced separately, so their sum —
100
100
  * not either one — is what must stay under the vendor's allowance.
101
+ *
102
+ * ## Odoo: the VERSION decides (#3391)
103
+ *
104
+ * Odoo speaks two dialects to the same ORM. Declare `ODOO_JSON2` for Odoo 19.0 or later (Odoo Online included) and
105
+ * `ODOO_JSONRPC` for Odoo 18.0, which has no JSON-2. `/jsonrpc` is deprecated from 19.0 and removed at Online 21.1
106
+ * (winter 2027) and Odoo 22 (fall 2028), so an instance moves to `ODOO_JSON2` by changing this one field; its
107
+ * bindings name the same dialect and change with it. The credential kind follows from the dialect, and the same
108
+ * Odoo API key serves both.
101
109
  */
102
110
  dialect: z.enum(HttpApiTransportDialect),
103
111
 
@@ -105,7 +113,8 @@ export const SystemOfRecordDeclarationSchema = z.strictObject({
105
113
  * How the engine proves who it is.
106
114
  *
107
115
  * OPTIONAL, and the absence is DERIVED rather than defaulted: when the instance's facet offers
108
- * exactly one credential kind there is nothing for an author to decide, so the registry takes it;
116
+ * exactly one credential kind OVER THE INSTANCE'S DIALECT (#3391) there is nothing for an author to decide, so the
117
+ * registry takes it;
109
118
  * when a facet offers more than one and the instance names none, boot refuses and lists them.
110
119
  * The framework derives before it asks: a declaration with one legal value is a question whose
111
120
  * answer the mechanism already holds.
@@ -269,9 +278,14 @@ const systemOfRecordSlotListSchema = (label: string) =>
269
278
  *
270
279
  * The kind owns its secrets and any address slot that exists only because the kind was chosen — a
271
280
  * future `OAUTH2_CLIENT_CREDENTIALS` owns `tokenUrl`, which no vendor would declare if it were
272
- * reached with a static key. `ODOO_API_KEY_IN_ARGS` needs no address slot of its own, and that is
273
- * the seam rather than an omission: its `database` and `login` inputs identify WHICH Odoo and WHICH
274
- * user, so they belong to the vendor and would survive a second Odoo credential kind.
281
+ * reached with a static key. `ODOO_API_KEY_IN_ARGS` owns `login`, for the same reason: the login exists only to be
282
+ * resolved to a uid by its `common.authenticate` handshake.
283
+ *
284
+ * ⚠ This used to say the kind needed no address slot of its own, because `database` and `login` "identify WHICH Odoo
285
+ * and WHICH user, so they belong to the vendor and would survive a second Odoo credential kind". Odoo's JSON-2 API
286
+ * (#3391) was that second kind, and it disproved the claim for `login`: a JSON-2 key IS the user, so nothing asks for a
287
+ * login at all. `database` did survive, as an optional `X-Odoo-Database` header, and stays the vendor's — required by
288
+ * this kind's offer, since every `execute_kw` call names it.
275
289
  */
276
290
  export const SystemOfRecordCredentialKindContractSchema = z.strictObject({
277
291
  addressSlots: systemOfRecordSlotListSchema('credential address'),
@@ -300,14 +314,23 @@ export type SystemOfRecordCredentialKindContract = z.infer<typeof SystemOfRecord
300
314
  * Three slots are declared `required: false` here and are made required by the FACET's offer, which
301
315
  * is the only place that knows: `certificateKeyId` when the vendor's assertion header policy is
302
316
  * {@link SystemOfRecordAssertionHeaderPolicy.KEY_ID_SUPPLIED}, `certificatePem` when it is
303
- * `X509_THUMBPRINT_DERIVED`, and `subject` for the JWT-bearer grant's `sub`. The join is performed
317
+ * `X509_THUMBPRINT_DERIVED`, and `subject` for the JWT-bearer grant's `sub`. An offer reaches a VENDOR slot the same
318
+ * way since #3391: Odoo's `database` is optional, and the in-args kind makes it required. The join is performed
304
319
  * ONCE, in {@link resolveSystemOfRecordInstanceSlots}, rather than by each of the five readers of
305
320
  * "what does this instance need" — which is the enumeration failure
306
321
  * `invariant-call-site-enumeration.md` exists to stop.
307
322
  */
308
323
  export const SYSTEM_OF_RECORD_CREDENTIAL_KIND_CONTRACTS: Readonly<Record<SystemOfRecordCredentialKind, SystemOfRecordCredentialKindContract>> = {
309
324
  [SystemOfRecordCredentialKind.ODOO_API_KEY_IN_ARGS]: {
310
- addressSlots: [],
325
+ addressSlots: [
326
+ {
327
+ slug: 'login',
328
+ required: true,
329
+ description:
330
+ 'The Odoo user login the API key belongs to. `common.authenticate` resolves it to the uid every `execute_kw` call '
331
+ + 'then acts as, so it decides what the application can read. JSON-RPC only: a JSON-2 key names its user itself.',
332
+ },
333
+ ],
311
334
  secretSlots: [
312
335
  {
313
336
  slug: 'apiKey',
@@ -527,11 +550,29 @@ const tokenLifetimeFallbackSecondsSchema = z.number().int().min(30).max(86_400);
527
550
  * no header name is unrepresentable here; under a parallel map it would parse and fail at the first
528
551
  * read.
529
552
  */
553
+ /**
554
+ * The dialects ONE offer is good for (#3391), spread into every offer arm. ABSENT means every dialect the vendor speaks,
555
+ * which is what every single-dialect vendor means and so writes nothing.
556
+ *
557
+ * Needed the day one vendor spoke two wires that authenticate differently: Odoo's `/jsonrpc` reads the key from the RPC
558
+ * arguments and ignores headers, and its JSON-2 API reads it from `Authorization: bearer` and has no arguments to carry
559
+ * it. An offer that did not say which wire it serves would make a JSON-2 instance with the in-args kind bootable and
560
+ * unable to authenticate — and would make every existing Odoo declaration, which names no credential kind, ambiguous.
561
+ * Scoping the offer keeps the credential kind DERIVED from the dialect the instance already declares
562
+ * ({@link chooseSystemOfRecordCredentialKind}), which is `derive-before-you-ask.md` applied.
563
+ *
564
+ * Rejected: a separate dialect → kinds map on the facet. Two lists that must agree about one offer is the
565
+ * parallel-map shape the union below exists to avoid.
566
+ */
567
+ const credentialOfferDialectScopeShape = {
568
+ dialects: z.array(z.enum(HttpApiTransportDialect)).min(1).optional(),
569
+ };
570
+
530
571
  export const SystemOfRecordCredentialOfferSchema = z.discriminatedUnion('kind', [
531
- z.strictObject({ kind: z.literal(SystemOfRecordCredentialKind.ODOO_API_KEY_IN_ARGS).systemEnum('SystemOfRecordCredentialKind') }),
572
+ z.strictObject({ kind: z.literal(SystemOfRecordCredentialKind.ODOO_API_KEY_IN_ARGS).systemEnum('SystemOfRecordCredentialKind'), ...credentialOfferDialectScopeShape }),
532
573
 
533
574
  z.strictObject({
534
- kind: z.literal(SystemOfRecordCredentialKind.API_KEY_HEADER).systemEnum('SystemOfRecordCredentialKind'),
575
+ kind: z.literal(SystemOfRecordCredentialKind.API_KEY_HEADER).systemEnum('SystemOfRecordCredentialKind'), ...credentialOfferDialectScopeShape,
535
576
  /** The header the key travels in — `Authorization`, `X-API-Key`, `apikey`, whatever the vendor reads. */
536
577
  headerName: z.string().regex(/^[A-Za-z0-9!#$%&'*+.^_`|~-]+$/, 'A header name is an RFC 9110 token.').max(64),
537
578
  /** What precedes the key in the header value, INCLUDING its trailing space (`"Bearer "`). Omitted when the key stands alone. */
@@ -539,21 +580,21 @@ export const SystemOfRecordCredentialOfferSchema = z.discriminatedUnion('kind',
539
580
  }),
540
581
 
541
582
  z.strictObject({
542
- kind: z.literal(SystemOfRecordCredentialKind.API_KEY_QUERY).systemEnum('SystemOfRecordCredentialKind'),
583
+ kind: z.literal(SystemOfRecordCredentialKind.API_KEY_QUERY).systemEnum('SystemOfRecordCredentialKind'), ...credentialOfferDialectScopeShape,
543
584
  /** The query parameter the key is appended as. */
544
585
  parameterName: z.string().regex(/^[A-Za-z0-9_.-]+$/, 'A query parameter name is alphanumeric with -._').max(64),
545
586
  }),
546
587
 
547
- z.strictObject({ kind: z.literal(SystemOfRecordCredentialKind.BASIC).systemEnum('SystemOfRecordCredentialKind') }),
588
+ z.strictObject({ kind: z.literal(SystemOfRecordCredentialKind.BASIC).systemEnum('SystemOfRecordCredentialKind'), ...credentialOfferDialectScopeShape }),
548
589
 
549
590
  z.strictObject({
550
- kind: z.literal(SystemOfRecordCredentialKind.OAUTH2_CLIENT_CREDENTIALS_SECRET).systemEnum('SystemOfRecordCredentialKind'),
591
+ kind: z.literal(SystemOfRecordCredentialKind.OAUTH2_CLIENT_CREDENTIALS_SECRET).systemEnum('SystemOfRecordCredentialKind'), ...credentialOfferDialectScopeShape,
551
592
  clientAuthentication: z.enum(SystemOfRecordClientAuthenticationPlacement),
552
593
  tokenLifetimeFallbackSeconds: tokenLifetimeFallbackSecondsSchema,
553
594
  }),
554
595
 
555
596
  z.strictObject({
556
- kind: z.literal(SystemOfRecordCredentialKind.OAUTH2_CLIENT_CREDENTIALS_CERTIFICATE).systemEnum('SystemOfRecordCredentialKind'),
597
+ kind: z.literal(SystemOfRecordCredentialKind.OAUTH2_CLIENT_CREDENTIALS_CERTIFICATE).systemEnum('SystemOfRecordCredentialKind'), ...credentialOfferDialectScopeShape,
557
598
  assertionHeaderPolicy: z.enum(SystemOfRecordAssertionHeaderPolicy),
558
599
  assertionSigningAlgorithm: z.enum(SystemOfRecordAssertionSigningAlgorithm),
559
600
  /** How long the ASSERTION is valid — minutes, not hours; it is consumed once at the token endpoint. */
@@ -562,13 +603,13 @@ export const SystemOfRecordCredentialOfferSchema = z.discriminatedUnion('kind',
562
603
  }),
563
604
 
564
605
  z.strictObject({
565
- kind: z.literal(SystemOfRecordCredentialKind.OAUTH2_JWT_BEARER).systemEnum('SystemOfRecordCredentialKind'),
606
+ kind: z.literal(SystemOfRecordCredentialKind.OAUTH2_JWT_BEARER).systemEnum('SystemOfRecordCredentialKind'), ...credentialOfferDialectScopeShape,
566
607
  assertionSigningAlgorithm: z.enum(SystemOfRecordAssertionSigningAlgorithm),
567
608
  assertionLifetimeSeconds: z.number().int().min(30).max(600),
568
609
  tokenLifetimeFallbackSeconds: tokenLifetimeFallbackSecondsSchema,
569
610
  }),
570
611
  // Nothing about mTLS varies by vendor: the certificate, the key and the CA are the deployment's (#1263).
571
- z.strictObject({ kind: z.literal(SystemOfRecordCredentialKind.MTLS_CLIENT_CERTIFICATE).systemEnum('SystemOfRecordCredentialKind') }),
612
+ z.strictObject({ kind: z.literal(SystemOfRecordCredentialKind.MTLS_CLIENT_CERTIFICATE).systemEnum('SystemOfRecordCredentialKind'), ...credentialOfferDialectScopeShape }),
572
613
  ]);
573
614
  export type SystemOfRecordCredentialOffer = z.infer<typeof SystemOfRecordCredentialOfferSchema>;
574
615
 
@@ -875,6 +916,26 @@ export const SystemOfRecordVendorFacetSchema = z.strictObject({
875
916
  seenKinds.add(offer.kind);
876
917
  }
877
918
 
919
+ // #3391 — an offer scoped to dialects names only dialects the vendor speaks, and every dialect the vendor speaks has at
920
+ // least one offer. Either failure is a facet that cannot be honoured: an offer for a dialect no instance may declare, or
921
+ // a dialect an instance may declare and then cannot authenticate over.
922
+ for (const [index, offer] of facet.credentialOffers.entries()) {
923
+ for (const dialect of offer.dialects ?? []) {
924
+ if (!facet.dialects.includes(dialect)) {
925
+ context.addIssue({
926
+ code: 'custom',
927
+ path: ['credentialOffers', index, 'dialects'],
928
+ message: `Credential offer "${offer.kind}" is scoped to ${dialect}, which this vendor's dialects do not list.`,
929
+ });
930
+ }
931
+ }
932
+ }
933
+ for (const [index, dialect] of facet.dialects.entries()) {
934
+ if (!facet.credentialOffers.some((offer) => systemOfRecordCredentialOfferServesDialect(offer, dialect))) {
935
+ context.addIssue({ code: 'custom', path: ['dialects', index], message: `No credential offer serves dialect "${dialect}".` });
936
+ }
937
+ }
938
+
878
939
  // A vendor address slug that a kind also declares would make the derived environment variable
879
940
  // ambiguous about who owns the value, so the two namespaces are checked against each other here
880
941
  // rather than at the instance, where the failure would read as an authoring mistake.