@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
@@ -37,10 +37,12 @@
37
37
  * 2. Per-bot blocks for `disallowedCrawlers` (allow-by-default
38
38
  * direction) — each named bot gets its own `User-agent: <bot>`
39
39
  * + `Disallow: /` block.
40
- * 3. Catch-all `User-agent: *` block carrying the site-wide
41
- * `policy` (`Disallow: /` if `policy === 'noindex'` OR if
42
- * `allowedCrawlers` is set, otherwise nothing) and any
43
- * `disallow[]` path-prefix entries.
40
+ * 3. Catch-all `User-agent: *` block: `Disallow: /` only when
41
+ * `allowedCrawlers` is set (the named bots are then the only ones
42
+ * permitted), otherwise the allow-everything `Disallow:` plus any
43
+ * `disallow[]` path-prefix entries. `policy === 'noindex'` adds
44
+ * nothing here — it is expressed by the page's robots meta tag,
45
+ * which a crawler can only read if it may fetch the page (#494).
44
46
  * 4. `Sitemap: <publicOrigin>/sitemap-index.xml` footer when
45
47
  * `seo.sitemap?.enabled !== false` (defaults to `true`).
46
48
  * `@astrojs/sitemap` emits `sitemap-index.xml` regardless of
@@ -60,10 +62,9 @@
60
62
  *
61
63
  * The `Sitemap:` directive is independent from any `User-agent`
62
64
  * block — it is a top-level signal to any crawler that the site
63
- * publishes a sitemap. Even when the catch-all policy is
64
- * `Disallow: /` (e.g. `policy === 'noindex'`), the `Sitemap:` line
65
- * stays useful: a crawler that ignores `noindex` (Bing was famous
66
- * for this) at least has a single canonical URL list to consult,
65
+ * publishes a sitemap. Even when the catch-all is `Disallow: /`
66
+ * (`allowedCrawlers` set), the `Sitemap:` line stays useful: the
67
+ * permitted crawlers have a single canonical URL list to consult,
67
68
  * and human readers of `robots.txt` see the publication contract
68
69
  * intact.
69
70
  *
@@ -123,13 +124,12 @@ export function renderRobotsTxt(siteContext: WebsiteSiteContext): string {
123
124
  }
124
125
 
125
126
  /**
126
- * Block 3 — catch-all `User-agent: *`. Two policy-driven shapes:
127
- * - `noindex` → `Disallow: /` (the site-wide closure).
128
- * - `index` (default) → `Disallow:` is the spec-canonical "allow
129
- * everything" line; combined with any per-path `Disallow: <path>`
130
- * entries from `disallow[]`. When `allowedCrawlers` is set, the
131
- * catch-all also closes the rest of the crawler universe with
132
- * `Disallow: /` so the named bots are the ONLY ones permitted.
127
+ * Block 3 — catch-all `User-agent: *`. `Disallow:` is the
128
+ * spec-canonical "allow everything" line, combined with any per-path
129
+ * `Disallow: <path>` entries from `disallow[]`. When `allowedCrawlers`
130
+ * is set, the catch-all instead closes the rest of the crawler universe
131
+ * with `Disallow: /` so the named bots are the ONLY ones permitted. The
132
+ * `policy` is not expressed here at all — see below.
133
133
  */
134
134
  const catchAllLines: string[] = ['User-agent: *'];
135
135
  /*
@@ -15,7 +15,8 @@
15
15
  * `WebsiteRootConfig` (page registry, design tokens, navigation chrome,
16
16
  * site-level SEO branding) with the per-service `WildoMarketingWebsiteConfig`
17
17
  * loaded from `wildo.website.config.ts` (locales, default locale,
18
- * public origin, future `appOrigin` cross-origin handoff target).
18
+ * public origin, and the `appOrigin` / `apiOrigin` the site reaches the
19
+ * product through — settled for THIS build by `loadWebsiteSiteContext`).
19
20
  *
20
21
  * # Why a dedicated aggregator type (vs. threading both raw configs)
21
22
  *
@@ -89,7 +90,9 @@ export interface WebsiteSiteContext {
89
90
  * The per-service `WildoMarketingWebsiteConfig` loaded from
90
91
  * `wildo.website.config.ts`. Single source of truth for the
91
92
  * marketing-site ROUTING + ORIGIN surface (`defaultLocale`,
92
- * `locales`, `publicOrigin`, future `appOrigin`).
93
+ * `locales`, `publicOrigin`, `appOrigin`, `apiOrigin`). The two origins
94
+ * are the values for THIS build (override, local dev, authored — see
95
+ * `resolveWebsiteBuildOrigins`), which is why every page reads them here.
93
96
  */
94
97
  readonly websiteConfig: WildoMarketingWebsiteConfig;
95
98
  /**
@@ -219,6 +219,14 @@ export interface CreateWebsiteBlogPostBridgeIslandDeps {
219
219
  * Config sync emits a stable map, including an empty map when no providers are declared.
220
220
  */
221
221
  frontendProviderModules?: GeneratedWebsiteProviderModules;
222
+ /**
223
+ * Loaders for provider components an ENGINE provider module declares but cannot import (#1703) —
224
+ * the website's facet-library door, the equivalent of the application's
225
+ * `contributeProviderComponentLoaders`. A provider PACKAGE that ships its own component needs
226
+ * nothing here: its module's `components[capability].load` is used. A DEPS entry because a loader
227
+ * is a function, and island props are serialized.
228
+ */
229
+ providerComponentLoaders?: ReadonlyArray<ProviderComponentLoaderContribution>;
222
230
  /**
223
231
  * Per-slug map of compiled MDX bodies (each entry is a React
224
232
  * component — the `.default` export of the MDX module). Typically
@@ -374,6 +382,13 @@ export function createWebsiteBlogPostBridgeIsland(
374
382
  );
375
383
  }
376
384
 
385
+ // After the missing-slug throw on purpose: that throw ends the render, so it never changes the
386
+ // hook order of a render that completes, and the build-time error stays reachable.
387
+ const { frontendProviderRegistry, providerComponentRegistry } = useWebsiteProviderRegistries({
388
+ frontendProviders,
389
+ frontendProviderModules: deps.frontendProviderModules,
390
+ providerComponentLoaders: deps.providerComponentLoaders,
391
+ });
377
392
  const runtimeValue: WebsiteRuntimeContextValue = {
378
393
  locale,
379
394
  defaultLocale,
@@ -383,10 +398,8 @@ export function createWebsiteBlogPostBridgeIsland(
383
398
  skipToMainContentLabelKey,
384
399
  appOrigin,
385
400
  ...(deps.consentBannerComponent !== undefined ? { consentBannerComponent: deps.consentBannerComponent } : {}),
386
- frontendProviderRegistry: createFrontendWebsiteProviderRegistry({
387
- entries: frontendProviders,
388
- modules: deps.frontendProviderModules,
389
- }),
401
+ frontendProviderRegistry,
402
+ providerComponentRegistry,
390
403
  };
391
404
  return (
392
405
  <WebsiteRuntimeContextProvider value={runtimeValue}>
@@ -0,0 +1,61 @@
1
+ # saas.website.config.pricing-catalog-loader
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-website`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-website`
10
+
11
+ ```typescript
12
+ *
13
+ * `loadWebsitePricingCatalog` — the application's public pricing catalogue, for a website's pricing
14
+ * page (#1835). Call it in the page's `.astro` frontmatter, pass the result to the bridge island as
15
+ * `pricingCatalog`, and read it in the section with `useWebsitePricingCatalog()`; build the page's
16
+ * `AggregateOffer` from the same value with `buildWebsitePricingOfferStructuredData`.
17
+ *
18
+ * It walks up to `wildo.saas.config.ts` the way `loadWebsiteSiteContext` does, and reads the billing
19
+ * catalogue the backend sells from — the `productDefinitions` of the application's shared modules —
20
+ * through `loadApplicationPublicPricingCatalog`, from SOURCE, so a website image that builds only the
21
+ * website still sees the current catalogue.
22
+ *
23
+ * Separate from `loadWebsiteSiteContext` on purpose: loading the shared graph costs seconds, and only a
24
+ * pricing page needs it. Every other page's build stays as fast as it was.
25
+ *
26
+ * **Node-only.** Lives on the `/config-loader` subpath; it must never reach a React-island bundle.
27
+ */
28
+ import {
29
+ loadApplicationPublicPricingCatalog,
30
+ loadConfig,
31
+ resolveWorkspaceScope,
32
+ type WildoSaasConfig,
33
+ } from '@wildo-ai/platform-config-lib';
34
+ import type { PublicPricingCatalog } from '@wildo-ai/saas-models/public-runtime';
35
+
36
+ export interface LoadWebsitePricingCatalogInput {
37
+ /** Where to start the walk up to `wildo.saas.config.ts`. Defaults to the working directory. */
38
+ readonly cwd?: string | undefined;
39
+ /**
40
+ * Keep only plans this scope may subscribe to (a `ResourcePrimaryScope` wire value, e.g.
41
+ * `'organizations'`). Omit when the catalogue sells to one audience.
42
+ */
43
+ readonly targetScope?: string | undefined;
44
+ }
45
+
46
+ export async function loadWebsitePricingCatalog(input: LoadWebsitePricingCatalogInput = {}): Promise<PublicPricingCatalog> {
47
+ const workspaceScope = resolveWorkspaceScope(input.cwd);
48
+ if (workspaceScope.saasRoot === null || workspaceScope.saasConfigPath === null) {
49
+ throw new Error(
50
+ `[saas-website] No wildo.saas.config.ts found walking up from ${input.cwd ?? process.cwd()}. `
51
+ + 'Run astro from inside the application workspace.',
52
+ );
53
+ }
54
+ const saasConfig = await loadConfig<WildoSaasConfig>(workspaceScope.saasConfigPath);
55
+ return loadApplicationPublicPricingCatalog({
56
+ saasRoot: workspaceScope.saasRoot,
57
+ saasConfig,
58
+ ...(input.targetScope === undefined ? {} : { targetScope: input.targetScope }),
59
+ });
60
+ }
61
+ ```
@@ -0,0 +1,154 @@
1
+ # saas.website.config.site-context-loader
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-website`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-website`
10
+
11
+ ```typescript
12
+ *
13
+ * `loadWebsiteSiteContext` — the ONE way a website workspace builds its
14
+ * `WebsiteSiteContext`. Called once, from the workspace's
15
+ * `src/website-site-context.ts`:
16
+ *
17
+ * ```ts
18
+ * import { loadWebsiteSiteContext } from '@wildo-ai/saas-website/config-loader';
19
+ * import { WEBSITE_ROOT_CONFIG } from './website-root.config';
20
+ *
21
+ * export const WEBSITE_SITE_CONTEXT = await loadWebsiteSiteContext({
22
+ * rootConfig: WEBSITE_ROOT_CONFIG,
23
+ * isDevelopment: import.meta.env?.DEV === true,
24
+ * });
25
+ * ```
26
+ *
27
+ * It walks up from the working directory to `wildo.saas.config.ts`, finds the
28
+ * application's single `STATIC_WEBSITE` service, loads that service's
29
+ * `wildo.website.config.ts` and its materialized provider block, and settles the
30
+ * two origins the site reaches the product through (see
31
+ * {@link resolveWebsiteBuildOrigins}).
32
+ *
33
+ * **Why the engine owns this.** Every website workspace used to carry its own
34
+ * copy of this lookup — the scaffolded ones and the hand-written ones alike —
35
+ * and each copy hardcoded its local API port while the app origin had no local
36
+ * form at all. The result: under `astro dev`, every "Start free" CTA pointed at a
37
+ * production-shaped host that resolves to nothing. One loader means one rule.
38
+ *
39
+ * **Why it walks up from the working directory, never from `import.meta.url`.**
40
+ * Astro's prerender pass bundles the calling module into `dist/.prerender/chunks/…`,
41
+ * where a `new URL('../..', import.meta.url)` anchor resolves to `dist/` rather than
42
+ * the application root — every prerendered route then failed with "Config file not
43
+ * found: …/website/dist/wildo.saas.config.ts", while `astro dev` hid it by serving
44
+ * from `src/`. Every `astro dev` / `astro build` runs with the website package (or
45
+ * an ancestor) as its working directory, which is inside the application either way.
46
+ *
47
+ * **Node-only.** Lives on the `/config-loader` subpath with the other loaders; it
48
+ * must never reach a React-island bundle.
49
+ */
50
+ import { resolve as resolvePath } from 'node:path';
51
+
52
+ import {
53
+ loadConfig,
54
+ loadMaterializedFrontendProviders,
55
+ resolveFrontendServicesArtifactPath,
56
+ resolveLocalhostApplicationOrigins,
57
+ resolveWorkspaceScope,
58
+ type LocalhostApplicationOrigins,
59
+ type WildoSaasConfig,
60
+ } from '@wildo-ai/platform-config-lib';
61
+
62
+ import { composeWebsiteSiteContext, type WebsiteSiteContext } from '../astro/website-site-context';
63
+ import type { WebsiteRootConfig } from '../schemas/manifests/website-root-config.shared.schemas';
64
+ import { loadWebsiteConfig, resolveStaticWebsiteServiceEntry } from './load-website-config';
65
+ import type { WildoMarketingWebsiteConfig } from './wildo-website-config.schemas';
66
+
67
+ /** Explicit per-build origin overrides — what a deploy build passes as build arguments. */
68
+ export interface WebsiteOriginOverrides {
69
+ /** `PUBLIC_APP_ORIGIN`: this environment's product origin, derived by the deploy workflow. */
70
+ readonly appOrigin?: string | undefined;
71
+ /** `PUBLIC_API_ORIGIN`: this environment's API origin. */
72
+ readonly apiOrigin?: string | undefined;
73
+ }
74
+
75
+ export interface ResolveWebsiteBuildOriginsInput {
76
+ /** The authored `wildo.website.config.ts` — the production default. */
77
+ readonly websiteConfig: WildoMarketingWebsiteConfig;
78
+ /** `true` under `astro dev`. */
79
+ readonly isDevelopment: boolean;
80
+ /** Where the product and API run locally, from the app's own declared ports. */
81
+ readonly localOrigins: LocalhostApplicationOrigins;
82
+ /** Explicit overrides, which win over everything. */
83
+ readonly overrides: WebsiteOriginOverrides;
84
+ }
85
+
86
+ /**
87
+ * The `websiteConfig` this BUILD serves, with `appOrigin` and `apiOrigin` settled.
88
+ *
89
+ * Precedence, per origin:
90
+ *
91
+ * 1. an explicit override (`PUBLIC_APP_ORIGIN` / `PUBLIC_API_ORIGIN`) — the deploy
92
+ * workflow derives these per environment, so a staging build links into staging;
93
+ * 2. under `astro dev`, the locally running product / API, from the ports the
94
+ * application declares — so a CTA reaches the process `wildo local dev` started;
95
+ * 3. the value authored in `wildo.website.config.ts`.
96
+ *
97
+ * The result replaces the two fields in `websiteConfig` rather than living beside
98
+ * it, because every page already forwards `websiteConfig.appOrigin` /
99
+ * `websiteConfig.apiOrigin` into its island: a second field would be a second
100
+ * source that pages could read instead. `websiteConfig` in a site context is
101
+ * therefore "the config as it applies to this build", which the config file was
102
+ * already half-way to being — it reads `PUBLIC_APP_ORIGIN` itself.
103
+ */
104
+ export function resolveWebsiteBuildOrigins(input: ResolveWebsiteBuildOriginsInput): WildoMarketingWebsiteConfig {
105
+ const { websiteConfig, isDevelopment, localOrigins, overrides } = input;
106
+ const settle = (override: string | undefined, local: string | undefined, authored: string | undefined): string | undefined =>
107
+ override || (isDevelopment ? local : undefined) || authored;
108
+ const appOrigin = settle(overrides.appOrigin, localOrigins.app, websiteConfig.appOrigin) ?? websiteConfig.appOrigin;
109
+ const apiOrigin = settle(overrides.apiOrigin, localOrigins.api, websiteConfig.apiOrigin);
110
+ return { ...websiteConfig, appOrigin, ...(apiOrigin === undefined ? {} : { apiOrigin }) };
111
+ }
112
+
113
+ export interface LoadWebsiteSiteContextInput {
114
+ /** The workspace's `WEBSITE_ROOT_CONFIG`. */
115
+ readonly rootConfig: WebsiteRootConfig;
116
+ /** Pass `import.meta.env?.DEV === true` (optional chaining: `astro.config.ts` evaluates the caller before Vite's env exists). */
117
+ readonly isDevelopment: boolean;
118
+ /** Where to start the walk up to `wildo.saas.config.ts`. Defaults to the working directory. */
119
+ readonly cwd?: string | undefined;
120
+ /** Defaults to `PUBLIC_APP_ORIGIN` / `PUBLIC_API_ORIGIN` from the process environment. */
121
+ readonly overrides?: WebsiteOriginOverrides | undefined;
122
+ }
123
+
124
+ export async function loadWebsiteSiteContext(input: LoadWebsiteSiteContextInput): Promise<WebsiteSiteContext> {
125
+ const workspaceScope = resolveWorkspaceScope(input.cwd);
126
+ if (workspaceScope.saasRoot === null || workspaceScope.saasConfigPath === null) {
127
+ throw new Error(
128
+ `[saas-website] No wildo.saas.config.ts found walking up from ${input.cwd ?? process.cwd()}. `
129
+ + 'Run astro from inside the application workspace.',
130
+ );
131
+ }
132
+ const saasRoot = workspaceScope.saasRoot;
133
+ const saasConfig = await loadConfig<WildoSaasConfig>(workspaceScope.saasConfigPath);
134
+ const [websiteServiceKey] = resolveStaticWebsiteServiceEntry(saasConfig);
135
+ const websiteConfig = await loadWebsiteConfig({ saasRoot, saasConfig });
136
+
137
+ return composeWebsiteSiteContext({
138
+ rootConfig: input.rootConfig,
139
+ websiteConfig: resolveWebsiteBuildOrigins({
140
+ websiteConfig,
141
+ isDevelopment: input.isDevelopment,
142
+ localOrigins: resolveLocalhostApplicationOrigins(saasConfig.services),
143
+ overrides: input.overrides ?? {
144
+ appOrigin: process.env.PUBLIC_APP_ORIGIN,
145
+ apiOrigin: process.env.PUBLIC_API_ORIGIN,
146
+ },
147
+ }),
148
+ frontendProviders: loadMaterializedFrontendProviders({
149
+ artifactPath: resolveFrontendServicesArtifactPath(resolvePath(saasRoot)),
150
+ serviceKey: websiteServiceKey,
151
+ }),
152
+ });
153
+ }
154
+ ```
@@ -45,7 +45,7 @@ const ROW_STYLE: React.CSSProperties = {
45
45
  columnGap: '0.625rem',
46
46
  alignItems: 'center',
47
47
  padding: '0.5rem 0.75rem',
48
- borderBottom: '1px solid var(--website-colors-border, #ccc)',
48
+ borderBottom: `1px solid ${websiteDesignTokenCssVar('colors', 'border', '#ccc')}`,
49
49
  };
50
50
 
51
51
  const ROW_DESCRIPTION_STYLE: React.CSSProperties = { margin: 0, gridColumn: 2, fontSize: '0.75rem', opacity: 0.8 };
@@ -75,10 +75,10 @@ function PurposeChoice({ purpose, checked, onChange }: { purpose: ConsentPurpose
75
75
 
76
76
  const BUTTON_STYLE: React.CSSProperties = {
77
77
  padding: '0.5rem 1rem',
78
- borderRadius: 'var(--website-radii-md, 0.375rem)',
79
- border: '1px solid var(--website-colors-border, #ccc)',
80
- background: 'var(--website-colors-background, #fff)',
81
- color: 'var(--website-colors-foreground, #000)',
78
+ borderRadius: websiteDesignTokenCssVar('radii', 'md', '0.375rem'),
79
+ border: `1px solid ${websiteDesignTokenCssVar('colors', 'border', '#ccc')}`,
80
+ background: websiteDesignTokenCssVar('colors', 'background', '#fff'),
81
+ color: websiteDesignTokenCssVar('colors', 'foreground', '#000'),
82
82
  cursor: 'pointer',
83
83
  };
84
84
 
@@ -137,10 +137,10 @@ export function WebsiteConsentBanner(): ReactNode {
137
137
  display: 'flex',
138
138
  flexDirection: 'column',
139
139
  gap: '0.625rem',
140
- background: 'var(--website-colors-surface, #fff)',
141
- color: 'var(--website-colors-surface-foreground, #000)',
142
- border: '1px solid var(--website-colors-border, #ccc)',
143
- borderRadius: 'var(--website-radii-lg, 0.5rem)',
140
+ background: websiteDesignTokenCssVar('colors', 'surface', '#fff'),
141
+ color: websiteDesignTokenCssVar('colors', 'surfaceForeground', '#000'),
142
+ border: `1px solid ${websiteDesignTokenCssVar('colors', 'border', '#ccc')}`,
143
+ borderRadius: websiteDesignTokenCssVar('radii', 'lg', '0.5rem'),
144
144
  }}
145
145
  >
146
146
  <h2 id={headingId} style={{ margin: 0, fontSize: '1.125rem' }}>{title}</h2>
@@ -150,7 +150,7 @@ export function WebsiteConsentBanner(): ReactNode {
150
150
  nothing — the same vacuous pin the app tier already had to repair. */}
151
151
  <div
152
152
  data-website-consent-rows=""
153
- style={{ minHeight: 0, flex: 1, overflowY: 'auto', border: '1px solid var(--website-colors-border, #ccc)', borderRadius: 'var(--website-radii-md, 0.375rem)' }}
153
+ style={{ minHeight: 0, flex: 1, overflowY: 'auto', border: `1px solid ${websiteDesignTokenCssVar('colors', 'border', '#ccc')}`, borderRadius: websiteDesignTokenCssVar('radii', 'md', '0.375rem') }}
154
154
  >
155
155
  {/*
156
156
  * The always-active row, first, carrying a CHECKED and DISABLED box. It is not a purpose the
@@ -11,8 +11,10 @@
11
11
  ```typescript
12
12
  *
13
13
  * `WebsiteColorTokens` — minimal palette the marketing-site exposes as
14
- * CSS custom properties (`--website-color-<token>`) on the
15
- * `<WebsitePageLayout>` root.
14
+ * CSS custom properties (`--website-colors-<token>`, the key verbatim, so
15
+ * `surfaceForeground` → `--website-colors-surfaceForeground`) on `:root`.
16
+ * Reference one from code through `websiteDesignTokenCssVar('colors', …)`
17
+ * rather than spelling the name.
16
18
  *
17
19
  * **Why a dedicated marketing palette** (vs. reusing
18
20
  * `presets-components-models/design-tokens-config`):
@@ -41,8 +43,9 @@
41
43
  * `cssSafeValue` JSDoc above for the full threat model.
42
44
  *
43
45
  * **Adding a token**: append the field here using `cssSafeValue(...)`,
44
- * document its semantic intent in the JSDoc, and update the matching
45
- * CSS-emit helper in Phase 2 (`emitWebsiteColorTokensCss`).
46
+ * document its semantic intent in the JSDoc. `renderWebsiteDesignTokensCss`
47
+ * (from `@wildo-ai/saas-website/astro`) emits every key generically, so no
48
+ * emitter needs editing.
46
49
  */
47
50
  const _WebsiteColorTokensSchema = z.object({
48
51
  background: cssSafeValue('background color'),
@@ -11,7 +11,7 @@
11
11
  ```typescript
12
12
  *
13
13
  * `WebsiteRadiusTokens` — border-radius scale exposed as
14
- * `--website-radius-<token>` CSS variables.
14
+ * `--website-radii-<token>` CSS variables.
15
15
  *
16
16
  * Marketing radii are intentionally a separate token set from the
17
17
  * SaaS app's radii: the website typically wants larger pill / hero
@@ -71,9 +71,9 @@ export interface TypedWebsiteSectionDefinition<TProps>
71
71
  * **Why a factory instead of constructing the literal directly**:
72
72
  * - Consumers don't have to remember to parse refs / keys
73
73
  * themselves before assembling the literal.
74
- * - The schema parse provides a single audited validation chokepoint
75
- * so `wildo website audit` (Phase 7) can re-validate definitions
76
- * without re-entering the React graph.
74
+ * - The schema parse provides a single audited validation chokepoint,
75
+ * and the parsed `expectedLabelKeys` are what `wildo website audit`
76
+ * checks every locale pack against, without re-entering the React graph.
77
77
  * - The factory is the documented authoring API the
78
78
  * `website_factory_authoring` skill targets — keeping the
79
79
  * authoring surface narrow lets the framework evolve the
@@ -179,8 +179,9 @@ function WebsitePageLayoutContent({
179
179
  //
180
180
  // Consent-based providers start only once their purpose is granted (#534). Before the stored decision is
181
181
  // read, nothing is granted — the static HTML and the first render start nothing optional.
182
- useWebsiteProviderScripts(runtime.frontendProviderRegistry, consent.grantedPurposes);
183
- useWebsiteProviderSdks(runtime.frontendProviderRegistry, consent.grantedPurposes);
182
+ useWebsiteProviderScripts(runtime.frontendProviderRegistry, runtime.providerComponentRegistry);
183
+ // The running SDKs are published to the page (#1735): the contact form asks the consented captcha vendor for a token.
184
+ const runningProviderSdks = useWebsiteProviderSdks(runtime.frontendProviderRegistry, consent.grantedPurposes);
184
185
 
185
186
  const providerRootAttributes = useMemo<Record<string, string>>(() => {
186
187
  const attrs: Record<string, string> = {};
@@ -228,6 +229,7 @@ function WebsitePageLayoutContent({
228
229
 
229
230
  return (
230
231
  <WebsitePageContextProvider value={pageContextValue}>
232
+ <WebsiteProviderSdkActivationsContext.Provider value={runningProviderSdks}>
231
233
  <div
232
234
  data-website-page-ref={safePageRef as unknown as string}
233
235
  className={className}
@@ -255,6 +257,7 @@ function WebsitePageLayoutContent({
255
257
  {resolvedFooter !== null ? <footer>{resolvedFooter}</footer> : null}
256
258
  {renderConsentSurface(consent, runtime.consentBannerComponent)}
257
259
  </div>
260
+ </WebsiteProviderSdkActivationsContext.Provider>
258
261
  </WebsitePageContextProvider>
259
262
  );
260
263
  }
@@ -0,0 +1,140 @@
1
+ # saas.website.pricing-offer-structured-data
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-website`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-website`
10
+
11
+ ```typescript
12
+ *
13
+ * `buildWebsitePricingOfferStructuredData` — the `AggregateOffer` a pricing page publishes, DERIVED from
14
+ * the application's public pricing catalogue (#1835) instead of typed by hand beside it.
15
+ *
16
+ * ## What it publishes, and what it refuses to
17
+ *
18
+ * A search engine shows an offer's `price` as the price of the offer, so an offer is published only
19
+ * when that is TRUE:
20
+ *
21
+ * - the plan is on sale (`availability: AVAILABLE`) — an upcoming plan cannot be bought;
22
+ * - its price is `LISTED` — a starting price is a floor, and an on-request plan has no price;
23
+ * - its published price states the whole offer for its unit: a flat or per-unit amount, never an
24
+ * indicative amount of a tiered, graduated or package price.
25
+ *
26
+ * Each published offer uses the plan's DEFAULT price (the one the catalogue marks) and carries a
27
+ * `UnitPriceSpecification` saying what the number is FOR: its recurrence as `billingDuration` (ISO 8601
28
+ * `P1M` / `P1Y`) and, for a per-unit price, a `referenceQuantity` of one of the page's unit (`member`)
29
+ * — so "$4 per member per month" is never read as "$4".
30
+ *
31
+ * One `AggregateOffer` per (currency, amount basis, recurrence): a range is only meaningful over prices
32
+ * that measure the same thing, so a flat price and a per-member price, or a monthly and a yearly one, are
33
+ * never folded into one `lowPrice` / `highPrice`. EVERY group's `@id` is `aggregateOfferIdPrefix` suffixed with
34
+ * what distinguishes it (`-per-unit-1-month-usd`), so an aggregate's identity depends only on what it
35
+ * aggregates: adding, removing or reordering a plan in ANOTHER group never moves it. Returns `[]` when
36
+ * nothing may be published — a page with only on-request plans publishes no price at all, which is the
37
+ * true statement.
38
+ */
39
+ export interface BuildWebsitePricingOfferStructuredDataInput {
40
+ readonly catalog: PublicPricingCatalog;
41
+ /** The `@id` of the entity the offers price — typically the page's `SoftwareApplication`. */
42
+ readonly itemOfferedId: string;
43
+ /**
44
+ * The prefix of every `AggregateOffer` `@id` (`https://…/pricing#plans`); each group appends what it
45
+ * aggregates, e.g. `#plans-flat-1-month-usd`.
46
+ */
47
+ readonly aggregateOfferIdPrefix: string;
48
+ /** The URL of the page the offers are made on; each offer's URL is this plus `#plan-<key>`. */
49
+ readonly url: string;
50
+ /**
51
+ * The plan's name in the page's locale. Names are text a person reads, so they come from the page's
52
+ * label pack; a plan the callback does not name is published without one rather than with its key.
53
+ */
54
+ readonly planName?: (planKey: string) => string | undefined;
55
+ /**
56
+ * What ONE unit of a per-unit price is, in the page's locale (`member`, `seat`) — published as the
57
+ * offer's `referenceQuantity.unitText`. Required when any published offer is per-unit: omitting it
58
+ * would state a per-member price as a whole price, so the builder refuses instead.
59
+ */
60
+ readonly perUnitName?: string;
61
+ }
62
+
63
+ export function buildWebsitePricingOfferStructuredData(input: BuildWebsitePricingOfferStructuredDataInput): readonly WebsiteStructuredDataPayload[] {
64
+ const published = input.catalog.plans.flatMap((plan) => {
65
+ const price = publishablePrice(plan);
66
+ return price === undefined ? [] : [{ plan, price }];
67
+ });
68
+ if (published.some(({ price }) => price.amountBasis === PublicPricingAmountBasis.PER_UNIT) && !input.perUnitName) {
69
+ throw new Error(
70
+ '[buildWebsitePricingOfferStructuredData] a published plan is priced per unit, so the page must name the unit '
71
+ + '(`perUnitName`, e.g. "member"); without it the offer would state a per-unit price as the whole price.',
72
+ );
73
+ }
74
+ const groupKeyOf = (price: PublicPricingPrice): string =>
75
+ `${price.currency}|${price.amountBasis}|${price.recurrence.unit}|${price.recurrence.count}`;
76
+ const groupKeys = [...new Set(published.map(({ price }) => groupKeyOf(price)))];
77
+ return groupKeys.map((groupKey) => {
78
+ const offers = published.filter(({ price }) => groupKeyOf(price) === groupKey);
79
+ const sample = offers[0]!.price;
80
+ const amounts = offers.map(({ price }) => publicPricingAmountDecimal(price));
81
+ const numeric = amounts.map(Number);
82
+ return {
83
+ '@type': 'AggregateOffer',
84
+ '@id': `${input.aggregateOfferIdPrefix}-${aggregateSuffix(sample)}`,
85
+ itemOffered: { '@id': input.itemOfferedId },
86
+ priceCurrency: sample.currency,
87
+ lowPrice: amounts[numeric.indexOf(Math.min(...numeric))],
88
+ highPrice: amounts[numeric.indexOf(Math.max(...numeric))],
89
+ offerCount: offers.length,
90
+ url: input.url,
91
+ offers: offers.map(({ plan, price }) => {
92
+ const name = input.planName?.(plan.key);
93
+ const amount = publicPricingAmountDecimal(price);
94
+ return {
95
+ '@type': 'Offer',
96
+ ...(name === undefined ? {} : { name }),
97
+ price: amount,
98
+ priceCurrency: price.currency,
99
+ availability: 'https://schema.org/InStock',
100
+ url: `${input.url}#plan-${plan.key}`,
101
+ priceSpecification: {
102
+ '@type': 'UnitPriceSpecification',
103
+ price: amount,
104
+ priceCurrency: price.currency,
105
+ ...(price.recurrence.unit === PublicPricingRecurrenceUnit.ONE_TIME ? {} : { billingDuration: isoDurationOf(price) }),
106
+ ...(price.amountBasis === PublicPricingAmountBasis.PER_UNIT
107
+ ? { referenceQuantity: { '@type': 'QuantitativeValue', value: 1, unitText: input.perUnitName } }
108
+ : {}),
109
+ },
110
+ };
111
+ }),
112
+ };
113
+ });
114
+ }
115
+
116
+ /** What distinguishes an aggregate's `@id`: its basis, its recurrence and its currency — exactly its group key. */
117
+ function aggregateSuffix(price: PublicPricingPrice): string {
118
+ return `${price.amountBasis}-${price.recurrence.count}-${price.recurrence.unit}-${price.currency}`.toLowerCase().replace(/_/gu, '-');
119
+ }
120
+
121
+ /** The plan's default price, when publishing it as the offer's price would be true. */
122
+ function publishablePrice(plan: PublicPricingPlan): PublicPricingPrice | undefined {
123
+ if (plan.availability !== ProductAvailability.AVAILABLE) return undefined;
124
+ if (plan.priceDisclosure !== ProductPriceDisclosure.LISTED) return undefined;
125
+ const price = plan.prices.find((candidate) => candidate.isDefault) ?? plan.prices[0];
126
+ if (price === undefined || price.amountBasis === PublicPricingAmountBasis.VARIABLE) return undefined;
127
+ return price;
128
+ }
129
+
130
+ /** Total over the recurring units: a member added to the vocabulary is a compile error here until it is mapped. */
131
+ const ISO_DURATION_DESIGNATOR: Record<Exclude<PublicPricingRecurrenceUnit, PublicPricingRecurrenceUnit.ONE_TIME>, string> = {
132
+ [PublicPricingRecurrenceUnit.MONTH]: 'M',
133
+ [PublicPricingRecurrenceUnit.YEAR]: 'Y',
134
+ };
135
+
136
+ function isoDurationOf(price: PublicPricingPrice): string {
137
+ const unit = price.recurrence.unit as Exclude<PublicPricingRecurrenceUnit, PublicPricingRecurrenceUnit.ONE_TIME>;
138
+ return `P${price.recurrence.count}${ISO_DURATION_DESIGNATOR[unit]}`;
139
+ }
140
+ ```