@wildo-ai/framework-knowledge 1.1.5 → 1.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (837) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
  3. package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
  4. package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
  5. package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
  6. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
  7. package/dist/{knowledge/skills/journey-run/references/framework-playbook-approval-policy.md → claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md} +10 -8
  8. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
  9. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
  10. package/dist/{knowledge/skills/journey-run → claude-marketplace/plugins/wildo}/references/expert-personas-and-deliberations.md +8 -8
  11. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
  12. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
  13. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
  14. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
  15. package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
  16. package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
  17. package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
  18. package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
  19. package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
  20. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
  21. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  22. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  23. package/dist/esm/framework-knowledge.definitions.js +321 -11
  24. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +0 -3
  28. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +12 -2
  30. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  31. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +33 -2
  32. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +8 -5
  34. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  35. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +55 -10
  36. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -6
  40. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
  42. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
  44. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  45. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
  46. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  47. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +0 -1
  48. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +2 -2
  50. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -4
  52. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +10 -3
  54. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +7 -3
  56. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  58. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +8 -3
  59. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +1 -1
  61. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  62. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +0 -1
  63. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  64. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +7 -3
  65. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  66. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +9 -4
  67. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  68. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +3 -2
  69. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +4 -3
  71. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  72. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +1 -1
  73. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  74. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +1 -3
  75. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  76. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
  77. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  78. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +0 -1
  79. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  80. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +10 -3
  81. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  82. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +8 -3
  83. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  84. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +12 -5
  85. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  86. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +33 -5
  87. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  88. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +1 -1
  89. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +1 -1
  90. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  91. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
  92. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
  93. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
  94. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
  95. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
  96. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
  97. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
  98. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
  99. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
  100. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
  101. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
  103. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
  104. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
  105. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
  106. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
  107. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +1 -1
  108. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  109. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +1 -1
  110. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
  111. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
  113. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  114. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +1 -1
  115. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +1 -1
  116. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  117. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +1 -1
  118. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +1 -1
  119. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +1 -1
  121. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +1 -1
  122. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  123. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +1 -1
  124. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +1 -1
  125. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +1 -1
  127. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  129. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +36 -17
  130. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  131. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +67 -17
  132. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  133. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +1 -1
  134. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +1 -1
  135. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  136. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
  137. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
  138. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
  139. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
  140. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +1 -1
  141. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  142. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +1 -1
  143. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  144. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +1 -1
  145. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  146. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  147. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +0 -1
  148. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  149. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +1 -1
  150. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +1 -1
  151. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +1 -1
  153. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +1 -1
  154. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +1 -1
  156. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +1 -1
  157. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  158. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +1 -1
  159. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +1 -1
  160. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  161. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +1 -1
  162. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  163. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +0 -1
  164. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  165. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +1 -1
  166. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  167. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -3
  168. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  169. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  170. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  171. package/dist/knowledge/manifest.json +8 -8
  172. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +0 -3
  173. package/dist/knowledge/playbooks/bottom_up.build/method.md +4 -2
  174. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +31 -7
  175. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  176. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  177. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +134 -26
  178. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +7 -4
  179. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +84 -29
  180. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -7
  181. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +12 -23
  182. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -7
  183. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +12 -14
  184. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -2
  185. package/dist/knowledge/playbooks/bottom_up.conception/method.md +20 -2
  186. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +15 -7
  187. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +8 -6
  188. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +11 -4
  189. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +2 -4
  190. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +3 -4
  191. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +18 -2
  192. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +1 -2
  193. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +2 -4
  194. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +8 -5
  195. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +16 -2
  196. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +3 -3
  197. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +1 -3
  198. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +1 -2
  199. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +8 -7
  200. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +11 -4
  201. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +27 -5
  202. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +1 -4
  203. package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
  204. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
  205. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
  206. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
  207. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +112 -21
  208. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
  209. package/dist/knowledge/playbooks/refinement.document-facts/method.md +7 -2
  210. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -4
  211. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
  212. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
  213. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +6 -0
  214. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
  215. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +0 -4
  216. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +1 -2
  217. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +1 -3
  218. package/dist/knowledge/playbooks/top_down.capability-map/method.md +2 -4
  219. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -2
  220. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +1 -3
  221. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +5 -3
  222. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +2 -4
  223. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +1 -3
  224. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +0 -4
  225. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +2 -4
  226. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -3
  227. package/dist/knowledge/playbooks/top_down.definition/method.md +7 -4
  228. package/dist/knowledge/playbooks/top_down.definition/playbook.json +52 -7
  229. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +1 -1
  230. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +2 -4
  231. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
  232. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
  233. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +0 -1
  234. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +0 -1
  235. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +0 -1
  236. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +2 -4
  237. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -2
  238. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +1 -1
  239. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +2 -6
  240. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +17 -1
  241. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +2 -5
  242. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -3
  243. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +15 -7
  244. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +2 -4
  245. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +2 -4
  246. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +1 -2
  247. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
  248. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +12 -5
  249. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
  250. package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
  251. package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
  252. package/dist/knowledge/references/build-plan.task-graph.config.md +71 -6
  253. package/dist/knowledge/references/capability-composition.config.md +20 -1
  254. package/dist/knowledge/references/cli.market.generate-command.md +18 -2
  255. package/dist/knowledge/references/engine.client-bundle.allow-list.md +7 -22
  256. package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
  257. package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
  258. package/dist/knowledge/references/example.backend.addon-wiring.module.md +5 -0
  259. package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
  260. package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
  261. package/dist/knowledge/references/example.config.app-shell.full.md +11 -0
  262. package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
  263. package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
  264. package/dist/knowledge/references/example.config.backend.required-floors.md +7 -0
  265. package/dist/knowledge/references/example.config.navigation.full.md +45 -2
  266. package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
  267. package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
  268. package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
  269. package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
  270. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
  271. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +26 -3
  272. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +1 -1
  273. package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
  274. package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
  275. package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
  276. package/dist/knowledge/references/example.infra.environment-config.local.md +14 -30
  277. package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
  278. package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
  279. package/dist/knowledge/references/example.module.companion-exports.full.md +8 -13
  280. package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
  281. package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
  282. package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
  283. package/dist/knowledge/references/example.provider.backend-module-shape.md +3 -0
  284. package/dist/knowledge/references/example.provider.frontend-app.module.md +9 -0
  285. package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
  286. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +14 -13
  287. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +18 -0
  288. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +11 -11
  289. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +5 -0
  290. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +2 -0
  291. package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
  292. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
  293. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +24 -6
  294. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +36 -25
  295. package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
  296. package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
  297. package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
  298. package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
  299. package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
  300. package/dist/knowledge/references/example.website.page.manifest.md +30 -0
  301. package/dist/knowledge/references/experience-plan.config.md +11 -4
  302. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +20 -0
  303. package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
  304. package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
  305. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
  306. package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
  307. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
  308. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
  309. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
  310. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +21 -0
  311. package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
  312. package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
  313. package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
  314. package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
  315. package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
  316. package/dist/knowledge/references/integration-plan.config.md +34 -2
  317. package/dist/knowledge/references/market.alternative.config.md +1 -1
  318. package/dist/knowledge/references/market.buying-journey.config.md +1 -1
  319. package/dist/knowledge/references/market.category.config.md +1 -1
  320. package/dist/knowledge/references/market.channel.config.md +1 -1
  321. package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
  322. package/dist/knowledge/references/market.gain.config.md +1 -1
  323. package/dist/knowledge/references/market.icp.config.md +1 -1
  324. package/dist/knowledge/references/market.job.config.md +1 -1
  325. package/dist/knowledge/references/market.message-template.config.md +1 -1
  326. package/dist/knowledge/references/market.objection.config.md +1 -1
  327. package/dist/knowledge/references/market.pain.config.md +1 -1
  328. package/dist/knowledge/references/market.persona.config.md +1 -1
  329. package/dist/knowledge/references/market.positioning.config.md +1 -1
  330. package/dist/knowledge/references/market.proof.config.md +1 -1
  331. package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
  332. package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
  333. package/dist/knowledge/references/market.trigger.config.md +1 -1
  334. package/dist/knowledge/references/placement-plan.config.md +7 -1
  335. package/dist/knowledge/references/platform.config.backing-services.md +15 -15
  336. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +57 -57
  337. package/dist/knowledge/references/presets.3d.focal-plane-settings.md +45 -0
  338. package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
  339. package/dist/knowledge/references/presets.3d.layout-contract.md +235 -0
  340. package/dist/knowledge/references/presets.3d.register-layout.md +100 -0
  341. package/dist/knowledge/references/presets.models.labelling.sections.md +5 -0
  342. package/dist/knowledge/references/presets.models.shell-region.md +47 -0
  343. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
  344. package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
  345. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  346. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +7 -6
  347. package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
  348. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +7 -0
  349. package/dist/knowledge/references/saas.backend.domain-module.md +93 -15
  350. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
  351. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
  352. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +200 -0
  353. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +2 -0
  354. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
  355. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +33 -9
  356. package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
  357. package/dist/knowledge/references/saas.backend.system-access-service.md +98 -0
  358. package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
  359. package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
  360. package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
  361. package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
  362. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
  363. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +2 -2
  364. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +253 -0
  365. package/dist/knowledge/references/saas.frontend.billing-context.md +25 -2
  366. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
  367. package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
  368. package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
  369. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
  370. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +7 -5
  371. package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
  372. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +17 -2
  373. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
  374. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
  375. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +9 -0
  376. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +100 -5
  377. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
  378. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +61 -0
  379. package/dist/knowledge/references/saas.market.generation-agent.md +0 -1
  380. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
  381. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
  382. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
  383. package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
  384. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
  385. package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
  386. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
  387. package/dist/knowledge/references/saas.models.audit.trail-config.md +15 -9
  388. package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
  389. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +8 -0
  390. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +54 -1
  391. package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
  392. package/dist/knowledge/references/saas.models.config.organization-types.md +74 -0
  393. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +31 -14
  394. package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
  395. package/dist/knowledge/references/saas.models.data-mode-read-list.md +4 -4
  396. package/dist/knowledge/references/saas.models.engine-capabilities.md +12 -0
  397. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +5 -1
  398. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
  399. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
  400. package/dist/knowledge/references/saas.models.external-data-pipeline.md +667 -6
  401. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
  402. package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
  403. package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
  404. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
  405. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
  406. package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
  407. package/dist/knowledge/references/saas.models.http-api-binding.md +812 -29
  408. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
  409. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
  410. package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
  411. package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
  412. package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
  413. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
  414. package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
  415. package/dist/knowledge/references/saas.models.navigation.layout.md +11 -7
  416. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +32 -23
  417. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +8 -4
  418. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +22 -20
  419. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +14 -0
  420. package/dist/knowledge/references/saas.models.notifications.targets.md +20 -12
  421. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +61 -34
  422. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +9 -0
  423. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
  424. package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
  425. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
  426. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
  427. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
  428. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
  429. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
  430. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
  431. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
  432. package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
  433. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
  434. package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
  435. package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
  436. package/dist/knowledge/references/saas.models.provider-capabilities.md +34 -0
  437. package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
  438. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
  439. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +61 -0
  440. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +98 -13
  441. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
  442. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -28
  443. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
  444. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +6 -0
  445. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +8 -0
  446. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
  447. package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
  448. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
  449. package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
  450. package/dist/knowledge/references/saas.models.systems-of-record.md +242 -7
  451. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
  452. package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
  453. package/dist/knowledge/references/saas.public-runtime.contract.md +75 -7
  454. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +20 -0
  455. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +106 -13
  456. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
  457. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
  458. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
  459. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
  460. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
  461. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +6 -4
  462. package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
  463. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +14 -2
  464. package/dist/knowledge/references/saas.specifications.processor-register.md +77 -0
  465. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
  466. package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
  467. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +112 -45
  468. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +13 -1
  469. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
  470. package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
  471. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
  472. package/dist/knowledge/references/saas.website.astro.bridge.md +32 -9
  473. package/dist/knowledge/references/saas.website.astro.head-renderer.md +1 -1
  474. package/dist/knowledge/references/saas.website.astro.label-loader.md +7 -4
  475. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +15 -15
  476. package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
  477. package/dist/knowledge/references/saas.website.blog.bridge.md +17 -4
  478. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
  479. package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
  480. package/dist/knowledge/references/saas.website.consent.banner.md +10 -10
  481. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
  482. package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
  483. package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
  484. package/dist/knowledge/references/saas.website.page-layout.component.md +5 -2
  485. package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
  486. package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
  487. package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
  488. package/dist/knowledge/references/saas.website.runtime.context.md +23 -4
  489. package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
  490. package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
  491. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
  492. package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
  493. package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
  494. package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
  495. package/dist/knowledge/references/website-plan.config.md +39 -6
  496. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +2 -1
  497. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +21 -0
  498. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +1 -2
  499. package/dist/knowledge/references/zod.decorators.file-schema.md +11 -10
  500. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +7 -4
  501. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +8 -2
  502. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +5 -1
  503. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +5 -1
  504. package/dist/knowledge/references/zod.factories.address.md +7 -7
  505. package/dist/knowledge/references/zod.factories.code.md +2 -2
  506. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  507. package/dist/knowledge/references/zod.factories.money.md +3 -3
  508. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  509. package/dist/knowledge/registries/framework-topics.json +1248 -54
  510. package/dist/knowledge/registries/playbooks.json +81 -109
  511. package/dist/knowledge/registries/source-tags.json +3201 -1118
  512. package/dist/knowledge/rules/live-context-door.md +29 -0
  513. package/dist/knowledge/skills/INDEX.md +27 -24
  514. package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
  515. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
  516. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
  517. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
  518. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
  519. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
  520. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
  521. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
  522. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
  523. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +31 -0
  524. package/dist/knowledge/skills/application-database-migrations/SKILL.md +1 -0
  525. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +1 -0
  526. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +9 -0
  527. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  528. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +94 -16
  529. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +21 -8
  530. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +7 -0
  531. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +13 -5
  532. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +30 -6
  533. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +160 -32
  534. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +20 -0
  535. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +14 -2
  536. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +88 -0
  537. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +112 -14
  538. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
  539. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
  540. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
  541. package/dist/knowledge/skills/config-app-shell/SKILL.md +21 -0
  542. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +2 -2
  543. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +279 -0
  544. package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
  545. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -0
  546. package/dist/knowledge/skills/config-navigation/SKILL.md +114 -16
  547. package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
  548. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +11 -7
  549. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +29 -5
  550. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +40 -27
  551. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +22 -20
  552. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +112 -5
  553. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +10 -10
  554. package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
  555. package/dist/knowledge/skills/config-saas/SKILL.md +3 -1
  556. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +7 -0
  557. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +21 -11
  558. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +5 -1
  559. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +59 -9
  560. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +46 -0
  561. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +251 -12
  562. package/dist/knowledge/skills/config-saas-backend/SKILL.md +8 -0
  563. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +81 -0
  564. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +37 -15
  565. package/dist/knowledge/skills/configure-billing/SKILL.md +64 -24
  566. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +35 -2
  567. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +14 -0
  568. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +3 -0
  569. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +25 -2
  570. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +73 -1
  571. package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
  572. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +27 -12
  573. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +11 -2
  574. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +26 -2
  575. package/dist/knowledge/skills/email-add-template/SKILL.md +61 -24
  576. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +5 -2
  577. package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
  578. package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
  579. package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
  580. package/dist/knowledge/skills/engine-component-registration/SKILL.md +1 -0
  581. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +6 -0
  582. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +27 -3
  583. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
  584. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
  585. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
  586. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
  587. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
  588. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +31 -4
  589. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +26 -3
  590. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
  591. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
  592. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +202 -0
  593. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +93 -15
  594. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +96 -11
  595. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +2 -1
  596. package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
  597. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -0
  598. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -2
  599. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +14 -9
  600. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +1 -0
  601. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +1 -0
  602. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +5 -0
  603. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
  604. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +5 -0
  605. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +8 -1
  606. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +5 -0
  607. package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
  608. package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
  609. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
  610. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
  611. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
  612. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
  613. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
  614. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
  615. package/dist/knowledge/skills/infra-environment-config/SKILL.md +150 -44
  616. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +83 -74
  617. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +180 -0
  618. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +53 -0
  619. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
  620. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +245 -0
  621. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +108 -0
  622. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +259 -0
  623. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
  624. package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +43 -0
  625. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
  626. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +32 -1
  627. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
  628. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +36 -4
  629. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +2 -1
  630. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
  631. package/dist/knowledge/skills/market-alternatives/SKILL.md +3 -2
  632. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
  633. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
  634. package/dist/knowledge/skills/market-category/SKILL.md +2 -1
  635. package/dist/knowledge/skills/market-channels/SKILL.md +2 -1
  636. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +7 -4
  637. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +6 -4
  638. package/dist/knowledge/skills/market-generation-cli/SKILL.md +28 -13
  639. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +18 -3
  640. package/dist/knowledge/skills/market-icp/SKILL.md +2 -1
  641. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +4 -3
  642. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -1
  643. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
  644. package/dist/knowledge/skills/market-persona/SKILL.md +2 -1
  645. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
  646. package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
  647. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +3 -2
  648. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
  649. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1 -0
  650. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +2 -1
  651. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +3 -2
  652. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +1 -0
  653. package/dist/knowledge/skills/minion-authoring/SKILL.md +5 -1
  654. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
  655. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
  656. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
  657. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
  658. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
  659. package/dist/knowledge/skills/module-companion-exports/SKILL.md +17 -16
  660. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +6 -4
  661. package/dist/knowledge/skills/module-registration/SKILL.md +2 -1
  662. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +93 -15
  663. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +86 -1
  664. package/dist/knowledge/skills/module-relationships/SKILL.md +3 -2
  665. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
  666. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
  667. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
  668. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
  669. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
  670. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
  671. package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
  672. package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -33
  673. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
  674. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
  675. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
  676. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
  677. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
  678. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
  679. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +132 -23
  680. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
  681. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +29 -0
  682. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
  683. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
  684. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
  685. package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
  686. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
  687. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +75 -24
  688. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +3 -3
  689. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +61 -0
  690. package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
  691. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +17 -2
  692. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +15 -0
  693. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
  694. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +25 -0
  695. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +6 -0
  696. package/dist/knowledge/skills/resource-add-field/SKILL.md +1 -0
  697. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
  698. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +105 -6
  699. package/dist/knowledge/skills/resource-add-module/SKILL.md +1 -0
  700. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +2 -1
  701. package/dist/knowledge/skills/resource-add-resource/SKILL.md +3 -0
  702. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +124 -30
  703. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +1 -0
  704. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +8 -0
  705. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +9 -0
  706. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +17 -1
  707. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +124 -30
  708. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +7 -6
  709. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +142 -34
  710. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +98 -0
  711. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +86 -52
  712. package/dist/knowledge/skills/resource-custom-view/SKILL.md +1 -0
  713. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +100 -5
  714. package/dist/knowledge/skills/resource-external-data/SKILL.md +1026 -28
  715. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
  716. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
  717. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
  718. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +686 -11
  719. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +904 -31
  720. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +166 -6
  721. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
  722. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
  723. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
  724. package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
  725. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
  726. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
  727. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
  728. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
  729. package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
  730. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
  731. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +1 -0
  732. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +1 -0
  733. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +12 -0
  734. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
  735. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
  736. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
  737. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
  738. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
  739. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
  740. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
  741. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +2 -2
  742. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
  743. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
  744. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +2 -1
  745. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +28 -0
  746. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +5 -1
  747. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +34 -30
  748. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +5 -1
  749. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +101 -42
  750. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +21 -0
  751. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +1 -2
  752. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +125 -6
  753. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +8 -2
  754. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
  755. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +61 -1
  756. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +110 -9
  757. package/dist/knowledge/skills/seeding-authoring/SKILL.md +1 -0
  758. package/dist/knowledge/skills/seeding-operations/SKILL.md +1 -0
  759. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
  760. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
  761. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
  762. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
  763. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
  764. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
  765. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +1 -0
  766. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +61 -0
  767. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
  768. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
  769. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +14 -16
  770. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +6 -4
  771. package/dist/knowledge/skills/spec-component-update/SKILL.md +1 -0
  772. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
  773. package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
  774. package/dist/knowledge/skills/spec-feature-update/SKILL.md +1 -0
  775. package/dist/knowledge/skills/spec-resource-update/SKILL.md +13 -0
  776. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +158 -46
  777. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
  778. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
  779. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +5 -1
  780. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +1 -0
  781. package/dist/knowledge/skills/views-app-level/SKILL.md +2 -1
  782. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +43 -1
  783. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
  784. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +5 -1
  785. package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
  786. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -0
  787. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +29 -6
  788. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
  789. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +17 -4
  790. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +23 -28
  791. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +7 -22
  792. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +167 -20
  793. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
  794. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +63 -6
  795. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
  796. package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
  797. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -2
  798. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -2
  799. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +2 -1
  800. package/dist/knowledge/skills/website-page-authoring/SKILL.md +117 -33
  801. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
  802. package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
  803. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
  804. package/dist/knowledge/skills/website-section-contact/SKILL.md +65 -36
  805. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -11
  806. package/dist/knowledge/skills/website-section-cta/SKILL.md +32 -22
  807. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -11
  808. package/dist/knowledge/skills/website-section-faq/SKILL.md +99 -63
  809. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -11
  810. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +27 -18
  811. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -11
  812. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +33 -22
  813. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -11
  814. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +31 -20
  815. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -11
  816. package/dist/knowledge/skills/website-section-hero/SKILL.md +65 -44
  817. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -11
  818. package/dist/knowledge/skills/website-section-pricing/SKILL.md +217 -200
  819. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -11
  820. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
  821. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +45 -34
  822. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -11
  823. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
  824. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
  825. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +30 -25
  826. package/dist/knowledge/skills/worker-authoring/SKILL.md +1 -0
  827. package/dist/knowledge/topic-index.json +5957 -1729
  828. package/dist/tsconfig.build.tsbuildinfo +1 -1
  829. package/dist/tsconfig.tsbuildinfo +1 -1
  830. package/package.json +4 -4
  831. package/dist/knowledge/skills/journey-approve/SKILL.md +0 -63
  832. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -77
  833. package/dist/knowledge/skills/journey-next/SKILL.md +0 -82
  834. package/dist/knowledge/skills/journey-report/SKILL.md +0 -56
  835. package/dist/knowledge/skills/journey-run/SKILL.md +0 -140
  836. package/dist/knowledge/skills/journey-status/SKILL.md +0 -60
  837. /package/dist/{knowledge/skills/journey-approve → claude-marketplace/plugins/wildo}/references/specification-family-map.md +0 -0
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: website-section-pricing
3
- description: Author a Pricing section using `defineWebsiteSection({ category: WebsiteSectionCategory.PRICING, … })` with first-class `Product` + `Offer` (or `AggregateOffer`) JSON-LD. Use when the user says "add a pricing section", "compose pricing tiers", "wire pricing JSON-LD for SEO", or "customize the pricing comparison layout".
3
+ description: Author a Pricing section that renders the application's billing catalogue — never a copy of its prices — with `defineWebsiteSection({ category: WebsiteSectionCategory.PRICING, … })`, `useWebsitePricingCatalog()`, and `Offer` / `AggregateOffer` JSON-LD derived from the same catalogue. Use when the user says "add a pricing section", "compose pricing tiers", "wire pricing JSON-LD for SEO", or "customize the pricing comparison layout".
4
+ user-invocable: false
4
5
  ---
5
6
 
6
7
  # Website Section: Pricing
@@ -102,7 +103,8 @@ export const WebsiteSectionCategorySchema: z.ZodEnum<typeof WebsiteSectionCatego
102
103
  ## Section definition (the contract `defineWebsiteSection` produces)
103
104
 
104
105
  The schema declares the **observable contract** the page-manifest
105
- registration, label-pack validator, and SEO dispatcher depend on. The
106
+ registration, the label-pack validator, `renderPageStructuredData` and
107
+ the structured-data audit depend on. The
106
108
  factory layer adds type-preserving generics on top so JSX usage keeps
107
109
  compile-time prop checking.
108
110
 
@@ -121,7 +123,8 @@ compile-time prop checking.
121
123
  * `core/define-website-section.tsx` module in Phase 2 because it carries
122
124
  * React types in its inputs). The shape is declared in `schemas/`
123
125
  * because it is the **observable contract** the page-manifest
124
- * registration, label-pack validator, and SEO dispatcher depend on.
126
+ * registration, the label-pack validator, `renderPageStructuredData` and the
127
+ * structured-data audit depend on.
125
128
  *
126
129
  * **Shape rationale** (each field carries semantic weight — see
127
130
  * `design-philosophy.mdc`):
@@ -131,7 +134,8 @@ compile-time prop checking.
131
134
  * (a section can be reused with the same `sectionRef` across pages
132
135
  * when its label-key root is intentionally shared).
133
136
  * - `category` — see `WebsiteSectionCategory` JSDoc; tags the section
134
- * for SEO-dispatch, skill-mapping, and analytics labelling.
137
+ * for skill-mapping and analytics labelling. It does NOT select the
138
+ * section's structured data.
135
139
  * - `expectedLabelKeys` — the **fully-composed** label keys the section
136
140
  * commits to consuming. The plan originally proposed leaf-relative
137
141
  * keys (`'headline'`) resolved at runtime against the
@@ -144,9 +148,13 @@ compile-time prop checking.
144
148
  * graph — `wildo website audit` can list a page's required keys
145
149
  * without booting React.
146
150
  * 3. The leaf-relative ergonomics (`useWebsiteLabel('headline')`)
147
- * survive in Phase 2 — the hook composes the leaf with the
148
- * page+section context and validates the result against
149
- * `expectedLabelKeys`.
151
+ * survive — the hook composes the leaf with the page+section
152
+ * context and looks the result up in the active pack. It does
153
+ * NOT check the key against `expectedLabelKeys`: a leaf the
154
+ * section never declared renders its key (with a console warning)
155
+ * and is caught by nothing until a reviewer reads the page. The
156
+ * build and `wildo website audit` check the pack against the
157
+ * DECLARED keys, so declare every slot the component reads.
150
158
  * - `Component` — the React component that renders the section. Typed
151
159
  * as `ComponentType<unknown>` here because schema-layer cannot lock
152
160
  * the component's prop shape (props vary per section). The factory
@@ -156,8 +164,9 @@ compile-time prop checking.
156
164
  * - `getStructuredData?` — optional pure function the SEO/AEO/GEO
157
165
  * builder library invokes at static-build time to materialize JSON-LD
158
166
  * for the section. The return type is intentionally `unknown` here;
159
- * the SEO library narrows by `category` (e.g. `PRICING` →
160
- * `Product | AggregateOffer`).
167
+ * nothing narrows it by `category` — the section returns whatever
168
+ * vocabulary it emits, and `wildo website audit` reconciles that
169
+ * against the application's Schema.org catalog.
161
170
  *
162
171
  * **Why not `z.custom<ComponentType>(…)`**: a `z.custom` predicate
163
172
  * cannot meaningfully validate "is a React component" beyond
@@ -304,9 +313,9 @@ export interface TypedWebsiteSectionDefinition<TProps>
304
313
  * **Why a factory instead of constructing the literal directly**:
305
314
  * - Consumers don't have to remember to parse refs / keys
306
315
  * themselves before assembling the literal.
307
- * - The schema parse provides a single audited validation chokepoint
308
- * so `wildo website audit` (Phase 7) can re-validate definitions
309
- * without re-entering the React graph.
316
+ * - The schema parse provides a single audited validation chokepoint,
317
+ * and the parsed `expectedLabelKeys` are what `wildo website audit`
318
+ * checks every locale pack against, without re-entering the React graph.
310
319
  * - The factory is the documented authoring API the
311
320
  * `website_factory_authoring` skill targets — keeping the
312
321
  * authoring surface narrow lets the framework evolve the
@@ -598,7 +607,7 @@ WebsiteSection.displayName = 'WebsiteSection';
598
607
  > **Framework rule**: the installed `@wildo-ai/saas-website` package ships **no concrete
599
608
  > Pricing component**. This skill documents the
600
609
  > `defineWebsiteSection<TProps>` authoring pattern with first-class
601
- > `Product` + `Offer` JSON-LD emission via `getStructuredData()`.
610
+ > `SoftwareApplication` (or `Product`) + `Offer` JSON-LD emission via `getStructuredData()`.
602
611
 
603
612
  ## Overview
604
613
 
@@ -607,89 +616,118 @@ tier carries a name, a price expression, a pitch line, a bullet list
607
616
  of included capabilities, and a CTA (sign up, contact sales, etc.).
608
617
 
609
618
  The pricing section is one of the few categories where **structured
610
- data emission is mandatory in practice**: emitting `Product` + `Offer`
619
+ data emission is mandatory in practice**: emitting `SoftwareApplication` + `Offer`
611
620
  (or `AggregateOffer` when the tier is a price range) materially
612
621
  improves SERP rendering AND lets answer-engine LLMs cite pricing
613
622
  without hallucinating.
614
623
 
615
- The category drives:
624
+ What the category does — and, for structured data, does not — decide:
616
625
 
617
- 1. **SEO/AEO/GEO dispatch** — `category: PRICING` allows `Product`,
618
- `Offer`, `AggregateOffer`. Other vocabularies are rejected.
626
+ 1. **SEO/AEO/GEO** — a pricing section emits the product and its
627
+ plans: `SoftwareApplication` (the application itself — the usual
628
+ case) or `Product` (a discrete good), with `Offer` per plan or one
629
+ `AggregateOffer`. Nothing enforces this pairing — the structured-data audit checks each payload against the Schema.org catalog, never against the section's category.
619
630
  2. **Skill mapping** — 1:1 with `WebsiteSectionCategory.PRICING`.
620
631
  3. **Analytics labelling** — `data-section-category="pricing"` is the
621
632
  funnel-step grouping for tier-impression tracking.
622
633
 
634
+ ## Where the prices come from
635
+
636
+ **The website never types a price.** The plans, their prices, which one is recommended, how much of
637
+ each price may be stated, and which are announced but not yet on sale all come from the application's
638
+ **billing catalogue** — the `ProductDefinition[]` its shared modules declare, the same array the backend
639
+ syncs to the billing provider (see `configure-billing`). The page reads it at build time and the
640
+ section renders from it. A price written a second time in the website is a price that will disagree
641
+ with the one the application charges.
642
+
643
+ If the catalogue is empty or does not yet state what the page must say (a plan to recommend, a price
644
+ that is only a starting price, a plan quoted on request, a plan not on sale yet), **fix the catalogue
645
+ first** — those are `isRecommended`, `priceDisclosure` and `availability` on the product definition —
646
+ and never compensate in the website.
647
+
623
648
  ## App Paths
624
649
 
625
650
  | Surface | Glob (relative to app root) |
626
651
  |---|---|
627
- | Section component + factory call | `website/src/sections/pricing.section.tsx` |
652
+ | The billing catalogue (the prices) | `shared-lib/src/engine/product.ts` — or wherever the shared modules declare `productDefinitions` |
653
+ | Section component + factory call, and its entry in the page's `<PAGE>_SECTIONS` list | `website/src/sections/<page>.sections.tsx` (one file per page, holding all its sections) |
628
654
  | Page composition | `website/src/pages-impl/pricing.page.tsx` |
655
+ | The route: loads the catalogue, passes it to the island, renders the offers | `website/src/pages/pricing.astro` |
656
+ | Structured data the audit reads | `website/src/structured-data/page-payloads.ts` |
629
657
  | Label pack (per locale) | `website/src/i18n/<locale>.json` |
630
- | Tier configuration (currency-aware, locale-neutral) | `website/src/sections/pricing.config.ts` |
631
658
 
632
659
  ## When to Use
633
660
 
634
- - Surfacing comparable plan tiers with a primary "buy" / "start"
635
- action per tier.
636
- - Pricing is locale-stable (currency may differ; copy is per-locale).
637
- - Search engines should index the price points (yes — almost always
638
- the right answer for SaaS).
661
+ - Surfacing the application's plans with a primary "start" / "buy" action per plan.
662
+ - Search engines should index the price points (yes — almost always the right answer for SaaS).
639
663
 
640
664
  ## When NOT to Use
641
665
 
642
- - Pricing requires a sales conversation (no published tiers) → use a
643
- CTA section pointing at `book-demo` instead.
644
- - Single price (no tiers) → still use this section but with a
645
- one-tier configuration; the JSON-LD becomes a single `Offer` rather
646
- than `AggregateOffer`.
666
+ - The application has no billing catalogue and sells through a sales conversation only → a CTA
667
+ section pointing at the contact page. (A catalogue whose plans are all `ON_REQUEST` still belongs
668
+ here: the section lists them without prices, and the page publishes no price at all.)
647
669
 
648
670
  ## Workflow
649
671
 
650
- ### Step 1: Author the locale-neutral tier configuration
651
-
652
- Tier names, currencies, and bullet identifiers are stable across
653
- locales; only the human-readable copy varies. Keep the configuration
654
- in a typed module (`pricing.config.ts`) and reference label keys for
655
- the copy.
672
+ ### Step 1: Confirm the catalogue says what the page will say
656
673
 
657
- ### Step 2: Author the component
674
+ Read the application's product definitions. Each public PLAN becomes one tier, in `sortOrder`. Check
675
+ the three pricing-surface facts against what the page must state, and edit the catalogue if they are
676
+ wrong. Never keep a list of exceptions in the website.
658
677
 
659
- Render the tiers as a grid (or table for >3 tiers). Read all copy
660
- through `useWebsiteLabel('<leaf>')`; read structured numbers
661
- (currency, amount) from the typed configuration.
678
+ ### Step 2: Load the catalogue in the route
662
679
 
663
- ### Step 3: Implement `getStructuredData`
680
+ In `website/src/pages/pricing.astro` frontmatter, `await loadWebsitePricingCatalog()` (from
681
+ `@wildo-ai/saas-website/config-loader`; pass `targetScope` when the catalogue sells to more than one
682
+ audience) and pass the result to the bridge island as `pricingCatalog={pricingCatalog}`. The loader
683
+ reads the catalogue from source, so it is current on every build.
664
684
 
665
- Return a `Product` with one `Offer` per tier (or `AggregateOffer`
666
- with `lowPrice` / `highPrice` when more useful). The function is
667
- pure and runs at static-build time — no React hooks inside.
685
+ ### Step 3: Author the component
668
686
 
669
- ### Step 4: Compose into the pricing page
687
+ Read the plans with `useWebsitePricingCatalog()`. Name each plan and its copy through labels keyed by
688
+ the plan's catalogue `key` (`plan-<key>.name`, `.pitch`, `.cta`); format each amount with
689
+ `publicPricingAmountDecimal(price)` and the page locale. Per plan:
670
690
 
671
- Typically the only major section on `/pricing`, often paired with an
672
- FAQ section below it.
673
-
674
- **Stop** after the pricing tiers render and `Product` / `Offer`
675
- JSON-LD validates in Google's Rich Results test; if the
676
- structured-data builder warns about missing `priceCurrency` or
677
- `price`, **return to Step 3** — `getStructuredData()` must mirror
678
- the visible per-tier price shape verbatim (the structured-data
679
- audit catches divergence before AEO ingest).
691
+ | Catalogue fact | What the tile does |
692
+ |---|---|
693
+ | `isRecommended` | Emphasis, and a label that says RECOMMENDED — never "most popular", which nothing measured |
694
+ | `priceDisclosure: STARTING_AT` | The price reads as a starting price ("From …") |
695
+ | `priceDisclosure: ON_REQUEST` | No price; the action leads to the contact page |
696
+ | `availability: UPCOMING` | Listed, with a "coming soon" state instead of a sign-up action |
697
+ | `amountBasis: PER_UNIT` | "per member" (or the application's unit noun) after the amount |
698
+ | `recurrence` | "per month" / "per year" / nothing for a one-time price |
699
+
700
+ ### Step 4: Publish the offers
701
+
702
+ Build the page's `AggregateOffer` with `buildWebsitePricingOfferStructuredData({ catalog, … })`: it
703
+ publishes a plan's price only when that price is TRUE — on sale, listed, and a flat or per-unit
704
+ amount — so a starting price, an on-request plan or an upcoming plan never appears in search results
705
+ as the offer. A per-unit price carries its unit (`perUnitName`, e.g. `member`, required when one is
706
+ published), and a range never mixes flat and per-unit prices or monthly and yearly ones. The unit is ONE
707
+ per page: the catalogue does not record what a per-unit price is per, so a page whose per-unit plans
708
+ charge for different things (seats and gigabytes) cannot be published truthfully by this builder. Return it from `resolveStructuredDataPagePayloadsForManifest` in
709
+ `website/src/structured-data/page-payloads.ts` (the audit reads it there) and render the same result
710
+ in the route through `renderPageStructuredData({ sections, pagePayloads })`. The section's own
711
+ `getStructuredData()` emits the `SoftwareApplication` the offers name as `itemOffered`, and no price.
712
+
713
+ **Stop** after the tiers render from the catalogue, `wildo website audit --strict` reports no
714
+ finding for the pricing page, and the built page's JSON-LD prices match the catalogue.
680
715
 
681
716
  ## Structured data (AEO)
682
717
 
683
- Pricing sections own the commercial entity graph: `Product` plus either
718
+ Pricing sections own the commercial entity graph: the product
719
+ (`SoftwareApplication`, or `Product` for a discrete good) plus either
684
720
  child `Offer` entries or one `AggregateOffer`.
685
721
 
686
722
  - **What earns its place**: a real purchasable plan surface, visible
687
- pricing, stable tier naming, and truthful currency semantics.
723
+ pricing, stable plan keys, and truthful currency semantics — all of it
724
+ derived from the billing catalogue.
688
725
  - **What is NOT in this block**: hidden sales-only tiers, promo-only
689
726
  pricing not visible on the page, or made-up ranges.
690
727
  - **Verification grep**:
691
- `rg -n "getStructuredData|priceCurrency|AggregateOffer|Offer" website/src/sections/pricing.section.tsx`
692
- (must return `>= 1` for the pricing emitter).
728
+ `rg -n "buildWebsitePricingOfferStructuredData" website/src/structured-data/page-payloads.ts`
729
+ (must return `>= 1`), and `rg -n "priceCurrency|price:" website/src/sections/<page>.sections.tsx`
730
+ (must return `0` — the section never types a price).
693
731
 
694
732
  ## Contribution to `llms.txt`
695
733
 
@@ -705,143 +743,116 @@ page entry in `website/src/content/llms.txt`.
705
743
 
706
744
  ## Worked Example
707
745
 
708
- <!-- TIER C WAIVER: This `PRICING_TIERS` config IS the locale-neutral source-of-truth Verification check #2 names ("Tier configuration lives in a separate locale-neutral module — numbers + tier refs only"); the `ref: 'starter' | 'team' | 'enterprise'` literal union IS the stable contract Common Rationalization #2 protects ("the `ref` ... is the stable contract that flows into URLs, analytics, and JSON-LD"); and the typed `amountMonthlyUSD` / `amountAnnualUSD` / `bulletCount` shape lets `getStructuredData()` build `AggregateOffer` from the same array the JSX renders. Keep it as Tier C until a stable application usage example is deliberately anchored. -->
709
- ```tsx
710
- // website/src/sections/pricing.config.ts
711
- export interface PricingTierConfig {
712
- ref: 'starter' | 'team' | 'enterprise';
713
- amountMonthlyUSD: number;
714
- amountAnnualUSD: number;
715
- bulletCount: 3 | 4 | 5;
716
- }
717
-
718
- export const PRICING_TIERS: readonly PricingTierConfig[] = [
719
- { ref: 'starter', amountMonthlyUSD: 0, amountAnnualUSD: 0, bulletCount: 3 },
720
- { ref: 'team', amountMonthlyUSD: 12, amountAnnualUSD: 120, bulletCount: 5 },
721
- { ref: 'enterprise', amountMonthlyUSD: 49, amountAnnualUSD: 490, bulletCount: 5 },
722
- ] as const;
723
- ```
724
-
725
- <!-- TIER C WAIVER: This block IS the canonical Pricing contract — the per-tier `useWebsiteLabel('tier-${ref}.name|.pitch|.cta')` leaf-relative pattern composing `expectedLabelKeys` from the same `PRICING_TIERS` array; the typed `tierHrefs` prop carrying cross-frontend handoff URLs Verification check #5 enforces; and the `getStructuredData()` `Product` + `AggregateOffer` shape with explicit `priceCurrency` that grep invariants 3+4 guard. The `useWebsiteLabel('tier-${tier.ref}.name')` template-string call is intentional here (the refs come from a `as const` literal union the TS narrows) and is the contract `name`/`pitch`/`cta` per tier compose. Keep it as Tier C until a stable application usage example is deliberately anchored. -->
746
+ <!-- TIER C WAIVER: the framework's reference application, where Tier A anchors live, does not yet render its site's pricing from the billing catalogue (#1880); the journey-built scratch application that does is not an anchorable source, so there is no stable Tier A usage yet. This block IS the catalogue-driven contract the workflow above states: the route loads the catalogue and passes it to the island, the section reads it with `useWebsitePricingCatalog()` and never types a price, and `page-payloads.ts` publishes the offers through `buildWebsitePricingOfferStructuredData`. Replace with a Tier A anchor once a dogfood site carries it. -->
726
747
  ```tsx
727
- // website/src/sections/pricing.section.tsx
728
- import {
729
- defineWebsiteSection,
730
- useWebsiteLabel,
731
- WebsiteButton,
732
- WebsiteHeading,
733
- WebsiteSectionCategory,
734
- WebsiteText,
735
- } from '@wildo-ai/saas-website';
736
- import { PRICING_TIERS } from './pricing.config';
737
-
738
- interface PricingSectionProps {
739
- /** Where each tier's CTA points (cross-frontend handoff URL). */
740
- tierHrefs: Record<'starter' | 'team' | 'enterprise', string>;
748
+ // website/src/pages/pricing.astro — frontmatter (the island receives the catalogue as a prop)
749
+ const pricingCatalog = await loadWebsitePricingCatalog();
750
+ const pagePayloads = (await resolveStructuredDataPagePayloadsForManifest(PRICING_PAGE_MANIFEST))
751
+ .flatMap((entry) => entry.payloads);
752
+ const structuredDataHtml = renderPageStructuredData({ sections: PRICING_SECTIONS, pagePayloads });
753
+ // …and in the body: <PricingBridgeIsland client:idle pricingCatalog={pricingCatalog} … />
754
+
755
+ // website/src/structured-data/page-payloads.ts — what `wildo website audit` reads
756
+ export async function resolveStructuredDataPagePayloadsForManifest(manifest: { ref: string }) {
757
+ if (manifest.ref !== 'pricing') return [];
758
+ const catalog = await loadWebsitePricingCatalog();
759
+ return [{
760
+ pageRef: 'pricing',
761
+ payloads: buildWebsitePricingOfferStructuredData({
762
+ catalog,
763
+ itemOfferedId: SCHEMA_ORG_IDS.softwareApplication,
764
+ aggregateOfferIdPrefix: `${MARKETING_SITE_URL}/pricing#plans`, // each group appends what it aggregates
765
+ url: `${MARKETING_SITE_URL}/pricing`,
766
+ perUnitName: 'member', // required when a published plan is priced per unit
767
+ }),
768
+ }];
741
769
  }
742
770
 
743
- function PricingSectionComponent({ tierHrefs }: PricingSectionProps) {
744
- const sectionTitle = useWebsiteLabel('title');
745
- const sectionSub = useWebsiteLabel('subtitle');
746
-
771
+ // website/src/sections/pricing.sections.tsx — the section renders the catalogue, never a copy
772
+ function PricingPlans() {
773
+ const { plans } = useWebsitePricingCatalog();
747
774
  return (
748
- <div className="pricing">
749
- <WebsiteHeading level={2} variant="title">{sectionTitle}</WebsiteHeading>
750
- <WebsiteText variant="lead">{sectionSub}</WebsiteText>
751
- <ul className="pricing__tiers">
752
- {PRICING_TIERS.map((tier) => (
753
- <PricingTier
754
- key={tier.ref}
755
- tier={tier}
756
- href={tierHrefs[tier.ref]}
757
- />
758
- ))}
759
- </ul>
760
- </div>
775
+ <ul className="pricing__plans">
776
+ {plans.map((plan) => <PricingPlanTile key={plan.key} plan={plan} />)}
777
+ </ul>
761
778
  );
762
779
  }
763
780
 
764
- function PricingTier({ tier, href }: { tier: typeof PRICING_TIERS[number]; href: string }) {
765
- const name = useWebsiteLabel(`tier-${tier.ref}.name`);
766
- const pitch = useWebsiteLabel(`tier-${tier.ref}.pitch`);
767
- const cta = useWebsiteLabel(`tier-${tier.ref}.cta`);
781
+ function PricingPlanTile({ plan }: { plan: PublicPricingPlan }) {
782
+ const name = useWebsiteLabel(`plan-${plan.key}.name`);
783
+ const price = plan.prices.find((candidate) => candidate.isDefault) ?? plan.prices[0];
784
+ const onRequest = plan.priceDisclosure === ProductPriceDisclosure.ON_REQUEST;
785
+ const upcoming = plan.availability === ProductAvailability.UPCOMING;
768
786
  return (
769
- <li className="pricing__tier">
787
+ <li className={plan.isRecommended ? 'pricing__plan pricing__plan--recommended' : 'pricing__plan'}>
770
788
  <WebsiteHeading level={3} variant="card-title">{name}</WebsiteHeading>
771
- <p className="pricing__price">
772
- ${tier.amountMonthlyUSD}<span>/mo</span>
773
- </p>
774
- <WebsiteText>{pitch}</WebsiteText>
775
- <WebsiteButton href={href} variant="primary">{cta}</WebsiteButton>
789
+ {!onRequest && price !== undefined && <PlanPrice plan={plan} price={price} />}
790
+ {upcoming ? <ComingSoon /> : onRequest ? <ContactSales /> : <StartCta planKey={plan.key} />}
776
791
  </li>
777
792
  );
778
793
  }
779
794
 
780
- export const PRICING_SECTION = defineWebsiteSection<PricingSectionProps>({
781
- sectionRef: 'tiers',
795
+ export const PRICING_PLANS_SECTION = defineWebsiteSection({
796
+ sectionRef: 'pricing-plans',
782
797
  category: WebsiteSectionCategory.PRICING,
783
- expectedLabelKeys: [
784
- 'website.pricing.tiers.title',
785
- 'website.pricing.tiers.subtitle',
786
- ...PRICING_TIERS.flatMap((tier) => [
787
- `website.pricing.tiers.tier-${tier.ref}.name`,
788
- `website.pricing.tiers.tier-${tier.ref}.pitch`,
789
- `website.pricing.tiers.tier-${tier.ref}.cta`,
790
- ]),
791
- ],
792
- Component: PricingSectionComponent,
798
+ Component: PricingPlans,
799
+ // The application the plans sell; its OFFERS are published by page-payloads.ts from the catalogue.
793
800
  getStructuredData: () => ({
794
- '@context': 'https://schema.org',
795
- '@type': 'Product',
801
+ '@type': 'SoftwareApplication',
802
+ '@id': SCHEMA_ORG_IDS.softwareApplication,
796
803
  name: 'Example Application',
797
- offers: {
798
- '@type': 'AggregateOffer',
799
- priceCurrency: 'USD',
800
- lowPrice: Math.min(...PRICING_TIERS.map((t) => t.amountMonthlyUSD)),
801
- highPrice: Math.max(...PRICING_TIERS.map((t) => t.amountMonthlyUSD)),
802
- offerCount: PRICING_TIERS.length,
803
- offers: PRICING_TIERS.map((tier) => ({
804
- '@type': 'Offer',
805
- name: tier.ref,
806
- price: tier.amountMonthlyUSD,
807
- priceCurrency: 'USD',
808
- url: `https://app.example.com/pricing#${tier.ref}`,
809
- })),
810
- },
804
+ applicationCategory: 'BusinessApplication',
805
+ operatingSystem: 'Web',
811
806
  }),
812
807
  });
813
808
  ```
814
809
 
815
- ## Structured-data contract
810
+ The label keys a catalogue-driven section needs are known only once the catalogue is: list them from
811
+ the same plans in the page's `expectedLabelKeys` (`plan-<key>.name` / `.pitch` / `.cta` for each
812
+ public plan), so a plan added to the catalogue without copy fails the label-pack audit instead of
813
+ rendering a raw key.
816
814
 
817
- Allowed JSON-LD vocabularies for `category: PRICING`:
815
+ ## Structured-data contract
818
816
 
819
- - `Product` (with nested `offers: Offer | AggregateOffer`).
820
- - `Offer` (single tier).
821
- - `AggregateOffer` (multi-tier — recommended pattern for SaaS).
817
+ What a pricing page emits:
822
818
 
823
- Disallowed (the SEO dispatcher will warn):
819
+ - `SoftwareApplication` — the application itself, the usual case for a
820
+ Wildo site — from the section's `getStructuredData()`.
821
+ - `Product` instead, only when the plans sell a discrete good rather
822
+ than the application.
823
+ - One `AggregateOffer` per currency, with an `Offer` per plan whose price
824
+ may be published, from `buildWebsitePricingOfferStructuredData` as a
825
+ page-level payload — top-level, so the audit checks it, linked to the
826
+ application by `itemOffered.@id`.
824
827
 
825
- - `FAQPage` → emit from a sibling FAQ section
826
- (`website-section-faq`).
827
- - `Organization` / `WebSite` → emit from `website-section-hero`
828
- on the landing page only.
828
+ Keep `FAQPage` in a sibling FAQ section (`website-section-faq`) and
829
+ `Organization` / `WebSite` in the landing page's hero
830
+ (`website-section-hero`). Nothing rejects them here — the audit checks
831
+ each payload against the Schema.org catalog, never against the
832
+ section's category — so the split is yours to keep.
829
833
 
830
834
  ## Catalog integration (AEO)
831
835
 
832
- The pricing section emits a TUPLE of `Product` + `AggregateOffer`
833
- payloads, both declared by the installed Schema.org catalog contract:
836
+ Every type above is in the installed Schema.org catalog. The
837
+ structured-data audit (`wildo website audit`) checks the required
838
+ fields of each TOP-LEVEL payload a section or `page-payloads.ts` returns —
839
+ and only those. The `AggregateOffer` the offer builder returns is top-level,
840
+ so the audit checks it; an `Offer` nested in its `offers` is not checked,
841
+ which is one reason the builder, not hand-written JSON-LD, writes them:
834
842
 
843
+ - `SOFTWARE_APPLICATION_CATALOG_ENTRY` (required: `name`,
844
+ `applicationCategory`, `operatingSystem`).
835
845
  - `PRODUCT_CATALOG_ENTRY` (required: `name`, `description`).
836
846
  - `AGGREGATE_OFFER_CATALOG_ENTRY` (required: `lowPrice`,
837
- `priceCurrency`, `offerCount`; `recommendOptionals: true` so
838
- missing `highPrice` triggers a "consider adding" warning).
847
+ `priceCurrency`, `offerCount`; `recommendOptionals: true`, so a
848
+ top-level one missing `highPrice` is listed as a recommendation —
849
+ information, never a finding).
839
850
  - For single-tier pricing, swap `AggregateOffer` for a single
840
851
  `Offer` (`OFFER_CATALOG_ENTRY`; required: `price` +
841
852
  `priceCurrency`).
842
853
 
843
854
  The page shell wires emission through the installed structured-data contract —
844
- the section returns a tuple `[Product, AggregateOffer]` and the renderer
855
+ the section returns its payload (or a tuple of payloads) and the renderer
845
856
  emits one `<script type="application/ld+json">` block per payload
846
857
  (NOT a single `@graph`, see the renderer's preamble). The companion's
847
858
  reconciliation surface validates each payload against the catalog and
@@ -849,83 +860,89 @@ warns on drift (warning-only per D-AG4).
849
860
 
850
861
  **What earns its place in this section's emission**:
851
862
 
852
- - A `Product` payload with `name` + `description` (required) and the
853
- pricing surface's `brand` / `category` when known.
854
- - An `AggregateOffer` payload referencing the `Product` via `@id` and
855
- declaring `lowPrice` / `priceCurrency` / `offerCount` (and
856
- `highPrice` when more than one tier is sold).
857
- - Per-tier `Offer` payloads inside `AggregateOffer.offers[]` when the
858
- pricing page surfaces full tier detail (price + name + URL per tier).
863
+ - A `SoftwareApplication` payload with `name`, `applicationCategory`
864
+ and `operatingSystem` (required) — or a `Product` with `name` +
865
+ `description` when the plans sell a discrete good.
866
+ - The `AggregateOffer` the offer builder returns, referencing the
867
+ application by `itemOffered.@id` — `lowPrice` / `highPrice` /
868
+ `priceCurrency` / `offerCount` and one `Offer` per publishable plan,
869
+ all computed from the catalogue.
859
870
 
860
871
  **What is NOT in this emission**:
861
872
 
862
873
  - Page-level entities (`WebSite`, `Organization`) — emitted once by
863
874
  the hero / page-shell.
864
- - App overrides of `Product` (e.g. requiring `gtin`) — those live in
865
- the app's `_catalogs/schema-org/product.catalog-spec.ts`, NOT in the
866
- section's emission.
867
- - For SaaS sites, prefer the app-side `SoftwareApplication` extension
868
- (canonical application example) — emit `SoftwareApplication +
869
- AggregateOffer` instead of `Product + AggregateOffer`.
875
+ - App overrides of a catalog entry (e.g. requiring `gtin` on
876
+ `Product`) — those live in the app's
877
+ `_catalogs/schema-org/<type>.catalog-spec.ts`, NOT in the section's
878
+ emission.
870
879
 
871
880
  **Verification grep** (run from the app root):
872
881
 
873
882
  | Invariant | Command |
874
883
  |---|---|
875
- | Section emits structured data | `rg -n "getStructuredData" website/src/sections/pricing.section.tsx` (must return 1) |
876
- | Both `@type`s present | `rg -n "'Product'\|'AggregateOffer'" website/src/sections/pricing.section.tsx` (must return ≥2) |
884
+ | Section emits the application | `rg -n "getStructuredData" website/src/sections/<page>.sections.tsx` (must return ≥1 — a page's sections file holds each of its sections) |
885
+ | Offers are derived, never typed | `rg -n "buildWebsitePricingOfferStructuredData" website/src/structured-data/page-payloads.ts` (must return ≥1) |
877
886
 
878
887
  ## References
879
888
 
880
889
  - `references/define-website-section-api.md` — source-backed factory + schema + section wrapper + label hook contracts.
890
+ - `references/framework-pricing-catalog-api.md` — source-backed catalogue loader, `useWebsitePricingCatalog()` and offer builder.
881
891
 
882
892
  ## Verification
883
893
 
884
894
  - [ ] `category: WebsiteSectionCategory.PRICING` (typed enum).
885
- - [ ] Tier configuration lives in a separate locale-neutral module
886
- (numbers + tier refs only).
887
- - [ ] All copy comes from `useWebsiteLabel`.
888
- - [ ] `getStructuredData()` returns a `Product` (or
889
- `AggregateOffer`) — pure function, no React hooks.
890
- - [ ] Every tier's CTA `href` flows through the cross-frontend
891
- handoff carrier (see `website-anonymous-session`).
892
- - [ ] `priceCurrency` is set explicitly (the absence of a currency
893
- breaks Google's pricing rich result).
895
+ - [ ] The website holds no price: every amount, currency and recurrence comes from
896
+ `useWebsitePricingCatalog()` (render) and `buildWebsitePricingOfferStructuredData` (JSON-LD).
897
+ - [ ] The route loads the catalogue and passes it to the island as `pricingCatalog`.
898
+ - [ ] All copy comes from `useWebsiteLabel`, keyed by the plan's catalogue `key`.
899
+ - [ ] A recommended plan is worded as a recommendation, never as popularity.
900
+ - [ ] A starting price reads as one, an on-request plan shows no price, an upcoming plan has no
901
+ sign-up action.
902
+ - [ ] Every plan's CTA `href` flows through the cross-frontend handoff carrier (see
903
+ `website-anonymous-session`).
894
904
 
895
905
  ### Grep invariants
896
906
 
897
907
  | Invariant | Command |
898
908
  |---|---|
899
- | Factory used | `rg -n "defineWebsiteSection<" website/src/sections/pricing.section.tsx` (must return 1) |
900
- | `getStructuredData` defined | `rg -n "getStructuredData:" website/src/sections/pricing.section.tsx` (must return 1) |
901
- | Currency declared | `rg -n "priceCurrency" website/src/sections/pricing.section.tsx` (must return ≥1) |
902
- | Allowed vocabulary only | `rg -n "@type" website/src/sections/pricing.section.tsx` (only `Product` / `Offer` / `AggregateOffer`) |
909
+ | Factory used | `rg -n "defineWebsiteSection" website/src/sections/<page>.sections.tsx` (must return ≥1 — a page's sections file holds each of its sections) |
910
+ | Plans read from the catalogue | `rg -n "useWebsitePricingCatalog" website/src/sections/<page>.sections.tsx` (must return ≥1) |
911
+ | No typed price in the website | `rg -n "priceCurrency|amountMonthly|monthlyPrice" website/src/sections website/src/pages-impl` (must return 0) |
912
+ | Catalogue passed to the island | `rg -n "pricingCatalog=" website/src/pages/pricing.astro` (must return ≥1) |
913
+ | Offers derived | `rg -n "buildWebsitePricingOfferStructuredData" website/src/structured-data/page-payloads.ts` (must return ≥1) |
914
+ | Audit passes | `wildo website audit --strict` (no finding for the pricing page) |
903
915
 
904
916
  ## Common Rationalizations
905
917
 
906
918
  | Rationalization | Reality |
907
919
  |---|---|
908
- | "I'll skip JSON-LD; we don't care about SEO yet" | Pricing JSON-LD is a 10-minute investment with disproportionate SERP / AEO upside. Ship it from day one. |
909
- | "Tier names can be label keys" | The `ref` (`starter`, `team`, `enterprise`) is the stable contract that flows into URLs, analytics, and JSON-LD. Display name is a label; ref is not. |
910
- | "Currency is implicit (USD)" | Google's pricing rich result requires `priceCurrency`. Declare it explicitly; never omit. |
911
- | "Each tier should be its own `defineWebsiteSection` instance" | A pricing band is intentionally ONE section that renders N tiers from `PRICING_TIERS`. Per-tier sections fragment the analytics funnel-step grouping (`data-section-category="pricing"` would appear N times), fragment JSON-LD into N `Product` payloads instead of one `AggregateOffer`, and force the page manifest to enumerate. Single section, typed-array config, derived `expectedLabelKeys`. |
920
+ | "I'll skip JSON-LD; we don't care about SEO yet" | Pricing JSON-LD is a 10-minute investment with disproportionate SERP / AEO upside. Ship it from day one — the offer builder makes it one call. |
921
+ | "It is quicker to type the three prices here" | It is quicker once. Every later price change then lands in the backend and not on the site, and nothing reports the divergence — a site built that way went on advertising a tier its own catalogue did not sell. |
922
+ | "This plan's price is not settled, I'll hide it in the website" | That is a fact about the offer, so it belongs in the catalogue: `priceDisclosure: STARTING_AT` or `ON_REQUEST`. The in-app pricing table needs the same answer. |
923
+ | "Mark the middle plan 'most popular'" | Nothing measured it. `isRecommended` states a recommendation, and the label must say so. |
924
+ | "Currency is implicit (USD)" | The catalogue carries the currency on every price, and the offer builder publishes it; never restate it. |
925
+ | "Each plan should be its own `defineWebsiteSection` instance" | A pricing band is ONE section that renders N plans. Per-plan sections fragment the analytics funnel-step grouping (`data-section-category="pricing"` would appear N times) and force the page manifest to enumerate what the catalogue already lists. |
912
926
 
913
927
  ## Red Flags
914
928
 
915
- - Hardcoded prices in JSX (`$12/mo`) — break the JSON-LD/UI parity.
916
- Source from the typed config in both places.
917
- - Tier CTAs pointing directly at `app.example.com/signup?plan=team`
918
- with no anonymous-session handoff — first-touch + plan attribution
919
- is lost.
920
- - A `getStructuredData()` that calls `useWebsiteLabel()` — hooks must
921
- not run inside the structured-data builder; it's a pure function
922
- invoked outside the React graph at build time.
929
+ - A price in JSX or a sections file (`$12/mo`, `monthlyPrice: 12`) — a second copy of the catalogue;
930
+ catch with the "No typed price" grep above.
931
+ - A tier list keyed by names the catalogue does not declare — the site then sells plans the backend
932
+ does not; catch with the "Plans read from the catalogue" grep above.
933
+ - Hand-written `Offer` JSON-LD — it publishes starting prices and on-request plans as offers; catch
934
+ with the "Offers derived" grep above.
935
+ - Plan CTAs pointing directly at `app.example.com/signup?plan=team` with no anonymous-session
936
+ handoff — first-touch + plan attribution is lost.
937
+ - A `getStructuredData()` that calls a hook — it is a pure function invoked outside the React graph
938
+ at build time.
923
939
 
924
940
  ## Related Skills
925
941
 
926
942
  - `website-page-authoring` — composing this section into the pricing
927
943
  page manifest.
928
- - `website-label-pack` — authoring tier copy across locales.
944
+ - `website-label-pack` — authoring plan copy across locales.
945
+ - `configure-billing` — the billing catalogue the plans and prices come from.
929
946
  - `website-section-faq` — the standard FAQ companion section
930
947
  (questions about pricing, billing, plan changes).
931
948
  - `website-anonymous-session` — handoff carrier for tier CTAs.