@wildo-ai/framework-knowledge 1.1.5 → 1.1.7

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 (837) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
  3. package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
  4. package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
  5. package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
  6. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
  7. package/dist/{knowledge/skills/journey-run/references/framework-playbook-approval-policy.md → claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md} +10 -8
  8. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
  9. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
  10. package/dist/{knowledge/skills/journey-run → claude-marketplace/plugins/wildo}/references/expert-personas-and-deliberations.md +8 -8
  11. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
  12. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
  13. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
  14. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
  15. package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
  16. package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
  17. package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
  18. package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
  19. package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
  20. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
  21. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  22. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  23. package/dist/esm/framework-knowledge.definitions.js +321 -11
  24. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +0 -3
  28. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +12 -2
  30. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  31. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +33 -2
  32. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +8 -5
  34. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  35. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +55 -10
  36. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -6
  40. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
  42. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
  44. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  45. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
  46. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  47. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +0 -1
  48. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +2 -2
  50. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -4
  52. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +10 -3
  54. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +7 -3
  56. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  58. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +8 -3
  59. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +1 -1
  61. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  62. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +0 -1
  63. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  64. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +7 -3
  65. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  66. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +9 -4
  67. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  68. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +3 -2
  69. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +4 -3
  71. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  72. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +1 -1
  73. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  74. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +1 -3
  75. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  76. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
  77. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  78. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +0 -1
  79. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  80. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +10 -3
  81. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  82. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +8 -3
  83. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  84. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +12 -5
  85. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  86. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +33 -5
  87. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  88. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +1 -1
  89. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +1 -1
  90. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  91. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
  92. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
  93. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
  94. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
  95. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
  96. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
  97. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
  98. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
  99. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
  100. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
  101. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
  103. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
  104. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
  105. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
  106. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
  107. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +1 -1
  108. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  109. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +1 -1
  110. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
  111. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
  113. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  114. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +1 -1
  115. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +1 -1
  116. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  117. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +1 -1
  118. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +1 -1
  119. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +1 -1
  121. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +1 -1
  122. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  123. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +1 -1
  124. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +1 -1
  125. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +1 -1
  127. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  129. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +36 -17
  130. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  131. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +67 -17
  132. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  133. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +1 -1
  134. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +1 -1
  135. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  136. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
  137. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
  138. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
  139. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
  140. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +1 -1
  141. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  142. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +1 -1
  143. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  144. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +1 -1
  145. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  146. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  147. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +0 -1
  148. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  149. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +1 -1
  150. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +1 -1
  151. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +1 -1
  153. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +1 -1
  154. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +1 -1
  156. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +1 -1
  157. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  158. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +1 -1
  159. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +1 -1
  160. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  161. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +1 -1
  162. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  163. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +0 -1
  164. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  165. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +1 -1
  166. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  167. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -3
  168. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  169. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  170. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  171. package/dist/knowledge/manifest.json +8 -8
  172. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +0 -3
  173. package/dist/knowledge/playbooks/bottom_up.build/method.md +4 -2
  174. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +31 -7
  175. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  176. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  177. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +134 -26
  178. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +7 -4
  179. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +84 -29
  180. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -7
  181. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +12 -23
  182. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -7
  183. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +12 -14
  184. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -2
  185. package/dist/knowledge/playbooks/bottom_up.conception/method.md +20 -2
  186. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +15 -7
  187. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +8 -6
  188. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +11 -4
  189. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +2 -4
  190. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +3 -4
  191. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +18 -2
  192. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +1 -2
  193. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +2 -4
  194. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +8 -5
  195. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +16 -2
  196. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +3 -3
  197. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +1 -3
  198. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +1 -2
  199. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +8 -7
  200. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +11 -4
  201. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +27 -5
  202. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +1 -4
  203. package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
  204. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
  205. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
  206. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
  207. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +112 -21
  208. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
  209. package/dist/knowledge/playbooks/refinement.document-facts/method.md +7 -2
  210. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -4
  211. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
  212. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
  213. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +6 -0
  214. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
  215. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +0 -4
  216. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +1 -2
  217. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +1 -3
  218. package/dist/knowledge/playbooks/top_down.capability-map/method.md +2 -4
  219. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -2
  220. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +1 -3
  221. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +5 -3
  222. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +2 -4
  223. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +1 -3
  224. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +0 -4
  225. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +2 -4
  226. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -3
  227. package/dist/knowledge/playbooks/top_down.definition/method.md +7 -4
  228. package/dist/knowledge/playbooks/top_down.definition/playbook.json +52 -7
  229. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +1 -1
  230. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +2 -4
  231. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
  232. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
  233. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +0 -1
  234. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +0 -1
  235. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +0 -1
  236. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +2 -4
  237. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -2
  238. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +1 -1
  239. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +2 -6
  240. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +17 -1
  241. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +2 -5
  242. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -3
  243. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +15 -7
  244. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +2 -4
  245. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +2 -4
  246. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +1 -2
  247. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
  248. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +12 -5
  249. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
  250. package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
  251. package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
  252. package/dist/knowledge/references/build-plan.task-graph.config.md +71 -6
  253. package/dist/knowledge/references/capability-composition.config.md +20 -1
  254. package/dist/knowledge/references/cli.market.generate-command.md +18 -2
  255. package/dist/knowledge/references/engine.client-bundle.allow-list.md +7 -22
  256. package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
  257. package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
  258. package/dist/knowledge/references/example.backend.addon-wiring.module.md +5 -0
  259. package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
  260. package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
  261. package/dist/knowledge/references/example.config.app-shell.full.md +11 -0
  262. package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
  263. package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
  264. package/dist/knowledge/references/example.config.backend.required-floors.md +7 -0
  265. package/dist/knowledge/references/example.config.navigation.full.md +45 -2
  266. package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
  267. package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
  268. package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
  269. package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
  270. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
  271. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +26 -3
  272. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +1 -1
  273. package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
  274. package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
  275. package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
  276. package/dist/knowledge/references/example.infra.environment-config.local.md +14 -30
  277. package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
  278. package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
  279. package/dist/knowledge/references/example.module.companion-exports.full.md +8 -13
  280. package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
  281. package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
  282. package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
  283. package/dist/knowledge/references/example.provider.backend-module-shape.md +3 -0
  284. package/dist/knowledge/references/example.provider.frontend-app.module.md +9 -0
  285. package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
  286. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +14 -13
  287. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +18 -0
  288. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +11 -11
  289. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +5 -0
  290. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +2 -0
  291. package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
  292. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
  293. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +24 -6
  294. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +36 -25
  295. package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
  296. package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
  297. package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
  298. package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
  299. package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
  300. package/dist/knowledge/references/example.website.page.manifest.md +30 -0
  301. package/dist/knowledge/references/experience-plan.config.md +11 -4
  302. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +20 -0
  303. package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
  304. package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
  305. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
  306. package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
  307. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
  308. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
  309. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
  310. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +21 -0
  311. package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
  312. package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
  313. package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
  314. package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
  315. package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
  316. package/dist/knowledge/references/integration-plan.config.md +34 -2
  317. package/dist/knowledge/references/market.alternative.config.md +1 -1
  318. package/dist/knowledge/references/market.buying-journey.config.md +1 -1
  319. package/dist/knowledge/references/market.category.config.md +1 -1
  320. package/dist/knowledge/references/market.channel.config.md +1 -1
  321. package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
  322. package/dist/knowledge/references/market.gain.config.md +1 -1
  323. package/dist/knowledge/references/market.icp.config.md +1 -1
  324. package/dist/knowledge/references/market.job.config.md +1 -1
  325. package/dist/knowledge/references/market.message-template.config.md +1 -1
  326. package/dist/knowledge/references/market.objection.config.md +1 -1
  327. package/dist/knowledge/references/market.pain.config.md +1 -1
  328. package/dist/knowledge/references/market.persona.config.md +1 -1
  329. package/dist/knowledge/references/market.positioning.config.md +1 -1
  330. package/dist/knowledge/references/market.proof.config.md +1 -1
  331. package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
  332. package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
  333. package/dist/knowledge/references/market.trigger.config.md +1 -1
  334. package/dist/knowledge/references/placement-plan.config.md +7 -1
  335. package/dist/knowledge/references/platform.config.backing-services.md +15 -15
  336. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +57 -57
  337. package/dist/knowledge/references/presets.3d.focal-plane-settings.md +45 -0
  338. package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
  339. package/dist/knowledge/references/presets.3d.layout-contract.md +235 -0
  340. package/dist/knowledge/references/presets.3d.register-layout.md +100 -0
  341. package/dist/knowledge/references/presets.models.labelling.sections.md +5 -0
  342. package/dist/knowledge/references/presets.models.shell-region.md +47 -0
  343. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
  344. package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
  345. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  346. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +7 -6
  347. package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
  348. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +7 -0
  349. package/dist/knowledge/references/saas.backend.domain-module.md +93 -15
  350. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
  351. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
  352. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +200 -0
  353. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +2 -0
  354. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
  355. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +33 -9
  356. package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
  357. package/dist/knowledge/references/saas.backend.system-access-service.md +98 -0
  358. package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
  359. package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
  360. package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
  361. package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
  362. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
  363. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +2 -2
  364. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +253 -0
  365. package/dist/knowledge/references/saas.frontend.billing-context.md +25 -2
  366. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
  367. package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
  368. package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
  369. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
  370. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +7 -5
  371. package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
  372. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +17 -2
  373. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
  374. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
  375. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +9 -0
  376. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +100 -5
  377. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
  378. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +61 -0
  379. package/dist/knowledge/references/saas.market.generation-agent.md +0 -1
  380. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
  381. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
  382. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
  383. package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
  384. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
  385. package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
  386. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
  387. package/dist/knowledge/references/saas.models.audit.trail-config.md +15 -9
  388. package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
  389. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +8 -0
  390. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +54 -1
  391. package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
  392. package/dist/knowledge/references/saas.models.config.organization-types.md +74 -0
  393. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +31 -14
  394. package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
  395. package/dist/knowledge/references/saas.models.data-mode-read-list.md +4 -4
  396. package/dist/knowledge/references/saas.models.engine-capabilities.md +12 -0
  397. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +5 -1
  398. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
  399. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
  400. package/dist/knowledge/references/saas.models.external-data-pipeline.md +667 -6
  401. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
  402. package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
  403. package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
  404. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
  405. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
  406. package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
  407. package/dist/knowledge/references/saas.models.http-api-binding.md +812 -29
  408. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
  409. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
  410. package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
  411. package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
  412. package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
  413. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
  414. package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
  415. package/dist/knowledge/references/saas.models.navigation.layout.md +11 -7
  416. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +32 -23
  417. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +8 -4
  418. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +22 -20
  419. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +14 -0
  420. package/dist/knowledge/references/saas.models.notifications.targets.md +20 -12
  421. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +61 -34
  422. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +9 -0
  423. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
  424. package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
  425. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
  426. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
  427. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
  428. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
  429. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
  430. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
  431. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
  432. package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
  433. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
  434. package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
  435. package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
  436. package/dist/knowledge/references/saas.models.provider-capabilities.md +34 -0
  437. package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
  438. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
  439. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +61 -0
  440. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +98 -13
  441. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
  442. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -28
  443. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
  444. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +6 -0
  445. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +8 -0
  446. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
  447. package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
  448. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
  449. package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
  450. package/dist/knowledge/references/saas.models.systems-of-record.md +242 -7
  451. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
  452. package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
  453. package/dist/knowledge/references/saas.public-runtime.contract.md +75 -7
  454. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +20 -0
  455. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +106 -13
  456. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
  457. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
  458. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
  459. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
  460. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
  461. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +6 -4
  462. package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
  463. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +14 -2
  464. package/dist/knowledge/references/saas.specifications.processor-register.md +77 -0
  465. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
  466. package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
  467. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +112 -45
  468. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +13 -1
  469. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
  470. package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
  471. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
  472. package/dist/knowledge/references/saas.website.astro.bridge.md +32 -9
  473. package/dist/knowledge/references/saas.website.astro.head-renderer.md +1 -1
  474. package/dist/knowledge/references/saas.website.astro.label-loader.md +7 -4
  475. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +15 -15
  476. package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
  477. package/dist/knowledge/references/saas.website.blog.bridge.md +17 -4
  478. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
  479. package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
  480. package/dist/knowledge/references/saas.website.consent.banner.md +10 -10
  481. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
  482. package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
  483. package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
  484. package/dist/knowledge/references/saas.website.page-layout.component.md +5 -2
  485. package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
  486. package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
  487. package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
  488. package/dist/knowledge/references/saas.website.runtime.context.md +23 -4
  489. package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
  490. package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
  491. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
  492. package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
  493. package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
  494. package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
  495. package/dist/knowledge/references/website-plan.config.md +39 -6
  496. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +2 -1
  497. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +21 -0
  498. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +1 -2
  499. package/dist/knowledge/references/zod.decorators.file-schema.md +11 -10
  500. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +7 -4
  501. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +8 -2
  502. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +5 -1
  503. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +5 -1
  504. package/dist/knowledge/references/zod.factories.address.md +7 -7
  505. package/dist/knowledge/references/zod.factories.code.md +2 -2
  506. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  507. package/dist/knowledge/references/zod.factories.money.md +3 -3
  508. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  509. package/dist/knowledge/registries/framework-topics.json +1248 -54
  510. package/dist/knowledge/registries/playbooks.json +81 -109
  511. package/dist/knowledge/registries/source-tags.json +3201 -1118
  512. package/dist/knowledge/rules/live-context-door.md +29 -0
  513. package/dist/knowledge/skills/INDEX.md +27 -24
  514. package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
  515. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
  516. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
  517. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
  518. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
  519. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
  520. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
  521. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
  522. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
  523. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +31 -0
  524. package/dist/knowledge/skills/application-database-migrations/SKILL.md +1 -0
  525. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +1 -0
  526. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +9 -0
  527. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  528. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +94 -16
  529. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +21 -8
  530. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +7 -0
  531. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +13 -5
  532. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +30 -6
  533. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +160 -32
  534. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +20 -0
  535. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +14 -2
  536. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +88 -0
  537. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +112 -14
  538. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
  539. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
  540. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
  541. package/dist/knowledge/skills/config-app-shell/SKILL.md +21 -0
  542. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +2 -2
  543. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +279 -0
  544. package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
  545. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -0
  546. package/dist/knowledge/skills/config-navigation/SKILL.md +114 -16
  547. package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
  548. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +11 -7
  549. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +29 -5
  550. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +40 -27
  551. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +22 -20
  552. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +112 -5
  553. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +10 -10
  554. package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
  555. package/dist/knowledge/skills/config-saas/SKILL.md +3 -1
  556. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +7 -0
  557. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +21 -11
  558. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +5 -1
  559. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +59 -9
  560. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +46 -0
  561. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +251 -12
  562. package/dist/knowledge/skills/config-saas-backend/SKILL.md +8 -0
  563. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +81 -0
  564. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +37 -15
  565. package/dist/knowledge/skills/configure-billing/SKILL.md +64 -24
  566. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +35 -2
  567. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +14 -0
  568. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +3 -0
  569. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +25 -2
  570. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +73 -1
  571. package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
  572. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +27 -12
  573. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +11 -2
  574. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +26 -2
  575. package/dist/knowledge/skills/email-add-template/SKILL.md +61 -24
  576. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +5 -2
  577. package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
  578. package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
  579. package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
  580. package/dist/knowledge/skills/engine-component-registration/SKILL.md +1 -0
  581. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +6 -0
  582. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +27 -3
  583. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
  584. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
  585. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
  586. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
  587. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
  588. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +31 -4
  589. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +26 -3
  590. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
  591. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
  592. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +202 -0
  593. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +93 -15
  594. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +96 -11
  595. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +2 -1
  596. package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
  597. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -0
  598. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -2
  599. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +14 -9
  600. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +1 -0
  601. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +1 -0
  602. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +5 -0
  603. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
  604. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +5 -0
  605. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +8 -1
  606. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +5 -0
  607. package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
  608. package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
  609. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
  610. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
  611. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
  612. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
  613. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
  614. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
  615. package/dist/knowledge/skills/infra-environment-config/SKILL.md +150 -44
  616. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +83 -74
  617. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +180 -0
  618. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +53 -0
  619. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
  620. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +245 -0
  621. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +108 -0
  622. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +259 -0
  623. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
  624. package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +43 -0
  625. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
  626. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +32 -1
  627. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
  628. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +36 -4
  629. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +2 -1
  630. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
  631. package/dist/knowledge/skills/market-alternatives/SKILL.md +3 -2
  632. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
  633. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
  634. package/dist/knowledge/skills/market-category/SKILL.md +2 -1
  635. package/dist/knowledge/skills/market-channels/SKILL.md +2 -1
  636. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +7 -4
  637. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +6 -4
  638. package/dist/knowledge/skills/market-generation-cli/SKILL.md +28 -13
  639. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +18 -3
  640. package/dist/knowledge/skills/market-icp/SKILL.md +2 -1
  641. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +4 -3
  642. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -1
  643. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
  644. package/dist/knowledge/skills/market-persona/SKILL.md +2 -1
  645. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
  646. package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
  647. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +3 -2
  648. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
  649. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1 -0
  650. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +2 -1
  651. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +3 -2
  652. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +1 -0
  653. package/dist/knowledge/skills/minion-authoring/SKILL.md +5 -1
  654. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
  655. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
  656. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
  657. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
  658. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
  659. package/dist/knowledge/skills/module-companion-exports/SKILL.md +17 -16
  660. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +6 -4
  661. package/dist/knowledge/skills/module-registration/SKILL.md +2 -1
  662. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +93 -15
  663. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +86 -1
  664. package/dist/knowledge/skills/module-relationships/SKILL.md +3 -2
  665. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
  666. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
  667. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
  668. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
  669. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
  670. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
  671. package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
  672. package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -33
  673. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
  674. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
  675. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
  676. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
  677. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
  678. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
  679. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +132 -23
  680. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
  681. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +29 -0
  682. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
  683. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
  684. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
  685. package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
  686. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
  687. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +75 -24
  688. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +3 -3
  689. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +61 -0
  690. package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
  691. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +17 -2
  692. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +15 -0
  693. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
  694. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +25 -0
  695. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +6 -0
  696. package/dist/knowledge/skills/resource-add-field/SKILL.md +1 -0
  697. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
  698. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +105 -6
  699. package/dist/knowledge/skills/resource-add-module/SKILL.md +1 -0
  700. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +2 -1
  701. package/dist/knowledge/skills/resource-add-resource/SKILL.md +3 -0
  702. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +124 -30
  703. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +1 -0
  704. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +8 -0
  705. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +9 -0
  706. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +17 -1
  707. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +124 -30
  708. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +7 -6
  709. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +142 -34
  710. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +98 -0
  711. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +86 -52
  712. package/dist/knowledge/skills/resource-custom-view/SKILL.md +1 -0
  713. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +100 -5
  714. package/dist/knowledge/skills/resource-external-data/SKILL.md +1026 -28
  715. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
  716. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
  717. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
  718. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +686 -11
  719. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +904 -31
  720. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +166 -6
  721. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
  722. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
  723. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
  724. package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
  725. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
  726. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
  727. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
  728. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
  729. package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
  730. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
  731. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +1 -0
  732. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +1 -0
  733. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +12 -0
  734. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
  735. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
  736. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
  737. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
  738. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
  739. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
  740. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
  741. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +2 -2
  742. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
  743. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
  744. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +2 -1
  745. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +28 -0
  746. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +5 -1
  747. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +34 -30
  748. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +5 -1
  749. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +101 -42
  750. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +21 -0
  751. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +1 -2
  752. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +125 -6
  753. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +8 -2
  754. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
  755. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +61 -1
  756. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +110 -9
  757. package/dist/knowledge/skills/seeding-authoring/SKILL.md +1 -0
  758. package/dist/knowledge/skills/seeding-operations/SKILL.md +1 -0
  759. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
  760. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
  761. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
  762. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
  763. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
  764. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
  765. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +1 -0
  766. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +61 -0
  767. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
  768. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
  769. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +14 -16
  770. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +6 -4
  771. package/dist/knowledge/skills/spec-component-update/SKILL.md +1 -0
  772. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
  773. package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
  774. package/dist/knowledge/skills/spec-feature-update/SKILL.md +1 -0
  775. package/dist/knowledge/skills/spec-resource-update/SKILL.md +13 -0
  776. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +158 -46
  777. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
  778. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
  779. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +5 -1
  780. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +1 -0
  781. package/dist/knowledge/skills/views-app-level/SKILL.md +2 -1
  782. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +43 -1
  783. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
  784. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +5 -1
  785. package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
  786. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -0
  787. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +29 -6
  788. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
  789. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +17 -4
  790. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +23 -28
  791. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +7 -22
  792. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +167 -20
  793. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
  794. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +63 -6
  795. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
  796. package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
  797. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -2
  798. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -2
  799. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +2 -1
  800. package/dist/knowledge/skills/website-page-authoring/SKILL.md +117 -33
  801. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
  802. package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
  803. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
  804. package/dist/knowledge/skills/website-section-contact/SKILL.md +65 -36
  805. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -11
  806. package/dist/knowledge/skills/website-section-cta/SKILL.md +32 -22
  807. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -11
  808. package/dist/knowledge/skills/website-section-faq/SKILL.md +99 -63
  809. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -11
  810. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +27 -18
  811. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -11
  812. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +33 -22
  813. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -11
  814. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +31 -20
  815. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -11
  816. package/dist/knowledge/skills/website-section-hero/SKILL.md +65 -44
  817. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -11
  818. package/dist/knowledge/skills/website-section-pricing/SKILL.md +217 -200
  819. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -11
  820. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
  821. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +45 -34
  822. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -11
  823. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
  824. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
  825. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +30 -25
  826. package/dist/knowledge/skills/worker-authoring/SKILL.md +1 -0
  827. package/dist/knowledge/topic-index.json +5957 -1729
  828. package/dist/tsconfig.build.tsbuildinfo +1 -1
  829. package/dist/tsconfig.tsbuildinfo +1 -1
  830. package/package.json +4 -4
  831. package/dist/knowledge/skills/journey-approve/SKILL.md +0 -63
  832. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -77
  833. package/dist/knowledge/skills/journey-next/SKILL.md +0 -82
  834. package/dist/knowledge/skills/journey-report/SKILL.md +0 -56
  835. package/dist/knowledge/skills/journey-run/SKILL.md +0 -140
  836. package/dist/knowledge/skills/journey-status/SKILL.md +0 -60
  837. /package/dist/{knowledge/skills/journey-approve → claude-marketplace/plugins/wildo}/references/specification-family-map.md +0 -0
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: provider-frontend-file-picker
3
3
  description: Add or tune the frontend FILE PICKER provider — the browser-bound FrontendAppProviderModule that gives every framework file form field its accepted MIME types, size limit and selection count, and that custom views resolve for their own upload chrome. Use when the user says "add a file picker", "let users attach files", "restrict uploads to PDFs/images", "raise the upload size limit", "file field accepts anything", "picker allows too many files", or "wire a file upload provider for the app".
4
+ user-invocable: false
4
5
  ---
5
6
 
6
7
  # Frontend File-Picker Provider
@@ -79,6 +80,41 @@ contract. The file-picker `publicConfig` vocabulary the framework
79
80
  reads: `acceptedMimeTypes` (string[]), `maxFileSizeMb` (number),
80
81
  `maxSelectionCount` (number), `uploadNamespace` (string).
81
82
 
83
+ Declare `publicConfigSchema` with `defineFrontendPublicConfigSchema` — it is
84
+ MANDATORY. List every key the module's `publicConfig` carries that the
85
+ capability does not own (here `uploadNamespace`; the three limits come with
86
+ `FRONTEND_FILE_PICKER`), plus any public key the application supplies, such
87
+ as a vendor chooser's client id. A module without a readable schema is
88
+ refused at projection, at `wildo config sync` and at hydration, and every
89
+ value it would serve is compared against the environment's secrets. Read
90
+ `references/framework-frontend-public-config-api.md`.
91
+
92
+ Declare the module's `complianceProfile` in the same step — who runs the
93
+ software the picker touches, where it processes, and which legal entity
94
+ stands behind it:
95
+
96
+ | Picker shape | `complianceProfile` |
97
+ |---|---|
98
+ | Native input (the browser's own dialog, bytes stored by this application) | `deploymentModels: [SELF_HOSTED]`, `processingRegions: []` |
99
+ | Vendor chooser (Google Drive, OneDrive, Dropbox) | `deploymentModels: [VENDOR_HOSTED]`, the vendor's regions, `vendorLegalEntityName` |
100
+
101
+ A picker runs in the data subject's browser and a vendor chooser talks to
102
+ its vendor directly, so it is a recipient a privacy notice has to name. The
103
+ profile crosses into this service's served frontend bootstrap in the
104
+ generated `frontend-services.runtime-providers.generated.json`, and the
105
+ recipient population (processor register, privacy-notice recipients,
106
+ regional report) reads it from there. A picker with NO profile is reported
107
+ as not established, so state `SELF_HOSTED` rather than leaving it out.
108
+
109
+ Declare only capabilities a browser may host, and add module-level
110
+ `consentPurposes` only when the vendor's own processing goes beyond the
111
+ picker — a vendor chooser that also profiles people for its own purposes.
112
+ A picker that rests on consent does not load until the signed-in person
113
+ grants it; the framework file field then shows a consent-required state
114
+ with a grant action instead of the picker. A picker that starts workers or
115
+ plays media declares `csp.workerOrigins` / `csp.mediaOrigins`. Read
116
+ `references/framework-frontend-provider-consent-api.md`.
117
+
82
118
  ### Step 2: Export it through the providers barrel
83
119
 
84
120
  `frontend/src/engine/providers/index.ts` re-exports the module; the
@@ -88,10 +124,15 @@ package's `./frontend-providers` entry exposes that barrel — the
88
124
  ### Step 3: Append the companion contribution
89
125
 
90
126
  In `frontend/src/provider-contributions.ts`, append one entry to
91
- `frontendProviderContributions`. Derive every duplicated field
92
- (capabilities, protocols, metadata, publicConfig) FROM the module
93
- object — see the worked example. `sourceModuleId` names the module
94
- that owns the provider semantically.
127
+ `frontendProviderContributions`, built by the engine's
128
+ `projectFrontendProviderContribution(module, AppFrontendType.SAAS_APP,
129
+ '<your-package>/frontend-providers')` from
130
+ `@wildo-ai/external-connectors-public/companion`, then add
131
+ `sourceModuleId` (the module that owns the provider semantically) —
132
+ see the worked example. Do not hand-write the `frontendEntry`: the
133
+ projection is what carries `csp`, `scripts`, the SDK descriptor, the
134
+ declared public-config keys, `fileStorage` and the `complianceProfile`,
135
+ and a literal carries only the fields it happens to name.
95
136
 
96
137
  ### Step 4: Declare the saas-config scope entry
97
138
 
@@ -108,6 +149,18 @@ Framework file fields pick the constraints up with no further wiring
108
149
  precedence). A custom view resolves the module via
109
150
  `findByProviderCapabilityAndProtocol(FRONTEND_FILE_PICKER, FRONTEND_SDK)`.
110
151
 
152
+ ### A vendor chooser opens on the person's CONNECTION, not on its ref
153
+
154
+ A vendor chooser (OneDrive, Google Drive) opens as the signed-in person: the host asks
155
+ `GET /connections/<ref>/access-token` for their own short-lived token. That route answers with the grant
156
+ of the ref's CONNECTION. When the application declares the picker's ref as a member of a shared
157
+ connection (`providers.sharedConnections: { microsoft: { refs: ['microsoft-onedrive'] } }` in
158
+ `wildo.saas.config.ts`), the picker opens on the one Microsoft grant the person already gave — they
159
+ connect Microsoft once, and the connected-accounts settings screen shows ONE Microsoft row naming
160
+ OneDrive among the features it serves. Without that declaration the picker's ref is its own connection
161
+ and asks for its own consent. A `404` from the route means nothing is connected for that connection:
162
+ send the person to the connected-accounts screen rather than opening the chooser on nobody's files.
163
+
111
164
  ## Worked Example
112
165
 
113
166
  The complete provider module — the generalized file-picker shape:
@@ -133,6 +186,24 @@ export const ApplicationFilePickerFrontendAppProvider: FrontendAppProviderModule
133
186
  maxSelectionCount: 10,
134
187
  uploadNamespace: 'task-attachments',
135
188
  },
189
+ // MANDATORY (#1705): the keys this picker's publicConfig may carry, readable without running anything.
190
+ // The three limits above belong to the FRONTEND_FILE_PICKER capability and are admitted through it, so
191
+ // only this provider's own key is declared here. `wildo config sync` refuses a module without one, and
192
+ // compares every served value against the environment's secrets before it can reach a browser.
193
+ publicConfigSchema: defineFrontendPublicConfigSchema({
194
+ uploadNamespace: { kind: FrontendPublicConfigValueKind.STRING, description: 'Storage namespace uploads land under.' },
195
+ }),
196
+ // WHO runs it and WHERE (#1743). This picker is the browser's own file dialog: it loads no vendor
197
+ // SDK, and the bytes go to this application's own storage — so the operator runs everything it
198
+ // touches, and it is NOT a third-party recipient. Stated rather than left absent, because a
199
+ // frontend provider with no profile is reported as NOT ESTABLISHED by the recipient population,
200
+ // which reads this profile from the served frontend bootstrap. A picker that fronts a VENDOR
201
+ // (Drive, OneDrive, Dropbox) declares `VENDOR_HOSTED`, the vendor's regions and its legal entity.
202
+ complianceProfile: {
203
+ deploymentModels: [ProviderDeploymentModel.SELF_HOSTED],
204
+ // Empty is the honest answer for a self-hosted provider: the region is wherever the operator runs it.
205
+ processingRegions: [],
206
+ },
136
207
  };
137
208
  ```
138
209
 
@@ -150,6 +221,13 @@ What earns its place:
150
221
  exactly this pair.
151
222
  - `publicConfig` carries ONLY the four picker keys — no secrets, no
152
223
  labels, no per-field decisions.
224
+ - `publicConfigSchema` declares `uploadNamespace`, the one key the picker
225
+ capability does not own. Without it the module is refused before
226
+ anything is served.
227
+ - `complianceProfile` says `SELF_HOSTED` with no regions, because a
228
+ native-input picker reaches no third party. A vendor chooser says
229
+ `VENDOR_HOSTED` with at least one region — the schema refuses a
230
+ vendor-hosted profile without one.
153
231
 
154
232
  And its companion contribution — the registration half:
155
233
 
@@ -159,19 +237,20 @@ And its companion contribution — the registration half:
159
237
  ```typescript
160
238
  function buildFilePickerContribution(): ProviderCompanionContribution {
161
239
  return {
162
- ref: ApplicationFilePickerFrontendAppProvider.metadata.ref,
163
- runtimeImportPath: FRONTEND_PROVIDERS_IMPORT_PATH,
164
- runtimeTargets: [{ kind: 'frontendService', serviceType: AppFrontendType.SAAS_APP }],
165
- engineCapabilities: [],
166
- providerCapabilities: [...ApplicationFilePickerFrontendAppProvider.providerCapabilities],
167
- protocols: [...ApplicationFilePickerFrontendAppProvider.protocols],
168
- secretsContractShape: [],
169
- frontendEntry: {
170
- metadata: ApplicationFilePickerFrontendAppProvider.metadata,
171
- providerCapabilities: [...ApplicationFilePickerFrontendAppProvider.providerCapabilities],
172
- protocols: [...ApplicationFilePickerFrontendAppProvider.protocols],
173
- publicConfig: ApplicationFilePickerFrontendAppProvider.publicConfig,
174
- },
240
+ // Projected by the ENGINE, not hand-written: `projectFrontendProviderContribution` carries every
241
+ // DATA field of the module across — `csp`, `scripts`, the SDK descriptor, contributed components,
242
+ // the declared publicConfig keys, `fileStorage` and the `complianceProfile` — to the CLI, which
243
+ // composes the service's Content-Security-Policy and the served bootstrap from the artifact
244
+ // without executing this browser-bound module. A hand-written `frontendEntry` carries whatever
245
+ // subset it happens to name: this one used to name four fields, so the picker's compliance
246
+ // profile never reached the recipient population that reads it from that bootstrap (#1743).
247
+ ...projectFrontendProviderContribution(
248
+ ApplicationFilePickerFrontendAppProvider,
249
+ AppFrontendType.SAAS_APP,
250
+ FRONTEND_PROVIDERS_IMPORT_PATH,
251
+ ),
252
+ // Added on top of the projection, which cannot know it: the engine's own providers belong to no
253
+ // application module, so the projection has nothing to attribute them to.
175
254
  sourceModuleId: 'tasks-manager',
176
255
  };
177
256
  }
@@ -202,9 +281,10 @@ export const frontendProviderContributions = [
202
281
  ] satisfies ReadonlyArray<ProviderCompanionContribution>;
203
282
  ```
204
283
 
205
- - Every duplicated field reads FROM the module object
206
- (`...Provider.providerCapabilities`, `publicConfig: Provider.publicConfig`)
207
- so the contribution cannot drift from the module.
284
+ - `projectFrontendProviderContribution` reads every field FROM the
285
+ module object, so the contribution cannot drift from the module and
286
+ no data field (the CSP footprint, the compliance profile) is dropped
287
+ on the way into the generated artifact.
208
288
  - `runtimeImportPath` is the app package's `./frontend-providers`
209
289
  entry — the door the provider-runtime sync validates.
210
290
  - The engine contributions spread (`...engineFrontendAppProviderContributions`)
@@ -217,14 +297,31 @@ export const frontendProviderContributions = [
217
297
  - `references/framework-file-provider-constraints-api.md` — how
218
298
  framework file fields resolve constraints from the provider
219
299
  (source-backed)
300
+ - `references/framework-frontend-public-config-api.md` — the mandatory
301
+ `publicConfigSchema`, which keys are checked from where, and the secret
302
+ VALUE screen `wildo config sync` and the backend run over what is served
303
+ (source-backed)
304
+ - `references/framework-frontend-provider-consent-api.md` — which
305
+ capabilities a browser may host, provider-level consent purposes,
306
+ consent-gated component loading, the worker/media CSP buckets and the
307
+ address-lookup slot (source-backed)
308
+ - `references/framework-provider-component-registry-api.md` — how a
309
+ provider's `components` declaration reaches the application, the
310
+ marketing website and the documentation site: the shared registry, where a
311
+ component's loader comes from, the load states, and the slot each surface
312
+ mounts (source-backed)
220
313
 
221
314
  ## Verification
222
315
 
223
316
  - [ ] Module lives under `frontend/src/engine/providers/` and exports a typed `FrontendAppProviderModule`
224
317
  - [ ] Capability/protocol use the `BUILTIN_PROVIDER_*` vocabulary members, not string literals
225
318
  - [ ] `publicConfig` holds only the picker keys — no secret, no localized string
319
+ - [ ] Module declares a `publicConfigSchema` (`defineFrontendPublicConfigSchema`) covering every key its `publicConfig` carries beyond the capability's own
320
+ - [ ] `wildo config sync` passes: no served value equals a secret in the environment's `secrets.json`
226
321
  - [ ] Barrel + `./frontend-providers` entry expose the module
227
- - [ ] Contribution derives its fields from the module object and names `sourceModuleId`
322
+ - [ ] Module declares `complianceProfile` (`SELF_HOSTED` for a native input, `VENDOR_HOSTED` + regions for a vendor chooser)
323
+ - [ ] Contribution is built by `projectFrontendProviderContribution` and names `sourceModuleId`
324
+ - [ ] Every declared capability is browser-hosted, and any module-level `consentPurposes` are `ConsentPurpose` members (the projection refuses otherwise)
228
325
  - [ ] `wildo.saas.config.ts` scope entry exists for `<ref>` (reachability validation passes)
229
326
  - [ ] A file form field without schema-level constraints shows the provider's limits
230
327
 
@@ -236,9 +333,13 @@ Run from the app root, substituting `<ref>`:
236
333
  |---|---|
237
334
  | Module declares the typed capability pair | `rg -n "FRONTEND_FILE_PICKER" frontend/src/engine/providers/` |
238
335
  | No string-literal capability/protocol in the module | `rg -n "providerCapabilities: \['" frontend/src/engine/providers/` (must be empty) |
239
- | Contribution derives from the module (no re-typed literals) | `rg -n "publicConfig: .*Provider.publicConfig" frontend/src/provider-contributions.ts` |
336
+ | Module states who runs it | `rg -n "complianceProfile" frontend/src/engine/providers/<ref>.frontend-app.module.ts` |
337
+ | Contribution is the engine projection (no hand-written entry) | `rg -n "projectFrontendProviderContribution" frontend/src/provider-contributions.ts` |
338
+ | No hand-written `frontendEntry` literal | `rg -n "frontendEntry: \{" frontend/src/provider-contributions.ts` (must be empty) |
240
339
  | Scope entry present | `rg -n "<ref>" wildo.saas.config.ts` |
340
+ | Consent purposes use the vocabulary, not strings | `rg -n "consentPurposes: \['" frontend/src/engine/providers/` (must be empty) |
241
341
  | No secret-looking key in publicConfig | `rg -in "secret\|apikey\|token" frontend/src/engine/providers/<ref>.frontend-app.module.ts` (must be empty) |
342
+ | Module declares its public-config keys | `rg -n "publicConfigSchema: defineFrontendPublicConfigSchema" frontend/src/engine/providers/<ref>.frontend-app.module.ts` |
242
343
 
243
344
  ## Common Rationalizations
244
345
 
@@ -248,14 +349,22 @@ Run from the app root, substituting `<ref>`:
248
349
  | "String literals for capability/protocol are fine" | The resolver looks the module up by the exact vocabulary pair; a typo silently yields schema-only constraints with no error. |
249
350
  | "The provider should carry the field's stricter limit" | Per-field constraints belong on the field's schema — schema metadata deliberately WINS over the provider so one strict field never loosens the app default. |
250
351
  | "Skip the saas-config scope entry, it already works in dev" | The provider-runtime sync cross-validates contribution ↔ scope; the missing entry fails reachability validation at sync time, after you have moved on. |
352
+ | "A native-input picker needs no compliance profile" | A provider with no profile is reported as NOT ESTABLISHED by the recipient population, so an absent one reads as an unanswered recipient question. `SELF_HOSTED` is the answer, and it takes two lines. |
353
+ | "Writing the `frontendEntry` by hand is simpler than calling the projection" | A literal carries only the fields it names. That is how a compliance profile was authored on a picker and dropped before any compliance reader could see it. |
354
+ | "The picker only helps people upload, so its vendor needs no consent" | The capability's floor says the picker does not; a vendor whose chooser also profiles people for its own purposes must add `consentPurposes`, or it loads for everyone who declined. |
355
+ | "The module reads only a couple of keys, a schema is overkill" | Without a readable key list nothing can refuse a key the module never reads, so ANY key — a secret under an innocent name included — would be served to every browser. The module is refused until it declares one. |
356
+ | "Renaming the key gets past the secret refusal" | The refusal compares VALUES, not names: the same secret under any key is refused. Serve the vendor's public key instead, and rotate the secret if it was ever served. |
251
357
  | "Put the display name in publicConfig" | Display text is i18n-owned: `metadata.displayNameLabelKey` + the label pipeline. A frozen string ships one language to every locale. |
252
358
 
253
359
  ## Red Flags
254
360
 
255
361
  - A capability or protocol string literal in the module (catch with the **no string-literal** grep)
256
- - The contribution re-types capabilities/protocols/publicConfig instead of reading them from the module (catch with the **derives from the module** grep)
362
+ - The contribution hand-writes a `frontendEntry` instead of calling `projectFrontendProviderContribution` (catch with the **no hand-written `frontendEntry`** grep)
363
+ - A picker module with no `complianceProfile`, or a vendor chooser declaring `SELF_HOSTED` (catch with the **states who runs it** grep)
257
364
  - A secret, publishable-key-lookalike or localized string inside `publicConfig` (catch with the **no secret-looking key** grep)
365
+ - A provider module with no `publicConfigSchema`, or one that omits a key its `publicConfig` carries (catch with the **declares its public-config keys** grep)
258
366
  - An upload surface with its own hardcoded MIME/size table beside the provider
367
+ - A surface that renders nothing when `useProviderComponent` reports `CONSENT_REQUIRED` (catch with the consent-purposes grep above, then check the surface's `renderConsentRequired`)
259
368
  - `maxFileSizeMb` treated as bytes somewhere — the resolver converts Mb → bytes; consumers must not convert again
260
369
 
261
370
  ## Related Skills
@@ -0,0 +1,399 @@
1
+ # Consent, CSP buckets and the address-lookup slot — what a frontend provider module must declare
2
+
3
+ Read this when a frontend provider module:
4
+
5
+ - declares a capability, and you need to know whether a browser may host it at all;
6
+ - belongs to a vendor whose own processing goes beyond the service the person asked for;
7
+ - contributes a component, and you need to know when that component is allowed to load;
8
+ - starts a web worker or plays audio or video;
9
+ - is an address lookup (`FRONTEND_ADDRESS_LOOKUP`).
10
+
11
+ ## Every capability is classified, and a browser may host only some
12
+
13
+ Each provider capability is classified for the browser in one table, total over the whole vocabulary.
14
+ A frontend module may declare only a capability classified `browserHosted: true`; a server-only
15
+ capability (`LLM_CHAT`, `EMAIL_TRANSACTIONAL`, …) on a frontend module is refused when the contribution
16
+ is projected, and a provider that reaches a browser with one anyway never starts. The table also gives
17
+ each hosted capability its consent FLOOR — only `FRONTEND_PRODUCT_ANALYTICS` rests on consent
18
+ (`ANALYTICS`); `SSO_OAUTH2` is hosted without consent (browser sign-in code, such as a vendor's one-tap
19
+ SDK), and `BILLING` is server-only.
20
+
21
+ A frontend module exists for code that RUNS in the page. Do not declare one to give a provider a
22
+ display name: the name is `providers.<ref>.displayName`, generated for every declared provider ref, and
23
+ the sign-in buttons, the identity-links page and the billing components resolve it from the ref they
24
+ already hold (`auth.socialOAuth2Providers`, `billing.providerRef`). Redirect-based sign-in and hosted
25
+ checkout run no vendor code in the browser, so they have no frontend module. A browser-hosted capability
26
+ fills an engine slot only when that slot's work happens on the page (error monitoring, product
27
+ analytics); one that maps to a backend slot is refused when projected.
28
+
29
+ ## Import Origins
30
+
31
+ - `@wildo-ai/external-connectors-public`
32
+
33
+ ## Source Excerpts
34
+
35
+ ### Origin Package: `@wildo-ai/external-connectors-public`
36
+
37
+ ```typescript
38
+ /**
39
+ * The consent classification of EVERY provider capability — total over the vocabulary, so a capability
40
+ * added tomorrow does not compile until it is classified here (#1702).
41
+ *
42
+ * A frontend provider module may declare only capabilities classified `browserHosted: true`; it rests on
43
+ * the union of their `consentPurposes` and its own module-level `consentPurposes`.
44
+ */
45
+ export const PROVIDER_CAPABILITY_FRONTEND_CONSENT_CLASSIFICATION = Object.freeze({
46
+ // Browser-hosted, consent-based: measuring how the service is used.
47
+ FRONTEND_PRODUCT_ANALYTICS: Object.freeze({ browserHosted: true, consentPurposes: Object.freeze([ConsentPurpose.ANALYTICS]) }),
48
+ // Browser-hosted, no consent at the floor: each delivers or protects a service the person asked for.
49
+ FRONTEND_ERROR_MONITORING: HOSTED_WITHOUT_CONSENT,
50
+ FRONTEND_CAPTCHA: HOSTED_WITHOUT_CONSENT,
51
+ FRONTEND_SEARCH: HOSTED_WITHOUT_CONSENT,
52
+ FRONTEND_FILE_PICKER: HOSTED_WITHOUT_CONSENT,
53
+ FRONTEND_ADDRESS_LOOKUP: HOSTED_WITHOUT_CONSENT,
54
+ // Browser sign-in code (a vendor's one-tap or button SDK). The person asked to sign in; that is not
55
+ // consent-based processing. No engine module declares it today: the redirect-based sign-in the engine
56
+ // ships runs no vendor code on the page, and its button labels come from the ref (#1701).
57
+ SSO_OAUTH2: HOSTED_WITHOUT_CONSENT,
58
+ // Server-side only. A frontend module declaring any of these is refused.
59
+ // BILLING is the backend billing slot (subscriptions, checkout sessions, the portal link, webhooks).
60
+ // Checkout and the customer portal are hosted redirects, so no billing code runs in the browser; a
61
+ // frontend module declaring it used to FILL the engine's billing slot from the browser (#1701). An
62
+ // embedded payment UI would be its own browser capability, decided in #1741.
63
+ BILLING: SERVER_ONLY,
64
+ EMAIL_TRANSACTIONAL: SERVER_ONLY,
65
+ EMAIL_MARKETING: SERVER_ONLY,
66
+ EMAIL_INBOUND: SERVER_ONLY,
67
+ SMS: SERVER_ONLY,
68
+ SSO_SAML: SERVER_ONLY,
69
+ LLM_CHAT: SERVER_ONLY,
70
+ LLM_EMBEDDINGS: SERVER_ONLY,
71
+ DOCUMENT_TEXT_EXTRACTION: SERVER_ONLY,
72
+ CODING_AGENT: SERVER_ONLY,
73
+ IMAGE_GENERATION: SERVER_ONLY,
74
+ LLM_OBSERVABILITY: SERVER_ONLY,
75
+ OBSERVABILITY_TELEMETRY: SERVER_ONLY,
76
+ COMPLIANCE_AUDIT_TRAIL: SERVER_ONLY,
77
+ } as const satisfies Readonly<Record<ProviderCapability, FrontendCapabilityConsentClassification>>);
78
+ ```
79
+
80
+ ## A consent-based provider must be stoppable
81
+
82
+ Consent can be withdrawn at any moment, and a withdrawal must stop what the grant started, in the same
83
+ page. So a provider that rests on ANY purpose — from its capability or its own `consentPurposes` — must:
84
+
85
+ - ship as an `sdk`, never as `scripts`. An injected `<script>` cannot be stopped (removing the element
86
+ undoes nothing it already ran), so a consent-based module declaring `scripts` is refused when its
87
+ contribution is projected, withheld at hydration, and its scripts are never injected. A vendor that ships
88
+ as a script loads it from inside `sdk.activate`, where it can also stop it;
89
+ - declare `sdk.stoppable: true`, and return a `deactivate` from `activate` that fully stops the vendor and
90
+ removes what it stored in the page's own storage. Check what the vendor's teardown really clears: PostHog's
91
+ `reset(true)` alone writes a FRESH distinct id and device id back, so the engine's PostHog module starts it
92
+ with `opt_out_persistence_by_default: true` and then `opt_out_capturing()` removes its localStorage entry
93
+ and cookie. What a vendor stored in cookies of its OWN domain cannot be cleared by the page, which is one
94
+ more reason it starts only on consent. Without the declaration the provider never starts; with it and no
95
+ `deactivate`, the runner reports a broken promise.
96
+
97
+ A provider that rests on no purpose (error monitoring, a file picker) is not held to this: nothing can be
98
+ withdrawn from it.
99
+
100
+ ## The application starts it on the signed-in person's grant
101
+
102
+ The application's startup activation runs before anyone is known, so it starts only providers that rest
103
+ on no purpose. The consent-based ones are started by `ConsentBasedProviderSdksProvider`, mounted by the
104
+ framework beside analytics: it reads the person's `privacy.consentedPurposes` from their preferences,
105
+ starts the consent-based providers once the purposes they rest on are granted, and calls their `deactivate`
106
+ on withdrawal and on sign-out (which publishes `privacy: null`). A change to the granted subset of those
107
+ purposes restarts all of them, one start only after the previous stop has finished. Pre-authentication pages start none. The consent decision itself is the audited preference
108
+ write; starting and stopping a provider records nothing more.
109
+
110
+ A `FRONTEND_PRODUCT_ANALYTICS` provider's activation returns a `FrontendProductAnalyticsSink`
111
+ (`track`, `page`, `identify`, `reset`). `useAnalytics().track()` and the framework's own
112
+ auto-instrumentation dispatch to every running sink, behind the `analytics.enabled` master switch. Each
113
+ running sink is identified with the framework's opaque user id of the identity analytics already holds, and
114
+ reset when that identity leaves. That is
115
+ the only way a vendor receives the application's analytics: declare the vendor's frontend module in the
116
+ application's frontend scope (the engine ships `posthog` for the app tier); there is no second provider
117
+ list inside analytics.
118
+
119
+ ## Import Origins
120
+
121
+ - `@wildo-ai/saas-frontend-lib`
122
+
123
+ ## Source Excerpts
124
+
125
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
126
+
127
+ ```tsx
128
+ /**
129
+ * The consent-based providers currently RUNNING on the application, in registry order (#1704).
130
+ *
131
+ * Empty until the signed-in person grants the purposes a provider rests on, and emptied again on withdrawal or
132
+ * sign-out — immediately, before the providers' `deactivate` has finished. A consumer that dispatches to a
133
+ * provider (`AnalyticsContext` does, for `FRONTEND_PRODUCT_ANALYTICS`) reads this and never holds a handle past it.
134
+ */
135
+ export function useConsentBasedProviderActivations(): ReadonlyArray<ConsentBasedProviderActivation> {
136
+ return useContext(ConsentBasedProviderActivationsContext);
137
+ }
138
+ ```
139
+
140
+ ## A vendor may ADD consent purposes, never remove them
141
+
142
+ Declare `consentPurposes` on the module when the vendor does more than its capability's floor — a
143
+ captcha whose vendor also analyses visitors for its own purposes is the case this exists for. The
144
+ provider then rests on the union of these and the floor, so declaring `consentPurposes: []` on an
145
+ analytics provider changes nothing. A value outside `ConsentPurpose` is refused at projection; do not
146
+ invent a purpose, adding one is a product decision with legal weight.
147
+
148
+ The purposes gate EVERYTHING of that provider on every surface: its SDK is not activated and its
149
+ components are not downloaded until the person has granted them. It declares no `<script>` tags at all —
150
+ see "A consent-based provider must be stoppable" above.
151
+
152
+ ## Loading a component is consent-gated
153
+
154
+ `useProviderComponent` asks the registry before downloading anything. A provider resting on a purpose the
155
+ signed-in person has not granted reports `ProviderComponentStatus.CONSENT_REQUIRED` with the
156
+ `missingConsentPurposes`, and a surface must render a consent-required state there — announced, with a
157
+ keyboard-reachable action that grants exactly those purposes — never a blank. `ProviderFilePickerHost`
158
+ does this for the file picker; pass `renderConsentRequired` to word it in your own chrome. Granting goes
159
+ through the person's audited preference write, and the component loads without a re-mount.
160
+
161
+ ## Worker and media origins
162
+
163
+ A provider that starts a web worker declares `csp.workerOrigins` (a `blob:` scheme source is allowed);
164
+ one that plays audio or video declares `csp.mediaOrigins`. Both compose into the service's
165
+ `worker-src` / `media-src` like every other bucket. When the application's policy does not state that
166
+ directive, the framework seeds it from the directive it was falling back to, so declaring
167
+ `workerOrigins: ['blob:']` never revokes the page's own `'self'` workers.
168
+
169
+ ## The address-lookup slot
170
+
171
+ Enabling a lookup (Google Places) and writing one for another vendor are taught by `provider-address-lookup`: a
172
+ lookup reaches its vendor only through the application backend, and needs no consent at the capability floor. What
173
+ follows is the slot contract itself.
174
+
175
+ An address-lookup component returns a `ProviderAddressLookupSelection`: the structured `z_address()`
176
+ value, plus the vendor's place id only if its component descriptor declares `placeIdRetention: TRANSIENT`
177
+ (usable for the interaction). A place id is never stored, whatever the vendor's terms allow: the field keeps
178
+ only the address. An undeclared retention means the component returns no place id, and a selection carrying
179
+ one is refused by `receiveProviderAddressLookupSelection`.
180
+
181
+ ## Import Origins
182
+
183
+ - `@wildo-ai/saas-models`
184
+
185
+ ## Source Excerpts
186
+
187
+ ### Origin Package: `@wildo-ai/saas-models`
188
+
189
+ ```typescript
190
+ /**
191
+ * What an address lookup hands back for ONE chosen place.
192
+ *
193
+ * `address` is the application's own value: the person chose it, and it is stored exactly as a typed
194
+ * address would be. `placeId` is the VENDOR's key for the place, present only when the component's
195
+ * declared `placeIdRetention` allows one; the framework refuses a selection that carries a place id its
196
+ * component declared it never returns, and never stores one (#561 D3).
197
+ */
198
+ export interface ProviderAddressLookupSelection {
199
+ readonly address: AddressValue;
200
+ /** The vendor's identifier for the matched place. Opaque, usable for this interaction only, and never stored. */
201
+ readonly placeId?: string;
202
+ }
203
+
204
+ /**
205
+ * The props every `FRONTEND_ADDRESS_LOOKUP` component receives.
206
+ *
207
+ * Deliberately narrow. The component suggests and resolves; the FIELD owns the value, its validation
208
+ * (`z_address()` with its `countriesAllowed`) and its persistence. That split is what lets an address
209
+ * field work with no lookup at all, which is why the capability fills no engine slot.
210
+ *
211
+ * ## The vendor is reached through `suggest` and `retrieve`, never directly (#561 D2)
212
+ *
213
+ * The framework's host binds both to the operations the component's descriptor declares
214
+ * (`addressLookup.suggestOperationId` / `retrieveOperationId`) and runs them through the application
215
+ * backend's provider-operation door. The host also writes the vendor session token into each input when the
216
+ * descriptor names `sessionTokenInput` (#561 D4) — a component never generates, holds or rotates one. Each
217
+ * resolves to the operation's parsed output, and rejects with the door's error (a refusal, a throttle, a
218
+ * vendor timeout); a component reports that through `onError` and the field stays usable by hand.
219
+ */
220
+ export interface ProviderAddressLookupProps {
221
+ /** The provider's own `ref`. */
222
+ readonly providerRef: string;
223
+ /** The provider's public configuration, already validated against its `publicConfigSchema` when it declares one. */
224
+ readonly publicConfig: Readonly<Record<string, unknown>>;
225
+ /**
226
+ * ISO 3166-1 alpha-2 codes the field accepts (`z_address({ countriesAllowed })`). A component should
227
+ * restrict its suggestions to them; the field still validates whatever comes back.
228
+ */
229
+ readonly countriesAllowed?: readonly string[];
230
+ /** The field's default country, a hint for ranking suggestions. */
231
+ readonly defaultCountry?: string;
232
+ /** The person's language (BCP 47), so suggestions and the retrieved address are spelled in it where the vendor can. */
233
+ readonly languageCode: string;
234
+ /** True while the field is disabled or read-only: the component offers no search then. */
235
+ readonly disabled: boolean;
236
+ /**
237
+ * The search control's form NAME. The host renders the control's visible label (from the application's
238
+ * labels) for the element whose id is `field-<name>` — the id every engine form control takes — so the
239
+ * component puts that id on its focusable control and invents no label text of its own.
240
+ */
241
+ readonly name: string;
242
+ /**
243
+ * The vendor's required attribution (#561 D4), from the descriptor's `attributionMark`, or absent when the vendor
244
+ * requires none. `mark` is the vendor's text, verbatim; `accessibleLabel` is a sentence from the application's
245
+ * labels naming it, for assistive technology.
246
+ *
247
+ * The component shows it INSIDE the container that shows its suggestions, whenever suggestions are shown — the
248
+ * placement Google requires ("within the same visual container" as the content). Render it with
249
+ * `ProviderAddressLookupAttribution` (`@wildo-ai/saas-frontend-lib`), which applies the vendor's text rules
250
+ * (untranslated, on one line, in a permitted colour); the framework's own lookup combobox does.
251
+ * spec-cite: https://developers.google.com/maps/documentation/places/web-service/policies — text attribution rules,
252
+ * fetched 2026-09-29.
253
+ */
254
+ readonly attribution?: ProviderAddressLookupAttributionText;
255
+ /** Run the declared SUGGEST operation with this input. */
256
+ suggest(input: Readonly<Record<string, unknown>>): Promise<unknown>;
257
+ /** Run the declared RETRIEVE operation with this input. Ends the vendor session, whatever it answers. */
258
+ retrieve(input: Readonly<Record<string, unknown>>): Promise<unknown>;
259
+ /** The person chose a place. Called at most once per interaction. */
260
+ onSelect(selection: ProviderAddressLookupSelection): void;
261
+ /** The person dismissed the lookup without choosing. Ends the vendor session. */
262
+ onCancel(): void;
263
+ /**
264
+ * The lookup could not run — the door refused it, the vendor timed out or answered a shape the adapter
265
+ * cannot read. Reported rather than thrown, for the reason the file-picker contract gives: a throw inside
266
+ * a component's own event handler reaches no React error boundary.
267
+ */
268
+ onError(error: Error): void;
269
+ }
270
+
271
+ /** A vendor's required attribution, as the host hands it to a lookup component. */
272
+ export interface ProviderAddressLookupAttributionText {
273
+ /** The vendor's own attribution text, never translated or restyled ("Google Maps"). */
274
+ readonly mark: string;
275
+ /** A sentence from the application's labels that names the mark, for assistive technology. */
276
+ readonly accessibleLabel: string;
277
+ }
278
+
279
+ /** One suggestion, as a person reads it. Vendor text, never derived by the framework. */
280
+ export interface ProviderAddressLookupSuggestion {
281
+ /** The vendor's handle for the suggestion, passed back to `buildRetrieveInput`. Opaque; never stored. */
282
+ readonly id: string;
283
+ /** The line a person recognises the place by (the street address). */
284
+ readonly primaryText: string;
285
+ /** The line that disambiguates it (town, region, country), when the vendor gives one. */
286
+ readonly secondaryText?: string;
287
+ }
288
+
289
+ /**
290
+ * Everything VENDOR-SPECIFIC about an address lookup, as four pure functions: how a query becomes the
291
+ * suggest operation's input, how its answer becomes suggestions, how a chosen suggestion becomes the retrieve
292
+ * operation's input, and how that answer becomes the framework's `AddressValue`.
293
+ *
294
+ * With it, the framework's own combobox (`ProviderAddressLookupCombobox` in `@wildo-ai/saas-frontend-lib`)
295
+ * is a complete lookup component: the keyboard pattern, the debounce, the minimum query length, stale-answer
296
+ * handling and the manual-entry fallback are written once rather than once per vendor. A provider whose
297
+ * lookup needs its own UI implements `ProviderAddressLookupProps` directly instead.
298
+ *
299
+ * `readAddress` returns TEXT parts only: a vendor geocode is never taken (#561 D3). A stored coordinate has no
300
+ * expiry, while a lookup's geocode is at best storable for a limited time (Google: 30 days) or not at all (Mapbox
301
+ * Search Box) — #561's 2026-09-14 reading of both vendors' terms — and nothing runs the vendor's clock. The
302
+ * field drops coordinates anyway.
303
+ */
304
+ export interface ProviderAddressLookupAdapter {
305
+ buildSuggestInput(request: {
306
+ readonly query: string;
307
+ readonly countriesAllowed?: readonly string[];
308
+ readonly defaultCountry?: string;
309
+ readonly languageCode: string;
310
+ }): Record<string, unknown>;
311
+ /** Never throws on a well-formed but empty answer; returns `[]`. Throws only on an answer it cannot read. */
312
+ readSuggestions(output: unknown): readonly ProviderAddressLookupSuggestion[];
313
+ buildRetrieveInput(request: { readonly suggestion: ProviderAddressLookupSuggestion; readonly languageCode: string }): Record<string, unknown>;
314
+ /** `undefined` when the vendor answered with no postal address for the place (a place with no street address). */
315
+ readAddress(output: unknown): AddressValue | undefined;
316
+ }
317
+ ```
318
+
319
+ The FIELD a lookup fills is `FormFieldAddress`, which every `z_address()` field renders. It depends on no
320
+ provider: its `renderLookup` slot hands whatever renders there an `AddressFieldLookupHost` — the field's
321
+ accepted countries, its default country, whether it is editable, and `applyAddress`. A lookup validates
322
+ the selection (`receiveProviderAddressLookupSelection` with the field's schema), then calls `applyAddress`,
323
+ which replaces every text part and the country as if the person had typed the chosen address, and leaves
324
+ them editable. It always clears the coordinates, including any the lookup passes: a vendor geocode is at
325
+ best storable for a limited time, while a stored address geocode never expires, so it is never filled from
326
+ a lookup. Do not fill the address's coordinates from a vendor response by any other route either.
327
+
328
+ ## Import Origins
329
+
330
+ - `@wildo-ai/saas-frontend-lib`
331
+
332
+ ## Source Excerpts
333
+
334
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
335
+
336
+ ```tsx
337
+ /**
338
+ * Props of `FormFieldAddress` (`@wildo-ai/saas-frontend-lib`), the control the framework renders for every
339
+ * field declared with `z_address()`. Forms dispatch to it automatically; an application passes these
340
+ * props itself only when it renders the control directly or fills its lookup slot.
341
+ */
342
+ export interface FormFieldAddressProps extends Omit<ControlBaseProps, 'value' | 'onChange' | 'defaultValue'> {
343
+ value?: AddressValue;
344
+ /**
345
+ * `undefined` is emitted when the user empties every part of a clearable field — the control's
346
+ * "no address" gesture. A pre-selected country alone is not an entry and does not count.
347
+ */
348
+ onChange?: (value: AddressValue | undefined) => void;
349
+ defaultValue?: AddressValue;
350
+ /**
351
+ * The resolved, displayable error of each part that has one, keyed by the part's dotted path inside
352
+ * the value (`city`, `coordinates.longitude` — see `listAddressPartPaths`). Resolved by the form,
353
+ * which owns touch/submit visibility; the control only places each message under its input.
354
+ */
355
+ partErrors?: Readonly<Record<string, string | undefined>>;
356
+ /**
357
+ * Renders an address LOOKUP (a vendor autocomplete) above the parts. Omitted, the field is the plain
358
+ * multi-part control, and it stays fully usable by hand when a lookup is refused or fails. The field
359
+ * decides nothing about which lookup this is and imports no provider code: whoever fills the slot
360
+ * resolves the provider, its consent and its errors, and fills the field through
361
+ * {@link AddressFieldLookupHost.applyAddress}.
362
+ */
363
+ renderLookup?: (host: AddressFieldLookupHost) => React.ReactNode;
364
+ }
365
+
366
+ /**
367
+ * What an address field hands to the lookup rendered in its `renderLookup` slot.
368
+ *
369
+ * Deliberately provider-free: every member is the FIELD's own knowledge (its `z_address()` options and
370
+ * its editability) plus one way to fill it. A vendor lookup narrows its suggestions to
371
+ * `countriesAllowed`, ranks by `defaultCountry`, and calls `applyAddress` with the place the person chose.
372
+ */
373
+ export interface AddressFieldLookupHost {
374
+ /** ISO 3166-1 alpha-2 codes the field accepts, from `z_address({ countriesAllowed })`. Absent means any; never empty. */
375
+ readonly countriesAllowed?: readonly string[];
376
+ /** The field's default country, from `z_address({ defaultCountry })` — a ranking hint for suggestions. */
377
+ readonly defaultCountry?: string;
378
+ /** True while the field is disabled or read-only. A lookup must not offer to fill it then; `applyAddress` ignores the call. */
379
+ readonly disabled: boolean;
380
+ /**
381
+ * Replace every TEXT part and the country with the chosen address, as though the person had typed
382
+ * it, and emit the value.
383
+ *
384
+ * Every text part is replaced, including the ones the chosen address omits: a `line2` left over from
385
+ * the previous address describes a different place, so keeping it would compose an address that exists
386
+ * nowhere.
387
+ *
388
+ * Coordinates are ALWAYS cleared, whatever `address` carries. The previous geocode describes the previous
389
+ * place, and a lookup's geocode is never stored: vendors' terms either forbid storing it or allow it for a
390
+ * limited time, while a stored `coordinates` has no expiry, so nothing would ever delete it on the
391
+ * vendor's clock. The person can still enter coordinates by hand where the field offers them.
392
+ *
393
+ * The value is NOT validated here: it goes through the same form validation as a typed address, so a
394
+ * country outside `countriesAllowed` shows the same error under the country part. A caller that wants to
395
+ * refuse such a value before it reaches the field (the provider path does) validates it first.
396
+ */
397
+ applyAddress(address: AddressValue): void;
398
+ }
399
+ ```