@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
@@ -0,0 +1,676 @@
1
+ # saas.models.privacy.data-residency
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-models`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-models`
10
+
11
+ ```typescript
12
+ /**
13
+ * WHERE an application's data may be stored and processed, as places the framework can compare (#2294).
14
+ *
15
+ * `territories` are jurisdiction slugs (`eu`, `de`, `ch`, `us`), the vocabulary `operatingJurisdictions` uses, so a
16
+ * provider's processing region can be checked against them: `eu` contains every EU member state, and a slug contains its
17
+ * own subdivisions (`us` contains `us-ca`). The EEA is spelled out (`eu`, `is`, `li`, `no`), because the grammar has no
18
+ * regime suffix.
19
+ *
20
+ * ## Two places, kept apart
21
+ *
22
+ * - **The application's OWN data store** (its databases, object storage, backups) runs on the operator's infrastructure.
23
+ * Where that is stays `hostingRegions`, in the operator's words, and declaring a residency is the operator's statement
24
+ * that the store lies inside `territories`. The framework cannot measure it: no deployment says which country a
25
+ * database volume is in.
26
+ * - **Each vendor that processes the data** (`providerComplianceChoices.<ref>`, `VENDOR_HOSTED`) processes in the region
27
+ * the application chose, and the provider's profile maps that region to the places it covers
28
+ * (`processingRegionTerritories`). That is measured: `wildo config sync` refuses a vendor region outside
29
+ * `territories`, and refuses a region whose places the profile does not state, before any artifact is written.
30
+ *
31
+ * Opt-in. Absent means the application states no residency and nothing is refused, which is not the same as "anywhere":
32
+ * the documents then say no residency is declared.
33
+ */
34
+ export const ApplicationDataResidencySchema = z
35
+ .strictObject({
36
+ /** 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. */
37
+ territories: z.array(JurisdictionSlugSchema).min(1),
38
+ })
39
+ .superRefine((residency, context) => {
40
+ const duplicates = residency.territories.filter((territory, index) => residency.territories.indexOf(territory) !== index);
41
+ if (duplicates.length > 0) {
42
+ context.addIssue({
43
+ code: 'custom',
44
+ path: ['territories'],
45
+ message: `data residency territory ${[...new Set(duplicates)].map((slug) => `"${slug}"`).join(', ')} is declared more than once`,
46
+ });
47
+ }
48
+ });
49
+ export type ApplicationDataResidency = z.infer<typeof ApplicationDataResidencySchema>;
50
+
51
+ /**
52
+ * WHERE one organization's data may be processed, narrower than the application's (#2294): a tenant pinned to `de` inside
53
+ * an application whose residency is `eu`. Stored on the organization (`Organization.dataResidency`), written by the
54
+ * tenant's administrator, and applied to every provider call made for that organization, where the application's own
55
+ * residency is applied when the configuration is synchronised and when a runtime loads its providers.
56
+ *
57
+ * The same shape as {@link ApplicationDataResidencySchema} and a different statement: the application's says where the
58
+ * product may process anyone's data, an organization's says where it may process this tenant's. Kept as its own name so a
59
+ * reader never takes one for the other.
60
+ *
61
+ * ## It only ever narrows, which is why the application must declare one first
62
+ *
63
+ * {@link organizationDataResidencyRefusal} refuses an organization residency that the application's does not contain,
64
+ * and refuses one when the application declares none. Both follow from what a narrowing is. A territory outside the
65
+ * application's would promise the tenant a place the product never undertook to keep the data in. With no application
66
+ * residency, nothing has placed the providers: their choices may name no region, and no synchronisation has checked
67
+ * them, so a call-time check would refuse on statements nobody made. Declaring the application's residency is the step
68
+ * that places them, and the refusal names it.
69
+ */
70
+ export const OrganizationDataResidencySchema = ApplicationDataResidencySchema;
71
+ export type OrganizationDataResidency = z.infer<typeof OrganizationDataResidencySchema>;
72
+
73
+ /**
74
+ * Why an organization's residency cannot be accepted, as a sentence naming the remedy; `null` when it narrows the
75
+ * application's. Applied where the organization writes it, so a stored residency is always inside the application's
76
+ * (a later narrowing of the APPLICATION's residency can still leave a stored one wider; the call-time check then applies
77
+ * both, see {@link effectiveDataResidencyTerritories}).
78
+ */
79
+ export function organizationDataResidencyRefusal(
80
+ application: ApplicationDataResidency | undefined,
81
+ organization: OrganizationDataResidency,
82
+ ): string | null {
83
+ if (application === undefined) {
84
+ return 'The application declares no data residency (operatorComplianceIdentity.dataResidency), so an organization has none to '
85
+ + 'narrow: nothing has placed its providers in named places. Declare the application\'s residency first.';
86
+ }
87
+ const outside = organization.territories.filter((territory) => !application.territories.some((resident) => jurisdictionReachCovers(resident, territory)));
88
+ if (outside.length === 0) return null;
89
+ return `The organization's data residency names ${outside.join(', ')}, outside the application's (${application.territories.join(', ')}). `
90
+ + 'An organization can only narrow the application\'s residency: name places inside it.';
91
+ }
92
+
93
+ /**
94
+ * The territories an organization may name in its residency (#2294): each of the application's own, and every
95
+ * jurisdiction an aggregate one contains (`eu` offers `eu` and each member state). What the organization's settings
96
+ * offer as its choices, so an administrator picks inside the application's residency rather than typing a slug the
97
+ * update then refuses. Empty when the application declares none: there is nothing to narrow.
98
+ *
99
+ * Subdivisions (`us-ca` inside `us`) are not listed, because nothing enumerates them; the update still admits one,
100
+ * since containment is computed rather than looked up.
101
+ */
102
+ export function organizationDataResidencyAdmissibleTerritories(application: ApplicationDataResidency | undefined): readonly string[] {
103
+ if (application === undefined) return [];
104
+ const admissible = new Set<string>();
105
+ for (const territory of application.territories) {
106
+ admissible.add(territory);
107
+ for (const member of JURISDICTION_CONTAINMENT[territory] ?? []) admissible.add(member);
108
+ }
109
+ return [...admissible];
110
+ }
111
+
112
+ /**
113
+ * The DI key of the backend service that holds the application's declared residency as this host's artifact carries
114
+ * it (`BackendProviderRegistryBackendService.getDataResidency`). Named here so a shared virtual field can read it through
115
+ * the calculation utilities' `getService`; the backend's service-type symbol is `Symbol.for` of this string, which a
116
+ * backend test holds equal.
117
+ */
118
+ export const BACKEND_PROVIDER_REGISTRY_SERVICE_KEY = 'SaaS.BackendProviderRegistryService';
119
+
120
+ /**
121
+ * The territories a call for an organization must stay inside: every place both residencies contain, as the narrower of
122
+ * each pair. An organization residency stored when the application's was wider can outlive a later narrowing of the
123
+ * application's, so the call-time check never trusts the stored value alone.
124
+ *
125
+ * `undefined` when the organization declares none (the application's residency is then applied where it already is, at
126
+ * synchronisation and at load). An empty list when the two share no place: every provider is then outside.
127
+ */
128
+ export function effectiveDataResidencyTerritories(
129
+ application: ApplicationDataResidency | undefined,
130
+ organization: OrganizationDataResidency | null | undefined,
131
+ ): readonly string[] | undefined {
132
+ if (organization === null || organization === undefined) return undefined;
133
+ if (application === undefined) return [...organization.territories];
134
+ const kept = new Set<string>();
135
+ for (const territory of organization.territories) {
136
+ for (const resident of application.territories) {
137
+ if (jurisdictionReachCovers(resident, territory)) kept.add(territory);
138
+ else if (jurisdictionReachCovers(territory, resident)) kept.add(resident);
139
+ }
140
+ }
141
+ return [...kept].sort((left, right) => left.localeCompare(right));
142
+ }
143
+ ```
144
+
145
+ ### Origin Package: `@wildo-ai/saas-models`
146
+
147
+ ```typescript
148
+ /**
149
+ * Where one provider stands against an application's declared data residency (#2294). Each answer is a different piece of
150
+ * work, and only INSIDE is not refused.
151
+ */
152
+ export enum ProviderDataResidencyStatus {
153
+ /** Every place the chosen region processes in lies inside the residency. */
154
+ INSIDE = 'inside',
155
+ /** The chosen region processes in at least one place outside the residency. */
156
+ OUTSIDE = 'outside',
157
+ /** The profile does not state which places the chosen region covers (a global region, or a map not yet researched). */
158
+ TERRITORY_UNKNOWN = 'territory-unknown',
159
+ /** The provider declares no established profile, so nothing says where it processes. */
160
+ NO_ESTABLISHED_PROFILE = 'no-established-profile',
161
+ /**
162
+ * A runtime that serves the application's data declares the provider, its profile allows a vendor to run it, and
163
+ * `providerComplianceChoices` says nothing about it: nobody stated where its calls go.
164
+ */
165
+ NO_CHOICE = 'no-choice',
166
+ /** The choice is VENDOR_HOSTED and names no region (the configuration schema refuses this; a runtime input may still carry it). */
167
+ REGION_NOT_CHOSEN = 'region-not-chosen',
168
+ /** The choice says SELF_HOSTED, but the provider is only offered vendor-hosted, so its data goes to the vendor anyway. */
169
+ DEPLOYMENT_MODEL_NOT_OFFERED = 'deployment-model-not-offered',
170
+ /**
171
+ * The call spends an organization's or a person's OWN vendor account (a connection they own), whose region that
172
+ * account decides and nothing records. The application's `providerComplianceChoices` describe its own account, never
173
+ * theirs, so the call cannot be shown to stay inside an organization's residency (#2294). Only ever produced by
174
+ * {@link assessProviderCallAgainstDataResidency}.
175
+ */
176
+ ACCOUNT_REGION_UNSTATED = 'account-region-unstated',
177
+ }
178
+
179
+ /**
180
+ * Why a provider call was refused under an organization's data residency (#2294), as the refusal's audit row records it:
181
+ * every {@link ProviderDataResidencyStatus} that is not INSIDE, by the same value, and one cause the status vocabulary
182
+ * cannot express because nothing was assessed: the organization's residency could not be read, so the call was refused
183
+ * rather than sent.
184
+ */
185
+ export enum ProviderDataResidencyRefusalReason {
186
+ OUTSIDE = ProviderDataResidencyStatus.OUTSIDE,
187
+ TERRITORY_UNKNOWN = ProviderDataResidencyStatus.TERRITORY_UNKNOWN,
188
+ NO_ESTABLISHED_PROFILE = ProviderDataResidencyStatus.NO_ESTABLISHED_PROFILE,
189
+ NO_CHOICE = ProviderDataResidencyStatus.NO_CHOICE,
190
+ REGION_NOT_CHOSEN = ProviderDataResidencyStatus.REGION_NOT_CHOSEN,
191
+ DEPLOYMENT_MODEL_NOT_OFFERED = ProviderDataResidencyStatus.DEPLOYMENT_MODEL_NOT_OFFERED,
192
+ ACCOUNT_REGION_UNSTATED = ProviderDataResidencyStatus.ACCOUNT_REGION_UNSTATED,
193
+ /** The organization the call was made for could not be read, so whether it pins its data is unknown. */
194
+ RESIDENCY_UNREADABLE = 'residency-unreadable',
195
+ }
196
+
197
+ /** Who declared the residency a refusal is about, which decides the remedy it names (#2294). */
198
+ export enum DataResidencyDeclarer {
199
+ /** `operatorComplianceIdentity.dataResidency`, checked at synchronisation and at load. */
200
+ APPLICATION = 'application',
201
+ /** `Organization.dataResidency`, checked on every provider call made for that organization. */
202
+ ORGANIZATION = 'organization',
203
+ }
204
+
205
+ /**
206
+ * Whose vendor account a provider call spends (#2294). Two answers, because they are two different statements about
207
+ * where the call goes: the application's account is where its `providerComplianceChoices` say, an owner's account is
208
+ * wherever that owner created it.
209
+ */
210
+ export enum ProviderCallAccount {
211
+ /** The application's own credential (its deployment secret, or an APPLICATION-owned connection). */
212
+ APPLICATION = 'application',
213
+ /** An ORGANIZATION- or USER-owned connection: the tenant's or the person's own vendor account. */
214
+ OWNER = 'owner',
215
+ }
216
+
217
+ /** One provider, assessed against the residency. */
218
+ export interface ProviderDataResidencyEntry {
219
+ readonly providerRef: string;
220
+ /** The region chosen for it; `null` when no choice names one ({@link ProviderDataResidencyStatus.NO_CHOICE} and the like). */
221
+ readonly processingRegion: string | null;
222
+ /** The places the region covers, from the profile; `null` when it states none. */
223
+ readonly territories: readonly string[] | null;
224
+ /** The places outside the residency, for {@link ProviderDataResidencyStatus.OUTSIDE}; empty otherwise. */
225
+ readonly outsideTerritories: readonly string[];
226
+ readonly status: ProviderDataResidencyStatus;
227
+ }
228
+
229
+ /** What the residency reads of a provider choice: who runs it, and in which region. */
230
+ export type ProviderDataResidencyChoice = Pick<ApplicationProviderComplianceChoice, 'deploymentModel' | 'processingRegion'>;
231
+
232
+ /**
233
+ * Every provider data can reach, assessed against the declared residency, sorted by provider ref. THE predicate: `wildo
234
+ * config sync` refuses on it, and the backend provider loader re-applies it to the modules it actually loaded, so a
235
+ * provider a call can be routed to at run time (the selected one, a `whenUnavailable` substitute, a `failover` provider,
236
+ * the one a per-environment override puts first) has passed it wherever it runs.
237
+ *
238
+ * The population is every provider with a choice AND every ref in `providerRefs` (the providers a runtime serving the
239
+ * application's data declares). A provider is not assessed (it is inside) when the operator runs it: a SELF_HOSTED choice
240
+ * the provider offers, or no choice and a profile that is only ever self-hosted. Everything else must name a vendor
241
+ * region whose places all lie inside; a declared provider no choice speaks for is refused rather than trusted, because
242
+ * nothing says where its calls go.
243
+ *
244
+ * Containment is `jurisdictionReachCovers`, the one operating-jurisdiction comparison: `eu` contains `de`, a slug contains
245
+ * its subdivisions, and `de` does not contain `eu`.
246
+ *
247
+ * assurance-control: WILDO.PRIVACY.THIRD_PARTY_PROCESSING — a processor whose chosen region covers a place outside the
248
+ * application's declared data residency, or whose places nothing states, is refused before the configuration is used and
249
+ * again before the runtime loads it.
250
+ */
251
+ export function assessProviderProcessingAgainstDataResidency(params: {
252
+ readonly residency: ApplicationDataResidency;
253
+ readonly choices: Readonly<Record<string, ProviderDataResidencyChoice>> | undefined;
254
+ readonly profilesByProviderRef: Readonly<Record<string, ProviderComplianceProfile | undefined>>;
255
+ /** The providers a runtime serving the application's data declares. Absent: only the providers with a choice. */
256
+ readonly providerRefs?: readonly string[];
257
+ }): readonly ProviderDataResidencyEntry[] {
258
+ const choices = params.choices ?? {};
259
+ const population = [...new Set([...Object.keys(choices), ...(params.providerRefs ?? [])])].sort((left, right) => left.localeCompare(right));
260
+ return population.flatMap((providerRef) => {
261
+ const entry = providerDataResidencyEntryOf({
262
+ providerRef,
263
+ choice: Object.hasOwn(choices, providerRef) ? choices[providerRef] : undefined,
264
+ profile: Object.hasOwn(params.profilesByProviderRef, providerRef) ? params.profilesByProviderRef[providerRef] : undefined,
265
+ residency: params.residency,
266
+ });
267
+ return entry === null ? [] : [entry];
268
+ });
269
+ }
270
+
271
+ /** One provider's entry, or `null` when the operator runs it. See {@link assessProviderProcessingAgainstDataResidency}. */
272
+ function providerDataResidencyEntryOf(input: {
273
+ readonly providerRef: string;
274
+ readonly choice: ProviderDataResidencyChoice | undefined;
275
+ readonly profile: ProviderComplianceProfile | undefined;
276
+ readonly residency: ApplicationDataResidency;
277
+ }): ProviderDataResidencyEntry | null {
278
+ const { providerRef, choice, residency } = input;
279
+ const established = establishedProviderComplianceProfile(input.profile);
280
+ const unplaced = (status: ProviderDataResidencyStatus): ProviderDataResidencyEntry => ({
281
+ providerRef, processingRegion: null, territories: null, outsideTerritories: [], status,
282
+ });
283
+ if (choice === undefined) {
284
+ if (established !== null && providerIsAlwaysSelfHosted(established)) return null;
285
+ return unplaced(established === null ? ProviderDataResidencyStatus.NO_ESTABLISHED_PROFILE : ProviderDataResidencyStatus.NO_CHOICE);
286
+ }
287
+ if (choice.deploymentModel === ProviderDeploymentModel.SELF_HOSTED) {
288
+ return established !== null && !established.deploymentModels.includes(ProviderDeploymentModel.SELF_HOSTED)
289
+ ? unplaced(ProviderDataResidencyStatus.DEPLOYMENT_MODEL_NOT_OFFERED)
290
+ : null;
291
+ }
292
+ if (choice.processingRegion === undefined) return unplaced(ProviderDataResidencyStatus.REGION_NOT_CHOSEN);
293
+ return vendorRegionDataResidencyEntry({
294
+ providerRef,
295
+ processingRegion: choice.processingRegion,
296
+ profileEstablished: established !== null,
297
+ regionTerritories: established?.processingRegionTerritories?.[choice.processingRegion] ?? null,
298
+ residency,
299
+ });
300
+ }
301
+
302
+ /** A vendor-hosted choice that names a region, against the residency: the one comparison both derivations below share. */
303
+ function vendorRegionDataResidencyEntry(input: {
304
+ readonly providerRef: string;
305
+ readonly processingRegion: string;
306
+ readonly profileEstablished: boolean;
307
+ readonly regionTerritories: readonly string[] | null;
308
+ readonly residency: ApplicationDataResidency;
309
+ }): ProviderDataResidencyEntry {
310
+ const base = { providerRef: input.providerRef, processingRegion: input.processingRegion };
311
+ if (!input.profileEstablished) {
312
+ return { ...base, territories: null, outsideTerritories: [], status: ProviderDataResidencyStatus.NO_ESTABLISHED_PROFILE };
313
+ }
314
+ if (input.regionTerritories === null) {
315
+ return { ...base, territories: null, outsideTerritories: [], status: ProviderDataResidencyStatus.TERRITORY_UNKNOWN };
316
+ }
317
+ const outsideTerritories = territoriesOutsideDataResidency(input.regionTerritories, input.residency);
318
+ return {
319
+ ...base,
320
+ territories: [...input.regionTerritories],
321
+ outsideTerritories,
322
+ status: outsideTerritories.length === 0 ? ProviderDataResidencyStatus.INSIDE : ProviderDataResidencyStatus.OUTSIDE,
323
+ };
324
+ }
325
+
326
+ /**
327
+ * The vendor-hosted choices among choices ALREADY assessed ({@link assessProviderComplianceChoices}), against the
328
+ * residency, for a reader that holds the assessments rather than the profiles (the recipient population, and the document
329
+ * fact built on it). The comparison is {@link assessProviderProcessingAgainstDataResidency}'s, so the refusal and the
330
+ * notice cannot disagree about where a vendor processes.
331
+ */
332
+ export function dataResidencyEntriesOf(
333
+ assessments: readonly ProviderComplianceChoiceAssessmentEntry[],
334
+ residency: ApplicationDataResidency,
335
+ ): readonly ProviderDataResidencyEntry[] {
336
+ return assessments
337
+ .filter((entry) => entry.choice.deploymentModel === ProviderDeploymentModel.VENDOR_HOSTED && entry.choice.processingRegion !== undefined)
338
+ .map((entry) => vendorRegionDataResidencyEntry({
339
+ providerRef: entry.providerRef,
340
+ processingRegion: entry.choice.processingRegion!,
341
+ profileEstablished: entry.offered !== null,
342
+ regionTerritories: entry.regionTerritories,
343
+ residency,
344
+ }));
345
+ }
346
+
347
+ /** The places in `territories` no declared residency territory contains. The one containment test every reader applies. */
348
+ export function territoriesOutsideDataResidency(territories: readonly string[], residency: ApplicationDataResidency): string[] {
349
+ return territories.filter((territory) => !residency.territories.some((resident) => jurisdictionReachCovers(resident, territory)));
350
+ }
351
+
352
+ /**
353
+ * What can be done, without asking anyone, about a provider a declared residency does not yet place inside (#2294).
354
+ * One member per answer; only {@link DERIVED} carries a choice to write, every other one is a decision left open and
355
+ * named (the creation foundation reports it, `wildo context launch-blockers` lists it).
356
+ */
357
+ export enum ProviderDataResidencyPlacementOutcome {
358
+ /**
359
+ * Exactly one of the provider's vendor regions processes wholly inside the residency, the provider is only offered
360
+ * vendor-hosted, and no authored choice names a region: that region is the only one the residency admits, so writing
361
+ * it decides nothing the residency had not already decided.
362
+ */
363
+ DERIVED = 'derived',
364
+ /** Several of its regions lie inside: which one the application uses is the operator's choice (cost, latency, account). */
365
+ SEVERAL_REGIONS_INSIDE = 'several-regions-inside',
366
+ /** None of its regions is stated to process wholly inside: choose another provider, run it self-hosted, or widen the residency. */
367
+ NO_REGION_INSIDE = 'no-region-inside',
368
+ /** The provider is offered self-hosted as well as vendor-hosted: who runs it is the operator's choice, never derived. */
369
+ DEPLOYMENT_MODEL_IS_A_CHOICE = 'deployment-model-is-a-choice',
370
+ /**
371
+ * An authored choice already speaks for the provider and does not place it inside (a region outside, a region whose
372
+ * places are unstated, or SELF_HOSTED for a provider only offered vendor-hosted). An authored choice is never
373
+ * overwritten: it is somebody's decision, and the residency now contradicts it.
374
+ */
375
+ AUTHORED_CHOICE_NOT_INSIDE = 'authored-choice-not-inside',
376
+ /** The provider declares no established compliance profile, so nothing says where any of its regions processes. */
377
+ NO_ESTABLISHED_PROFILE = 'no-established-profile',
378
+ }
379
+
380
+ /** One provider a residency does not place inside, and what can be done about it. See {@link placeProvidersInsideDataResidency}. */
381
+ export interface ProviderDataResidencyPlacement {
382
+ readonly providerRef: string;
383
+ /** The provider's entry from {@link assessProviderProcessingAgainstDataResidency}: never INSIDE. */
384
+ readonly assessment: ProviderDataResidencyEntry;
385
+ readonly outcome: ProviderDataResidencyPlacementOutcome;
386
+ /** The provider's vendor regions whose stated places all lie inside the residency, in the profile's order. */
387
+ readonly regionsInside: readonly string[];
388
+ /** The choice to write, for {@link ProviderDataResidencyPlacementOutcome.DERIVED} only. */
389
+ readonly derivedChoice?: { readonly deploymentModel: ProviderDeploymentModel.VENDOR_HOSTED; readonly processingRegion: string };
390
+ }
391
+
392
+ /**
393
+ * For every provider the residency does not place inside, whether its processing region can be DERIVED (#2294).
394
+ *
395
+ * The population and the verdict are {@link assessProviderProcessingAgainstDataResidency}'s, so a provider this calls
396
+ * placed is exactly one the synchronisation then admits: writing every `derivedChoice` turns each DERIVED entry INSIDE,
397
+ * and nothing else changes. A provider already INSIDE is not returned.
398
+ *
399
+ * Derived only when the residency leaves no choice: the provider is only offered vendor-hosted, exactly one of its
400
+ * regions processes wholly inside, and no authored choice names a region. Everything else is a decision, and is
401
+ * returned with the regions that would satisfy the residency so whoever takes it sees the options.
402
+ */
403
+ export function placeProvidersInsideDataResidency(params: Parameters<typeof assessProviderProcessingAgainstDataResidency>[0]): readonly ProviderDataResidencyPlacement[] {
404
+ return assessProviderProcessingAgainstDataResidency(params).flatMap((assessment): ProviderDataResidencyPlacement[] => {
405
+ if (assessment.status === ProviderDataResidencyStatus.INSIDE) return [];
406
+ const profile = Object.hasOwn(params.profilesByProviderRef, assessment.providerRef) ? params.profilesByProviderRef[assessment.providerRef] : undefined;
407
+ const established = establishedProviderComplianceProfile(profile);
408
+ const regionsInside = established === null
409
+ ? []
410
+ : established.processingRegions.filter((region) => {
411
+ const territories = established.processingRegionTerritories?.[region];
412
+ return territories !== undefined && territoriesOutsideDataResidency(territories, params.residency).length === 0;
413
+ });
414
+ const placement = (outcome: ProviderDataResidencyPlacementOutcome): ProviderDataResidencyPlacement[] => [
415
+ { providerRef: assessment.providerRef, assessment, outcome, regionsInside },
416
+ ];
417
+ switch (assessment.status) {
418
+ case ProviderDataResidencyStatus.NO_ESTABLISHED_PROFILE:
419
+ return placement(ProviderDataResidencyPlacementOutcome.NO_ESTABLISHED_PROFILE);
420
+ case ProviderDataResidencyStatus.OUTSIDE:
421
+ case ProviderDataResidencyStatus.TERRITORY_UNKNOWN:
422
+ case ProviderDataResidencyStatus.DEPLOYMENT_MODEL_NOT_OFFERED:
423
+ // Never produced by the assessment above (it is the call-time verdict); an authored statement if it were.
424
+ case ProviderDataResidencyStatus.ACCOUNT_REGION_UNSTATED:
425
+ return placement(ProviderDataResidencyPlacementOutcome.AUTHORED_CHOICE_NOT_INSIDE);
426
+ case ProviderDataResidencyStatus.NO_CHOICE:
427
+ case ProviderDataResidencyStatus.REGION_NOT_CHOSEN: {
428
+ // NO_CHOICE with an established profile allows a vendor (an always-self-hosted provider is never assessed).
429
+ if (established === null) return placement(ProviderDataResidencyPlacementOutcome.NO_ESTABLISHED_PROFILE);
430
+ // A REGION_NOT_CHOSEN choice already says VENDOR_HOSTED; with no choice, offering self-hosting makes the model a choice.
431
+ if (assessment.status === ProviderDataResidencyStatus.NO_CHOICE && established.deploymentModels.includes(ProviderDeploymentModel.SELF_HOSTED)) {
432
+ return placement(ProviderDataResidencyPlacementOutcome.DEPLOYMENT_MODEL_IS_A_CHOICE);
433
+ }
434
+ if (regionsInside.length === 0) return placement(ProviderDataResidencyPlacementOutcome.NO_REGION_INSIDE);
435
+ if (regionsInside.length > 1) return placement(ProviderDataResidencyPlacementOutcome.SEVERAL_REGIONS_INSIDE);
436
+ return [{
437
+ providerRef: assessment.providerRef,
438
+ assessment,
439
+ outcome: ProviderDataResidencyPlacementOutcome.DERIVED,
440
+ regionsInside,
441
+ derivedChoice: { deploymentModel: ProviderDeploymentModel.VENDOR_HOSTED, processingRegion: regionsInside[0]! },
442
+ }];
443
+ }
444
+ }
445
+ });
446
+ }
447
+
448
+ /**
449
+ * The decision a placement leaves open, as one sentence naming the provider, why it is not placed and what settles it
450
+ * (#2294). The creation foundation reports it and `wildo context launch-blockers` lists it, so the two say the same
451
+ * thing. A {@link ProviderDataResidencyPlacementOutcome.DERIVED} placement leaves nothing open: it names the region
452
+ * written.
453
+ */
454
+ export function dataResidencyPlacementStatement(placement: ProviderDataResidencyPlacement, residency: ApplicationDataResidency): string {
455
+ const declared = residency.territories.join(', ');
456
+ const at = `providerComplianceChoices.${placement.providerRef}`;
457
+ const inside = placement.regionsInside.map((region) => `"${region}"`).join(', ');
458
+ switch (placement.outcome) {
459
+ case ProviderDataResidencyPlacementOutcome.DERIVED:
460
+ return `Provider "${placement.providerRef}" processes in region "${placement.derivedChoice?.processingRegion}", the only one of its regions inside the data residency (${declared}).`;
461
+ case ProviderDataResidencyPlacementOutcome.SEVERAL_REGIONS_INSIDE:
462
+ return `Provider "${placement.providerRef}" has several regions inside the data residency (${declared}): ${inside}. Choose one as ${at}.processingRegion (deploymentModel VENDOR_HOSTED).`;
463
+ case ProviderDataResidencyPlacementOutcome.NO_REGION_INSIDE:
464
+ return `Provider "${placement.providerRef}" has no region its profile states to process wholly inside the data residency (${declared}). `
465
+ + 'Replace it with a provider that does, run it self-hosted if it is offered that way, or widen the residency.';
466
+ case ProviderDataResidencyPlacementOutcome.DEPLOYMENT_MODEL_IS_A_CHOICE:
467
+ return `Provider "${placement.providerRef}" can be run by its vendor or by you: decide which as ${at}.deploymentModel`
468
+ + (placement.regionsInside.length === 0 ? ` (none of its vendor regions lies inside the data residency, ${declared}).` : ` (vendor regions inside the data residency, ${declared}: ${inside}).`);
469
+ case ProviderDataResidencyPlacementOutcome.AUTHORED_CHOICE_NOT_INSIDE:
470
+ return `${dataResidencyRefusalOf(placement.assessment, residency) ?? `${at} is not inside the data residency (${declared}).`}`
471
+ + (placement.regionsInside.length === 0 ? '' : ` Its regions inside: ${inside}.`);
472
+ case ProviderDataResidencyPlacementOutcome.NO_ESTABLISHED_PROFILE:
473
+ return `Provider "${placement.providerRef}" declares no established compliance profile, so nothing says where it processes and it cannot be `
474
+ + `placed inside the data residency (${declared}). Replace it, or remove it from the runtime scopes that serve the application's data.`;
475
+ }
476
+ }
477
+
478
+ /**
479
+ * The refusal one entry implies: a sentence naming the provider, what is wrong and the remedy; `null` for INSIDE. The
480
+ * configuration sync joins them ({@link dataResidencyRefusals}); the backend provider loader keeps one per provider, so
481
+ * the startup refusal names each.
482
+ */
483
+ export function dataResidencyRefusalOf(
484
+ entry: ProviderDataResidencyEntry,
485
+ residency: ApplicationDataResidency,
486
+ declarer: DataResidencyDeclarer = DataResidencyDeclarer.APPLICATION,
487
+ ): string | null {
488
+ const declared = declarer === DataResidencyDeclarer.ORGANIZATION
489
+ ? `${residency.territories.join(', ')}, the organization's`
490
+ : residency.territories.join(', ');
491
+ const widen = declarer === DataResidencyDeclarer.ORGANIZATION
492
+ ? 'or have the organization\'s administrator widen its dataResidency inside the application\'s.'
493
+ : 'or widen operatorComplianceIdentity.dataResidency.territories.';
494
+ const where = entry.processingRegion === null
495
+ ? `providerComplianceChoices.${entry.providerRef}`
496
+ : `providerComplianceChoices.${entry.providerRef}.processingRegion "${entry.processingRegion}"`;
497
+ switch (entry.status) {
498
+ case ProviderDataResidencyStatus.INSIDE:
499
+ return null;
500
+ case ProviderDataResidencyStatus.OUTSIDE:
501
+ return `${where} processes in ${entry.outsideTerritories.join(', ')}, outside the declared data residency (${declared}). `
502
+ + `Choose a region inside it, run the provider self-hosted, ${widen}`;
503
+ case ProviderDataResidencyStatus.TERRITORY_UNKNOWN:
504
+ return `${where}: provider "${entry.providerRef}" does not state which places that region processes in, so it cannot be shown to stay inside `
505
+ + `the declared data residency (${declared}). Choose a region its profile maps to places (processingRegionTerritories), or remove the provider.`;
506
+ case ProviderDataResidencyStatus.NO_ESTABLISHED_PROFILE:
507
+ return `${where}: provider "${entry.providerRef}" declares no established compliance profile, so nothing says where it processes, and it `
508
+ + `cannot be shown to stay inside the declared data residency (${declared}).`;
509
+ case ProviderDataResidencyStatus.NO_CHOICE:
510
+ return `provider "${entry.providerRef}" is declared on a runtime that serves the application's data, but ${where} does not exist, so nothing `
511
+ + `says where its calls go and it cannot be shown to stay inside the declared data residency (${declared}). Declare its deploymentModel `
512
+ + 'and processingRegion there, or remove the provider from the runtime scopes.';
513
+ case ProviderDataResidencyStatus.REGION_NOT_CHOSEN:
514
+ return `${where} is VENDOR_HOSTED and names no processingRegion, so it cannot be shown to stay inside the declared data residency (${declared}).`;
515
+ case ProviderDataResidencyStatus.ACCOUNT_REGION_UNSTATED:
516
+ return `provider "${entry.providerRef}" would be called through an organization's or a person's own connected account, whose region that `
517
+ + `account decides and no connection records, so the call cannot be shown to stay inside the data residency (${declared}). Call it `
518
+ + 'through the application\'s own connection, whose region providerComplianceChoices states.';
519
+ case ProviderDataResidencyStatus.DEPLOYMENT_MODEL_NOT_OFFERED:
520
+ return `${where} says SELF_HOSTED, but provider "${entry.providerRef}" is only offered vendor-hosted, so its data goes to the vendor and it `
521
+ + `cannot be shown to stay inside the declared data residency (${declared}). Declare the vendor region it processes in, or remove the provider.`;
522
+ }
523
+ }
524
+
525
+ /**
526
+ * One provider CALL made for an organization that declares its own residency, against the territories that apply to it
527
+ * ({@link effectiveDataResidencyTerritories}): the call-time half of #2294, applied by the backend's provider-call gate.
528
+ * `null` when the operator runs the provider (nothing leaves); otherwise the entry, refused unless INSIDE.
529
+ *
530
+ * - Through the APPLICATION's account, it is {@link assessProviderProcessingAgainstDataResidency}'s comparison over the
531
+ * application's choice for the provider, the one the configuration synchronisation and the loader apply.
532
+ * - Through an OWNER's account, the application's choice says nothing about where the call goes, and no connection
533
+ * records its account's region, so the call is refused ({@link ProviderDataResidencyStatus.ACCOUNT_REGION_UNSTATED})
534
+ * unless the provider is only ever self-hosted. Fail closed: a residency the tenant declared is not kept by trusting
535
+ * an account nobody placed. A connection that records the region its vendor reports for the account is the door that
536
+ * would admit such a call, and it does not exist yet.
537
+ *
538
+ * assurance-control: WILDO.PRIVACY.THIRD_PARTY_PROCESSING — a call for an organization that pinned its data to named
539
+ * places goes only to a processor whose chosen region processes inside them.
540
+ */
541
+ export function assessProviderCallAgainstDataResidency(params: {
542
+ readonly territories: readonly string[];
543
+ readonly providerRef: string;
544
+ readonly choice: ProviderDataResidencyChoice | undefined;
545
+ readonly profile: ProviderComplianceProfile | undefined;
546
+ readonly account: ProviderCallAccount;
547
+ }): ProviderDataResidencyEntry | null {
548
+ const residency: ApplicationDataResidency = { territories: [...params.territories] as ApplicationDataResidency['territories'] };
549
+ if (params.account === ProviderCallAccount.OWNER) {
550
+ const established = establishedProviderComplianceProfile(params.profile);
551
+ if (established !== null && providerIsAlwaysSelfHosted(established)) return null;
552
+ return { providerRef: params.providerRef, processingRegion: null, territories: null, outsideTerritories: [], status: ProviderDataResidencyStatus.ACCOUNT_REGION_UNSTATED };
553
+ }
554
+ return providerDataResidencyEntryOf({ providerRef: params.providerRef, choice: params.choice, profile: params.profile, residency });
555
+ }
556
+
557
+ /**
558
+ * Why calling `model` would process outside the region the application declared for the provider, as one sentence naming
559
+ * the remedy; `null` when it stays inside, when no region is declared, or when the profile declares no model-id routing
560
+ * (#2294). The id's routing is the prefix it starts with, from the profile's `modelIdRouting.routingPrefixes`; an id
561
+ * naming none is sent where the region's endpoint is, and is inside.
562
+ *
563
+ * Applied twice from the one rule: when an agent is registered (startup), with the region the host's artifact binds the
564
+ * provider to, and by the provider's client when it builds the model (call time), with the region the loader bound it to.
565
+ *
566
+ * assurance-control: WILDO.PRIVACY.THIRD_PARTY_PROCESSING — a model id cannot route a call out of the region the
567
+ * application declared for its processor.
568
+ */
569
+ export function modelIdProcessingRegionRefusal(input: {
570
+ readonly providerRef: string;
571
+ readonly profile: ProviderComplianceProfile | undefined;
572
+ readonly processingRegion: string | undefined;
573
+ readonly model: string;
574
+ }): string | null {
575
+ if (input.processingRegion === undefined) return null;
576
+ const routing = establishedProviderComplianceProfile(input.profile)?.modelIdRouting;
577
+ if (routing === undefined) return null;
578
+ const prefix = routing.routingPrefixes.find((candidate) => input.model.startsWith(candidate));
579
+ if (prefix === undefined) return null;
580
+ const admitted = Object.hasOwn(routing.admittedByRegion, input.processingRegion) ? routing.admittedByRegion[input.processingRegion]! : [];
581
+ if (admitted.includes(prefix)) return null;
582
+ return `model "${input.model}" names its own routing ("${prefix}"), which takes provider "${input.providerRef}"'s calls outside the region `
583
+ + `the application declares for it (providerComplianceChoices.${input.providerRef}.processingRegion "${input.processingRegion}"`
584
+ + (admitted.length > 0 ? `, which admits ${admitted.join(', ')}` : ', which admits no routing prefix')
585
+ + '). Name the model without a routing prefix, so the region\'s endpoint routes it, or declare the region that model id routes within.';
586
+ }
587
+
588
+ /** Every refusal {@link assessProviderProcessingAgainstDataResidency} implies. Empty when every provider is inside. `wildo config sync` throws on any. */
589
+ export function dataResidencyRefusals(entries: readonly ProviderDataResidencyEntry[], residency: ApplicationDataResidency): readonly string[] {
590
+ return entries.flatMap((entry) => {
591
+ const refusal = dataResidencyRefusalOf(entry, residency);
592
+ return refusal === null ? [] : [refusal];
593
+ });
594
+ }
595
+
596
+ /**
597
+ * What a runtime's provider artifact carries so the runtime can re-apply the residency (#2294): the declared territories,
598
+ * and the choice of every provider that runtime declares (narrowed to them). Written by `wildo config sync` for the hosts
599
+ * that load providers to serve the application's data (backend, minions, node workers); absent when no residency is
600
+ * declared, which keeps every artifact of an application without one byte-identical.
601
+ *
602
+ * Inputs rather than a verdict: the loader decides with the profiles of the modules it actually loaded, so a provider
603
+ * package upgraded after the sync (a region remapped, a profile withdrawn) is judged on what runs, not on what sync saw.
604
+ */
605
+ export const RuntimeProviderDataResidencySchema = z.strictObject({
606
+ territories: z.array(JurisdictionSlugSchema).min(1),
607
+ choices: z.record(z.string().min(1), z.strictObject({
608
+ deploymentModel: z.enum(ProviderDeploymentModel),
609
+ processingRegion: z.string().min(1).optional(),
610
+ })),
611
+ });
612
+ export type RuntimeProviderDataResidency = z.infer<typeof RuntimeProviderDataResidencySchema>;
613
+
614
+ /** The {@link RuntimeProviderDataResidency} one runtime artifact carries, or `undefined` when no residency is declared. */
615
+ export function runtimeProviderDataResidencyFor(input: {
616
+ readonly residency: ApplicationDataResidency | undefined;
617
+ readonly choices: ApplicationProviderComplianceChoices | undefined;
618
+ readonly providerRefs: readonly string[];
619
+ }): RuntimeProviderDataResidency | undefined {
620
+ if (input.residency === undefined) return undefined;
621
+ const choices = input.choices ?? {};
622
+ return {
623
+ territories: [...input.residency.territories],
624
+ choices: Object.fromEntries([...new Set(input.providerRefs)].sort((left, right) => left.localeCompare(right))
625
+ .filter((providerRef) => Object.hasOwn(choices, providerRef))
626
+ .map((providerRef) => {
627
+ const choice = choices[providerRef]!;
628
+ return [providerRef, {
629
+ deploymentModel: choice.deploymentModel,
630
+ ...(choice.processingRegion !== undefined ? { processingRegion: choice.processingRegion } : {}),
631
+ }];
632
+ })),
633
+ };
634
+ }
635
+
636
+ /**
637
+ * A multi-scope artifact's residency narrowed to one host's providers (a minion's, a node worker's). The territories stay;
638
+ * the choices keep only the host's refs, as every other per-host projection does. `undefined` stays `undefined`, so a
639
+ * host projecting an artifact that carries no residency carries none either.
640
+ */
641
+ export function narrowRuntimeProviderDataResidency(
642
+ runtime: RuntimeProviderDataResidency | undefined,
643
+ providerRefs: readonly string[],
644
+ ): RuntimeProviderDataResidency | undefined {
645
+ if (runtime === undefined) return undefined;
646
+ return {
647
+ territories: [...runtime.territories],
648
+ choices: Object.fromEntries(Object.entries(runtime.choices).filter(([providerRef]) => providerRefs.includes(providerRef))),
649
+ };
650
+ }
651
+
652
+ /**
653
+ * The residency a runtime re-applies at load, over the providers it loaded: `providerRef` -> the refusal, for every one
654
+ * that is not inside. The backend provider loader leaves each unresolved, so startup refuses naming it.
655
+ */
656
+ export function runtimeDataResidencyRefusalsByProvider(input: {
657
+ readonly runtime: RuntimeProviderDataResidency;
658
+ readonly providerRefs: readonly string[];
659
+ readonly profilesByProviderRef: Readonly<Record<string, ProviderComplianceProfile | undefined>>;
660
+ }): ReadonlyMap<string, string> {
661
+ const residency: ApplicationDataResidency = { territories: input.runtime.territories };
662
+ const refusals = new Map<string, string>();
663
+ // Only the providers this host LOADED: a choice for one that failed to load for another reason must not replace that
664
+ // reason, and a provider that is not loaded receives no call.
665
+ for (const entry of assessProviderProcessingAgainstDataResidency({
666
+ residency,
667
+ choices: narrowRuntimeProviderDataResidency(input.runtime, input.providerRefs)?.choices,
668
+ profilesByProviderRef: input.profilesByProviderRef,
669
+ providerRefs: input.providerRefs,
670
+ })) {
671
+ const refusal = dataResidencyRefusalOf(entry, residency);
672
+ if (refusal !== null) refusals.set(entry.providerRef, refusal);
673
+ }
674
+ return refusals;
675
+ }
676
+ ```