@wildo-ai/framework-knowledge 1.1.4 → 1.1.6

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