@wildo-ai/framework-knowledge 1.1.5 → 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 (835) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
  3. package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
  4. package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
  5. package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
  6. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
  7. package/dist/{knowledge/skills/journey-run/references/framework-playbook-approval-policy.md → claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md} +10 -8
  8. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
  9. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
  10. package/dist/{knowledge/skills/journey-run → claude-marketplace/plugins/wildo}/references/expert-personas-and-deliberations.md +8 -8
  11. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
  12. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
  13. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
  14. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
  15. package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
  16. package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
  17. package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
  18. package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
  19. package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
  20. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
  21. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  22. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  23. package/dist/esm/framework-knowledge.definitions.js +320 -11
  24. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +0 -3
  28. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +12 -2
  30. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  31. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +33 -2
  32. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +8 -5
  34. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  35. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +55 -10
  36. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -6
  40. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
  42. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
  44. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  45. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
  46. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  47. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +0 -1
  48. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +2 -2
  50. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -4
  52. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +10 -3
  54. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +7 -3
  56. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  58. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +8 -3
  59. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +1 -1
  61. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  62. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +0 -1
  63. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  64. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +7 -3
  65. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  66. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +9 -4
  67. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  68. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +3 -2
  69. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +4 -3
  71. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  72. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +1 -1
  73. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  74. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +1 -3
  75. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  76. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
  77. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  78. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +0 -1
  79. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  80. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +10 -3
  81. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  82. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +8 -3
  83. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  84. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +12 -5
  85. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  86. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +33 -5
  87. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  88. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +1 -1
  89. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +1 -1
  90. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  91. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
  92. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
  93. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
  94. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
  95. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
  96. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
  97. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
  98. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
  99. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
  100. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
  101. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
  103. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
  104. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
  105. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
  106. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
  107. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +1 -1
  108. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  109. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +1 -1
  110. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
  111. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
  113. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  114. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +1 -1
  115. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +1 -1
  116. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  117. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +1 -1
  118. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +1 -1
  119. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +1 -1
  121. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +1 -1
  122. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  123. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +1 -1
  124. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +1 -1
  125. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +1 -1
  127. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  129. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +36 -17
  130. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  131. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +67 -17
  132. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  133. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +1 -1
  134. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +1 -1
  135. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  136. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
  137. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
  138. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
  139. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
  140. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +1 -1
  141. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  142. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +1 -1
  143. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  144. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +1 -1
  145. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  146. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  147. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +0 -1
  148. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  149. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +1 -1
  150. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +1 -1
  151. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +1 -1
  153. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +1 -1
  154. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +1 -1
  156. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +1 -1
  157. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  158. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +1 -1
  159. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +1 -1
  160. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  161. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +1 -1
  162. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  163. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +0 -1
  164. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  165. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +1 -1
  166. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  167. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -3
  168. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  169. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  170. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  171. package/dist/knowledge/manifest.json +8 -8
  172. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +0 -3
  173. package/dist/knowledge/playbooks/bottom_up.build/method.md +4 -2
  174. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +31 -7
  175. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  176. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  177. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +134 -26
  178. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +7 -4
  179. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +84 -29
  180. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -7
  181. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +12 -23
  182. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -7
  183. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +12 -14
  184. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -2
  185. package/dist/knowledge/playbooks/bottom_up.conception/method.md +20 -2
  186. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +15 -7
  187. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +8 -6
  188. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +11 -4
  189. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +2 -4
  190. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +3 -4
  191. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +18 -2
  192. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +1 -2
  193. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +2 -4
  194. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +8 -5
  195. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +16 -2
  196. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +3 -3
  197. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +1 -3
  198. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +1 -2
  199. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +8 -7
  200. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +11 -4
  201. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +27 -5
  202. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +1 -4
  203. package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
  204. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
  205. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
  206. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
  207. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +112 -21
  208. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
  209. package/dist/knowledge/playbooks/refinement.document-facts/method.md +7 -2
  210. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -4
  211. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
  212. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
  213. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +6 -0
  214. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
  215. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +0 -4
  216. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +1 -2
  217. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +1 -3
  218. package/dist/knowledge/playbooks/top_down.capability-map/method.md +2 -4
  219. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -2
  220. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +1 -3
  221. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +5 -3
  222. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +2 -4
  223. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +1 -3
  224. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +0 -4
  225. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +2 -4
  226. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -3
  227. package/dist/knowledge/playbooks/top_down.definition/method.md +7 -4
  228. package/dist/knowledge/playbooks/top_down.definition/playbook.json +52 -7
  229. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +1 -1
  230. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +2 -4
  231. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
  232. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
  233. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +0 -1
  234. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +0 -1
  235. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +0 -1
  236. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +2 -4
  237. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -2
  238. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +1 -1
  239. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +2 -6
  240. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +17 -1
  241. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +2 -5
  242. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -3
  243. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +15 -7
  244. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +2 -4
  245. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +2 -4
  246. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +1 -2
  247. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
  248. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +12 -5
  249. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
  250. package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
  251. package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
  252. package/dist/knowledge/references/build-plan.task-graph.config.md +71 -6
  253. package/dist/knowledge/references/capability-composition.config.md +20 -1
  254. package/dist/knowledge/references/cli.market.generate-command.md +18 -2
  255. package/dist/knowledge/references/engine.client-bundle.allow-list.md +7 -22
  256. package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
  257. package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
  258. package/dist/knowledge/references/example.backend.addon-wiring.module.md +5 -0
  259. package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
  260. package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
  261. package/dist/knowledge/references/example.config.app-shell.full.md +11 -0
  262. package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
  263. package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
  264. package/dist/knowledge/references/example.config.backend.required-floors.md +7 -0
  265. package/dist/knowledge/references/example.config.navigation.full.md +45 -2
  266. package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
  267. package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
  268. package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
  269. package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
  270. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
  271. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +26 -3
  272. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +1 -1
  273. package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
  274. package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
  275. package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
  276. package/dist/knowledge/references/example.infra.environment-config.local.md +14 -30
  277. package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
  278. package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
  279. package/dist/knowledge/references/example.module.companion-exports.full.md +8 -13
  280. package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
  281. package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
  282. package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
  283. package/dist/knowledge/references/example.provider.backend-module-shape.md +3 -0
  284. package/dist/knowledge/references/example.provider.frontend-app.module.md +9 -0
  285. package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
  286. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +14 -13
  287. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +18 -0
  288. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +11 -11
  289. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +5 -0
  290. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +2 -0
  291. package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
  292. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
  293. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +24 -6
  294. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +36 -25
  295. package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
  296. package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
  297. package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
  298. package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
  299. package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
  300. package/dist/knowledge/references/example.website.page.manifest.md +30 -0
  301. package/dist/knowledge/references/experience-plan.config.md +11 -4
  302. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +20 -0
  303. package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
  304. package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
  305. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
  306. package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
  307. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
  308. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
  309. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
  310. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +21 -0
  311. package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
  312. package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
  313. package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
  314. package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
  315. package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
  316. package/dist/knowledge/references/integration-plan.config.md +34 -2
  317. package/dist/knowledge/references/market.alternative.config.md +1 -1
  318. package/dist/knowledge/references/market.buying-journey.config.md +1 -1
  319. package/dist/knowledge/references/market.category.config.md +1 -1
  320. package/dist/knowledge/references/market.channel.config.md +1 -1
  321. package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
  322. package/dist/knowledge/references/market.gain.config.md +1 -1
  323. package/dist/knowledge/references/market.icp.config.md +1 -1
  324. package/dist/knowledge/references/market.job.config.md +1 -1
  325. package/dist/knowledge/references/market.message-template.config.md +1 -1
  326. package/dist/knowledge/references/market.objection.config.md +1 -1
  327. package/dist/knowledge/references/market.pain.config.md +1 -1
  328. package/dist/knowledge/references/market.persona.config.md +1 -1
  329. package/dist/knowledge/references/market.positioning.config.md +1 -1
  330. package/dist/knowledge/references/market.proof.config.md +1 -1
  331. package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
  332. package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
  333. package/dist/knowledge/references/market.trigger.config.md +1 -1
  334. package/dist/knowledge/references/placement-plan.config.md +7 -1
  335. package/dist/knowledge/references/platform.config.backing-services.md +15 -15
  336. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +57 -57
  337. package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
  338. package/dist/knowledge/references/presets.3d.layout-contract.md +213 -0
  339. package/dist/knowledge/references/presets.3d.register-layout.md +95 -0
  340. package/dist/knowledge/references/presets.models.labelling.sections.md +5 -0
  341. package/dist/knowledge/references/presets.models.shell-region.md +47 -0
  342. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
  343. package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
  344. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  345. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +7 -6
  346. package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
  347. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +7 -0
  348. package/dist/knowledge/references/saas.backend.domain-module.md +93 -15
  349. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
  350. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
  351. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +200 -0
  352. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +2 -0
  353. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
  354. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +33 -9
  355. package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
  356. package/dist/knowledge/references/saas.backend.system-access-service.md +98 -0
  357. package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
  358. package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
  359. package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
  360. package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
  361. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
  362. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +2 -2
  363. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +250 -0
  364. package/dist/knowledge/references/saas.frontend.billing-context.md +25 -2
  365. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
  366. package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
  367. package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
  368. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
  369. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +7 -5
  370. package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
  371. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +17 -2
  372. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
  373. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
  374. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +9 -0
  375. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +100 -5
  376. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
  377. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +61 -0
  378. package/dist/knowledge/references/saas.market.generation-agent.md +0 -1
  379. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
  380. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
  381. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
  382. package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
  383. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
  384. package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
  385. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
  386. package/dist/knowledge/references/saas.models.audit.trail-config.md +15 -9
  387. package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
  388. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +8 -0
  389. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +54 -1
  390. package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
  391. package/dist/knowledge/references/saas.models.config.organization-types.md +74 -0
  392. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +31 -14
  393. package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
  394. package/dist/knowledge/references/saas.models.data-mode-read-list.md +4 -4
  395. package/dist/knowledge/references/saas.models.engine-capabilities.md +12 -0
  396. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +5 -1
  397. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
  398. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
  399. package/dist/knowledge/references/saas.models.external-data-pipeline.md +667 -6
  400. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
  401. package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
  402. package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
  403. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
  404. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
  405. package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
  406. package/dist/knowledge/references/saas.models.http-api-binding.md +812 -29
  407. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
  408. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
  409. package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
  410. package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
  411. package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
  412. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
  413. package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
  414. package/dist/knowledge/references/saas.models.navigation.layout.md +11 -7
  415. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +32 -23
  416. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +8 -4
  417. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +22 -20
  418. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +14 -0
  419. package/dist/knowledge/references/saas.models.notifications.targets.md +20 -12
  420. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +61 -34
  421. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +9 -0
  422. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
  423. package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
  424. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
  425. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
  426. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
  427. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
  428. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
  429. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
  430. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
  431. package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
  432. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
  433. package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
  434. package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
  435. package/dist/knowledge/references/saas.models.provider-capabilities.md +34 -0
  436. package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
  437. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
  438. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +61 -0
  439. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +98 -13
  440. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
  441. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -28
  442. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
  443. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +6 -0
  444. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +8 -0
  445. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
  446. package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
  447. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
  448. package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
  449. package/dist/knowledge/references/saas.models.systems-of-record.md +242 -7
  450. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
  451. package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
  452. package/dist/knowledge/references/saas.public-runtime.contract.md +75 -7
  453. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +20 -0
  454. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +106 -13
  455. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
  456. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
  457. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
  458. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
  459. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
  460. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +6 -4
  461. package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
  462. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +14 -2
  463. package/dist/knowledge/references/saas.specifications.processor-register.md +77 -0
  464. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
  465. package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
  466. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +112 -45
  467. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +13 -1
  468. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
  469. package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
  470. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
  471. package/dist/knowledge/references/saas.website.astro.bridge.md +32 -9
  472. package/dist/knowledge/references/saas.website.astro.head-renderer.md +1 -1
  473. package/dist/knowledge/references/saas.website.astro.label-loader.md +7 -4
  474. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +15 -15
  475. package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
  476. package/dist/knowledge/references/saas.website.blog.bridge.md +17 -4
  477. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
  478. package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
  479. package/dist/knowledge/references/saas.website.consent.banner.md +10 -10
  480. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
  481. package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
  482. package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
  483. package/dist/knowledge/references/saas.website.page-layout.component.md +5 -2
  484. package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
  485. package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
  486. package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
  487. package/dist/knowledge/references/saas.website.runtime.context.md +23 -4
  488. package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
  489. package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
  490. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
  491. package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
  492. package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
  493. package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
  494. package/dist/knowledge/references/website-plan.config.md +39 -6
  495. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +2 -1
  496. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +21 -0
  497. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +1 -2
  498. package/dist/knowledge/references/zod.decorators.file-schema.md +11 -10
  499. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +7 -4
  500. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +8 -2
  501. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +5 -1
  502. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +5 -1
  503. package/dist/knowledge/references/zod.factories.address.md +7 -7
  504. package/dist/knowledge/references/zod.factories.code.md +2 -2
  505. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  506. package/dist/knowledge/references/zod.factories.money.md +3 -3
  507. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  508. package/dist/knowledge/registries/framework-topics.json +1238 -54
  509. package/dist/knowledge/registries/playbooks.json +81 -109
  510. package/dist/knowledge/registries/source-tags.json +3191 -1126
  511. package/dist/knowledge/rules/live-context-door.md +29 -0
  512. package/dist/knowledge/skills/INDEX.md +27 -24
  513. package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
  514. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
  515. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
  516. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
  517. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
  518. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
  519. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
  520. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
  521. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
  522. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +31 -0
  523. package/dist/knowledge/skills/application-database-migrations/SKILL.md +1 -0
  524. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +1 -0
  525. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +9 -0
  526. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  527. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +94 -16
  528. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +21 -8
  529. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +7 -0
  530. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +13 -5
  531. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +30 -6
  532. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +160 -32
  533. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +20 -0
  534. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +14 -2
  535. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +88 -0
  536. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +112 -14
  537. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
  538. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
  539. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
  540. package/dist/knowledge/skills/config-app-shell/SKILL.md +21 -0
  541. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +2 -2
  542. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +276 -0
  543. package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
  544. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -0
  545. package/dist/knowledge/skills/config-navigation/SKILL.md +114 -16
  546. package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
  547. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +11 -7
  548. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +29 -5
  549. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +40 -27
  550. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +22 -20
  551. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +112 -5
  552. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +10 -10
  553. package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
  554. package/dist/knowledge/skills/config-saas/SKILL.md +3 -1
  555. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +7 -0
  556. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +21 -11
  557. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +5 -1
  558. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +59 -9
  559. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +46 -0
  560. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +251 -12
  561. package/dist/knowledge/skills/config-saas-backend/SKILL.md +8 -0
  562. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +81 -0
  563. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +37 -15
  564. package/dist/knowledge/skills/configure-billing/SKILL.md +64 -24
  565. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +35 -2
  566. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +14 -0
  567. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +3 -0
  568. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +25 -2
  569. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +73 -1
  570. package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
  571. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +27 -12
  572. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +11 -2
  573. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +26 -2
  574. package/dist/knowledge/skills/email-add-template/SKILL.md +61 -24
  575. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +5 -2
  576. package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
  577. package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
  578. package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
  579. package/dist/knowledge/skills/engine-component-registration/SKILL.md +1 -0
  580. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +6 -0
  581. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +27 -3
  582. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
  583. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
  584. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
  585. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
  586. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
  587. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +31 -4
  588. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +26 -3
  589. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
  590. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
  591. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +202 -0
  592. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +93 -15
  593. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +96 -11
  594. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +2 -1
  595. package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
  596. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -0
  597. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -2
  598. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +14 -9
  599. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +1 -0
  600. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +1 -0
  601. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +5 -0
  602. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
  603. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +5 -0
  604. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +8 -1
  605. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +5 -0
  606. package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
  607. package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
  608. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
  609. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
  610. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
  611. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
  612. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
  613. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
  614. package/dist/knowledge/skills/infra-environment-config/SKILL.md +150 -44
  615. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +83 -74
  616. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +176 -0
  617. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
  618. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +223 -0
  619. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +103 -0
  620. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +256 -0
  621. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
  622. package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +29 -0
  623. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
  624. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +32 -1
  625. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
  626. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +36 -4
  627. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +2 -1
  628. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
  629. package/dist/knowledge/skills/market-alternatives/SKILL.md +3 -2
  630. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
  631. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
  632. package/dist/knowledge/skills/market-category/SKILL.md +2 -1
  633. package/dist/knowledge/skills/market-channels/SKILL.md +2 -1
  634. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +7 -4
  635. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +6 -4
  636. package/dist/knowledge/skills/market-generation-cli/SKILL.md +28 -13
  637. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +18 -3
  638. package/dist/knowledge/skills/market-icp/SKILL.md +2 -1
  639. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +4 -3
  640. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -1
  641. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
  642. package/dist/knowledge/skills/market-persona/SKILL.md +2 -1
  643. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
  644. package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
  645. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +3 -2
  646. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
  647. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1 -0
  648. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +2 -1
  649. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +3 -2
  650. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +1 -0
  651. package/dist/knowledge/skills/minion-authoring/SKILL.md +5 -1
  652. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
  653. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
  654. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
  655. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
  656. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
  657. package/dist/knowledge/skills/module-companion-exports/SKILL.md +17 -16
  658. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +6 -4
  659. package/dist/knowledge/skills/module-registration/SKILL.md +2 -1
  660. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +93 -15
  661. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +86 -1
  662. package/dist/knowledge/skills/module-relationships/SKILL.md +3 -2
  663. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
  664. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
  665. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
  666. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
  667. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
  668. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
  669. package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
  670. package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -33
  671. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
  672. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
  673. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
  674. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
  675. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
  676. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
  677. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +132 -23
  678. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
  679. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +29 -0
  680. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
  681. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
  682. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
  683. package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
  684. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
  685. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +75 -24
  686. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +3 -3
  687. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +61 -0
  688. package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
  689. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +17 -2
  690. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +15 -0
  691. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
  692. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +25 -0
  693. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +6 -0
  694. package/dist/knowledge/skills/resource-add-field/SKILL.md +1 -0
  695. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
  696. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +105 -6
  697. package/dist/knowledge/skills/resource-add-module/SKILL.md +1 -0
  698. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +2 -1
  699. package/dist/knowledge/skills/resource-add-resource/SKILL.md +3 -0
  700. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +124 -30
  701. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +1 -0
  702. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +8 -0
  703. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +9 -0
  704. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +17 -1
  705. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +124 -30
  706. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +7 -6
  707. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +142 -34
  708. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +98 -0
  709. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +86 -52
  710. package/dist/knowledge/skills/resource-custom-view/SKILL.md +1 -0
  711. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +100 -5
  712. package/dist/knowledge/skills/resource-external-data/SKILL.md +1026 -28
  713. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
  714. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
  715. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
  716. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +686 -11
  717. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +904 -31
  718. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +166 -6
  719. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
  720. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
  721. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
  722. package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
  723. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
  724. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
  725. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
  726. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
  727. package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
  728. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
  729. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +1 -0
  730. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +1 -0
  731. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +12 -0
  732. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
  733. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
  734. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
  735. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
  736. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
  737. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
  738. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
  739. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +2 -2
  740. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
  741. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
  742. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +2 -1
  743. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +28 -0
  744. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +5 -1
  745. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +34 -30
  746. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +5 -1
  747. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +101 -42
  748. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +21 -0
  749. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +1 -2
  750. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +125 -6
  751. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +8 -2
  752. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
  753. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +61 -1
  754. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +110 -9
  755. package/dist/knowledge/skills/seeding-authoring/SKILL.md +1 -0
  756. package/dist/knowledge/skills/seeding-operations/SKILL.md +1 -0
  757. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
  758. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
  759. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
  760. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
  761. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
  762. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
  763. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +1 -0
  764. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +61 -0
  765. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
  766. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
  767. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +14 -16
  768. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +6 -4
  769. package/dist/knowledge/skills/spec-component-update/SKILL.md +1 -0
  770. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
  771. package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
  772. package/dist/knowledge/skills/spec-feature-update/SKILL.md +1 -0
  773. package/dist/knowledge/skills/spec-resource-update/SKILL.md +13 -0
  774. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +158 -46
  775. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
  776. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
  777. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +5 -1
  778. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +1 -0
  779. package/dist/knowledge/skills/views-app-level/SKILL.md +2 -1
  780. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +43 -1
  781. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
  782. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +5 -1
  783. package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
  784. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -0
  785. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +29 -6
  786. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
  787. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +17 -4
  788. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +23 -28
  789. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +7 -22
  790. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +167 -20
  791. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
  792. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +63 -6
  793. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
  794. package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
  795. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -2
  796. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -2
  797. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +2 -1
  798. package/dist/knowledge/skills/website-page-authoring/SKILL.md +117 -33
  799. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
  800. package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
  801. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
  802. package/dist/knowledge/skills/website-section-contact/SKILL.md +65 -36
  803. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -11
  804. package/dist/knowledge/skills/website-section-cta/SKILL.md +32 -22
  805. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -11
  806. package/dist/knowledge/skills/website-section-faq/SKILL.md +99 -63
  807. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -11
  808. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +27 -18
  809. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -11
  810. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +33 -22
  811. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -11
  812. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +31 -20
  813. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -11
  814. package/dist/knowledge/skills/website-section-hero/SKILL.md +65 -44
  815. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -11
  816. package/dist/knowledge/skills/website-section-pricing/SKILL.md +217 -200
  817. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -11
  818. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
  819. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +45 -34
  820. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -11
  821. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
  822. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
  823. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +30 -25
  824. package/dist/knowledge/skills/worker-authoring/SKILL.md +1 -0
  825. package/dist/knowledge/topic-index.json +5887 -1695
  826. package/dist/tsconfig.build.tsbuildinfo +1 -1
  827. package/dist/tsconfig.tsbuildinfo +1 -1
  828. package/package.json +4 -4
  829. package/dist/knowledge/skills/journey-approve/SKILL.md +0 -63
  830. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -77
  831. package/dist/knowledge/skills/journey-next/SKILL.md +0 -82
  832. package/dist/knowledge/skills/journey-report/SKILL.md +0 -56
  833. package/dist/knowledge/skills/journey-run/SKILL.md +0 -140
  834. package/dist/knowledge/skills/journey-status/SKILL.md +0 -60
  835. /package/dist/{knowledge/skills/journey-approve → claude-marketplace/plugins/wildo}/references/specification-family-map.md +0 -0
@@ -0,0 +1,275 @@
1
+ # Submission challenge (captcha or proof of work)
2
+
3
+ The check a caller who is not signed in answers before a protected public operation runs, when the application
4
+ declares a captcha provider.
5
+
6
+ Read this when:
7
+
8
+ - the contact form answers `400` with `error.code` `SUBMISSION_CHALLENGE_REQUIRED` or `SUBMISSION_CHALLENGE_REFUSED`;
9
+ - you add Google reCAPTCHA (`recaptcha`) or another captcha provider to the application;
10
+ - you add your own public operation (a waitlist, a quote request, a newsletter signup) and want it protected the way
11
+ the contact form is;
12
+ - you write your own public form and need it to send the answer the way `InboundContactForm` does.
13
+
14
+ ## Protecting an operation: declare it on the variant
15
+
16
+ A protected operation DECLARES the challenge on its variant. The framework asks it before anything else in the operation
17
+ runs, documents the header and both refusals in the API reference, and refuses a submission it cannot check. You write
18
+ no hook for it, and you do not call the challenge service yourself.
19
+
20
+ ## Import Origins
21
+
22
+ - `@wildo-ai/saas-models`
23
+
24
+ ## Source Excerpts
25
+
26
+ ### Origin Package: `@wildo-ai/saas-models`
27
+
28
+ ```typescript
29
+ *
30
+ * Whether a caller who is NOT signed in must answer a submission challenge — a captcha vendor's token or the
31
+ * framework's proof of work — for this variant to run (#1985).
32
+ *
33
+ * Declare it on a public operation a script could flood: a contact form, a waitlist, a quote request. `action` names
34
+ * the form, in your own vocabulary (letters, digits, `_` and `/`); a vendor token is minted for that action and one
35
+ * minted for another is refused, so give each form its own. The framework's own contact form declares
36
+ * `SubmissionChallengeAction.INBOUND_CONTACT`.
37
+ *
38
+ * When it applies: only when the application declares a captcha provider (Google reCAPTCHA is `recaptcha`), and only
39
+ * to a caller who proved no identity (an anonymous-session or public request). A signed-in person, a machine credential
40
+ * and the application's own internal calls are not asked: a challenge tells a person from a script, and those callers
41
+ * already proved who they are. An application without a captcha provider asks nobody.
42
+ *
43
+ * What the framework does for you: checks the `x-submission-challenge-response` header before anything else in the
44
+ * operation runs — before your prefix hooks, before any read — and refuses with 400 and `error.code`
45
+ * `SUBMISSION_CHALLENGE_REQUIRED` (no answer) or `SUBMISSION_CHALLENGE_REFUSED` (an answer it did not accept); a
46
+ * submission it cannot check, because no verifier is bound, is refused too. It counts each refusal by reason, records
47
+ * each vendor verification, and documents the header and both refusals in the OpenAPI reference. Your implementation
48
+ * does nothing: do not call the challenge service from a prefix hook.
49
+ *
50
+ * Who sends the answer: a website form — the framework's `InboundContactForm`, or your own form calling
51
+ * `obtainSubmissionChallengeAnswer` from `@wildo-ai/saas-website` with this action. The application's own frontend
52
+ * client sends none, so do not declare it on an anonymous operation your application's screens call: every such call
53
+ * would be refused once a captcha provider is declared.
54
+ *
55
+ * Constraints, each refused when the resource configuration is built or when the application starts: a variant reached
56
+ * by an HTTP request (`API_CALL` or `API_CALL_WITH_CALLBACK`; no other variant receives a request header), an action
57
+ * matching the vendor's grammar, and the `INLINE` runtime mode (a queued or background execution re-enters without
58
+ * the header).
59
+ *
60
+ * @example a public waitlist signup, protected like the contact form
61
+ * variants: [{
62
+ * variantType: ResourceOperationVariantType.API_CALL,
63
+ * isDefault: true,
64
+ * roles: [CORE_APP_ROLES.APP_ANONYMOUS],
65
+ * riskLevel: ResourceOperationRiskLevel.LOW,
66
+ * rateLimit: { requestsPerMinute: 5, requestsPerHour: 30 },
67
+ * submissionChallenge: { action: WaitlistChallengeAction.JOIN },
68
+ * }]
69
+ */
70
+ submissionChallenge?: ResourceOperationSubmissionChallenge;
71
+ ```
72
+
73
+ Name the action in your own vocabulary, one per form (an enum in your `shared-lib`, beside the resource). The
74
+ framework's contact form uses `SubmissionChallengeAction.INBOUND_CONTACT`; do not reuse it for another form, because a
75
+ vendor token minted for one action is accepted on every operation that declares that action.
76
+
77
+ ## What the check does
78
+
79
+ ## Import Origins
80
+
81
+ - `@wildo-ai/saas-backend-lib`
82
+
83
+ ## Source Excerpts
84
+
85
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
86
+
87
+ ```typescript
88
+ /**
89
+ * The check a PUBLIC submission answers before the backend accepts it (#1735, #1985).
90
+ *
91
+ * You do not call it. Declare `submissionChallenge: { action }` on the operation variant, and the framework asks it in
92
+ * the operation pipeline, before any hook of yours runs:
93
+ *
94
+ * - Required only when this backend declares a captcha provider (a module shipping a captcha verifier, such as
95
+ * `recaptcha`'s backend part), and only of a caller who proved no identity (see
96
+ * {@link SUBMISSION_CHALLENGE_ASKED_BY_EXECUTION_TYPE}). With no captcha provider declared, nobody is asked.
97
+ * - Otherwise it refuses with `400` and `SUBMISSION_CHALLENGE_REQUIRED` (no answer) or `SUBMISSION_CHALLENGE_REFUSED`
98
+ * (an answer it did not accept), unless the `x-submission-challenge-response` header carries EITHER a token the
99
+ * declared vendor accepts for the declared `action`, OR an unused, unexpired solution to a proof-of-work challenge from
100
+ * `GET /submission-challenges/proof-of-work`.
101
+ * - The proof of work is the consent-exempt answer: a visitor who declined the vendor's consent still submits.
102
+ * - The answer belongs to the operation the request addressed. A nested operation never receives it, so an unauthenticated
103
+ * request whose implementation calls a protected operation is refused there: nothing can answer for it.
104
+ *
105
+ * @example the framework's own contact form declares it on its public CREATE variant
106
+ * {
107
+ * variantType: ResourceOperationVariantType.API_CALL,
108
+ * isDefault: true,
109
+ * roles: [CORE_APP_ROLES.APP_ANONYMOUS],
110
+ * riskLevel: ResourceOperationRiskLevel.LOW,
111
+ * rateLimit: { requestsPerMinute: 5, requestsPerHour: 30 },
112
+ * submissionChallenge: { action: SubmissionChallengeAction.INBOUND_CONTACT },
113
+ * }
114
+ */
115
+ export interface SubmissionChallengeVerifier {
116
+ /** Whether public submissions must answer a challenge: this backend declares a captcha provider. */
117
+ isChallengeRequired(): boolean;
118
+ /** Refuse (throw) unless the encoded answer is accepted for `action`; resolves when no challenge is required. */
119
+ assertSubmissionChallengeAnswered(params: {
120
+ readonly action: string;
121
+ readonly encodedResponse: string | undefined;
122
+ readonly executionContext?: ExecutionContext<any>;
123
+ }): Promise<void>;
124
+ }
125
+
126
+ /**
127
+ * Whether a caller of each execution type is asked a declared challenge: `true` when nobody authenticated.
128
+ *
129
+ * TOTAL over the enum on purpose, so a new execution type is a compile error here until someone decides whether it
130
+ * proved an identity: a set of types to ask would exempt a new unauthenticated type silently. A signed-in person, a
131
+ * machine credential, a consumable token and the application's own internal calls (seeds, jobs) are not asked, because a
132
+ * challenge tells a person from a script and those callers already proved who they are. A verified webhook sender and a
133
+ * declared inbound handler proved a signature, not a person, and cannot answer a browser challenge.
134
+ */
135
+ export const SUBMISSION_CHALLENGE_ASKED_BY_EXECUTION_TYPE: Readonly<Record<ExecutionContext_ExecutionType, boolean>> = {
136
+ [ExecutionContext_ExecutionType.ANONYMOUS_SESSION]: true,
137
+ [ExecutionContext_ExecutionType.PUBLIC_EXECUTION]: true,
138
+ [ExecutionContext_ExecutionType.USER_REQUEST]: false,
139
+ [ExecutionContext_ExecutionType.ORGANIZATION_MACHINE]: false,
140
+ [ExecutionContext_ExecutionType.APPLICATION_MACHINE]: false,
141
+ [ExecutionContext_ExecutionType.CONSUMABLE_TOKEN]: false,
142
+ [ExecutionContext_ExecutionType.INTERNALLY_INITIATED_REQUEST]: false,
143
+ [ExecutionContext_ExecutionType.WEBHOOK_CALLBACK]: false,
144
+ [ExecutionContext_ExecutionType.INBOUND_DELIVERY]: false,
145
+ };
146
+
147
+ /**
148
+ * Ask a public submission its challenge, refusing when there is nothing to ask it with.
149
+ *
150
+ * The verifier is optional on the service tier, because a minimal container (a test, a platform service) binds none.
151
+ * Skipping the check when it is absent would let an unauthenticated submission through unchecked wherever the binding is
152
+ * missing, and nothing would say so. This fails CLOSED instead: with no verifier it throws a CONFIGURATION error, since
153
+ * whether the application declared a captcha provider — the only thing that could make the check a no-op — is exactly
154
+ * what cannot be known without the verifier.
155
+ */
156
+ export async function assertPublicSubmissionChallenge(params: {
157
+ readonly verifier: SubmissionChallengeVerifier | undefined;
158
+ readonly errorBuilder: Pick<ErrorBuilderBackendService, 'buildError'>;
159
+ readonly action: string;
160
+ readonly encodedResponse: string | undefined;
161
+ readonly executionContext?: ExecutionContext<any>;
162
+ }): Promise<void> {
163
+ const { verifier, errorBuilder, action, encodedResponse, executionContext } = params;
164
+ if (verifier === undefined) {
165
+ throw errorBuilder.buildError(ErrorType.CONFIGURATION, executionContext, {
166
+ customMessageReference: ErrorCustomMessageReference.CONFIGURATION,
167
+ context: { message: 'No submission-challenge verifier is bound, so an unauthenticated submission cannot be checked and is refused' },
168
+ });
169
+ }
170
+ await verifier.assertSubmissionChallengeAnswered({ action, encodedResponse, executionContext });
171
+ }
172
+
173
+ /**
174
+ * The operation pipeline's one enforcement of a DECLARED challenge (#1985): called by `doOperation` for every operation,
175
+ * on every transport, before anything else in the operation runs.
176
+ *
177
+ * Resolves at once when the operation declares no challenge, or when the caller's execution type proved an identity.
178
+ * Otherwise it asks {@link assertPublicSubmissionChallenge}, which fails closed on a missing verifier. An execution type
179
+ * outside {@link SUBMISSION_CHALLENGE_ASKED_BY_EXECUTION_TYPE} (a value the enum does not know) reads as `undefined` and
180
+ * is asked.
181
+ */
182
+ export async function enforceDeclaredSubmissionChallenge(params: {
183
+ readonly declaration: ResourceOperationSubmissionChallenge | undefined;
184
+ readonly verifier: SubmissionChallengeVerifier | undefined;
185
+ readonly errorBuilder: Pick<ErrorBuilderBackendService, 'buildError'>;
186
+ readonly encodedResponse: string | undefined;
187
+ readonly executionContext: ExecutionContext<any>;
188
+ }): Promise<void> {
189
+ const { declaration, verifier, errorBuilder, encodedResponse, executionContext } = params;
190
+ if (declaration === undefined) return;
191
+ if (SUBMISSION_CHALLENGE_ASKED_BY_EXECUTION_TYPE[executionContext.executionType] === false) return;
192
+ await assertPublicSubmissionChallenge({ verifier, errorBuilder, action: declaration.action, encodedResponse, executionContext });
193
+ }
194
+ ```
195
+
196
+ ## The website side
197
+
198
+ What a custom form posting to a protected operation calls (the engine's `InboundContactForm` already does it for
199
+ `/inbound-contacts`). Pass the action your operation declares:
200
+
201
+ ## Import Origins
202
+
203
+ - `@wildo-ai/saas-website`
204
+
205
+ ## Source Excerpts
206
+
207
+ ### Origin Package: `@wildo-ai/saas-website`
208
+
209
+ ```typescript
210
+ /** What a form knows about the page's captcha when it submits. */
211
+ export interface WebsiteSubmissionChallengeSource {
212
+ /** This website declares a captcha provider, so its public forms answer a challenge. */
213
+ readonly captchaDeclared: boolean;
214
+ /** The captcha vendor RUNNING on the page — present only once the visitor consented and it started. */
215
+ readonly runningCaptcha?: { readonly providerRef: string; readonly sink: FrontendCaptchaSink };
216
+ }
217
+
218
+ /** The challenge source of the current page: its declared captcha provider and, if started, its running client. */
219
+ export function useWebsiteSubmissionChallengeSource(): WebsiteSubmissionChallengeSource {
220
+ // Read without `useWebsiteRuntime`'s throw: a form rendered outside a page (a test, a storybook) simply has no captcha.
221
+ const runtime = useContext(WebsiteRuntimeContext);
222
+ const running = useWebsiteProviderSdkActivations();
223
+ const captchaDeclared = runtime?.frontendProviderRegistry?.findProviderByProviderCapability(BUILTIN_PROVIDER_CAPABILITY.FRONTEND_CAPTCHA) !== undefined;
224
+ return useMemo(() => {
225
+ const captcha = running.find((entry) => entry.providerCapabilities.includes(BUILTIN_PROVIDER_CAPABILITY.FRONTEND_CAPTCHA)
226
+ && isFrontendCaptchaSink(entry.activation.handle));
227
+ return {
228
+ captchaDeclared,
229
+ ...(captcha === undefined ? {} : { runningCaptcha: { providerRef: captcha.providerRef, sink: captcha.activation.handle as FrontendCaptchaSink } }),
230
+ };
231
+ }, [captchaDeclared, running]);
232
+ }
233
+
234
+ /**
235
+ * The encoded answer to send, or `undefined` when this site asks for none. `proofOfWorkOnly` skips the vendor (the
236
+ * retry after a refused token). Throws only when the proof-of-work challenge cannot be fetched or solved; the caller
237
+ * then shows its ordinary failure and does not submit unanswered (`InboundContactForm` shows its `errorMessage`).
238
+ */
239
+ export async function obtainSubmissionChallengeAnswer(params: {
240
+ readonly source: WebsiteSubmissionChallengeSource;
241
+ /**
242
+ * The action the operation the form posts to DECLARES in its `submissionChallenge` (#1985): the engine's
243
+ * `SubmissionChallengeAction.INBOUND_CONTACT` for `/inbound-contacts`, your own action for your own operation. A token
244
+ * minted for any other action is refused.
245
+ */
246
+ readonly action: string;
247
+ readonly client: Pick<WebsiteAnonymousSessionClient, 'getPublic'>;
248
+ readonly proofOfWorkOnly?: boolean;
249
+ readonly signal?: AbortSignal;
250
+ }): Promise<string | undefined> {
251
+ const { source, action, client, proofOfWorkOnly = false, signal } = params;
252
+ if (!proofOfWorkOnly && source.runningCaptcha !== undefined) {
253
+ const token = await source.runningCaptcha.sink.execute(action);
254
+ if (token !== undefined) {
255
+ return encodeSubmissionChallengeResponse({
256
+ kind: SubmissionChallengeResponseKind.PROVIDER_TOKEN,
257
+ providerRef: source.runningCaptcha.providerRef,
258
+ token,
259
+ });
260
+ }
261
+ }
262
+ if (!source.captchaDeclared && !proofOfWorkOnly) return undefined;
263
+ const challenge = await client.getPublic<ProofOfWorkChallenge>(SUBMISSION_CHALLENGE_PROOF_OF_WORK_PATH);
264
+ const answer = await solveProofOfWorkChallenge(challenge, { signal });
265
+ if (answer === undefined) throw new Error('The proof-of-work challenge could not be solved.');
266
+ return encodeSubmissionChallengeResponse(answer);
267
+ }
268
+
269
+ /** Whether a failed submission was refused at its challenge — the one refusal a form answers again, with the proof of work. */
270
+ export function isSubmissionChallengeRefusal(error: unknown): boolean {
271
+ if (!(error instanceof WebsiteAnonymousRequestError)) return false;
272
+ const code = error.errorCode;
273
+ return code === SubmissionChallengeRefusalCode.REQUIRED || code === SubmissionChallengeRefusalCode.REFUSED;
274
+ }
275
+ ```
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: website-label-pack
3
3
  description: Add or repair a typed website label pack, locale override or section label key. Use when the user says "add a translation key", "author a label pack", "override a page label per locale", or "wire a per-variant label override".
4
+ user-invocable: false
4
5
  ---
5
6
 
6
7
  # Website Label Pack
@@ -51,17 +52,20 @@ rendered sections.
51
52
 
52
53
  ## Worked Example
53
54
 
55
+ A key is `website.<page>.<sectionRef>.<slot>`, and section refs are page-scoped
56
+ (`landing-hero`, not `hero`), so the section's ref appears whole inside the key.
57
+
54
58
  <!-- TIER C WAIVER: this demonstrates the ownership sequence without assuming
55
59
  the installed package's exact mapped-type export name. -->
56
60
  ```ts
57
61
  const expectedHeroLabels = [
58
- 'website.landing.hero.headline',
59
- 'website.landing.hero.primary-cta',
62
+ 'website.landing.landing-hero.headline',
63
+ 'website.landing.landing-hero.cta.primary',
60
64
  ] as const;
61
65
 
62
66
  const en = {
63
- 'website.landing.hero.headline': 'Make the next step clear',
64
- 'website.landing.hero.primary-cta': 'Start now',
67
+ 'website.landing.landing-hero.headline': 'Make the next step clear',
68
+ 'website.landing.landing-hero.cta.primary': 'Start now',
65
69
  };
66
70
  ```
67
71
 
@@ -358,7 +362,11 @@ validator that checks manifest-to-pack completeness.
358
362
 
359
363
  ## Verification
360
364
 
361
- - Every expected key is present in each supported locale pack.
365
+ - Every expected key is present in each supported locale pack — `wildo website
366
+ audit` checks every pack against every page and section, as `astro build` does.
367
+ - Every slot a component reads is declared in its section's `expectedLabelKeys`.
368
+ The label hook does not check this: an undeclared slot renders its raw key and
369
+ no validator sees it, because validation runs against the DECLARED keys.
362
370
  - A section component uses the scope-specific label access path.
363
371
  - A copy change that changes page intent has an explicit `llms.txt` review.
364
372
 
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: website-layout-overrides
3
3
  description: Customize an application website page layout or section wrapper without losing page, section and accessibility responsibilities. Use when the user says "override website page layout", "customize the website landing layout", "swap the WebsiteSection wrapper", or "replace default website chrome".
4
+ user-invocable: false
4
5
  ---
5
6
 
6
7
  # Website Layout Overrides
@@ -252,8 +253,9 @@ function WebsitePageLayoutContent({
252
253
  //
253
254
  // Consent-based providers start only once their purpose is granted (#534). Before the stored decision is
254
255
  // read, nothing is granted — the static HTML and the first render start nothing optional.
255
- useWebsiteProviderScripts(runtime.frontendProviderRegistry, consent.grantedPurposes);
256
- useWebsiteProviderSdks(runtime.frontendProviderRegistry, consent.grantedPurposes);
256
+ useWebsiteProviderScripts(runtime.frontendProviderRegistry, runtime.providerComponentRegistry);
257
+ // The running SDKs are published to the page (#1735): the contact form asks the consented captcha vendor for a token.
258
+ const runningProviderSdks = useWebsiteProviderSdks(runtime.frontendProviderRegistry, consent.grantedPurposes);
257
259
 
258
260
  const providerRootAttributes = useMemo<Record<string, string>>(() => {
259
261
  const attrs: Record<string, string> = {};
@@ -301,6 +303,7 @@ function WebsitePageLayoutContent({
301
303
 
302
304
  return (
303
305
  <WebsitePageContextProvider value={pageContextValue}>
306
+ <WebsiteProviderSdkActivationsContext.Provider value={runningProviderSdks}>
304
307
  <div
305
308
  data-website-page-ref={safePageRef as unknown as string}
306
309
  className={className}
@@ -328,6 +331,7 @@ function WebsitePageLayoutContent({
328
331
  {resolvedFooter !== null ? <footer>{resolvedFooter}</footer> : null}
329
332
  {renderConsentSurface(consent, runtime.consentBannerComponent)}
330
333
  </div>
334
+ </WebsiteProviderSdkActivationsContext.Provider>
331
335
  </WebsitePageContextProvider>
332
336
  );
333
337
  }
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: website-marketing-metadata-extension
3
3
  description: Add an application-owned marketing metadata field to a website contact/conversion flow without turning the payload into ungoverned browser data. Use when the user says "add custom marketing metadata", "track ICP fields on contact", "capture company size on form submission", or "extend inbound-contact attribution".
4
+ user-invocable: false
4
5
  ---
5
6
 
6
7
  # Website Marketing Metadata Extension
@@ -77,7 +78,8 @@ type ContactExtra = {
77
78
  * `WebsiteRootConfig` (page registry, design tokens, navigation chrome,
78
79
  * site-level SEO branding) with the per-service `WildoMarketingWebsiteConfig`
79
80
  * loaded from `wildo.website.config.ts` (locales, default locale,
80
- * public origin, future `appOrigin` cross-origin handoff target).
81
+ * public origin, and the `appOrigin` / `apiOrigin` the site reaches the
82
+ * product through — settled for THIS build by `loadWebsiteSiteContext`).
81
83
  *
82
84
  * # Why a dedicated aggregator type (vs. threading both raw configs)
83
85
  *
@@ -151,7 +153,9 @@ export interface WebsiteSiteContext {
151
153
  * The per-service `WildoMarketingWebsiteConfig` loaded from
152
154
  * `wildo.website.config.ts`. Single source of truth for the
153
155
  * marketing-site ROUTING + ORIGIN surface (`defaultLocale`,
154
- * `locales`, `publicOrigin`, future `appOrigin`).
156
+ * `locales`, `publicOrigin`, `appOrigin`, `apiOrigin`). The two origins
157
+ * are the values for THIS build (override, local dev, authored — see
158
+ * `resolveWebsiteBuildOrigins`), which is why every page reads them here.
155
159
  */
156
160
  readonly websiteConfig: WildoMarketingWebsiteConfig;
157
161
  /**
@@ -222,6 +226,11 @@ export function composeWebsiteSiteContext(
222
226
  requestsPerMinute: 5,
223
227
  requestsPerHour: 30,
224
228
  },
229
+ // …and, when the application declares a captcha provider, a visitor answers a challenge before the lead is
230
+ // written (#1985): the engine asks it in `doOperation`, documents the header in the API reference, and refuses
231
+ // an unanswered or refused submission with 400. The rate limit stays the primary control: a bot can always
232
+ // choose the proof of work, which costs it milliseconds.
233
+ submissionChallenge: { action: SubmissionChallengeAction.INBOUND_CONTACT },
225
234
  // The lead's marketing opt-in is a consent DECISION: the server stamps its instant (#534).
226
235
  basicPrefixOperation: ({ inputDto }) => buildConsentDecisionPatch(inputDto, undefined),
227
236
  authoritativeFields: ['privacy'],
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: website-navigation-authoring
3
3
  description: Author site-wide navigation (header + footer) as plain React components plugged into `WebsiteRootConfig.navigation.{headerComponent,footerComponent}` and rendered by `WebsitePageLayout`. Use when the user says "add a header link", "configure footer columns", "wire site navigation", "compose a header with mega-menu", "swap the header on the pricing page", "add a locale switcher", or "wire the sign-up CTA into the header".
4
+ user-invocable: false
4
5
  ---
5
6
 
6
7
  # Website Navigation Authoring (Header & Footer)
@@ -369,7 +370,7 @@ don't pass the prop).
369
370
  | Rationalization | Reality |
370
371
  | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
371
372
  | "I'll wrap the header in `<WebsiteSection>` for analytics consistency" | Chrome is not a section. The framework emits `data-website-chrome="header"` on the runtime layout's `<header>` element; analytics that needs the chrome distinction reads that, not `data-section-ref`. Wrapping in `<WebsiteSection>` would corrupt the page's section context and break label-key derivation in chrome's children. |
372
- | "I'll author header/footer once via `defineWebsiteSection` so they get the SEO contract" | Chrome doesn't have an SEO category. There is no `WebsiteSectionCategory.HEADER` for a reason — chrome doesn't emit JSON-LD; the page sections do. Trying to force chrome into the section vocabulary breaks the 1:1 invariant the SEO dispatcher relies on. |
373
+ | "I'll author header/footer once via `defineWebsiteSection` so they get the SEO contract" | Chrome doesn't have an SEO category. There is no `WebsiteSectionCategory.HEADER` for a reason — chrome doesn't emit JSON-LD; the page sections do. Forcing chrome into the section vocabulary breaks the one-skill-per-category mapping, and gains no structured data: the page's sections emit JSON-LD through `getStructuredData`, rendered by the page route. |
373
374
  | "My header is the site's banner, so its root should be `<header>`" | It already is one: `WebsitePageLayout` renders `<header>{HeaderComponent}</header>`. A second `<header>` inside it is a banner nested in the banner and a page with two, which axe reports three ways and a screen reader lists twice. The layout owns the landmark; the component owns its contents. |
374
375
  | "I'll register the header per page so each page can override it" | Per-page override IS supported (`header={…}` prop on `<WebsitePageLayout>`). Site-wide registration is the common case; per-page is the escape hatch. Using per-page registration as the default forces every page module to repeat the registration and loses the runtime-context single source of truth. |
375
376
  | "Header CTA can target `https://app.example.com/signup` directly" | Direct URLs lose the parent-domain anonymous-session UUID at the cross-frontend boundary. The app-side cannot match the marketing-site visitor to the new sign-up. Use the handoff route (D16). |