@wildo-ai/framework-knowledge 1.1.11 → 1.1.12

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 (803) 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 +170 -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 +29 -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 +80 -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 +51 -7
  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 +10 -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/playbook.json +10 -6
  272. package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
  273. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
  274. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
  275. package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
  276. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
  277. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
  278. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
  279. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
  280. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
  281. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
  282. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
  283. package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
  284. package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
  285. package/dist/knowledge/references/application-maturity.config.md +27 -1
  286. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
  287. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
  288. package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
  289. package/dist/knowledge/references/brand.name-screening.config.md +30 -3
  290. package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
  291. package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
  292. package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
  293. package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
  294. package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
  295. package/dist/knowledge/references/companion.market.generation-service.md +46 -5
  296. package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
  297. package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
  298. package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
  299. package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
  300. package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
  301. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
  302. package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
  303. package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
  304. package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
  305. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
  306. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
  307. package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
  308. package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
  309. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
  310. package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
  311. package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
  312. package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
  313. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
  314. package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
  315. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
  316. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
  317. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
  318. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
  319. package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
  320. package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
  321. package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
  322. package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
  323. package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
  324. package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
  325. package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
  326. package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
  327. package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
  328. package/dist/knowledge/references/example.website.section.stats.md +1 -1
  329. package/dist/knowledge/references/experience-plan.config.md +111 -1
  330. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
  331. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
  332. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
  333. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
  334. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
  335. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
  336. package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
  337. package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
  338. package/dist/knowledge/references/integration-plan.config.md +7 -7
  339. package/dist/knowledge/references/placement-plan.config.md +19 -0
  340. package/dist/knowledge/references/platform.config.backing-services.md +9 -11
  341. package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
  342. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
  343. package/dist/knowledge/references/platform.config.infrastructure-host.md +0 -1
  344. package/dist/knowledge/references/platform.config.platform-key-management.md +84 -8
  345. package/dist/knowledge/references/platform.config.saas.md +20 -18
  346. package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
  347. package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
  348. package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
  349. package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
  350. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
  351. package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
  352. package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
  353. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +4 -4
  354. package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
  355. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +29 -2
  356. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
  357. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
  358. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
  359. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  360. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
  361. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
  362. package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
  363. package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
  364. package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
  365. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
  366. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
  367. package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
  368. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
  369. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
  370. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +363 -2
  371. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
  372. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
  373. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
  374. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
  375. package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
  376. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
  377. package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
  378. package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
  379. package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
  380. package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
  381. package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
  382. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
  383. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
  384. package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
  385. package/dist/knowledge/references/saas.frontend.chart-dashboard.md +130 -0
  386. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
  387. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
  388. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
  389. package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
  390. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
  391. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
  392. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
  393. package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
  394. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
  395. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
  396. package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
  397. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
  398. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
  399. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
  400. package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
  401. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
  402. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
  403. package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
  404. package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
  405. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
  406. package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
  407. package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
  408. package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
  409. package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
  410. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
  411. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
  412. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
  413. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
  414. package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
  415. package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
  416. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
  417. package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
  418. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
  419. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
  420. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
  421. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
  422. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
  423. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
  424. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
  425. package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
  426. package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
  427. package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
  428. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
  429. package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
  430. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
  431. package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
  432. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
  433. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
  434. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
  435. package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
  436. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
  437. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
  438. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
  439. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
  440. package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
  441. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
  442. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
  443. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
  444. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
  445. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
  446. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
  447. package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
  448. package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
  449. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
  450. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
  451. package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
  452. package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
  453. package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
  454. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
  455. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
  456. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
  457. package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
  458. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
  459. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
  460. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
  461. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
  462. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
  463. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
  464. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
  465. package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
  466. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
  467. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
  468. package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
  469. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
  470. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
  471. package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
  472. package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
  473. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
  474. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
  475. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
  476. package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
  477. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
  478. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
  479. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
  480. package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
  481. package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
  482. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
  483. package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
  484. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
  485. package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
  486. package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
  487. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
  488. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
  489. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
  490. package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
  491. package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
  492. package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
  493. package/dist/knowledge/references/service-method.config.md +35 -2
  494. package/dist/knowledge/references/vision.constraint.config.md +4 -2
  495. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
  496. package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
  497. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
  498. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
  499. package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
  500. package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
  501. package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
  502. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
  503. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
  504. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
  505. package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
  506. package/dist/knowledge/references/zod.factories.code.md +4 -4
  507. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  508. package/dist/knowledge/references/zod.factories.money.md +4 -4
  509. package/dist/knowledge/references/zod.factories.phone.md +4 -4
  510. package/dist/knowledge/references/zod.factories.year-month.md +79 -0
  511. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  512. package/dist/knowledge/registries/framework-topics.json +415 -2
  513. package/dist/knowledge/registries/playbooks.json +51 -39
  514. package/dist/knowledge/registries/source-tags.json +2412 -1604
  515. package/dist/knowledge/rules/database-migration-obligation.md +6 -7
  516. package/dist/knowledge/rules/live-context-door.md +1 -1
  517. package/dist/knowledge/skills/INDEX.md +3 -1
  518. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
  519. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
  520. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
  521. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
  522. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
  523. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
  524. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
  525. package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
  526. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
  527. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
  528. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
  529. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
  530. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
  531. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
  532. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
  533. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
  534. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  535. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
  536. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
  537. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
  538. package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
  539. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
  540. package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
  541. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
  542. package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
  543. package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +79 -0
  544. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
  545. package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
  546. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
  547. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
  548. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
  549. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
  550. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
  551. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
  552. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
  553. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
  554. package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
  555. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
  556. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
  557. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
  558. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
  559. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
  560. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
  561. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
  562. package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
  563. package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
  564. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
  565. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
  566. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
  567. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
  568. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
  569. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +197 -9
  570. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
  571. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
  572. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
  573. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
  574. package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
  575. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
  576. package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
  577. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
  578. package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
  579. package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
  580. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
  581. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
  582. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
  583. package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
  584. package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +61 -0
  585. package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
  586. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
  587. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
  588. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
  589. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
  590. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
  591. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +1 -1
  592. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
  593. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +18 -7
  594. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
  595. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
  596. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +44 -4
  597. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
  598. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
  599. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
  600. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
  601. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
  602. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +375 -8
  603. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
  604. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
  605. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
  606. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +1 -1
  607. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
  608. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
  609. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +1 -1
  610. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
  611. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
  612. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +3 -3
  613. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +37 -14
  614. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
  615. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
  616. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
  617. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
  618. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
  619. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
  620. package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
  621. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
  622. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
  623. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
  624. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
  625. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
  626. package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
  627. package/dist/knowledge/skills/infra-environment-config/SKILL.md +125 -77
  628. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
  629. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
  630. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +0 -1
  631. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +84 -8
  632. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
  633. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
  634. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
  635. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
  636. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
  637. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
  638. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
  639. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
  640. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
  641. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
  642. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
  643. package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
  644. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
  645. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
  646. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
  647. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
  648. package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
  649. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
  650. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
  651. package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
  652. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
  653. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
  654. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
  655. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
  656. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
  657. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
  658. package/dist/knowledge/skills/provider-backend-package/SKILL.md +255 -12
  659. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
  660. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
  661. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
  662. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
  663. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
  664. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
  665. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
  666. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
  667. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
  668. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
  669. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
  670. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
  671. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
  672. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
  673. package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
  674. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
  675. package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
  676. package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
  677. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
  678. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
  679. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
  680. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
  681. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
  682. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +33 -7
  683. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
  684. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
  685. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
  686. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +7 -2
  687. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
  688. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
  689. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
  690. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
  691. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
  692. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
  693. package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
  694. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
  695. package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
  696. package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
  697. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
  698. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
  699. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
  700. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
  701. package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
  702. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
  703. package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
  704. package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
  705. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
  706. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
  707. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
  708. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
  709. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
  710. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
  711. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
  712. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
  713. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
  714. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
  715. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
  716. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
  717. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
  718. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
  719. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
  720. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
  721. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
  722. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  723. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
  724. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
  725. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
  726. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
  727. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
  728. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
  729. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
  730. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
  731. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
  732. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
  733. package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
  734. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
  735. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
  736. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
  737. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
  738. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
  739. package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
  740. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
  741. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
  742. package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
  743. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
  744. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
  745. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
  746. package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
  747. package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
  748. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
  749. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
  750. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
  751. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
  752. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
  753. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
  754. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
  755. package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
  756. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
  757. package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
  758. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
  759. package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
  760. package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
  761. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
  762. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
  763. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  764. package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
  765. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
  766. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
  767. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
  768. package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
  769. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
  770. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
  771. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
  772. package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
  773. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
  774. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
  775. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
  776. package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
  777. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
  778. package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
  779. package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
  780. package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
  781. package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
  782. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
  783. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
  784. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
  785. package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
  786. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
  787. package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
  788. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
  789. package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
  790. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
  791. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
  792. package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
  793. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
  794. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
  795. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
  796. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
  797. package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
  798. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
  799. package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
  800. package/dist/knowledge/topic-index.json +2275 -715
  801. package/dist/tsconfig.build.tsbuildinfo +1 -1
  802. package/package.json +6 -6
  803. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -25,6 +25,850 @@ None of them refuses anything: the brief and the evidence collector report them.
25
25
  on the vendor's own labels: if the profile lists `us-east-1`, a choice of `United States` is reported as
26
26
  `REGION_NOT_OFFERED`. Choose a label the profile lists.
27
27
 
28
+ One case IS refused: a region a provider that selects its regions by ENDPOINT cannot be reached in.
29
+ `wildo config sync` stops with a message naming the regions it serves, because the runtime binds that provider
30
+ to the chosen region's host and there is no host for an unlisted one.
31
+
32
+ ## Enforced, attested, or neither
33
+
34
+ Each assessment also carries `regionReach`, and a document states the region as what it is:
35
+
36
+ | `regionReach` | the region is | write it as |
37
+ |---|---|---|
38
+ | `endpoint` | ENFORCED: every call goes to that region's endpoint | where the data is processed |
39
+ | `account-residency` | ATTESTED: the operator's statement about its account at the vendor | where the operator states its vendor account keeps the data |
40
+ | `null` | neither: the provider does not say how the region is reached | the operator's claim, without asserting the product enforces it |
41
+
42
+ ## Pinning where the data may be processed: `dataResidency`
43
+
44
+ An application that commits to keeping its data inside named places declares them on
45
+ `operatorComplianceIdentity.dataResidency.territories`, as jurisdiction slugs (`eu`, `de`, `ch`, `us`; the
46
+ EEA is `eu`, `is`, `li`, `no`). It is opt-in: without it nothing is refused.
47
+
48
+ With it, `wildo config sync` (and so every `wildo local dev` start) refuses, before writing anything, any
49
+ `VENDOR_HOSTED` choice whose region processes in a place outside the territories, whose places the
50
+ provider's profile does not state (`processingRegionTerritories`: a `Global` endpoint states none), or
51
+ whose provider has no established profile. A `SELF_HOSTED` choice is not checked: it runs on your own
52
+ infrastructure, which the residency itself states is inside (unless the provider is only offered vendor-hosted,
53
+ which is refused). Containment is by place: `eu` contains `de`, `us` contains `us-ca`, and an EU-and-EFTA region
54
+ (Mistral `EU`) is outside an `eu`-only residency.
55
+
56
+ It also refuses a provider that a runtime serving the application's data declares (backend, frontend services,
57
+ minions, workers) and no choice places, because a call can be routed to it (a `whenUnavailable` substitute, a
58
+ `failover` provider) and nothing says where it goes. The development companion's scope is not covered. Each
59
+ backend, minion and node-worker artifact carries the residency (`providerDataResidency`), and the host's provider
60
+ loader re-applies it to the modules it actually loaded, so startup refuses a provider outside it by name.
61
+
62
+ `hostingRegions` stays where your own store is, in your words; `dataResidency` is the boundary, and the
63
+ `international-transfers` document fact states it from this declaration, with each vendor's region, its
64
+ places and whether it is inside.
65
+
66
+ ## Import Origins
67
+
68
+ - `@wildo-ai/saas-models`
69
+
70
+ ## Source Excerpts
71
+
72
+ ### Origin Package: `@wildo-ai/saas-models`
73
+
74
+ ```typescript
75
+ /**
76
+ * WHERE an application's data may be stored and processed, as places the framework can compare (#2294).
77
+ *
78
+ * `territories` are jurisdiction slugs (`eu`, `de`, `ch`, `us`), the vocabulary `operatingJurisdictions` uses, so a
79
+ * provider's processing region can be checked against them: `eu` contains every EU member state, and a slug contains its
80
+ * own subdivisions (`us` contains `us-ca`). The EEA is spelled out (`eu`, `is`, `li`, `no`), because the grammar has no
81
+ * regime suffix.
82
+ *
83
+ * ## Two places, kept apart
84
+ *
85
+ * - **The application's OWN data store** (its databases, object storage, backups) runs on the operator's infrastructure.
86
+ * Where that is stays `hostingRegions`, in the operator's words, and declaring a residency is the operator's statement
87
+ * that the store lies inside `territories`. The framework cannot measure it: no deployment says which country a
88
+ * database volume is in.
89
+ * - **Each vendor that processes the data** (`providerComplianceChoices.<ref>`, `VENDOR_HOSTED`) processes in the region
90
+ * the application chose, and the provider's profile maps that region to the places it covers
91
+ * (`processingRegionTerritories`). That is measured: `wildo config sync` refuses a vendor region outside
92
+ * `territories`, and refuses a region whose places the profile does not state, before any artifact is written.
93
+ *
94
+ * Opt-in. Absent means the application states no residency and nothing is refused, which is not the same as "anywhere":
95
+ * the documents then say no residency is declared.
96
+ */
97
+ export const ApplicationDataResidencySchema = z
98
+ .strictObject({
99
+ /** The places the data may be stored and processed in. A vendor region counts as inside when every place it covers is inside one of these. */
100
+ territories: z.array(JurisdictionSlugSchema).min(1),
101
+ })
102
+ .superRefine((residency, context) => {
103
+ const duplicates = residency.territories.filter((territory, index) => residency.territories.indexOf(territory) !== index);
104
+ if (duplicates.length > 0) {
105
+ context.addIssue({
106
+ code: 'custom',
107
+ path: ['territories'],
108
+ message: `data residency territory ${[...new Set(duplicates)].map((slug) => `"${slug}"`).join(', ')} is declared more than once`,
109
+ });
110
+ }
111
+ });
112
+ export type ApplicationDataResidency = z.infer<typeof ApplicationDataResidencySchema>;
113
+
114
+ /**
115
+ * WHERE one organization's data may be processed, narrower than the application's (#2294): a tenant pinned to `de` inside
116
+ * an application whose residency is `eu`. Stored on the organization (`Organization.dataResidency`), written by the
117
+ * tenant's administrator, and applied to every provider call made for that organization, where the application's own
118
+ * residency is applied when the configuration is synchronised and when a runtime loads its providers.
119
+ *
120
+ * The same shape as {@link ApplicationDataResidencySchema} and a different statement: the application's says where the
121
+ * product may process anyone's data, an organization's says where it may process this tenant's. Kept as its own name so a
122
+ * reader never takes one for the other.
123
+ *
124
+ * ## It only ever narrows, which is why the application must declare one first
125
+ *
126
+ * {@link organizationDataResidencyRefusal} refuses an organization residency that the application's does not contain,
127
+ * and refuses one when the application declares none. Both follow from what a narrowing is. A territory outside the
128
+ * application's would promise the tenant a place the product never undertook to keep the data in. With no application
129
+ * residency, nothing has placed the providers: their choices may name no region, and no synchronisation has checked
130
+ * them, so a call-time check would refuse on statements nobody made. Declaring the application's residency is the step
131
+ * that places them, and the refusal names it.
132
+ */
133
+ export const OrganizationDataResidencySchema = ApplicationDataResidencySchema;
134
+ export type OrganizationDataResidency = z.infer<typeof OrganizationDataResidencySchema>;
135
+
136
+ /**
137
+ * Why an organization's residency cannot be accepted, as a sentence naming the remedy; `null` when it narrows the
138
+ * application's. Applied where the organization writes it, so a stored residency is always inside the application's
139
+ * (a later narrowing of the APPLICATION's residency can still leave a stored one wider; the call-time check then applies
140
+ * both, see {@link effectiveDataResidencyTerritories}).
141
+ */
142
+ export function organizationDataResidencyRefusal(
143
+ application: ApplicationDataResidency | undefined,
144
+ organization: OrganizationDataResidency,
145
+ ): string | null {
146
+ if (application === undefined) {
147
+ return 'The application declares no data residency (operatorComplianceIdentity.dataResidency), so an organization has none to '
148
+ + 'narrow: nothing has placed its providers in named places. Declare the application\'s residency first.';
149
+ }
150
+ const outside = organization.territories.filter((territory) => !application.territories.some((resident) => jurisdictionReachCovers(resident, territory)));
151
+ if (outside.length === 0) return null;
152
+ return `The organization's data residency names ${outside.join(', ')}, outside the application's (${application.territories.join(', ')}). `
153
+ + 'An organization can only narrow the application\'s residency: name places inside it.';
154
+ }
155
+
156
+ /**
157
+ * The territories an organization may name in its residency (#2294): each of the application's own, and every
158
+ * jurisdiction an aggregate one contains (`eu` offers `eu` and each member state). What the organization's settings
159
+ * offer as its choices, so an administrator picks inside the application's residency rather than typing a slug the
160
+ * update then refuses. Empty when the application declares none: there is nothing to narrow.
161
+ *
162
+ * Subdivisions (`us-ca` inside `us`) are not listed, because nothing enumerates them; the update still admits one,
163
+ * since containment is computed rather than looked up.
164
+ */
165
+ export function organizationDataResidencyAdmissibleTerritories(application: ApplicationDataResidency | undefined): readonly string[] {
166
+ if (application === undefined) return [];
167
+ const admissible = new Set<string>();
168
+ for (const territory of application.territories) {
169
+ admissible.add(territory);
170
+ for (const member of JURISDICTION_CONTAINMENT[territory] ?? []) admissible.add(member);
171
+ }
172
+ return [...admissible];
173
+ }
174
+
175
+ /**
176
+ * The DI key of the backend service that holds the application's declared residency as this host's artifact carries
177
+ * it (`BackendProviderRegistryBackendService.getDataResidency`). Named here so a shared virtual field can read it through
178
+ * the calculation utilities' `getService`; the backend's service-type symbol is `Symbol.for` of this string, which a
179
+ * backend test holds equal.
180
+ */
181
+ export const BACKEND_PROVIDER_REGISTRY_SERVICE_KEY = 'SaaS.BackendProviderRegistryService';
182
+
183
+ /**
184
+ * The territories a call for an organization must stay inside: every place both residencies contain, as the narrower of
185
+ * each pair. An organization residency stored when the application's was wider can outlive a later narrowing of the
186
+ * application's, so the call-time check never trusts the stored value alone.
187
+ *
188
+ * `undefined` when the organization declares none (the application's residency is then applied where it already is, at
189
+ * synchronisation and at load). An empty list when the two share no place: every provider is then outside.
190
+ */
191
+ export function effectiveDataResidencyTerritories(
192
+ application: ApplicationDataResidency | undefined,
193
+ organization: OrganizationDataResidency | null | undefined,
194
+ ): readonly string[] | undefined {
195
+ if (organization === null || organization === undefined) return undefined;
196
+ if (application === undefined) return [...organization.territories];
197
+ const kept = new Set<string>();
198
+ for (const territory of organization.territories) {
199
+ for (const resident of application.territories) {
200
+ if (jurisdictionReachCovers(resident, territory)) kept.add(territory);
201
+ else if (jurisdictionReachCovers(territory, resident)) kept.add(resident);
202
+ }
203
+ }
204
+ return [...kept].sort((left, right) => left.localeCompare(right));
205
+ }
206
+ ```
207
+
208
+ ### Origin Package: `@wildo-ai/saas-models`
209
+
210
+ ```typescript
211
+ /**
212
+ * Where one provider stands against an application's declared data residency (#2294). Each answer is a different piece of
213
+ * work, and only INSIDE is not refused.
214
+ */
215
+ export enum ProviderDataResidencyStatus {
216
+ /** Every place the chosen region processes in lies inside the residency. */
217
+ INSIDE = 'inside',
218
+ /** The chosen region processes in at least one place outside the residency. */
219
+ OUTSIDE = 'outside',
220
+ /** The profile does not state which places the chosen region covers (a global region, or a map not yet researched). */
221
+ TERRITORY_UNKNOWN = 'territory-unknown',
222
+ /** The provider declares no established profile, so nothing says where it processes. */
223
+ NO_ESTABLISHED_PROFILE = 'no-established-profile',
224
+ /**
225
+ * A runtime that serves the application's data declares the provider, its profile allows a vendor to run it, and
226
+ * `providerComplianceChoices` says nothing about it: nobody stated where its calls go.
227
+ */
228
+ NO_CHOICE = 'no-choice',
229
+ /** The choice is VENDOR_HOSTED and names no region (the configuration schema refuses this; a runtime input may still carry it). */
230
+ REGION_NOT_CHOSEN = 'region-not-chosen',
231
+ /** The choice says SELF_HOSTED, but the provider is only offered vendor-hosted, so its data goes to the vendor anyway. */
232
+ DEPLOYMENT_MODEL_NOT_OFFERED = 'deployment-model-not-offered',
233
+ /**
234
+ * The call spends an organization's or a person's OWN vendor account (a connection they own), whose region that
235
+ * account decides and nothing records. The application's `providerComplianceChoices` describe its own account, never
236
+ * theirs, so the call cannot be shown to stay inside an organization's residency (#2294). Only ever produced by
237
+ * {@link assessProviderCallAgainstDataResidency}.
238
+ */
239
+ ACCOUNT_REGION_UNSTATED = 'account-region-unstated',
240
+ }
241
+
242
+ /**
243
+ * Why a provider call was refused under an organization's data residency (#2294), as the refusal's audit row records it:
244
+ * every {@link ProviderDataResidencyStatus} that is not INSIDE, by the same value, and one cause the status vocabulary
245
+ * cannot express because nothing was assessed: the organization's residency could not be read, so the call was refused
246
+ * rather than sent.
247
+ */
248
+ export enum ProviderDataResidencyRefusalReason {
249
+ OUTSIDE = ProviderDataResidencyStatus.OUTSIDE,
250
+ TERRITORY_UNKNOWN = ProviderDataResidencyStatus.TERRITORY_UNKNOWN,
251
+ NO_ESTABLISHED_PROFILE = ProviderDataResidencyStatus.NO_ESTABLISHED_PROFILE,
252
+ NO_CHOICE = ProviderDataResidencyStatus.NO_CHOICE,
253
+ REGION_NOT_CHOSEN = ProviderDataResidencyStatus.REGION_NOT_CHOSEN,
254
+ DEPLOYMENT_MODEL_NOT_OFFERED = ProviderDataResidencyStatus.DEPLOYMENT_MODEL_NOT_OFFERED,
255
+ ACCOUNT_REGION_UNSTATED = ProviderDataResidencyStatus.ACCOUNT_REGION_UNSTATED,
256
+ /** The organization the call was made for could not be read, so whether it pins its data is unknown. */
257
+ RESIDENCY_UNREADABLE = 'residency-unreadable',
258
+ }
259
+
260
+ /** Who declared the residency a refusal is about, which decides the remedy it names (#2294). */
261
+ export enum DataResidencyDeclarer {
262
+ /** `operatorComplianceIdentity.dataResidency`, checked at synchronisation and at load. */
263
+ APPLICATION = 'application',
264
+ /** `Organization.dataResidency`, checked on every provider call made for that organization. */
265
+ ORGANIZATION = 'organization',
266
+ }
267
+
268
+ /**
269
+ * Whose vendor account a provider call spends (#2294). Two answers, because they are two different statements about
270
+ * where the call goes: the application's account is where its `providerComplianceChoices` say, an owner's account is
271
+ * wherever that owner created it.
272
+ */
273
+ export enum ProviderCallAccount {
274
+ /** The application's own credential (its deployment secret, or an APPLICATION-owned connection). */
275
+ APPLICATION = 'application',
276
+ /** An ORGANIZATION- or USER-owned connection: the tenant's or the person's own vendor account. */
277
+ OWNER = 'owner',
278
+ }
279
+
280
+ /** One provider, assessed against the residency. */
281
+ export interface ProviderDataResidencyEntry {
282
+ readonly providerRef: string;
283
+ /** The region chosen for it; `null` when no choice names one ({@link ProviderDataResidencyStatus.NO_CHOICE} and the like). */
284
+ readonly processingRegion: string | null;
285
+ /** The places the region covers, from the profile; `null` when it states none. */
286
+ readonly territories: readonly string[] | null;
287
+ /** The places outside the residency, for {@link ProviderDataResidencyStatus.OUTSIDE}; empty otherwise. */
288
+ readonly outsideTerritories: readonly string[];
289
+ readonly status: ProviderDataResidencyStatus;
290
+ }
291
+
292
+ /** What the residency reads of a provider choice: who runs it, and in which region. */
293
+ export type ProviderDataResidencyChoice = Pick<ApplicationProviderComplianceChoice, 'deploymentModel' | 'processingRegion'>;
294
+
295
+ /**
296
+ * Every provider data can reach, assessed against the declared residency, sorted by provider ref. THE predicate: `wildo
297
+ * config sync` refuses on it, and the backend provider loader re-applies it to the modules it actually loaded, so a
298
+ * provider a call can be routed to at run time (the selected one, a `whenUnavailable` substitute, a `failover` provider,
299
+ * the one a per-environment override puts first) has passed it wherever it runs.
300
+ *
301
+ * The population is every provider with a choice AND every ref in `providerRefs` (the providers a runtime serving the
302
+ * application's data declares). A provider is not assessed (it is inside) when the operator runs it: a SELF_HOSTED choice
303
+ * the provider offers, or no choice and a profile that is only ever self-hosted. Everything else must name a vendor
304
+ * region whose places all lie inside; a declared provider no choice speaks for is refused rather than trusted, because
305
+ * nothing says where its calls go.
306
+ *
307
+ * Containment is `jurisdictionReachCovers`, the one operating-jurisdiction comparison: `eu` contains `de`, a slug contains
308
+ * its subdivisions, and `de` does not contain `eu`.
309
+ *
310
+ * assurance-control: WILDO.PRIVACY.THIRD_PARTY_PROCESSING — a processor whose chosen region covers a place outside the
311
+ * application's declared data residency, or whose places nothing states, is refused before the configuration is used and
312
+ * again before the runtime loads it.
313
+ */
314
+ export function assessProviderProcessingAgainstDataResidency(params: {
315
+ readonly residency: ApplicationDataResidency;
316
+ readonly choices: Readonly<Record<string, ProviderDataResidencyChoice>> | undefined;
317
+ readonly profilesByProviderRef: Readonly<Record<string, ProviderComplianceProfile | undefined>>;
318
+ /** The providers a runtime serving the application's data declares. Absent: only the providers with a choice. */
319
+ readonly providerRefs?: readonly string[];
320
+ }): readonly ProviderDataResidencyEntry[] {
321
+ const choices = params.choices ?? {};
322
+ const population = [...new Set([...Object.keys(choices), ...(params.providerRefs ?? [])])].sort((left, right) => left.localeCompare(right));
323
+ return population.flatMap((providerRef) => {
324
+ const entry = providerDataResidencyEntryOf({
325
+ providerRef,
326
+ choice: Object.hasOwn(choices, providerRef) ? choices[providerRef] : undefined,
327
+ profile: Object.hasOwn(params.profilesByProviderRef, providerRef) ? params.profilesByProviderRef[providerRef] : undefined,
328
+ residency: params.residency,
329
+ });
330
+ return entry === null ? [] : [entry];
331
+ });
332
+ }
333
+
334
+ /** One provider's entry, or `null` when the operator runs it. See {@link assessProviderProcessingAgainstDataResidency}. */
335
+ function providerDataResidencyEntryOf(input: {
336
+ readonly providerRef: string;
337
+ readonly choice: ProviderDataResidencyChoice | undefined;
338
+ readonly profile: ProviderComplianceProfile | undefined;
339
+ readonly residency: ApplicationDataResidency;
340
+ }): ProviderDataResidencyEntry | null {
341
+ const { providerRef, choice, residency } = input;
342
+ const established = establishedProviderComplianceProfile(input.profile);
343
+ const unplaced = (status: ProviderDataResidencyStatus): ProviderDataResidencyEntry => ({
344
+ providerRef, processingRegion: null, territories: null, outsideTerritories: [], status,
345
+ });
346
+ if (choice === undefined) {
347
+ if (established !== null && providerIsAlwaysSelfHosted(established)) return null;
348
+ return unplaced(established === null ? ProviderDataResidencyStatus.NO_ESTABLISHED_PROFILE : ProviderDataResidencyStatus.NO_CHOICE);
349
+ }
350
+ if (choice.deploymentModel === ProviderDeploymentModel.SELF_HOSTED) {
351
+ return established !== null && !established.deploymentModels.includes(ProviderDeploymentModel.SELF_HOSTED)
352
+ ? unplaced(ProviderDataResidencyStatus.DEPLOYMENT_MODEL_NOT_OFFERED)
353
+ : null;
354
+ }
355
+ if (choice.processingRegion === undefined) return unplaced(ProviderDataResidencyStatus.REGION_NOT_CHOSEN);
356
+ return vendorRegionDataResidencyEntry({
357
+ providerRef,
358
+ processingRegion: choice.processingRegion,
359
+ profileEstablished: established !== null,
360
+ regionTerritories: established?.processingRegionTerritories?.[choice.processingRegion] ?? null,
361
+ residency,
362
+ });
363
+ }
364
+
365
+ /** A vendor-hosted choice that names a region, against the residency: the one comparison both derivations below share. */
366
+ function vendorRegionDataResidencyEntry(input: {
367
+ readonly providerRef: string;
368
+ readonly processingRegion: string;
369
+ readonly profileEstablished: boolean;
370
+ readonly regionTerritories: readonly string[] | null;
371
+ readonly residency: ApplicationDataResidency;
372
+ }): ProviderDataResidencyEntry {
373
+ const base = { providerRef: input.providerRef, processingRegion: input.processingRegion };
374
+ if (!input.profileEstablished) {
375
+ return { ...base, territories: null, outsideTerritories: [], status: ProviderDataResidencyStatus.NO_ESTABLISHED_PROFILE };
376
+ }
377
+ if (input.regionTerritories === null) {
378
+ return { ...base, territories: null, outsideTerritories: [], status: ProviderDataResidencyStatus.TERRITORY_UNKNOWN };
379
+ }
380
+ const outsideTerritories = territoriesOutsideDataResidency(input.regionTerritories, input.residency);
381
+ return {
382
+ ...base,
383
+ territories: [...input.regionTerritories],
384
+ outsideTerritories,
385
+ status: outsideTerritories.length === 0 ? ProviderDataResidencyStatus.INSIDE : ProviderDataResidencyStatus.OUTSIDE,
386
+ };
387
+ }
388
+
389
+ /**
390
+ * The vendor-hosted choices among choices ALREADY assessed ({@link assessProviderComplianceChoices}), against the
391
+ * residency, for a reader that holds the assessments rather than the profiles (the recipient population, and the document
392
+ * fact built on it). The comparison is {@link assessProviderProcessingAgainstDataResidency}'s, so the refusal and the
393
+ * notice cannot disagree about where a vendor processes.
394
+ */
395
+ export function dataResidencyEntriesOf(
396
+ assessments: readonly ProviderComplianceChoiceAssessmentEntry[],
397
+ residency: ApplicationDataResidency,
398
+ ): readonly ProviderDataResidencyEntry[] {
399
+ return assessments
400
+ .filter((entry) => entry.choice.deploymentModel === ProviderDeploymentModel.VENDOR_HOSTED && entry.choice.processingRegion !== undefined)
401
+ .map((entry) => vendorRegionDataResidencyEntry({
402
+ providerRef: entry.providerRef,
403
+ processingRegion: entry.choice.processingRegion!,
404
+ profileEstablished: entry.offered !== null,
405
+ regionTerritories: entry.regionTerritories,
406
+ residency,
407
+ }));
408
+ }
409
+
410
+ /** The places in `territories` no declared residency territory contains. The one containment test every reader applies. */
411
+ export function territoriesOutsideDataResidency(territories: readonly string[], residency: ApplicationDataResidency): string[] {
412
+ return territories.filter((territory) => !residency.territories.some((resident) => jurisdictionReachCovers(resident, territory)));
413
+ }
414
+
415
+ /**
416
+ * What can be done, without asking anyone, about a provider a declared residency does not yet place inside (#2294).
417
+ * One member per answer; only {@link DERIVED} carries a choice to write, every other one is a decision left open and
418
+ * named (the creation foundation reports it, `wildo context launch-blockers` lists it).
419
+ */
420
+ export enum ProviderDataResidencyPlacementOutcome {
421
+ /**
422
+ * Exactly one of the provider's vendor regions processes wholly inside the residency, the provider is only offered
423
+ * vendor-hosted, and no authored choice names a region: that region is the only one the residency admits, so writing
424
+ * it decides nothing the residency had not already decided.
425
+ */
426
+ DERIVED = 'derived',
427
+ /** Several of its regions lie inside: which one the application uses is the operator's choice (cost, latency, account). */
428
+ SEVERAL_REGIONS_INSIDE = 'several-regions-inside',
429
+ /** None of its regions is stated to process wholly inside: choose another provider, run it self-hosted, or widen the residency. */
430
+ NO_REGION_INSIDE = 'no-region-inside',
431
+ /** The provider is offered self-hosted as well as vendor-hosted: who runs it is the operator's choice, never derived. */
432
+ DEPLOYMENT_MODEL_IS_A_CHOICE = 'deployment-model-is-a-choice',
433
+ /**
434
+ * An authored choice already speaks for the provider and does not place it inside (a region outside, a region whose
435
+ * places are unstated, or SELF_HOSTED for a provider only offered vendor-hosted). An authored choice is never
436
+ * overwritten: it is somebody's decision, and the residency now contradicts it.
437
+ */
438
+ AUTHORED_CHOICE_NOT_INSIDE = 'authored-choice-not-inside',
439
+ /** The provider declares no established compliance profile, so nothing says where any of its regions processes. */
440
+ NO_ESTABLISHED_PROFILE = 'no-established-profile',
441
+ }
442
+
443
+ /** One provider a residency does not place inside, and what can be done about it. See {@link placeProvidersInsideDataResidency}. */
444
+ export interface ProviderDataResidencyPlacement {
445
+ readonly providerRef: string;
446
+ /** The provider's entry from {@link assessProviderProcessingAgainstDataResidency}: never INSIDE. */
447
+ readonly assessment: ProviderDataResidencyEntry;
448
+ readonly outcome: ProviderDataResidencyPlacementOutcome;
449
+ /** The provider's vendor regions whose stated places all lie inside the residency, in the profile's order. */
450
+ readonly regionsInside: readonly string[];
451
+ /** The choice to write, for {@link ProviderDataResidencyPlacementOutcome.DERIVED} only. */
452
+ readonly derivedChoice?: { readonly deploymentModel: ProviderDeploymentModel.VENDOR_HOSTED; readonly processingRegion: string };
453
+ }
454
+
455
+ /**
456
+ * For every provider the residency does not place inside, whether its processing region can be DERIVED (#2294).
457
+ *
458
+ * The population and the verdict are {@link assessProviderProcessingAgainstDataResidency}'s, so a provider this calls
459
+ * placed is exactly one the synchronisation then admits: writing every `derivedChoice` turns each DERIVED entry INSIDE,
460
+ * and nothing else changes. A provider already INSIDE is not returned.
461
+ *
462
+ * Derived only when the residency leaves no choice: the provider is only offered vendor-hosted, exactly one of its
463
+ * regions processes wholly inside, and no authored choice names a region. Everything else is a decision, and is
464
+ * returned with the regions that would satisfy the residency so whoever takes it sees the options.
465
+ */
466
+ export function placeProvidersInsideDataResidency(params: Parameters<typeof assessProviderProcessingAgainstDataResidency>[0]): readonly ProviderDataResidencyPlacement[] {
467
+ return assessProviderProcessingAgainstDataResidency(params).flatMap((assessment): ProviderDataResidencyPlacement[] => {
468
+ if (assessment.status === ProviderDataResidencyStatus.INSIDE) return [];
469
+ const profile = Object.hasOwn(params.profilesByProviderRef, assessment.providerRef) ? params.profilesByProviderRef[assessment.providerRef] : undefined;
470
+ const established = establishedProviderComplianceProfile(profile);
471
+ const regionsInside = established === null
472
+ ? []
473
+ : established.processingRegions.filter((region) => {
474
+ const territories = established.processingRegionTerritories?.[region];
475
+ return territories !== undefined && territoriesOutsideDataResidency(territories, params.residency).length === 0;
476
+ });
477
+ const placement = (outcome: ProviderDataResidencyPlacementOutcome): ProviderDataResidencyPlacement[] => [
478
+ { providerRef: assessment.providerRef, assessment, outcome, regionsInside },
479
+ ];
480
+ switch (assessment.status) {
481
+ case ProviderDataResidencyStatus.NO_ESTABLISHED_PROFILE:
482
+ return placement(ProviderDataResidencyPlacementOutcome.NO_ESTABLISHED_PROFILE);
483
+ case ProviderDataResidencyStatus.OUTSIDE:
484
+ case ProviderDataResidencyStatus.TERRITORY_UNKNOWN:
485
+ case ProviderDataResidencyStatus.DEPLOYMENT_MODEL_NOT_OFFERED:
486
+ // Never produced by the assessment above (it is the call-time verdict); an authored statement if it were.
487
+ case ProviderDataResidencyStatus.ACCOUNT_REGION_UNSTATED:
488
+ return placement(ProviderDataResidencyPlacementOutcome.AUTHORED_CHOICE_NOT_INSIDE);
489
+ case ProviderDataResidencyStatus.NO_CHOICE:
490
+ case ProviderDataResidencyStatus.REGION_NOT_CHOSEN: {
491
+ // NO_CHOICE with an established profile allows a vendor (an always-self-hosted provider is never assessed).
492
+ if (established === null) return placement(ProviderDataResidencyPlacementOutcome.NO_ESTABLISHED_PROFILE);
493
+ // A REGION_NOT_CHOSEN choice already says VENDOR_HOSTED; with no choice, offering self-hosting makes the model a choice.
494
+ if (assessment.status === ProviderDataResidencyStatus.NO_CHOICE && established.deploymentModels.includes(ProviderDeploymentModel.SELF_HOSTED)) {
495
+ return placement(ProviderDataResidencyPlacementOutcome.DEPLOYMENT_MODEL_IS_A_CHOICE);
496
+ }
497
+ if (regionsInside.length === 0) return placement(ProviderDataResidencyPlacementOutcome.NO_REGION_INSIDE);
498
+ if (regionsInside.length > 1) return placement(ProviderDataResidencyPlacementOutcome.SEVERAL_REGIONS_INSIDE);
499
+ return [{
500
+ providerRef: assessment.providerRef,
501
+ assessment,
502
+ outcome: ProviderDataResidencyPlacementOutcome.DERIVED,
503
+ regionsInside,
504
+ derivedChoice: { deploymentModel: ProviderDeploymentModel.VENDOR_HOSTED, processingRegion: regionsInside[0]! },
505
+ }];
506
+ }
507
+ }
508
+ });
509
+ }
510
+
511
+ /**
512
+ * The decision a placement leaves open, as one sentence naming the provider, why it is not placed and what settles it
513
+ * (#2294). The creation foundation reports it and `wildo context launch-blockers` lists it, so the two say the same
514
+ * thing. A {@link ProviderDataResidencyPlacementOutcome.DERIVED} placement leaves nothing open: it names the region
515
+ * written.
516
+ */
517
+ export function dataResidencyPlacementStatement(placement: ProviderDataResidencyPlacement, residency: ApplicationDataResidency): string {
518
+ const declared = residency.territories.join(', ');
519
+ const at = `providerComplianceChoices.${placement.providerRef}`;
520
+ const inside = placement.regionsInside.map((region) => `"${region}"`).join(', ');
521
+ switch (placement.outcome) {
522
+ case ProviderDataResidencyPlacementOutcome.DERIVED:
523
+ return `Provider "${placement.providerRef}" processes in region "${placement.derivedChoice?.processingRegion}", the only one of its regions inside the data residency (${declared}).`;
524
+ case ProviderDataResidencyPlacementOutcome.SEVERAL_REGIONS_INSIDE:
525
+ return `Provider "${placement.providerRef}" has several regions inside the data residency (${declared}): ${inside}. Choose one as ${at}.processingRegion (deploymentModel VENDOR_HOSTED).`;
526
+ case ProviderDataResidencyPlacementOutcome.NO_REGION_INSIDE:
527
+ return `Provider "${placement.providerRef}" has no region its profile states to process wholly inside the data residency (${declared}). `
528
+ + 'Replace it with a provider that does, run it self-hosted if it is offered that way, or widen the residency.';
529
+ case ProviderDataResidencyPlacementOutcome.DEPLOYMENT_MODEL_IS_A_CHOICE:
530
+ return `Provider "${placement.providerRef}" can be run by its vendor or by you: decide which as ${at}.deploymentModel`
531
+ + (placement.regionsInside.length === 0 ? ` (none of its vendor regions lies inside the data residency, ${declared}).` : ` (vendor regions inside the data residency, ${declared}: ${inside}).`);
532
+ case ProviderDataResidencyPlacementOutcome.AUTHORED_CHOICE_NOT_INSIDE:
533
+ return `${dataResidencyRefusalOf(placement.assessment, residency) ?? `${at} is not inside the data residency (${declared}).`}`
534
+ + (placement.regionsInside.length === 0 ? '' : ` Its regions inside: ${inside}.`);
535
+ case ProviderDataResidencyPlacementOutcome.NO_ESTABLISHED_PROFILE:
536
+ return `Provider "${placement.providerRef}" declares no established compliance profile, so nothing says where it processes and it cannot be `
537
+ + `placed inside the data residency (${declared}). Replace it, or remove it from the runtime scopes that serve the application's data.`;
538
+ }
539
+ }
540
+
541
+ /**
542
+ * The refusal one entry implies: a sentence naming the provider, what is wrong and the remedy; `null` for INSIDE. The
543
+ * configuration sync joins them ({@link dataResidencyRefusals}); the backend provider loader keeps one per provider, so
544
+ * the startup refusal names each.
545
+ */
546
+ export function dataResidencyRefusalOf(
547
+ entry: ProviderDataResidencyEntry,
548
+ residency: ApplicationDataResidency,
549
+ declarer: DataResidencyDeclarer = DataResidencyDeclarer.APPLICATION,
550
+ ): string | null {
551
+ const declared = declarer === DataResidencyDeclarer.ORGANIZATION
552
+ ? `${residency.territories.join(', ')}, the organization's`
553
+ : residency.territories.join(', ');
554
+ const widen = declarer === DataResidencyDeclarer.ORGANIZATION
555
+ ? 'or have the organization\'s administrator widen its dataResidency inside the application\'s.'
556
+ : 'or widen operatorComplianceIdentity.dataResidency.territories.';
557
+ const where = entry.processingRegion === null
558
+ ? `providerComplianceChoices.${entry.providerRef}`
559
+ : `providerComplianceChoices.${entry.providerRef}.processingRegion "${entry.processingRegion}"`;
560
+ switch (entry.status) {
561
+ case ProviderDataResidencyStatus.INSIDE:
562
+ return null;
563
+ case ProviderDataResidencyStatus.OUTSIDE:
564
+ return `${where} processes in ${entry.outsideTerritories.join(', ')}, outside the declared data residency (${declared}). `
565
+ + `Choose a region inside it, run the provider self-hosted, ${widen}`;
566
+ case ProviderDataResidencyStatus.TERRITORY_UNKNOWN:
567
+ return `${where}: provider "${entry.providerRef}" does not state which places that region processes in, so it cannot be shown to stay inside `
568
+ + `the declared data residency (${declared}). Choose a region its profile maps to places (processingRegionTerritories), or remove the provider.`;
569
+ case ProviderDataResidencyStatus.NO_ESTABLISHED_PROFILE:
570
+ return `${where}: provider "${entry.providerRef}" declares no established compliance profile, so nothing says where it processes, and it `
571
+ + `cannot be shown to stay inside the declared data residency (${declared}).`;
572
+ case ProviderDataResidencyStatus.NO_CHOICE:
573
+ return `provider "${entry.providerRef}" is declared on a runtime that serves the application's data, but ${where} does not exist, so nothing `
574
+ + `says where its calls go and it cannot be shown to stay inside the declared data residency (${declared}). Declare its deploymentModel `
575
+ + 'and processingRegion there, or remove the provider from the runtime scopes.';
576
+ case ProviderDataResidencyStatus.REGION_NOT_CHOSEN:
577
+ return `${where} is VENDOR_HOSTED and names no processingRegion, so it cannot be shown to stay inside the declared data residency (${declared}).`;
578
+ case ProviderDataResidencyStatus.ACCOUNT_REGION_UNSTATED:
579
+ return `provider "${entry.providerRef}" would be called through an organization's or a person's own connected account, whose region that `
580
+ + `account decides and no connection records, so the call cannot be shown to stay inside the data residency (${declared}). Call it `
581
+ + 'through the application\'s own connection, whose region providerComplianceChoices states.';
582
+ case ProviderDataResidencyStatus.DEPLOYMENT_MODEL_NOT_OFFERED:
583
+ return `${where} says SELF_HOSTED, but provider "${entry.providerRef}" is only offered vendor-hosted, so its data goes to the vendor and it `
584
+ + `cannot be shown to stay inside the declared data residency (${declared}). Declare the vendor region it processes in, or remove the provider.`;
585
+ }
586
+ }
587
+
588
+ /**
589
+ * One provider CALL made for an organization that declares its own residency, against the territories that apply to it
590
+ * ({@link effectiveDataResidencyTerritories}): the call-time half of #2294, applied by the backend's provider-call gate.
591
+ * `null` when the operator runs the provider (nothing leaves); otherwise the entry, refused unless INSIDE.
592
+ *
593
+ * - Through the APPLICATION's account, it is {@link assessProviderProcessingAgainstDataResidency}'s comparison over the
594
+ * application's choice for the provider, the one the configuration synchronisation and the loader apply.
595
+ * - Through an OWNER's account, the application's choice says nothing about where the call goes, and no connection
596
+ * records its account's region, so the call is refused ({@link ProviderDataResidencyStatus.ACCOUNT_REGION_UNSTATED})
597
+ * unless the provider is only ever self-hosted. Fail closed: a residency the tenant declared is not kept by trusting
598
+ * an account nobody placed. A connection that records the region its vendor reports for the account is the door that
599
+ * would admit such a call, and it does not exist yet.
600
+ *
601
+ * assurance-control: WILDO.PRIVACY.THIRD_PARTY_PROCESSING — a call for an organization that pinned its data to named
602
+ * places goes only to a processor whose chosen region processes inside them.
603
+ */
604
+ export function assessProviderCallAgainstDataResidency(params: {
605
+ readonly territories: readonly string[];
606
+ readonly providerRef: string;
607
+ readonly choice: ProviderDataResidencyChoice | undefined;
608
+ readonly profile: ProviderComplianceProfile | undefined;
609
+ readonly account: ProviderCallAccount;
610
+ }): ProviderDataResidencyEntry | null {
611
+ const residency: ApplicationDataResidency = { territories: [...params.territories] as ApplicationDataResidency['territories'] };
612
+ if (params.account === ProviderCallAccount.OWNER) {
613
+ const established = establishedProviderComplianceProfile(params.profile);
614
+ if (established !== null && providerIsAlwaysSelfHosted(established)) return null;
615
+ return { providerRef: params.providerRef, processingRegion: null, territories: null, outsideTerritories: [], status: ProviderDataResidencyStatus.ACCOUNT_REGION_UNSTATED };
616
+ }
617
+ return providerDataResidencyEntryOf({ providerRef: params.providerRef, choice: params.choice, profile: params.profile, residency });
618
+ }
619
+
620
+ /**
621
+ * Why calling `model` would process outside the region the application declared for the provider, as one sentence naming
622
+ * the remedy; `null` when it stays inside, when no region is declared, or when the profile declares no model-id routing
623
+ * (#2294). The id's routing is the prefix it starts with, from the profile's `modelIdRouting.routingPrefixes`; an id
624
+ * naming none is sent where the region's endpoint is, and is inside.
625
+ *
626
+ * Applied twice from the one rule: when an agent is registered (startup), with the region the host's artifact binds the
627
+ * provider to, and by the provider's client when it builds the model (call time), with the region the loader bound it to.
628
+ *
629
+ * assurance-control: WILDO.PRIVACY.THIRD_PARTY_PROCESSING — a model id cannot route a call out of the region the
630
+ * application declared for its processor.
631
+ */
632
+ export function modelIdProcessingRegionRefusal(input: {
633
+ readonly providerRef: string;
634
+ readonly profile: ProviderComplianceProfile | undefined;
635
+ readonly processingRegion: string | undefined;
636
+ readonly model: string;
637
+ }): string | null {
638
+ if (input.processingRegion === undefined) return null;
639
+ const routing = establishedProviderComplianceProfile(input.profile)?.modelIdRouting;
640
+ if (routing === undefined) return null;
641
+ const prefix = routing.routingPrefixes.find((candidate) => input.model.startsWith(candidate));
642
+ if (prefix === undefined) return null;
643
+ const admitted = Object.hasOwn(routing.admittedByRegion, input.processingRegion) ? routing.admittedByRegion[input.processingRegion]! : [];
644
+ if (admitted.includes(prefix)) return null;
645
+ return `model "${input.model}" names its own routing ("${prefix}"), which takes provider "${input.providerRef}"'s calls outside the region `
646
+ + `the application declares for it (providerComplianceChoices.${input.providerRef}.processingRegion "${input.processingRegion}"`
647
+ + (admitted.length > 0 ? `, which admits ${admitted.join(', ')}` : ', which admits no routing prefix')
648
+ + '). Name the model without a routing prefix, so the region\'s endpoint routes it, or declare the region that model id routes within.';
649
+ }
650
+
651
+ /** Every refusal {@link assessProviderProcessingAgainstDataResidency} implies. Empty when every provider is inside. `wildo config sync` throws on any. */
652
+ export function dataResidencyRefusals(entries: readonly ProviderDataResidencyEntry[], residency: ApplicationDataResidency): readonly string[] {
653
+ return entries.flatMap((entry) => {
654
+ const refusal = dataResidencyRefusalOf(entry, residency);
655
+ return refusal === null ? [] : [refusal];
656
+ });
657
+ }
658
+
659
+ /**
660
+ * What a runtime's provider artifact carries so the runtime can re-apply the residency (#2294): the declared territories,
661
+ * and the choice of every provider that runtime declares (narrowed to them). Written by `wildo config sync` for the hosts
662
+ * that load providers to serve the application's data (backend, minions, node workers); absent when no residency is
663
+ * declared, which keeps every artifact of an application without one byte-identical.
664
+ *
665
+ * Inputs rather than a verdict: the loader decides with the profiles of the modules it actually loaded, so a provider
666
+ * package upgraded after the sync (a region remapped, a profile withdrawn) is judged on what runs, not on what sync saw.
667
+ */
668
+ export const RuntimeProviderDataResidencySchema = z.strictObject({
669
+ territories: z.array(JurisdictionSlugSchema).min(1),
670
+ choices: z.record(z.string().min(1), z.strictObject({
671
+ deploymentModel: z.enum(ProviderDeploymentModel),
672
+ processingRegion: z.string().min(1).optional(),
673
+ })),
674
+ });
675
+ export type RuntimeProviderDataResidency = z.infer<typeof RuntimeProviderDataResidencySchema>;
676
+
677
+ /** The {@link RuntimeProviderDataResidency} one runtime artifact carries, or `undefined` when no residency is declared. */
678
+ export function runtimeProviderDataResidencyFor(input: {
679
+ readonly residency: ApplicationDataResidency | undefined;
680
+ readonly choices: ApplicationProviderComplianceChoices | undefined;
681
+ readonly providerRefs: readonly string[];
682
+ }): RuntimeProviderDataResidency | undefined {
683
+ if (input.residency === undefined) return undefined;
684
+ const choices = input.choices ?? {};
685
+ return {
686
+ territories: [...input.residency.territories],
687
+ choices: Object.fromEntries([...new Set(input.providerRefs)].sort((left, right) => left.localeCompare(right))
688
+ .filter((providerRef) => Object.hasOwn(choices, providerRef))
689
+ .map((providerRef) => {
690
+ const choice = choices[providerRef]!;
691
+ return [providerRef, {
692
+ deploymentModel: choice.deploymentModel,
693
+ ...(choice.processingRegion !== undefined ? { processingRegion: choice.processingRegion } : {}),
694
+ }];
695
+ })),
696
+ };
697
+ }
698
+
699
+ /**
700
+ * A multi-scope artifact's residency narrowed to one host's providers (a minion's, a node worker's). The territories stay;
701
+ * the choices keep only the host's refs, as every other per-host projection does. `undefined` stays `undefined`, so a
702
+ * host projecting an artifact that carries no residency carries none either.
703
+ */
704
+ export function narrowRuntimeProviderDataResidency(
705
+ runtime: RuntimeProviderDataResidency | undefined,
706
+ providerRefs: readonly string[],
707
+ ): RuntimeProviderDataResidency | undefined {
708
+ if (runtime === undefined) return undefined;
709
+ return {
710
+ territories: [...runtime.territories],
711
+ choices: Object.fromEntries(Object.entries(runtime.choices).filter(([providerRef]) => providerRefs.includes(providerRef))),
712
+ };
713
+ }
714
+
715
+ /**
716
+ * The residency a runtime re-applies at load, over the providers it loaded: `providerRef` -> the refusal, for every one
717
+ * that is not inside. The backend provider loader leaves each unresolved, so startup refuses naming it.
718
+ */
719
+ export function runtimeDataResidencyRefusalsByProvider(input: {
720
+ readonly runtime: RuntimeProviderDataResidency;
721
+ readonly providerRefs: readonly string[];
722
+ readonly profilesByProviderRef: Readonly<Record<string, ProviderComplianceProfile | undefined>>;
723
+ }): ReadonlyMap<string, string> {
724
+ const residency: ApplicationDataResidency = { territories: input.runtime.territories };
725
+ const refusals = new Map<string, string>();
726
+ // Only the providers this host LOADED: a choice for one that failed to load for another reason must not replace that
727
+ // reason, and a provider that is not loaded receives no call.
728
+ for (const entry of assessProviderProcessingAgainstDataResidency({
729
+ residency,
730
+ choices: narrowRuntimeProviderDataResidency(input.runtime, input.providerRefs)?.choices,
731
+ profilesByProviderRef: input.profilesByProviderRef,
732
+ providerRefs: input.providerRefs,
733
+ })) {
734
+ const refusal = dataResidencyRefusalOf(entry, residency);
735
+ if (refusal !== null) refusals.set(entry.providerRef, refusal);
736
+ }
737
+ return refusals;
738
+ }
739
+ ```
740
+
741
+ ## Import Origins
742
+
743
+ - `@wildo-ai/saas-models`
744
+
745
+ ## Source Excerpts
746
+
747
+ ### Origin Package: `@wildo-ai/saas-models`
748
+
749
+ ```typescript
750
+ /**
751
+ * HOW a provider's processing region is reached — which decides whether an application's region choice is something the
752
+ * product DOES or something the operator ATTESTS (#3513).
753
+ *
754
+ * A region in `processingRegions` used to be a label and nothing more: Your Application chose Mistral `EU` while every call
755
+ * went to Mistral's global host, so the processor register stated a location the product did not use. A vendor offers a
756
+ * region in one of two ways, and they are different claims:
757
+ *
758
+ * - by ENDPOINT: each region has its own host, and the host a call goes to IS the region. The application's choice
759
+ * selects that host, so the region is enforced by the product, and a choice the vendor cannot be reached in is a
760
+ * configuration error, refused when the configuration is loaded rather than dialled at the global host.
761
+ * - by ACCOUNT RESIDENCY: the region was fixed when the operator created its account (or domain, workspace, project) at
762
+ * the vendor, and every call goes to the same host. No call selects it, so the application's choice is the operator's
763
+ * statement about that account, and a reader must say so rather than present it as enforced.
764
+ *
765
+ * - by REQUEST PARAMETER: every region shares one host, and each request names the region it must run in (Anthropic's
766
+ * `inference_geo`). The application's choice sets that parameter on every request, so the region is enforced per call
767
+ * exactly as an endpoint is, but by the body rather than the host. A choice the vendor cannot serve is refused the same
768
+ * way.
769
+ *
770
+ * An ENDPOINT region may name its host in two ways, per protocol arm: a fixed base URL (Mistral's `api.eu.mistral.ai`),
771
+ * or, for an arm whose host is a per-account placeholder admitted through `baseUrlHostAllowances`, the ANSWER the
772
+ * application's own account gives to that placeholder's question (Intercom's EU login host, from which its EU API host
773
+ * is derived). The second is still the endpoint: the answer passes the same host allowance a connected account's
774
+ * answer passes, on every call.
775
+ */
776
+ export enum ProviderProcessingRegionReachKind {
777
+ /** The region has its own endpoint, and the application's choice selects it: enforced by what the product calls. */
778
+ ENDPOINT = 'endpoint',
779
+ /**
780
+ * The region is named by a parameter of every request (one host for all regions), and the application's choice sets
781
+ * it: enforced by what the product sends.
782
+ */
783
+ REQUEST_PARAMETER = 'request-parameter',
784
+ /** The region is where the operator's account at the vendor lives; no call selects it: attested by the operator. */
785
+ ACCOUNT_RESIDENCY = 'account-residency',
786
+ }
787
+
788
+ /**
789
+ * True for a reach the PRODUCT enforces (every call goes to the region's endpoint, or names the region), false for one the
790
+ * operator attests. The one reading the companion brief, the evidence collector and the sync share, so an enforced kind
791
+ * added to {@link ProviderProcessingRegionReachKind} is enforced everywhere at once.
792
+ */
793
+ export function processingRegionReachIsEnforced(kind: ProviderProcessingRegionReachKind): boolean {
794
+ switch (kind) {
795
+ case ProviderProcessingRegionReachKind.ENDPOINT:
796
+ case ProviderProcessingRegionReachKind.REQUEST_PARAMETER:
797
+ return true;
798
+ case ProviderProcessingRegionReachKind.ACCOUNT_RESIDENCY:
799
+ return false;
800
+ }
801
+ }
802
+
803
+ /**
804
+ * How a region an application chose for a provider HOLDS, in the words a document states it (#3513). Three answers, and a
805
+ * reader must not round one into another: a region the product enforces is a property of the product, a region the
806
+ * operator attests is a statement about its account, and a region nothing says how it is reached is the operator's claim
807
+ * only.
808
+ */
809
+ export enum ProcessingRegionHolding {
810
+ /** Every call goes to the region's endpoint, or names the region ({@link processingRegionReachIsEnforced}). */
811
+ ENFORCED = 'enforced',
812
+ /** The region is where the operator's account at the vendor lives, as the operator states it; no call selects it. */
813
+ ATTESTED = 'attested',
814
+ /** The provider does not say how the region is reached (no reach declared, or a region it does not list). */
815
+ NEITHER = 'neither',
816
+ }
817
+
818
+ /**
819
+ * The {@link ProcessingRegionHolding} of a chosen region, from its reach kind (`null` when none is declared). The one
820
+ * reading the companion brief and the computed document facts share, so the two cannot state a region differently.
821
+ */
822
+ export function processingRegionHoldingOf(reach: ProviderProcessingRegionReachKind | null): ProcessingRegionHolding {
823
+ if (reach === null) return ProcessingRegionHolding.NEITHER;
824
+ return processingRegionReachIsEnforced(reach) ? ProcessingRegionHolding.ENFORCED : ProcessingRegionHolding.ATTESTED;
825
+ }
826
+
827
+ /** One value an AI-SDK `providerOptions` entry may carry (the shape the vendor's SDK reads). */
828
+ const ProcessingRegionSdkOptionValueSchema = z.union([z.string(), z.number(), z.boolean()]);
829
+
830
+ /**
831
+ * How ONE region is reached. Every map is keyed by the provider's protocol arms (its `protocols[].protocol`, e.g.
832
+ * `LLM_PROVIDER`, `DOCUMENT_EXTRACTION_PROVIDER`), because a vendor's operation families can live on different hosts.
833
+ *
834
+ * - {@link ProviderProcessingRegionReachKind.ENDPOINT}: `baseUrls` gives each arm with a fixed host the base URL it calls
835
+ * in this region; `applicationConnectionAnswers` gives an arm whose host is a per-account placeholder the answer the
836
+ * APPLICATION's own account gives in this region (each name one the arm's `applicationConnectionAnswers` declares), and
837
+ * that answer passes the arm's `baseUrlHostAllowances` on every call. A connected person's or organization's account
838
+ * keeps its own answers: the region is the operator's processing, not theirs. Every arm with a fixed base URL must be
839
+ * covered one way or the other; the backend provider composition refuses a module that leaves one out.
840
+ * An arm whose host is the operator's own deployment slot (`baseUrlHostEnvVarName`) may be named in `baseUrls` too, when
841
+ * the vendor derives the host from the region alone (AWS: `bedrock-runtime.<region>.amazonaws.com`): the region then
842
+ * SELECTS the slot's value instead of the deployment authoring it, and a deployment value naming another host is
843
+ * refused. Such an arm that SIGNS with the region (AWS SigV4) names it in `requestSigningRegions`, so the signature is
844
+ * scoped to the host it is sent to. A host slot that names a resource rather than a region (Azure's
845
+ * `<resource>.openai.azure.com`) cannot be derived from a region, so a region there is ACCOUNT_RESIDENCY.
846
+ * - {@link ProviderProcessingRegionReachKind.REQUEST_PARAMETER}: `sdkProviderOptions` gives each AI-SDK arm the
847
+ * `providerOptions` every model it builds sends (`{ anthropic: { inferenceGeo: 'us' } }`), set by the engine on every
848
+ * request and never overridden by a call. Every arm with an `sdkFactory` must be covered.
849
+ * - {@link ProviderProcessingRegionReachKind.ACCOUNT_RESIDENCY}: nothing to name.
850
+ */
851
+ export const ProviderProcessingRegionReachSchema = z.discriminatedUnion('kind', [
852
+ z.strictObject({
853
+ kind: z.literal(ProviderProcessingRegionReachKind.ENDPOINT),
854
+ baseUrls: z.record(z.string().trim().min(1), z.url({ protocol: /^https$/ })).optional(),
855
+ applicationConnectionAnswers: z.record(z.string().trim().min(1), z.record(z.string().trim().min(1), z.string().trim().min(1))).optional(),
856
+ /** Per arm that signs its requests with the region (AWS SigV4), the region its signature is scoped to here. */
857
+ requestSigningRegions: z.record(z.string().trim().min(1), z.string().trim().min(1)).optional(),
858
+ }).refine(
859
+ (entry) => Object.keys(entry.baseUrls ?? {}).length + Object.keys(entry.applicationConnectionAnswers ?? {}).length > 0,
860
+ { message: 'an endpoint-reached region names, for at least one protocol arm, its base URL or its application account\'s host answer' },
861
+ ),
862
+ z.strictObject({
863
+ kind: z.literal(ProviderProcessingRegionReachKind.REQUEST_PARAMETER),
864
+ sdkProviderOptions: z.record(z.string().trim().min(1), z.record(z.string().trim().min(1), z.record(z.string().trim().min(1), ProcessingRegionSdkOptionValueSchema)))
865
+ .refine((options) => Object.keys(options).length > 0, { message: 'a request-parameter region names the provider options of at least one protocol arm' }),
866
+ }),
867
+ z.strictObject({ kind: z.literal(ProviderProcessingRegionReachKind.ACCOUNT_RESIDENCY) }),
868
+ ]);
869
+ export type ProviderProcessingRegionReach = z.infer<typeof ProviderProcessingRegionReachSchema>;
870
+ ```
871
+
28
872
  ## Import Origins
29
873
 
30
874
  - `@wildo-ai/saas-models`
@@ -191,6 +1035,19 @@ export interface ProviderComplianceChoiceAssessmentEntry {
191
1035
  readonly assessment: ProviderComplianceChoiceAssessment;
192
1036
  /** What the provider offers, when established — so a report can name both sides of a divergence. */
193
1037
  readonly offered: { readonly deploymentModels: readonly ProviderDeploymentModel[]; readonly processingRegions: readonly string[] } | null;
1038
+ /**
1039
+ * How the chosen region is reached (#3513): `ENDPOINT` means the product calls that region's host and `REQUEST_PARAMETER`
1040
+ * that every request names the region, so the region is ENFORCED ({@link processingRegionReachIsEnforced});
1041
+ * `ACCOUNT_RESIDENCY` means it is the operator's statement about its account, so it is ATTESTED. `null` when
1042
+ * no region is chosen, the provider declares no reach, or the region is not one it lists — a reader then says the
1043
+ * region is neither.
1044
+ */
1045
+ readonly regionReach: ProviderProcessingRegionReachKind | null;
1046
+ /**
1047
+ * The places the chosen region processes in, from the profile's `processingRegionTerritories` (#2294). `null` when no
1048
+ * region is chosen or the profile does not map it.
1049
+ */
1050
+ readonly regionTerritories: readonly string[] | null;
194
1051
  }
195
1052
 
196
1053
  /** Assess ONE choice against the provider's profile. See {@link ProviderComplianceChoiceAssessment}. */
@@ -232,6 +1089,8 @@ export function assessProviderComplianceChoices(params: {
232
1089
  choice,
233
1090
  assessment: assessProviderComplianceChoice(choice, params.profilesByProviderRef[providerRef]),
234
1091
  offered: established === null ? null : { deploymentModels: established.deploymentModels, processingRegions: established.processingRegions },
1092
+ regionReach: choice.processingRegion === undefined ? null : established?.processingRegionReach?.[choice.processingRegion]?.kind ?? null,
1093
+ regionTerritories: choice.processingRegion === undefined ? null : established?.processingRegionTerritories?.[choice.processingRegion] ?? null,
235
1094
  };
236
1095
  });
237
1096
  }