@wildo-ai/framework-knowledge 1.1.3 → 1.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (841) hide show
  1. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  2. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  3. package/dist/esm/framework-knowledge.definitions.js +349 -17
  4. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  5. package/dist/esm/framework-knowledge.loader.d.ts +19 -0
  6. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  7. package/dist/esm/framework-knowledge.loader.js +47 -1
  8. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  9. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  10. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
  11. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  12. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +125 -0
  13. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
  14. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
  15. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
  16. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
  17. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  18. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +326 -8
  19. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  20. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +5 -3
  21. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  22. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +21 -14
  23. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
  25. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
  26. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
  27. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
  28. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
  29. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
  30. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
  31. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
  32. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
  33. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
  34. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
  35. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
  36. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
  37. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +10 -5
  39. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
  41. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
  42. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
  43. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
  44. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
  45. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
  47. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +67 -0
  49. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
  50. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
  51. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
  52. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
  53. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
  54. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
  55. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
  56. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
  57. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
  58. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +71 -0
  60. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
  61. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
  62. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
  63. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
  64. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
  65. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
  66. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
  67. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
  68. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
  69. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
  70. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
  71. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
  72. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
  74. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +171 -1
  76. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +146 -1
  78. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
  80. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
  81. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
  82. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
  83. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
  84. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  85. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +172 -4
  86. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  87. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
  88. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  89. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +8 -7
  90. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  91. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
  92. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  93. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +22 -3
  94. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  95. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +5 -3
  96. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +21 -12
  98. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  99. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +192 -27
  100. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  101. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +172 -33
  102. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  103. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +2 -1
  104. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  105. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +6 -2
  106. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  107. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +182 -5
  108. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  109. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +191 -5
  110. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  111. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +2 -1
  112. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  113. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +3 -2
  114. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  115. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +154 -0
  116. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
  117. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
  118. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
  119. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
  120. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
  121. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
  122. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
  123. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
  124. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  125. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +2 -1
  126. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  127. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
  128. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  129. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +6 -2
  130. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  131. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
  132. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  133. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +2 -1
  134. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  135. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
  136. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  137. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -3
  138. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  139. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +32 -4
  140. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  141. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +27 -3
  142. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  143. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -2
  144. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  145. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +4 -2
  146. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  147. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
  148. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
  149. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
  150. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
  151. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
  152. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  153. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +18 -4
  154. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
  156. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  157. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -4
  158. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  159. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +6 -5
  160. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  161. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +18 -17
  162. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  163. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  164. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
  165. package/dist/knowledge/manifest.json +9 -8
  166. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
  167. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
  168. package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
  169. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
  170. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
  171. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
  172. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
  173. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
  174. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
  175. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
  176. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
  177. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
  178. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
  179. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
  180. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
  181. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
  182. package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
  183. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
  184. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
  185. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
  186. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
  187. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
  188. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
  189. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
  190. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
  191. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
  192. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
  193. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
  194. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
  195. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
  196. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
  197. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
  198. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
  199. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
  200. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
  201. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
  202. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
  203. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
  204. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
  205. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
  206. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
  207. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
  208. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
  209. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
  210. package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
  211. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
  212. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
  213. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
  214. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
  215. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
  216. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
  217. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
  218. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
  219. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
  220. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
  221. package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
  222. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
  223. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
  224. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
  225. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
  226. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
  227. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
  228. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
  229. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
  230. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
  231. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
  232. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
  233. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
  234. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
  235. package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
  236. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
  237. package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
  238. package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
  239. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
  240. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
  241. package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
  242. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
  243. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
  244. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
  245. package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
  246. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
  247. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
  248. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
  249. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
  250. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
  251. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  252. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  253. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
  254. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
  255. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
  256. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
  257. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
  258. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
  259. package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
  260. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
  261. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
  262. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
  263. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
  264. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
  265. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
  266. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
  267. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
  268. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
  269. package/dist/knowledge/references/acp.execution-profile.md +266 -0
  270. package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
  271. package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
  272. package/dist/knowledge/references/acp.permission-escalation.md +37 -0
  273. package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
  274. package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
  275. package/dist/knowledge/references/application-maturity.config.md +319 -0
  276. package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
  277. package/dist/knowledge/references/assertions.specification.config.md +1 -1
  278. package/dist/knowledge/references/brand.asset.config.md +8 -16
  279. package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
  280. package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
  281. package/dist/knowledge/references/brand.snapshot.config.md +16 -2
  282. package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
  283. package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
  284. package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
  285. package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
  286. package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
  287. package/dist/knowledge/references/capability-composition.config.md +155 -0
  288. package/dist/knowledge/references/cli.market.utils.md +1 -0
  289. package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
  290. package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
  291. package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
  292. package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
  293. package/dist/knowledge/references/engine.saas-website.config.md +22 -10
  294. package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
  295. package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
  296. package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
  297. package/dist/knowledge/references/example.config.design-system.full.md +3 -0
  298. package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
  299. package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
  300. package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
  301. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
  302. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
  303. package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
  304. package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
  305. package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
  306. package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
  307. package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
  308. package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
  309. package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
  310. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
  311. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
  312. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
  313. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
  314. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
  315. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
  316. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
  317. package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
  318. package/dist/knowledge/references/example.worker.node-route.md +94 -0
  319. package/dist/knowledge/references/experience-plan.config.md +311 -0
  320. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
  321. package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
  322. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
  323. package/dist/knowledge/references/integration-plan.config.md +185 -0
  324. package/dist/knowledge/references/market.alternative.config.md +1 -1
  325. package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
  326. package/dist/knowledge/references/market.channel.config.md +3 -3
  327. package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
  328. package/dist/knowledge/references/market.gain.config.md +1 -1
  329. package/dist/knowledge/references/market.icp.config.md +2 -2
  330. package/dist/knowledge/references/market.job.config.md +1 -1
  331. package/dist/knowledge/references/market.message-template.config.md +2 -2
  332. package/dist/knowledge/references/market.objection.config.md +1 -1
  333. package/dist/knowledge/references/market.pain.config.md +1 -1
  334. package/dist/knowledge/references/market.persona.config.md +2 -2
  335. package/dist/knowledge/references/market.proof.config.md +1 -1
  336. package/dist/knowledge/references/market.snapshot.validation.md +15 -0
  337. package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
  338. package/dist/knowledge/references/market.trigger.config.md +1 -1
  339. package/dist/knowledge/references/minions.tick-contract.md +83 -0
  340. package/dist/knowledge/references/placement-plan.config.md +369 -0
  341. package/dist/knowledge/references/platform.config.application-database.md +5 -2
  342. package/dist/knowledge/references/platform.config.backing-services.md +0 -21
  343. package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
  344. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
  345. package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
  346. package/dist/knowledge/references/platform.config.saas.md +261 -9
  347. package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
  348. package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
  349. package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
  350. package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
  351. package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
  352. package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
  353. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
  354. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
  355. package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
  356. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
  357. package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
  358. package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
  359. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
  360. package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
  361. package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
  362. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
  363. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
  364. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
  365. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
  366. package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
  367. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
  368. package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
  369. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
  370. package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
  371. package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
  372. package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
  373. package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
  374. package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
  375. package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
  376. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
  377. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
  378. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
  379. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
  380. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
  381. package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
  382. package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
  383. package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
  384. package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
  385. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
  386. package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
  387. package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
  388. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
  389. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
  390. package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
  391. package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
  392. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
  393. package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
  394. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
  395. package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
  396. package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
  397. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
  398. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
  399. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
  400. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
  401. package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
  402. package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
  403. package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
  404. package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
  405. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
  406. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
  407. package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
  408. package/dist/knowledge/references/saas.models.config.registration.md +188 -0
  409. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
  410. package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
  411. package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
  412. package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
  413. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
  414. package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
  415. package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
  416. package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
  417. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
  418. package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
  419. package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
  420. package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
  421. package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
  422. package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
  423. package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
  424. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
  425. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
  426. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
  427. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
  428. package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
  429. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
  430. package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
  431. package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
  432. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
  433. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
  434. package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
  435. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
  436. package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
  437. package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
  438. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
  439. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
  440. package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
  441. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
  442. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
  443. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
  444. package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
  445. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
  446. package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
  447. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
  448. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
  449. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
  450. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
  451. package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
  452. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
  453. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
  454. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
  455. package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
  456. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
  457. package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
  458. package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
  459. package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
  460. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
  461. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
  462. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
  463. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
  464. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
  465. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
  466. package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
  467. package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
  468. package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
  469. package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
  470. package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
  471. package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
  472. package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
  473. package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
  474. package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
  475. package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
  476. package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
  477. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
  478. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
  479. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
  480. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
  481. package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
  482. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
  483. package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
  484. package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
  485. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
  486. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
  487. package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
  488. package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
  489. package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
  490. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
  491. package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
  492. package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
  493. package/dist/knowledge/references/saas.website.consent.context.md +162 -0
  494. package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
  495. package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
  496. package/dist/knowledge/references/saas.website.page.context.md +4 -3
  497. package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
  498. package/dist/knowledge/references/saas.website.section.context.md +3 -2
  499. package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
  500. package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
  501. package/dist/knowledge/references/website-plan.config.md +205 -0
  502. package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
  503. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
  504. package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
  505. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
  506. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
  507. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
  508. package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
  509. package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
  510. package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
  511. package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
  512. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
  513. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
  514. package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
  515. package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
  516. package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
  517. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
  518. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
  519. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
  520. package/dist/knowledge/references/zod.factories.address.md +118 -0
  521. package/dist/knowledge/references/zod.factories.code.md +2 -0
  522. package/dist/knowledge/references/zod.factories.duration.md +2 -0
  523. package/dist/knowledge/references/zod.factories.money.md +2 -0
  524. package/dist/knowledge/references/zod.factories.phone.md +14 -1
  525. package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
  526. package/dist/knowledge/registries/framework-topics.json +1215 -11
  527. package/dist/knowledge/registries/playbooks.json +454 -50
  528. package/dist/knowledge/registries/source-tags.json +3153 -1043
  529. package/dist/knowledge/rules/database-migration-obligation.md +110 -0
  530. package/dist/knowledge/rules/live-context-door.md +108 -0
  531. package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
  532. package/dist/knowledge/skills/INDEX.md +46 -11
  533. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
  534. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
  535. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
  536. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
  537. package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
  538. package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
  539. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
  540. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
  541. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
  542. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
  543. package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
  544. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
  545. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
  546. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
  547. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
  548. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
  549. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
  550. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
  551. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
  552. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
  553. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
  554. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
  555. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
  556. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
  557. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
  558. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
  559. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
  560. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
  561. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
  562. package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
  563. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
  564. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
  565. package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
  566. package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
  567. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
  568. package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
  569. package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
  570. package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
  571. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
  572. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
  573. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
  574. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
  575. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
  576. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
  577. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
  578. package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
  579. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
  580. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
  581. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
  582. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
  583. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
  584. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
  585. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
  586. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
  587. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
  588. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
  589. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
  590. package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
  591. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
  592. package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
  593. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
  594. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
  595. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
  596. package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
  597. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
  598. package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
  599. package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
  600. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
  601. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
  602. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
  603. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
  604. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
  605. package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
  606. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
  607. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
  608. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
  609. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
  610. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
  611. package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
  612. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
  613. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
  614. package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
  615. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
  616. package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
  617. package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
  618. package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
  619. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
  620. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
  621. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
  622. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
  623. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
  624. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
  625. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
  626. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
  627. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
  628. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
  629. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
  630. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
  631. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
  632. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
  633. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
  634. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
  635. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
  636. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
  637. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
  638. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
  639. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
  640. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
  641. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
  642. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
  643. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
  644. package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
  645. package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
  646. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
  647. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
  648. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
  649. package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
  650. package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
  651. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
  652. package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
  653. package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
  654. package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
  655. package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
  656. package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
  657. package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
  658. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
  659. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
  660. package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
  661. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
  662. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
  663. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
  664. package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
  665. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
  666. package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
  667. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
  668. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
  669. package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
  670. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
  671. package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
  672. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
  673. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
  674. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
  675. package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
  676. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
  677. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
  678. package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
  679. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
  680. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
  681. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
  682. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
  683. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
  684. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
  685. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
  686. package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
  687. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
  688. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
  689. package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
  690. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
  691. package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
  692. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
  693. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
  694. package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
  695. package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
  696. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
  697. package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
  698. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
  699. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
  700. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
  701. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
  702. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
  703. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
  704. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
  705. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
  706. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
  707. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
  708. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
  709. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
  710. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
  711. package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
  712. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
  713. package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
  714. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
  715. package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
  716. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
  717. package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
  718. package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
  719. package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
  720. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
  721. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
  722. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
  723. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
  724. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
  725. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
  726. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
  727. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
  728. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
  729. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
  730. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
  731. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
  732. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
  733. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
  734. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
  735. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
  736. package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
  737. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
  738. package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
  739. package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
  740. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
  741. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
  742. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
  743. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
  744. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
  745. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
  746. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
  747. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
  748. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
  749. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
  750. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
  751. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
  752. package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
  753. package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
  754. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
  755. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
  756. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
  757. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
  758. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
  759. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
  760. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
  761. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
  762. package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
  763. package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
  764. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
  765. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
  766. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
  767. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
  768. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
  769. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
  770. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
  771. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
  772. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
  773. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
  774. package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
  775. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
  776. package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
  777. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
  778. package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
  779. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
  780. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
  781. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
  782. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
  783. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
  784. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
  785. package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
  786. package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
  787. package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
  788. package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
  789. package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
  790. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
  791. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
  792. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
  793. package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
  794. package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
  795. package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
  796. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
  797. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
  798. package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
  799. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
  800. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
  801. package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
  802. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
  803. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
  804. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
  805. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
  806. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
  807. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
  808. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
  809. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
  810. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
  811. package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
  812. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
  813. package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
  814. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
  815. package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
  816. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
  817. package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
  818. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
  819. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
  820. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
  821. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
  822. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
  823. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
  824. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
  825. package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
  826. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
  827. package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
  828. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
  829. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
  830. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
  831. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
  832. package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
  833. package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
  834. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
  835. package/dist/knowledge/topic-index.json +5335 -1010
  836. package/dist/tsconfig.build.tsbuildinfo +1 -1
  837. package/dist/tsconfig.tsbuildinfo +1 -1
  838. package/package.json +4 -4
  839. package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
  840. package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
  841. /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: website-consent-gate-overrides
3
- description: Customize a website consent gate while preserving the application's consent, storage and anonymous-session boundaries. Use when the user says "customize the consent banner", "override WebsiteConsentGate", "configure consent jurisdictions", or "wire a brand-specific cookie consent UI".
3
+ description: Customize the website's visitor consent panel, gate consent-based content, and keep optional tracking off until a visitor agrees. Use when the user says "customize the consent banner", "override the consent panel", "gate this embed behind consent", "add a privacy choices link", or "wire a brand-specific cookie consent UI".
4
4
  ---
5
5
 
6
6
  # Website Consent Gate Overrides
@@ -19,65 +19,67 @@ Read and apply these patterns from the application-developer point of view:
19
19
 
20
20
  ## Overview
21
21
 
22
- A consent UI is an interaction layer over an application policy. A visual
23
- override may improve brand fit and accessibility, but it must not silently
24
- change what is collected, the legal basis selected by the application, or the
25
- conditions under which optional website behavior starts.
22
+ The marketing website already asks visitors for consent and enforces the answer.
23
+ `WebsitePageLayout` provides the visitor's consent state, starts a provider SDK or
24
+ script only once the purpose it rests on is granted, stops the SDK when consent is
25
+ withdrawn, and shows a panel when the site runs a consent-based provider and the
26
+ visitor has not decided. This skill is for changing how that panel LOOKS, gating your
27
+ own consent-based content, and adding a way back to the choice — never for deciding
28
+ what runs without consent.
29
+
30
+ Consent is a SET of purposes (`ConsentPurpose.ANALYTICS`, `ConsentPurpose.MARKETING`),
31
+ each granted on its own. There is no ladder: agreeing to marketing does not imply
32
+ analytics.
26
33
 
27
34
  ## App Paths
28
35
 
29
36
  | Surface | Application-relative location |
30
37
  |---|---|
31
- | Consent-gate component | `website/src/consent/**` |
32
- | Website layout/provider | `website/src/layouts/**` |
33
- | Consent policy/configuration | `infrastructure/**` or `shared-lib/**` |
34
- | Optional analytics/session consumers | `website/src/**` |
38
+ | Page bridges (where an override is plugged in) | `website/src/pages-impl/*.bridge.tsx` |
39
+ | A replacement consent panel | `website/src/components/**` |
40
+ | Consent-panel labels, every locale | `website/src/i18n/*.json` (`website.chrome.consent.*`) |
41
+ | Content that rests on consent (embeds, widgets) | `website/src/sections/**` |
35
42
 
36
- ## Decision
43
+ ## When to Use / When NOT to Use
37
44
 
38
- First classify every behavior the gate controls. Essential security/session
39
- behavior and optional measurement/personalization must not share an ambiguous
40
- “accepted” switch.
45
+ - Use to restyle the panel, add a "Privacy choices" link to the footer, or hide an
46
+ embed until its purpose is granted.
47
+ - Do NOT use to make an analytics provider start without consent. Whether a provider
48
+ rests on consent follows from its capability (product analytics does; error
49
+ monitoring and captcha do not), and that classification is the framework's.
50
+ - Do NOT use for the signed-in application's consent, which is stored on the person's
51
+ preferences and asked by the application's own consent gate.
52
+
53
+ ## Decision
41
54
 
42
- | Behavior | Gate behavior |
55
+ | You need | Use |
43
56
  |---|---|
44
- | Essential site operation and security | Follow the selected application policy; do not mislabel it as optional analytics. |
45
- | Optional measurement, marketing or personalization | Keep off until the policy records the applicable consent decision. |
46
- | Privacy signal conflicts with a stored choice | Apply the application's documented precedence and surface the resulting state. |
47
- | Policy cannot be loaded | Fail closed for optional behavior and keep the site usable. |
57
+ | A different look for the panel | a component passed as `consentBannerComponent` to each page bridge |
58
+ | Content that must not render until a purpose is granted | `<WebsiteConsentGate purpose={ConsentPurpose.MARKETING} fallback={…}>` |
59
+ | A form, CTA or page the visitor asked for | nothing, or `<WebsiteConsentGate>` with no purpose — essential content always renders |
60
+ | A link that reopens the choice | `useWebsiteConsent().openSettings()` |
61
+ | To know what was granted | `useWebsiteConsent()` — never storage or a cookie |
48
62
 
49
63
  ## Workflow
50
64
 
51
- 1. Read the installed website consent-state contract and the application’s
52
- selected policy before building UI.
53
- 2. Model choices by purpose, not by vendor name. Present plain language that
54
- matches the actual behavior enabled by each choice.
55
- 3. Keep the state provider at the layout boundary; child components consume the
56
- resolved state rather than reinterpreting a cookie themselves.
57
- 4. Ensure an optional anonymous-session or contact-form enhancement observes
58
- the resolved state before it initializes.
59
- 5. Provide a reversible settings path and make keyboard/screen-reader behavior
60
- equivalent to pointer interaction.
61
- 6. Test the no-choice, decline, accept, changed-choice and unavailable-policy
62
- paths.
65
+ 1. **Read the contract.** The consent state and the gate are exported from
66
+ `@wildo-ai/saas-website`; see the references below.
67
+ 2. **Replace the panel, if the look must change.** Author a component with no props
68
+ that reads `useWebsiteConsent()`, and pass it to every bridge:
69
+ `createWebsitePageBridgeIsland({ …, consentBannerComponent: BrandConsentPanel })` and
70
+ `createWebsiteBlogPostBridgeIsland({ …, consentBannerComponent: BrandConsentPanel })`.
71
+ Keep the three properties of the default: nothing pre-ticked; declining as easy as
72
+ accepting and recorded with `decide([])`; only `purposesInUse` offered.
73
+ 3. **Gate consent-based content** with `<WebsiteConsentGate purpose={…}>`, and give it a
74
+ `fallback` that says what is withheld and calls `openSettings()`.
75
+ 4. **Label every consent key in every locale.** The build refuses a locale pack missing
76
+ any `website.chrome.consent.*` key, including one purpose name per `ConsentPurpose`.
77
+ 5. **Test the paths** in a clean browser profile: no choice (nothing optional starts),
78
+ decline, accept, change of mind through the reopen link.
63
79
 
64
80
  ## Worked Example
65
81
 
66
- <!-- TIER C WAIVER: consent-policy field names are application-specific; this
67
- illustrates the required purpose separation without inventing an API. -->
68
- ```ts
69
- type ResolvedConsent = {
70
- essential: true;
71
- analytics: boolean;
72
- marketing: boolean;
73
- };
74
-
75
- export function canStartOptionalAnalytics(consent: ResolvedConsent): boolean {
76
- return consent.analytics;
77
- }
78
- ```
79
-
80
- ## References
82
+ The state a replacement panel reads and the actions it calls:
81
83
 
82
84
  ## Import Origins
83
85
 
@@ -89,169 +91,417 @@ export function canStartOptionalAnalytics(consent: ResolvedConsent): boolean {
89
91
 
90
92
  ```tsx
91
93
  *
92
- * `WebsiteRuntimeContext` — site-wide runtime state for the marketing
93
- * surface. Created **once per page render** by the host adapter
94
- * (Phase 5 `WebsitePageBridge.astro` reads `WebsiteRootConfig` and the
95
- * resolved label pack from disk and calls
96
- * `<WebsiteRuntimeContextProvider value={…}>` around the page tree).
94
+ * `WebsiteConsentContext` — a website visitor's consent state (#534), provided once per page by
95
+ * `WebsitePageLayout`.
97
96
  *
98
- * **Why "runtime" and not "config"**: the values here are the
99
- * locale-resolved subset of `WebsiteRootConfig` — only the active
100
- * locale's label pack travels with the React tree (the other locales
101
- * live in their own per-locale static builds). A `*Config` name would
102
- * suggest the full multi-locale surface is in scope.
97
+ * Consent is a SET of `ConsentPurpose`s, each granted or not on its own. Nothing optional runs until its
98
+ * purpose is granted: the layout's provider SDKs and scripts read `grantedPurposes`, and so does
99
+ * `<WebsiteConsentGate purpose={…}>`.
103
100
  *
104
- * **Three pieces of state**:
105
- *
106
- * - `locale` — the currently-rendering locale. Sections that need
107
- * locale-aware formatting (number/date in marketing copy is rare
108
- * but legitimate) read it via `useWebsiteRuntime()`.
109
- * - `labelPack` — the locale-resolved flat key→string map, validated
110
- * against the manifest by `validateLabelPackAgainstManifest` at
111
- * build start. Consumed by `useWebsiteLabel` and
112
- * `useWebsiteLabelByKey`.
113
- * - `designTokens` — the `WebsiteDesignTokens` from
114
- * `WebsiteRootConfig.designTokens`. Consumed by
115
- * `useWebsiteDesignTokens` and by the Phase 5 CSS emitter that
116
- * materializes them as `--website-*` custom properties on the
117
- * `<WebsitePageLayout>` root.
118
- * - `navigation` — the `WebsiteNavigationConfig` from
119
- * `WebsiteRootConfig.navigation`. Carried in the runtime context
120
- * (rather than as a separate `WebsiteNavigationContext`) because
121
- * `<WebsitePageLayout>` already reads runtime state and
122
- * header/footer slots are inseparable from "the site is rendering
123
- * right now". A second context for two component refs would split
124
- * the host-adapter's wiring surface without buying isolation.
125
- * - `frontendProviderRegistry` — optional website-facing public provider
126
- * registry hydrated from the materialized provider artifact for the
127
- * concrete `STATIC_WEBSITE` service. This keeps analytics / captcha /
128
- * browser-monitoring integrations on the same frontend-provider
129
- * contract the SaaS app now uses, instead of inventing a website-only
130
- * metadata seam.
131
- *
132
- * **Why a separate file from the hook + provider**: split for React
133
- * Fast Refresh — when a `.tsx` exports both a React component and a
134
- * React Context object, edits to either one invalidate the entire
135
- * module's HMR boundary. Keeping the bare context here, the hook in
136
- * `useWebsiteRuntime.ts`, and the provider component in
137
- * `WebsiteRuntimeContextProvider.tsx` makes section authors edit
138
- * components without retriggering the runtime context's identity.
101
+ * `purposesInUse` is DERIVED from the live providers (`consentPurposesInUseByProviders`), so the panel asks
102
+ * about exactly the purposes this site processes and nothing else. A site running no consent-based
103
+ * provider shows no panel at all.
139
104
  */
140
- export interface WebsiteRuntimeContextValue {
141
- /**
142
- * The currently-rendering locale. Marketing-site routing emits one
143
- * static build per locale (D8), so this value is constant per build
144
- * — never re-renders mid-session.
145
- */
146
- locale: AvailableLanguage;
147
- /**
148
- * The site's default locale (mirrors `WebsiteRootConfig.defaultLocale`).
149
- * Carried in the runtime context so client-tier components — namely
150
- * `WebsiteInternalLink` (Phase 6 fix H-β) — can compute the correct
151
- * locale-prefixed pathname (`/pricing` on the EN site,
152
- * `/fr/pricing` on the FR site) without re-importing the root
153
- * config. Plumbing it through the runtime keeps the routing rule
154
- * a framework-internal concern: section authors NEVER hand-prefix
155
- * paths.
156
- */
157
- defaultLocale: AvailableLanguage;
158
- /**
159
- * Flat `Record<string, string>` label pack for the active locale.
160
- * Lookup keys MUST be fully-composed `website.<page>.<section>.<slot>`
161
- * strings; consumers that hold leaf paths use `useWebsiteLabel(leaf)`
162
- * which composes the full key against the page+section context.
163
- */
164
- labelPack: LabelPack;
165
- /**
166
- * Design-token bundle for the active site. Same object referenced
167
- * by `WebsiteRootConfig.designTokens`; passed by reference (not
168
- * cloned) so token-aware components can rely on referential
169
- * stability across renders.
170
- */
171
- designTokens: WebsiteDesignTokens;
172
- /**
173
- * Site-wide navigation slot bindings (header / footer components).
174
- * Same object referenced by `WebsiteRootConfig.navigation`. Read
175
- * by `<WebsitePageLayout>` to render the chrome around each page's
176
- * `<main>` content; per-page `header` / `footer` props on
177
- * `<WebsitePageLayout>` override these defaults.
178
- */
179
- navigation: WebsiteNavigationConfig;
105
+ export enum WebsiteConsentStatus {
106
+ /** The visitor has not decided — or their decision cannot be read. Nothing optional runs. */
107
+ UNDECIDED = 'undecided',
108
+ /** The visitor decided; `grantedPurposes` is their answer, possibly empty. */
109
+ DECIDED = 'decided',
110
+ }
111
+
112
+ export interface WebsiteConsentContextValue {
113
+ status: WebsiteConsentStatus;
180
114
  /**
181
- * Fully-composed label key the framework reads to render the
182
- * "Skip to main content" affordance as the FIRST focusable element
183
- * on every page (Phase 6 third audit fix M-α). Mirrors
184
- * `WebsiteRootConfig.skipToMainContentLabelKey`. Carried in the
185
- * runtime context (NOT re-derived from the root config inside
186
- * `WebsitePageLayout`) for two reasons:
187
- * - The layout is a client-tier React component; it cannot import
188
- * the consumer's `WEBSITE_ROOT_CONFIG` symbol without dragging
189
- * server-only code (manifest registry, page components) into
190
- * the client bundle.
191
- * - Threading the key through the runtime keeps the layout's
192
- * contract symmetric with how every other localized text on the
193
- * page is sourced (label pack + key), so the skip link is
194
- * translated automatically without any per-locale branching.
115
+ * `false` during the server render and the first client render, before storage has been read. A
116
+ * consent panel must not render while this is false: it would flash for a visitor who already decided,
117
+ * and differ from the static HTML. Optional behaviour stays off either way.
195
118
  */
196
- skipToMainContentLabelKey: WebsiteLabelKey;
119
+ isResolved: boolean;
120
+ /** What the visitor granted. Empty while UNDECIDED. */
121
+ grantedPurposes: readonly ConsentPurpose[];
122
+ /** When the visitor decided, ISO-8601; absent while UNDECIDED. */
123
+ decidedAt?: string;
124
+ /** The purposes this site's live providers rest on — what a consent panel offers. */
125
+ purposesInUse: readonly ConsentPurpose[];
126
+ /** Whether the visitor re-opened the panel to change a decision already made. */
127
+ isSettingsOpen: boolean;
128
+ /** Whether `purpose` is granted. */
129
+ hasGranted: (purpose: ConsentPurpose) => boolean;
130
+ /** Record the WHOLE set the visitor grants — a purpose left out is not granted. Closes the panel. */
131
+ decide: (grantedPurposes: readonly ConsentPurpose[]) => void;
132
+ /** Re-open the panel so the visitor can change their decision. */
133
+ openSettings: () => void;
134
+ /** Close a re-opened panel without changing anything. */
135
+ closeSettings: () => void;
136
+ }
137
+
138
+ export const WebsiteConsentContext: React.Context<WebsiteConsentContextValue | null> = createContext<WebsiteConsentContextValue | null>(null);
139
+
140
+ /**
141
+ * The narrow slice of `WebsiteAnonymousSessionClient` this provider needs, declared structurally
142
+ * rather than imported (#1258).
143
+ *
144
+ * Structural because the provider does not want the client's construction concerns — an `apiOrigin`
145
+ * and the application's own `frontendServiceName`, which only the application knows — and because it
146
+ * makes the durable write trivially substitutable in a test.
147
+ */
148
+ export interface WebsiteConsentRecorder {
197
149
  /**
198
- * Website-facing public providers for the active static website
199
- * service. Optional so older tests and provider-free sites can omit
200
- * it, but when present it is the canonical frontend-safe provider
201
- * catalog for analytics / captcha / browser-monitoring slices.
150
+ * NOT generic, deliberately, though `WebsiteAnonymousSessionClient.requestAnonymous` is: this
151
+ * provider ignores the response entirely, so a type parameter here would be a promise to the caller
152
+ * that nothing keeps. The client's generic method satisfies this shape structurally.
153
+ *
154
+ * It takes the METHOD rather than being named after one. The consent door is a PUT — its operation
155
+ * borrows `UPDATE_MANY` — and this interface previously named `postAnonymous`, so every decision a
156
+ * visitor made 404'd, silently, by this provider's own (correct) design of never telling a visitor
157
+ * their privacy choice failed. A door's method is part of its address, so it is passed like one.
202
158
  */
203
- frontendProviderRegistry?: FrontendWebsiteProviderRegistry;
159
+ requestAnonymous(method: string, path: string, body: unknown): Promise<unknown>;
160
+ }
161
+
162
+ export interface WebsiteConsentProviderProps {
163
+ purposesInUse: readonly ConsentPurpose[];
204
164
  /**
205
- * Backend API origin (WITHOUT a trailing slash) that anonymous-capture
206
- * sections POST to when constructing a `WebsiteAnonymousSessionClient`
207
- * (lead / draft-note forms). Sourced from
208
- * `WildoMarketingWebsiteConfig.apiOrigin` and passed as a
209
- * JSON-serializable island prop (the `.astro` page resolves the
210
- * per-environment value and forwards it).
165
+ * OPTIONAL. When present, a decision is ALSO recorded server-side against the visitor's anonymous
166
+ * session, which is what lets it follow them into the account they go on to create (#1258).
211
167
  *
212
- * Optional because only pages that host an anonymous-capture section
213
- * need it — brochure pages omit it. A capture section that reads
214
- * `undefined` here surfaces a loud misconfiguration rather than
215
- * silently failing to submit.
168
+ * Absent is a first-class answer and is exactly today's behaviour: the decision lives in this
169
+ * browser and nowhere else. A site with no anonymous-session wiring keeps working, gates the same
170
+ * way, and simply carries nothing forward.
216
171
  */
217
- apiOrigin?: string;
172
+ recorder?: WebsiteConsentRecorder;
173
+ children: ReactNode;
218
174
  }
219
175
 
220
- /**
221
- * Bare React context. Default `null` — `useWebsiteRuntime()` throws
222
- * with a clear error message when invoked outside of
223
- * `<WebsiteRuntimeContextProvider>`. The defensive throw is preferred
224
- * over a silent default value so a missing provider is detected at
225
- * the first hook call rather than at render time when a missing
226
- * label silently renders as the key string.
227
- */
228
- export const WebsiteRuntimeContext: React.Context<WebsiteRuntimeContextValue | null> =
229
- createContext<WebsiteRuntimeContextValue | null>(null);
176
+ export function WebsiteConsentProvider({ purposesInUse, recorder, children }: WebsiteConsentProviderProps): ReactNode {
177
+ const [record, setRecord] = useState<WebsiteVisitorConsentRecord | null>(null);
178
+ const [isResolved, setIsResolved] = useState(false);
179
+ const [isSettingsOpen, setIsSettingsOpen] = useState(false);
230
180
 
231
- export interface WebsiteRuntimeContextProviderProps {
232
- value: WebsiteRuntimeContextValue;
181
+ // Read after mount, never during render: the static HTML was produced with no storage at all.
182
+ useEffect(() => {
183
+ setRecord(readWebsiteVisitorConsent());
184
+ setIsResolved(true);
185
+ return subscribeWebsiteVisitorConsent(() => setRecord(readWebsiteVisitorConsent()));
186
+ }, []);
187
+
188
+ const decide = useCallback((grantedPurposes: readonly ConsentPurpose[]): void => {
189
+ /*
190
+ * Local storage FIRST, and it is what gates this page (D6). The site is statically built, so a
191
+ * refusal that only held while an API answered would not hold at all — and the visitor's panel
192
+ * must close on their click, not on a round trip.
193
+ */
194
+ setRecord(writeWebsiteVisitorConsent(grantedPurposes));
195
+ setIsSettingsOpen(false);
196
+
197
+ /*
198
+ * Then the DURABLE copy, best-effort. This is the one that survives the browser and is carried
199
+ * onto the account at signup; its failure changes nothing the visitor can see, so it is never
200
+ * awaited and never surfaced.
201
+ *
202
+ * `purposesInUse` is sent as the OFFERED set — what this panel actually put in front of them.
203
+ * Without it the application could not tell a declined purpose from one this site never asked
204
+ * about, and would record a decision the visitor never made
205
+ * (`AnonymousUserPrivacySchema.offeredPurposes`).
206
+ */
207
+ if (recorder !== undefined && purposesInUse.length > 0) {
208
+ void recorder
209
+ .requestAnonymous(ANONYMOUS_CONSENT_RECORD_METHOD, ANONYMOUS_CONSENT_RECORD_PATH, {
210
+ grantedPurposes: [...grantedPurposes],
211
+ offeredPurposes: [...purposesInUse],
212
+ })
213
+ .catch(() => {
214
+ /*
215
+ * Deliberately silent. The decision HELD — it is in this browser and gating this page. All
216
+ * that is lost is the carry, and telling a visitor their privacy choice failed when it did
217
+ * not would be worse than losing it.
218
+ */
219
+ });
220
+ }
221
+ }, [recorder, purposesInUse]);
222
+ const openSettings = useCallback((): void => setIsSettingsOpen(true), []);
223
+ const closeSettings = useCallback((): void => setIsSettingsOpen(false), []);
224
+
225
+ const value = useMemo<WebsiteConsentContextValue>(() => {
226
+ const grantedPurposes = record?.grantedPurposes ?? [];
227
+ return {
228
+ status: record === null ? WebsiteConsentStatus.UNDECIDED : WebsiteConsentStatus.DECIDED,
229
+ isResolved,
230
+ grantedPurposes,
231
+ ...(record !== null ? { decidedAt: record.decidedAt } : {}),
232
+ purposesInUse,
233
+ isSettingsOpen,
234
+ hasGranted: (purpose) => grantedPurposes.includes(purpose),
235
+ decide,
236
+ openSettings,
237
+ closeSettings,
238
+ };
239
+ }, [record, isResolved, purposesInUse, isSettingsOpen, decide, openSettings, closeSettings]);
240
+
241
+ return <WebsiteConsentContext.Provider value={value}>{children}</WebsiteConsentContext.Provider>;
242
+ }
243
+ ```
244
+
245
+ Gating content that rests on a purpose:
246
+
247
+ ## Import Origins
248
+
249
+ - `@wildo-ai/saas-website`
250
+
251
+ ## Source Excerpts
252
+
253
+ ### Origin Package: `@wildo-ai/saas-website`
254
+
255
+ ```tsx
256
+ *
257
+ * `<WebsiteConsentGate>` — renders its children only when the visitor's consent allows it (#534).
258
+ *
259
+ * - **No `purpose`** — the content is ESSENTIAL and always renders. This is the right wrapper for a
260
+ * contact form: submitting a form the visitor chose to fill in never depends on optional consent, and the
261
+ * form's own opt-ins (marketing) are recorded with the submission, not here.
262
+ * - **`purpose`** — the content rests on that purpose (an embedded video that tracks, a chat widget, a
263
+ * marketing pixel). It renders only once the visitor granted it; until then `fallback` renders — a
264
+ * placeholder that says what is withheld and offers `useWebsiteConsent().openSettings()`.
265
+ *
266
+ * It renders `fallback` during the server render and before the stored decision is read, so a static page
267
+ * never ships consent-based content in its HTML.
268
+ */
269
+ export interface WebsiteConsentGateProps {
270
+ /** The purpose the children rest on. Omit for essential content. */
271
+ purpose?: ConsentPurpose;
272
+ /** Rendered in place of consent-based children until the purpose is granted. Defaults to nothing. */
273
+ fallback?: ReactNode;
233
274
  children: ReactNode;
234
275
  }
235
276
 
277
+ export function WebsiteConsentGate({ purpose, fallback = null, children }: WebsiteConsentGateProps): ReactNode {
278
+ const consent = useWebsiteConsent();
279
+ if (purpose === undefined) return <>{children}</>;
280
+ return <>{consent.isResolved && consent.hasGranted(purpose) ? children : fallback}</>;
281
+ }
282
+ ```
283
+
284
+ The default panel, whose three properties a replacement keeps:
285
+
286
+ ## Import Origins
287
+
288
+ - `@wildo-ai/saas-website`
289
+
290
+ ## Source Excerpts
291
+
292
+ ### Origin Package: `@wildo-ai/saas-website`
293
+
294
+ ```tsx
295
+ *
296
+ * `WebsiteConsentBanner` — the framework's default visitor consent panel (#534).
297
+ *
298
+ * Rendered by `WebsitePageLayout` when the site runs a consent-based provider and the visitor has not
299
+ * decided, or re-opened the panel. A site replaces it by passing `consentBannerComponent` to its bridge
300
+ * island; a replacement reads `useWebsiteConsent()` exactly as this one does and must keep its three
301
+ * properties:
302
+ *
303
+ * 1. **No box is pre-ticked.** A pre-ticked box is not a choice.
304
+ * 2. **Declining is as easy as accepting**, and is RECORDED — so the panel does not return on every page.
305
+ * 3. **Only purposes in use are offered** (`purposesInUse`), each named by its label.
306
+ *
307
+ * Styled only through the site's `--website-*` design tokens, like the skip link, so it needs no
308
+ * stylesheet and cannot be shadowed by a utility class.
309
+ */
310
+ function useWebsiteConsentSlotLabel(slot: WebsiteConsentLabelSlot): string {
311
+ return useWebsiteLabelByKey(websiteConsentLabelKey(slot));
312
+ }
313
+
236
314
  /**
237
- * Provider component. Authored as a thin wrapper so consumers do NOT
238
- * have to import `WebsiteRuntimeContext.Provider` directly — the
239
- * provider component carries the documented authoring API and is the
240
- * Fast-Refresh-stable surface section authors compose against.
315
+ * Every row has the SAME shape: the control, then the name on its line, then the explanation beneath
316
+ * the NAME rather than beneath the control — a two-column grid, so the second line starts where the
317
+ * first line's words do and the row stays scannable.
318
+ *
319
+ * That includes the row that cannot be changed, which carries a real checkbox, CHECKED and DISABLED,
320
+ * rather than a text status. A person scanning the panel reads DOWN the column of controls, and a row
321
+ * whose control is missing does not read as "cannot be changed" — it reads as a row that was
322
+ * forgotten. A checked, disabled box says it in the vocabulary the rest of the list already uses, and
323
+ * a screen reader announces "checked, unavailable" without any extra words.
241
324
  */
242
- export function WebsiteRuntimeContextProvider({
243
- value,
244
- children,
245
- }: WebsiteRuntimeContextProviderProps): ReactNode {
325
+ const ROW_STYLE: React.CSSProperties = {
326
+ display: 'grid',
327
+ gridTemplateColumns: 'auto 1fr',
328
+ columnGap: '0.625rem',
329
+ alignItems: 'center',
330
+ padding: '0.5rem 0.75rem',
331
+ borderBottom: '1px solid var(--website-colors-border, #ccc)',
332
+ };
333
+
334
+ const ROW_DESCRIPTION_STYLE: React.CSSProperties = { margin: 0, gridColumn: 2, fontSize: '0.75rem', opacity: 0.8 };
335
+
336
+ /** Slightly larger than a default box: this is the one control the whole panel exists to offer. */
337
+ const ROW_CONTROL_STYLE: React.CSSProperties = { width: '1.15rem', height: '1.15rem' };
338
+
339
+ /**
340
+ * One purpose: its NAME, what agreeing to it MEANS for this visitor, and the control.
341
+ *
342
+ * The explanation is the half that was missing. A tick box labelled "Analytics" is a category, not
343
+ * something a visitor can weigh, and consent is only valid if it is informed — which is why every
344
+ * specialized consent platform pairs the two and why the label key is derived from the vocabulary,
345
+ * so a purpose can never arrive with a name and no explanation.
346
+ */
347
+ function PurposeChoice({ purpose, checked, onChange }: { purpose: ConsentPurpose; checked: boolean; onChange: (checked: boolean) => void }): ReactNode {
348
+ const label = useWebsiteLabelByKey(websiteConsentPurposeLabelKey(purpose));
349
+ const description = useWebsiteLabelByKey(websiteConsentPurposeDescriptionLabelKey(purpose));
246
350
  return (
247
- <WebsiteRuntimeContext.Provider value={value}>
248
- {children}
249
- </WebsiteRuntimeContext.Provider>
351
+ <label data-website-consent-purpose={purpose} style={{ ...ROW_STYLE, cursor: 'pointer' }}>
352
+ <input type="checkbox" checked={checked} style={ROW_CONTROL_STYLE} onChange={(event) => onChange(event.target.checked)} />
353
+ <span style={{ fontWeight: 600 }}>{label}</span>
354
+ <span style={ROW_DESCRIPTION_STYLE}>{description}</span>
355
+ </label>
356
+ );
357
+ }
358
+
359
+ const BUTTON_STYLE: React.CSSProperties = {
360
+ padding: '0.5rem 1rem',
361
+ borderRadius: 'var(--website-radii-md, 0.375rem)',
362
+ border: '1px solid var(--website-colors-border, #ccc)',
363
+ background: 'var(--website-colors-background, #fff)',
364
+ color: 'var(--website-colors-foreground, #000)',
365
+ cursor: 'pointer',
366
+ };
367
+
368
+ export function WebsiteConsentBanner(): ReactNode {
369
+ const consent = useWebsiteConsent();
370
+ const headingId = useId();
371
+ const [selected, setSelected] = useState<readonly ConsentPurpose[]>(consent.grantedPurposes);
372
+ // Re-seed from the stored decision each time the panel is re-opened, so it shows what is in force.
373
+ useEffect(() => setSelected(consent.grantedPurposes), [consent.grantedPurposes, consent.isSettingsOpen]);
374
+
375
+ const title = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.TITLE);
376
+ const description = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.DESCRIPTION);
377
+ const acceptAll = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.ACCEPT_ALL);
378
+ const declineAll = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.DECLINE_ALL);
379
+ const save = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.SAVE);
380
+ const essentialTitle = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.ESSENTIAL_TITLE);
381
+ const essentialDescription = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.ESSENTIAL_DESCRIPTION);
382
+
383
+ const offered = consent.purposesInUse;
384
+ // Purposes the panel does not offer keep their stored grant; offered ones are granted exactly when ticked.
385
+ const choose = (chosen: readonly ConsentPurpose[]): void =>
386
+ consent.decide([...consent.grantedPurposes.filter((purpose) => !offered.includes(purpose)), ...chosen]);
387
+
388
+ return (
389
+ <section
390
+ role="region"
391
+ aria-labelledby={headingId}
392
+ data-website-consent-banner={consent.status === WebsiteConsentStatus.UNDECIDED ? 'undecided' : 'settings'}
393
+ style={{
394
+ /*
395
+ * BOTTOM-RIGHT CORNER, and the three properties together are what make that work on a phone
396
+ * too. `left` and `right` both bound the box to the viewport with a gutter; `maxWidth` caps it
397
+ * on a wide screen; `marginLeft: auto` pushes the remaining slack to the left so the box hugs
398
+ * the right edge. On a narrow screen the gutters bind before the cap does and it simply spans
399
+ * the width — a corner popup that overflowed a phone would be worse than a bar.
400
+ *
401
+ * Inline styles, not a media query: this ships into a static marketing page with no stylesheet
402
+ * of its own, which is the same constraint that keeps the rest of this file inline.
403
+ */
404
+ position: 'fixed',
405
+ left: '1rem',
406
+ right: '1rem',
407
+ bottom: '1rem',
408
+ zIndex: 9000,
409
+ maxWidth: '30rem',
410
+ marginLeft: 'auto',
411
+ /*
412
+ * The panel never exceeds the viewport, and its ACTIONS are never what gets cut off: the rows
413
+ * scroll inside `maxHeight`, the buttons sit outside that box. A panel that grows with its
414
+ * content pushes accept and reject off the bottom of a short screen — and a refusal that
415
+ * cannot be reached is a refusal that was not offered, whatever the markup says. `dvh` rather
416
+ * than `vh` because a mobile browser's toolbars make `vh` taller than the visible page.
417
+ */
418
+ maxHeight: '85dvh',
419
+ padding: '0.875rem 1rem',
420
+ display: 'flex',
421
+ flexDirection: 'column',
422
+ gap: '0.625rem',
423
+ background: 'var(--website-colors-surface, #fff)',
424
+ color: 'var(--website-colors-surface-foreground, #000)',
425
+ border: '1px solid var(--website-colors-border, #ccc)',
426
+ borderRadius: 'var(--website-radii-lg, 0.5rem)',
427
+ }}
428
+ >
429
+ <h2 id={headingId} style={{ margin: 0, fontSize: '1.125rem' }}>{title}</h2>
430
+ <p style={{ margin: 0 }}>{description}</p>
431
+ {/* `data-website-consent-rows` is the scroll box's own hook. A test anchoring on a style
432
+ substring instead matched the ROW (whose grid template also contains "auto") and asserted
433
+ nothing — the same vacuous pin the app tier already had to repair. */}
434
+ <div
435
+ data-website-consent-rows=""
436
+ style={{ minHeight: 0, flex: 1, overflowY: 'auto', border: '1px solid var(--website-colors-border, #ccc)', borderRadius: 'var(--website-radii-md, 0.375rem)' }}
437
+ >
438
+ {/*
439
+ * The always-active row, first, carrying a CHECKED and DISABLED box. It is not a purpose the
440
+ * visitor decides — which is exactly why it is stated: a panel listing only the optional
441
+ * purposes leaves them unable to see what is happening on the site at all, which is the
442
+ * question they opened it to answer.
443
+ *
444
+ * It carried a text status instead until 2026-09-20, on the argument that a disabled control
445
+ * invites a click that cannot work. The reversal: a visitor scans DOWN the column of boxes,
446
+ * and a gap there does not read as "cannot be changed", it reads as a row that was
447
+ * forgotten. A disabled box says it in the vocabulary the rest of the list already uses.
448
+ */}
449
+ <div data-website-consent-essential="" style={ROW_STYLE}>
450
+ {/*
451
+ * `aria-label`, because this row is a `div` rather than a `<label>` — nothing else names
452
+ * the control, and a checkbox with no accessible name is announced as an unlabelled
453
+ * checkbox. Its own note claimed AT would announce "checked, unavailable"; it announced
454
+ * no words at all.
455
+ *
456
+ * `readOnly` is gone: it is inert on a checkbox per HTML, and leaving it invites a later
457
+ * reader to delete `disabled` believing the lock survives.
458
+ */}
459
+ <input type="checkbox" checked disabled aria-label={essentialTitle} style={ROW_CONTROL_STYLE} />
460
+ <span style={{ fontWeight: 600 }}>{essentialTitle}</span>
461
+ <span style={ROW_DESCRIPTION_STYLE}>{essentialDescription}</span>
462
+ </div>
463
+ {offered.map((purpose) => (
464
+ <PurposeChoice
465
+ key={purpose}
466
+ purpose={purpose}
467
+ checked={selected.includes(purpose)}
468
+ onChange={(checked) => setSelected((current) => (checked ? [...current.filter((entry) => entry !== purpose), purpose] : current.filter((entry) => entry !== purpose)))}
469
+ />
470
+ ))}
471
+ </div>
472
+ <div style={{ display: 'flex', flexWrap: 'wrap', gap: '0.5rem', justifyContent: 'flex-end' }}>
473
+ <button type="button" style={BUTTON_STYLE} onClick={() => choose([])}>{declineAll}</button>
474
+ {/*
475
+ * SAVE appears only when a MIXED choice exists to save — two or more purposes in use.
476
+ *
477
+ * With one purpose the button is unanswerable: "decline all" and "accept all" already cover
478
+ * the whole space, so a third action beside them describes nothing a visitor can picture and
479
+ * reads as a question rather than an answer. Derived from the offered set, so a site that
480
+ * adds a second purpose gets the control with no edit here.
481
+ */}
482
+ {offered.length > 1 && (
483
+ <button type="button" style={BUTTON_STYLE} onClick={() => choose(selected.filter((purpose) => offered.includes(purpose)))}>{save}</button>
484
+ )}
485
+ <button type="button" style={BUTTON_STYLE} onClick={() => choose(offered)}>{acceptAll}</button>
486
+ </div>
487
+ </section>
488
+ );
489
+ }
490
+
491
+ /** The reopen affordance: always reachable once a visitor decided, so every choice can be changed. */
492
+ export function WebsiteConsentSettingsButton(): ReactNode {
493
+ const consent = useWebsiteConsent();
494
+ const manage = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.MANAGE);
495
+ return (
496
+ <button type="button" data-website-consent-manage="" style={BUTTON_STYLE} onClick={consent.openSettings}>
497
+ {manage}
498
+ </button>
250
499
  );
251
500
  }
252
- WebsiteRuntimeContextProvider.displayName = 'WebsiteRuntimeContextProvider';
253
501
  ```
254
502
 
503
+ ## References
504
+
255
505
  ## Import Origins
256
506
 
257
507
  - `@wildo-ai/saas-website`
@@ -287,6 +537,14 @@ WebsiteRuntimeContextProvider.displayName = 'WebsiteRuntimeContextProvider';
287
537
  * captcha so non-React tooling can detect the configured vendor
288
538
  * without reverse-engineering app code.
289
539
  *
540
+ * 4. **Provides the visitor's consent state and enforces it** (#534) —
541
+ * mounts `WebsiteConsentProvider`, starts a provider SDK or script only
542
+ * once the purpose it rests on is granted (and stops the SDK when it is
543
+ * withdrawn), and renders the consent panel when the site runs a
544
+ * consent-based provider and the visitor has not decided. Here rather
545
+ * than in each bridge because every page — including every blog post —
546
+ * renders through this layout, so no page can be mounted without it.
547
+ *
290
548
  * **Why semantic `<header>` / `<main>` / `<footer>` elements**:
291
549
  * marketing-site SEO scoring penalizes pages that ship a single
292
550
  * unstructured `<div>` tree. Using semantic landmarks costs nothing
@@ -332,6 +590,17 @@ export interface WebsitePageLayoutProps {
332
590
  * vertical-rhythm overrides on long-scroll landing pages.
333
591
  */
334
592
  mainClassName?: string;
593
+ /**
594
+ * OPTIONAL anonymous-session client. When supplied, a visitor's consent decision is ALSO recorded
595
+ * server-side against their session, which is what lets it follow them into the account they go on
596
+ * to create (#1258). Pass the SAME instance the page's capture sections use, so one `uuidRef`
597
+ * carries the decision, the lead and the draft note together.
598
+ *
599
+ * Absent keeps today's behaviour exactly: the decision lives in this browser and nowhere else.
600
+ * The engine cannot construct the client here — it needs the application's own
601
+ * `frontendServiceName` — which is why it arrives as a prop rather than off the runtime context.
602
+ */
603
+ consentRecorder?: WebsiteConsentRecorder;
335
604
  /**
336
605
  * The page's section composition. Typically a sequence of
337
606
  * `<WebsiteSection>` wrappers around concrete section components.
@@ -339,7 +608,21 @@ export interface WebsitePageLayoutProps {
339
608
  children: ReactNode;
340
609
  }
341
610
 
342
- export function WebsitePageLayout({
611
+ export function WebsitePageLayout(props: WebsitePageLayoutProps): ReactNode {
612
+ const runtime = useWebsiteRuntime();
613
+ // Derived from the LIVE providers, so the panel asks about exactly what this site processes.
614
+ const purposesInUse = useMemo(
615
+ () => consentPurposesInUseByProviders(runtime.frontendProviderRegistry?.modules.values()),
616
+ [runtime.frontendProviderRegistry],
617
+ );
618
+ return (
619
+ <WebsiteConsentProvider purposesInUse={purposesInUse} recorder={props.consentRecorder}>
620
+ <WebsitePageLayoutContent {...props} />
621
+ </WebsiteConsentProvider>
622
+ );
623
+ }
624
+
625
+ function WebsitePageLayoutContent({
343
626
  pageRef,
344
627
  header,
345
628
  footer,
@@ -348,6 +631,7 @@ export function WebsitePageLayout({
348
631
  children,
349
632
  }: WebsitePageLayoutProps): ReactNode {
350
633
  const runtime = useWebsiteRuntime();
634
+ const consent = useWebsiteConsent();
351
635
 
352
636
  /**
353
637
  * Defensive parse: callers should pass a `WebsitePageManifest.ref`
@@ -390,6 +674,16 @@ export function WebsitePageLayout({
390
674
  return <FooterComponent />;
391
675
  }, [footer, runtime.navigation.footerComponent]);
392
676
 
677
+ // Load whatever the live providers declared. Until this landed, the surface
678
+ // resolved provider refs and stamped them into the attributes below and
679
+ // stopped there — a provider could be declared, enabled and hydrated without
680
+ // anything of it ever running.
681
+ //
682
+ // Consent-based providers start only once their purpose is granted (#534). Before the stored decision is
683
+ // read, nothing is granted — the static HTML and the first render start nothing optional.
684
+ useWebsiteProviderScripts(runtime.frontendProviderRegistry, consent.grantedPurposes);
685
+ useWebsiteProviderSdks(runtime.frontendProviderRegistry, consent.grantedPurposes);
686
+
393
687
  const providerRootAttributes = useMemo<Record<string, string>>(() => {
394
688
  const attrs: Record<string, string> = {};
395
689
  const productAnalyticsProviderRef = runtime.frontendProviderRegistry
@@ -461,51 +755,281 @@ export function WebsitePageLayout({
461
755
  {children}
462
756
  </main>
463
757
  {resolvedFooter !== null ? <footer>{resolvedFooter}</footer> : null}
758
+ {renderConsentSurface(consent, runtime.consentBannerComponent)}
464
759
  </div>
465
760
  </WebsitePageContextProvider>
466
761
  );
467
762
  }
468
763
  WebsitePageLayout.displayName = 'WebsitePageLayout';
764
+
765
+ /**
766
+ * The panel while a decision is owed (or re-opened), the reopen button once one is made, and nothing at
767
+ * all on a site whose live providers rest on no consent. Nothing renders before the stored decision is
768
+ * read, so a visitor who already decided never sees the panel flash.
769
+ */
770
+ function renderConsentSurface(
771
+ consent: ReturnType<typeof useWebsiteConsent>,
772
+ BannerOverride: React.ComponentType | undefined,
773
+ ): ReactNode {
774
+ if (!consent.isResolved || consent.purposesInUse.length === 0) return null;
775
+ if (consent.status === WebsiteConsentStatus.UNDECIDED || consent.isSettingsOpen) {
776
+ const Banner = BannerOverride ?? WebsiteConsentBanner;
777
+ return <Banner />;
778
+ }
779
+ return (
780
+ <div data-website-consent-settings="">
781
+ <WebsiteConsentSettingsButton />
782
+ </div>
783
+ );
784
+ }
469
785
  ```
470
786
 
471
- These source-backed website contracts identify the shared state boundary that
472
- the override must respect; the selected application policy still owns purposes.
787
+ ## Import Origins
473
788
 
474
- ## Verification
789
+ - `@wildo-ai/saas-website`
475
790
 
476
- - Declining optional purposes leaves the website usable and keeps optional
477
- session enhancements off.
478
- - Changing a choice updates all consumers through the shared state, not a
479
- page-local boolean.
480
- - The gate states which choices are optional and where the visitor can revise
481
- them.
791
+ ## Source Excerpts
482
792
 
483
- | Invariant | Command |
484
- |---|---|
485
- | Optional scripts are consent-gated | `rg -n "analytics|marketing" website/src/ | rg -v "consent"` (review every result) |
486
- | No raw cookie reads in page components | `rg -n "document\.cookie" website/src/` (must be empty outside the approved adapter) |
793
+ ### Origin Package: `@wildo-ai/saas-website`
487
794
 
488
- ## Mechanical Checks
795
+ ```tsx
796
+ *
797
+ * `WebsiteRuntimeContext` — site-wide runtime state for the marketing
798
+ * surface. Created **once per page render** by the host adapter
799
+ * (Phase 5 `WebsitePageBridge.astro` reads `WebsiteRootConfig` and the
800
+ * resolved label pack from disk and calls
801
+ * `<WebsiteRuntimeContextProvider value={…}>` around the page tree).
802
+ *
803
+ * **Why "runtime" and not "config"**: the values here are the
804
+ * locale-resolved subset of `WebsiteRootConfig` — only the active
805
+ * locale's label pack travels with the React tree (the other locales
806
+ * live in their own per-locale static builds). A `*Config` name would
807
+ * suggest the full multi-locale surface is in scope.
808
+ *
809
+ * **Three pieces of state**:
810
+ *
811
+ * - `locale` — the currently-rendering locale. Sections that need
812
+ * locale-aware formatting (number/date in marketing copy is rare
813
+ * but legitimate) read it via `useWebsiteRuntime()`.
814
+ * - `labelPack` — the locale-resolved flat key→string map, validated
815
+ * against the manifest by `validateLabelPackAgainstManifest` at
816
+ * build start. Consumed by `useWebsiteLabel` and
817
+ * `useWebsiteLabelByKey`.
818
+ * - `designTokens` — the `WebsiteDesignTokens` from
819
+ * `WebsiteRootConfig.designTokens`. Consumed by
820
+ * `useWebsiteDesignTokens` and by the Phase 5 CSS emitter that
821
+ * materializes them as `--website-*` custom properties on the
822
+ * `<WebsitePageLayout>` root.
823
+ * - `navigation` — the `WebsiteNavigationConfig` from
824
+ * `WebsiteRootConfig.navigation`. Carried in the runtime context
825
+ * (rather than as a separate `WebsiteNavigationContext`) because
826
+ * `<WebsitePageLayout>` already reads runtime state and
827
+ * header/footer slots are inseparable from "the site is rendering
828
+ * right now". A second context for two component refs would split
829
+ * the host-adapter's wiring surface without buying isolation.
830
+ * - `frontendProviderRegistry` — optional website-facing public provider
831
+ * registry hydrated from the materialized provider artifact for the
832
+ * concrete `STATIC_WEBSITE` service. This keeps analytics / captcha /
833
+ * browser-monitoring integrations on the same frontend-provider
834
+ * contract the SaaS app now uses, instead of inventing a website-only
835
+ * metadata seam.
836
+ *
837
+ * **Why the hook lives in a separate file**: React Fast Refresh only
838
+ * preserves state for a module whose every export is a component, so
839
+ * a module mixing components with plain functions loses its HMR
840
+ * boundary. This file holds the two things that must be identical
841
+ * objects at runtime — the context and the provider component that
842
+ * writes it — while `useWebsiteRuntime` sits alone in
843
+ * `useWebsiteRuntime.ts`. A section author editing a component that
844
+ * merely READS the runtime therefore never remounts the provider.
845
+ *
846
+ * Until 2026-09-09 this paragraph described a different arrangement:
847
+ * that only the bare context was kept here and the provider lived in
848
+ * a file of its own. No such file has ever existed — the provider is
849
+ * exported below — and splitting it out would be the wrong shape
850
+ * anyway, since `useContext` matches on object identity.
851
+ * prose-referent-waiver: the retired file name is quoted only to retire it.
852
+ * The claim named `WebsiteRuntimeContextProvider.tsx`.
853
+ */
854
+ export interface WebsiteRuntimeContextValue {
855
+ /**
856
+ * The currently-rendering locale. Marketing-site routing emits one
857
+ * static build per locale (D8), so this value is constant per build
858
+ * — never re-renders mid-session.
859
+ */
860
+ locale: AvailableLanguage;
861
+ /**
862
+ * The site's default locale (mirrors `WebsiteRootConfig.defaultLocale`).
863
+ * Carried in the runtime context so client-tier components — namely
864
+ * `WebsiteInternalLink` (Phase 6 fix H-β) — can compute the correct
865
+ * locale-prefixed pathname (`/pricing` on the EN site,
866
+ * `/fr/pricing` on the FR site) without re-importing the root
867
+ * config. Plumbing it through the runtime keeps the routing rule
868
+ * a framework-internal concern: section authors NEVER hand-prefix
869
+ * paths.
870
+ */
871
+ defaultLocale: AvailableLanguage;
872
+ /**
873
+ * Origin of the application this marketing site sends visitors INTO — the
874
+ * marketing → product handoff target, authored once as
875
+ * `WildoMarketingWebsiteConfig.appOrigin` (#493).
876
+ *
877
+ * Carried here for exactly the reason `defaultLocale` above is: a
878
+ * `wildo.website.config.ts` is Node-loaded and therefore invisible to a
879
+ * client island, so before this a site resolved the app origin a SECOND
880
+ * time from a public build-time environment variable it could read in the
881
+ * browser — one host authored twice, in two files, with no mechanical link
882
+ * between the copies. That is how a marketing site comes to point at the
883
+ * wrong environment: a defect nobody notices until a customer follows the
884
+ * link.
885
+ *
886
+ * Threading it through the runtime keeps the handoff a framework-internal
887
+ * concern, the same way threading `defaultLocale` kept locale-prefixing one:
888
+ * section authors never hand-assemble the product URL, and there is one
889
+ * place to change it.
890
+ */
891
+ appOrigin?: string;
892
+ /**
893
+ * Flat `Record<string, string>` label pack for the active locale.
894
+ * Lookup keys MUST be fully-composed `website.<page>.<section>.<slot>`
895
+ * strings; consumers that hold leaf paths use `useWebsiteLabel(leaf)`
896
+ * which composes the full key against the page+section context.
897
+ */
898
+ labelPack: LabelPack;
899
+ /**
900
+ * Design-token bundle for the active site. Same object referenced
901
+ * by `WebsiteRootConfig.designTokens`; passed by reference (not
902
+ * cloned) so token-aware components can rely on referential
903
+ * stability across renders.
904
+ */
905
+ designTokens: WebsiteDesignTokens;
906
+ /**
907
+ * Site-wide navigation slot bindings (header / footer components).
908
+ * Same object referenced by `WebsiteRootConfig.navigation`. Read
909
+ * by `<WebsitePageLayout>` to render the chrome around each page's
910
+ * `<main>` content; per-page `header` / `footer` props on
911
+ * `<WebsitePageLayout>` override these defaults.
912
+ */
913
+ navigation: WebsiteNavigationConfig;
914
+ /**
915
+ * Fully-composed label key the framework reads to render the
916
+ * "Skip to main content" affordance as the FIRST focusable element
917
+ * on every page (Phase 6 third audit fix M-α). Mirrors
918
+ * `WebsiteRootConfig.skipToMainContentLabelKey`. Carried in the
919
+ * runtime context (NOT re-derived from the root config inside
920
+ * `WebsitePageLayout`) for two reasons:
921
+ * - The layout is a client-tier React component; it cannot import
922
+ * the consumer's `WEBSITE_ROOT_CONFIG` symbol without dragging
923
+ * server-only code (manifest registry, page components) into
924
+ * the client bundle.
925
+ * - Threading the key through the runtime keeps the layout's
926
+ * contract symmetric with how every other localized text on the
927
+ * page is sourced (label pack + key), so the skip link is
928
+ * translated automatically without any per-locale branching.
929
+ */
930
+ skipToMainContentLabelKey: WebsiteLabelKey;
931
+ /**
932
+ * Website-facing public providers for the active static website
933
+ * service. Optional so older tests and provider-free sites can omit
934
+ * it, but when present it is the canonical frontend-safe provider
935
+ * catalog for analytics / captcha / browser-monitoring slices.
936
+ */
937
+ frontendProviderRegistry?: FrontendWebsiteProviderRegistry;
938
+ /**
939
+ * Replaces the framework's visitor consent panel (#534). Reads `useWebsiteConsent()`; see
940
+ * `WebsiteConsentBanner` for the three properties a replacement must keep. Absent uses the default.
941
+ * Closed over by the bridge rather than passed as an island prop, like `navigation`, because a
942
+ * component cannot cross Astro's serialization boundary.
943
+ */
944
+ consentBannerComponent?: ComponentType;
945
+ /**
946
+ * Backend API origin (WITHOUT a trailing slash) that anonymous-capture
947
+ * sections POST to when constructing a `WebsiteAnonymousSessionClient`
948
+ * (lead / draft-note forms). Sourced from
949
+ * `WildoMarketingWebsiteConfig.apiOrigin` and passed as a
950
+ * JSON-serializable island prop (the `.astro` page resolves the
951
+ * per-environment value and forwards it).
952
+ *
953
+ * Optional because only pages that host an anonymous-capture section
954
+ * need it — brochure pages omit it. A capture section that reads
955
+ * `undefined` here surfaces a loud misconfiguration rather than
956
+ * silently failing to submit.
957
+ */
958
+ apiOrigin?: string;
959
+ }
960
+
961
+ /**
962
+ * Bare React context. Default `null` — `useWebsiteRuntime()` throws
963
+ * with a clear error message when invoked outside of
964
+ * `<WebsiteRuntimeContextProvider>`. The defensive throw is preferred
965
+ * over a silent default value so a missing provider is detected at
966
+ * the first hook call rather than at render time when a missing
967
+ * label silently renders as the key string.
968
+ */
969
+ export const WebsiteRuntimeContext: React.Context<WebsiteRuntimeContextValue | null> =
970
+ createContext<WebsiteRuntimeContextValue | null>(null);
971
+
972
+ export interface WebsiteRuntimeContextProviderProps {
973
+ value: WebsiteRuntimeContextValue;
974
+ children: ReactNode;
975
+ }
976
+
977
+ /**
978
+ * Provider component. Authored as a thin wrapper so consumers do NOT
979
+ * have to import `WebsiteRuntimeContext.Provider` directly — the
980
+ * provider component carries the documented authoring API and is the
981
+ * Fast-Refresh-stable surface section authors compose against.
982
+ */
983
+ export function WebsiteRuntimeContextProvider({
984
+ value,
985
+ children,
986
+ }: WebsiteRuntimeContextProviderProps): ReactNode {
987
+ return (
988
+ <WebsiteRuntimeContext.Provider value={value}>
989
+ {children}
990
+ </WebsiteRuntimeContext.Provider>
991
+ );
992
+ }
993
+ WebsiteRuntimeContextProvider.displayName = 'WebsiteRuntimeContextProvider';
994
+ ```
995
+
996
+ ## Verification
997
+
998
+ - Before any choice, the product-analytics SDK has not loaded (network panel), and the
999
+ panel offers only purposes the site uses, unticked.
1000
+ - "Decline all" leaves the site usable, the panel does not return on the next page, and
1001
+ the reopen link shows the stored choice.
1002
+ - Withdrawing a granted purpose stops the analytics client without a reload.
489
1003
 
490
1004
  | Invariant | Command |
491
1005
  |---|---|
492
- | Optional scripts are consent-gated | `rg -n "analytics|marketing" website/src/ | rg -v "consent"` (review every result) |
493
- | No raw cookie reads in page components | `rg -n "document\.cookie" website/src/` (must be empty outside the approved adapter) |
1006
+ | No component reads consent from storage | `rg -n "__wildo_website_consent\|localStorage" website/src/` (must return nothing) |
1007
+ | No raw cookie reads | `rg -n "document\.cookie" website/src/` (must return nothing) |
1008
+ | Every locale labels the panel | `rg -c "website.chrome.consent." website/src/i18n/` (same count in every file) |
1009
+ | A replacement panel reaches every bridge | `rg -n "consentBannerComponent" website/src/pages-impl/` (one per bridge, or none) |
494
1010
 
495
1011
  ## Common Rationalizations
496
1012
 
497
- - “The banner looks compliant, so the underlying behavior is compliant.” A
498
- visual banner is not evidence that consumers respect its resolved state.
499
- - “We can initialize first and delete data if consent is declined.” That makes
500
- the gate performative rather than preventative.
1013
+ | Rationalization | Reality |
1014
+ |---|---|
1015
+ | "The banner looks compliant, so tracking is compliant." | Tracking is stopped by the layout, not the banner. A panel that calls `decide` wrongly records a consent the visitor did not give. |
1016
+ | "Pre-tick analytics — most visitors accept anyway." | A pre-ticked box is not a choice. The default leaves every box empty for that reason. |
1017
+ | "Hide Decline behind a settings screen." | Declining must be as easy as accepting; the default puts both side by side. |
1018
+ | "Read the stored choice directly, it is faster." | `useWebsiteConsent()` is the one reader. A second reader drifts from the record's format and misses changes from another tab. |
501
1019
 
502
1020
  ## Red Flags
503
1021
 
504
- - A page reads a raw consent cookie instead of the application consent context.
505
- - Optional scripts load before the consent state is known.
506
- - The override changes a purpose decision without a policy change.
1022
+ - A component reads `localStorage` or `document.cookie` for consent (catch with the
1023
+ storage grep above).
1024
+ - A replacement panel starts with boxes ticked, or has no decline action.
1025
+ - A locale pack lacks a `website.chrome.consent.*` key (the build refuses it; the count
1026
+ grep above shows it first).
1027
+ - An embed that tracks is rendered outside `<WebsiteConsentGate purpose={…}>`.
507
1028
 
508
1029
  ## Related Skills
509
1030
 
510
- - `website-anonymous-session` for anonymous behavior gated by consent.
511
- - `website-inbound-contact-forms` for form-specific consent and disclosure.
1031
+ - `website-inbound-contact-forms` — a contact form is essential; its marketing opt-in is
1032
+ recorded with the submission.
1033
+ - `website-anonymous-session` — anonymous sessions and the marketing→app handoff.
1034
+ - `website-navigation-authoring` — placing a "Privacy choices" link in the footer.
1035
+ - `website-label-pack` — authoring the `website.chrome.*` keys.