@wildo-ai/framework-knowledge 1.1.5 → 1.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (835) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
  3. package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
  4. package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
  5. package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
  6. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
  7. package/dist/{knowledge/skills/journey-run/references/framework-playbook-approval-policy.md → claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md} +10 -8
  8. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
  9. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
  10. package/dist/{knowledge/skills/journey-run → claude-marketplace/plugins/wildo}/references/expert-personas-and-deliberations.md +8 -8
  11. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
  12. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
  13. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
  14. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
  15. package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
  16. package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
  17. package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
  18. package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
  19. package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
  20. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
  21. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  22. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  23. package/dist/esm/framework-knowledge.definitions.js +320 -11
  24. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +0 -3
  28. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +12 -2
  30. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  31. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +33 -2
  32. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +8 -5
  34. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  35. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +55 -10
  36. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -6
  40. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
  42. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
  44. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  45. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
  46. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  47. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +0 -1
  48. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +2 -2
  50. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -4
  52. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +10 -3
  54. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +7 -3
  56. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  58. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +8 -3
  59. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +1 -1
  61. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  62. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +0 -1
  63. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  64. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +7 -3
  65. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  66. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +9 -4
  67. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  68. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +3 -2
  69. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +4 -3
  71. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  72. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +1 -1
  73. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  74. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +1 -3
  75. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  76. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
  77. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  78. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +0 -1
  79. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  80. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +10 -3
  81. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  82. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +8 -3
  83. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  84. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +12 -5
  85. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  86. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +33 -5
  87. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  88. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +1 -1
  89. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +1 -1
  90. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  91. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
  92. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
  93. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
  94. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
  95. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
  96. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
  97. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
  98. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
  99. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
  100. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
  101. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
  103. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
  104. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
  105. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
  106. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
  107. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +1 -1
  108. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  109. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +1 -1
  110. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
  111. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
  113. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  114. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +1 -1
  115. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +1 -1
  116. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  117. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +1 -1
  118. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +1 -1
  119. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +1 -1
  121. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +1 -1
  122. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  123. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +1 -1
  124. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +1 -1
  125. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +1 -1
  127. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  129. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +36 -17
  130. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  131. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +67 -17
  132. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  133. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +1 -1
  134. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +1 -1
  135. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  136. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
  137. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
  138. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
  139. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
  140. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +1 -1
  141. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  142. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +1 -1
  143. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  144. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +1 -1
  145. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  146. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  147. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +0 -1
  148. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  149. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +1 -1
  150. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +1 -1
  151. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +1 -1
  153. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +1 -1
  154. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +1 -1
  156. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +1 -1
  157. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  158. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +1 -1
  159. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +1 -1
  160. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  161. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +1 -1
  162. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  163. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +0 -1
  164. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  165. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +1 -1
  166. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  167. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -3
  168. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  169. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  170. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  171. package/dist/knowledge/manifest.json +8 -8
  172. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +0 -3
  173. package/dist/knowledge/playbooks/bottom_up.build/method.md +4 -2
  174. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +31 -7
  175. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  176. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  177. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +134 -26
  178. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +7 -4
  179. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +84 -29
  180. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -7
  181. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +12 -23
  182. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -7
  183. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +12 -14
  184. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -2
  185. package/dist/knowledge/playbooks/bottom_up.conception/method.md +20 -2
  186. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +15 -7
  187. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +8 -6
  188. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +11 -4
  189. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +2 -4
  190. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +3 -4
  191. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +18 -2
  192. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +1 -2
  193. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +2 -4
  194. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +8 -5
  195. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +16 -2
  196. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +3 -3
  197. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +1 -3
  198. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +1 -2
  199. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +8 -7
  200. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +11 -4
  201. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +27 -5
  202. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +1 -4
  203. package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
  204. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
  205. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
  206. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
  207. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +112 -21
  208. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
  209. package/dist/knowledge/playbooks/refinement.document-facts/method.md +7 -2
  210. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -4
  211. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
  212. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
  213. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +6 -0
  214. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
  215. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +0 -4
  216. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +1 -2
  217. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +1 -3
  218. package/dist/knowledge/playbooks/top_down.capability-map/method.md +2 -4
  219. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -2
  220. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +1 -3
  221. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +5 -3
  222. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +2 -4
  223. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +1 -3
  224. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +0 -4
  225. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +2 -4
  226. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -3
  227. package/dist/knowledge/playbooks/top_down.definition/method.md +7 -4
  228. package/dist/knowledge/playbooks/top_down.definition/playbook.json +52 -7
  229. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +1 -1
  230. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +2 -4
  231. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
  232. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
  233. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +0 -1
  234. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +0 -1
  235. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +0 -1
  236. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +2 -4
  237. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -2
  238. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +1 -1
  239. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +2 -6
  240. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +17 -1
  241. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +2 -5
  242. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -3
  243. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +15 -7
  244. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +2 -4
  245. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +2 -4
  246. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +1 -2
  247. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
  248. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +12 -5
  249. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
  250. package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
  251. package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
  252. package/dist/knowledge/references/build-plan.task-graph.config.md +71 -6
  253. package/dist/knowledge/references/capability-composition.config.md +20 -1
  254. package/dist/knowledge/references/cli.market.generate-command.md +18 -2
  255. package/dist/knowledge/references/engine.client-bundle.allow-list.md +7 -22
  256. package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
  257. package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
  258. package/dist/knowledge/references/example.backend.addon-wiring.module.md +5 -0
  259. package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
  260. package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
  261. package/dist/knowledge/references/example.config.app-shell.full.md +11 -0
  262. package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
  263. package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
  264. package/dist/knowledge/references/example.config.backend.required-floors.md +7 -0
  265. package/dist/knowledge/references/example.config.navigation.full.md +45 -2
  266. package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
  267. package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
  268. package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
  269. package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
  270. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
  271. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +26 -3
  272. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +1 -1
  273. package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
  274. package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
  275. package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
  276. package/dist/knowledge/references/example.infra.environment-config.local.md +14 -30
  277. package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
  278. package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
  279. package/dist/knowledge/references/example.module.companion-exports.full.md +8 -13
  280. package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
  281. package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
  282. package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
  283. package/dist/knowledge/references/example.provider.backend-module-shape.md +3 -0
  284. package/dist/knowledge/references/example.provider.frontend-app.module.md +9 -0
  285. package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
  286. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +14 -13
  287. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +18 -0
  288. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +11 -11
  289. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +5 -0
  290. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +2 -0
  291. package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
  292. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
  293. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +24 -6
  294. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +36 -25
  295. package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
  296. package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
  297. package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
  298. package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
  299. package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
  300. package/dist/knowledge/references/example.website.page.manifest.md +30 -0
  301. package/dist/knowledge/references/experience-plan.config.md +11 -4
  302. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +20 -0
  303. package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
  304. package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
  305. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
  306. package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
  307. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
  308. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
  309. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
  310. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +21 -0
  311. package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
  312. package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
  313. package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
  314. package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
  315. package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
  316. package/dist/knowledge/references/integration-plan.config.md +34 -2
  317. package/dist/knowledge/references/market.alternative.config.md +1 -1
  318. package/dist/knowledge/references/market.buying-journey.config.md +1 -1
  319. package/dist/knowledge/references/market.category.config.md +1 -1
  320. package/dist/knowledge/references/market.channel.config.md +1 -1
  321. package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
  322. package/dist/knowledge/references/market.gain.config.md +1 -1
  323. package/dist/knowledge/references/market.icp.config.md +1 -1
  324. package/dist/knowledge/references/market.job.config.md +1 -1
  325. package/dist/knowledge/references/market.message-template.config.md +1 -1
  326. package/dist/knowledge/references/market.objection.config.md +1 -1
  327. package/dist/knowledge/references/market.pain.config.md +1 -1
  328. package/dist/knowledge/references/market.persona.config.md +1 -1
  329. package/dist/knowledge/references/market.positioning.config.md +1 -1
  330. package/dist/knowledge/references/market.proof.config.md +1 -1
  331. package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
  332. package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
  333. package/dist/knowledge/references/market.trigger.config.md +1 -1
  334. package/dist/knowledge/references/placement-plan.config.md +7 -1
  335. package/dist/knowledge/references/platform.config.backing-services.md +15 -15
  336. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +57 -57
  337. package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
  338. package/dist/knowledge/references/presets.3d.layout-contract.md +213 -0
  339. package/dist/knowledge/references/presets.3d.register-layout.md +95 -0
  340. package/dist/knowledge/references/presets.models.labelling.sections.md +5 -0
  341. package/dist/knowledge/references/presets.models.shell-region.md +47 -0
  342. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
  343. package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
  344. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  345. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +7 -6
  346. package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
  347. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +7 -0
  348. package/dist/knowledge/references/saas.backend.domain-module.md +93 -15
  349. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
  350. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
  351. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +200 -0
  352. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +2 -0
  353. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
  354. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +33 -9
  355. package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
  356. package/dist/knowledge/references/saas.backend.system-access-service.md +98 -0
  357. package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
  358. package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
  359. package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
  360. package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
  361. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
  362. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +2 -2
  363. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +250 -0
  364. package/dist/knowledge/references/saas.frontend.billing-context.md +25 -2
  365. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
  366. package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
  367. package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
  368. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
  369. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +7 -5
  370. package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
  371. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +17 -2
  372. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
  373. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
  374. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +9 -0
  375. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +100 -5
  376. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
  377. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +61 -0
  378. package/dist/knowledge/references/saas.market.generation-agent.md +0 -1
  379. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
  380. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
  381. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
  382. package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
  383. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
  384. package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
  385. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
  386. package/dist/knowledge/references/saas.models.audit.trail-config.md +15 -9
  387. package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
  388. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +8 -0
  389. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +54 -1
  390. package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
  391. package/dist/knowledge/references/saas.models.config.organization-types.md +74 -0
  392. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +31 -14
  393. package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
  394. package/dist/knowledge/references/saas.models.data-mode-read-list.md +4 -4
  395. package/dist/knowledge/references/saas.models.engine-capabilities.md +12 -0
  396. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +5 -1
  397. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
  398. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
  399. package/dist/knowledge/references/saas.models.external-data-pipeline.md +667 -6
  400. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
  401. package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
  402. package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
  403. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
  404. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
  405. package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
  406. package/dist/knowledge/references/saas.models.http-api-binding.md +812 -29
  407. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
  408. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
  409. package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
  410. package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
  411. package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
  412. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
  413. package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
  414. package/dist/knowledge/references/saas.models.navigation.layout.md +11 -7
  415. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +32 -23
  416. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +8 -4
  417. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +22 -20
  418. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +14 -0
  419. package/dist/knowledge/references/saas.models.notifications.targets.md +20 -12
  420. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +61 -34
  421. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +9 -0
  422. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
  423. package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
  424. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
  425. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
  426. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
  427. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
  428. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
  429. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
  430. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
  431. package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
  432. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
  433. package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
  434. package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
  435. package/dist/knowledge/references/saas.models.provider-capabilities.md +34 -0
  436. package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
  437. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
  438. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +61 -0
  439. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +98 -13
  440. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
  441. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -28
  442. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
  443. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +6 -0
  444. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +8 -0
  445. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
  446. package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
  447. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
  448. package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
  449. package/dist/knowledge/references/saas.models.systems-of-record.md +242 -7
  450. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
  451. package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
  452. package/dist/knowledge/references/saas.public-runtime.contract.md +75 -7
  453. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +20 -0
  454. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +106 -13
  455. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
  456. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
  457. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
  458. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
  459. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
  460. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +6 -4
  461. package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
  462. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +14 -2
  463. package/dist/knowledge/references/saas.specifications.processor-register.md +77 -0
  464. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
  465. package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
  466. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +112 -45
  467. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +13 -1
  468. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
  469. package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
  470. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
  471. package/dist/knowledge/references/saas.website.astro.bridge.md +32 -9
  472. package/dist/knowledge/references/saas.website.astro.head-renderer.md +1 -1
  473. package/dist/knowledge/references/saas.website.astro.label-loader.md +7 -4
  474. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +15 -15
  475. package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
  476. package/dist/knowledge/references/saas.website.blog.bridge.md +17 -4
  477. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
  478. package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
  479. package/dist/knowledge/references/saas.website.consent.banner.md +10 -10
  480. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
  481. package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
  482. package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
  483. package/dist/knowledge/references/saas.website.page-layout.component.md +5 -2
  484. package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
  485. package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
  486. package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
  487. package/dist/knowledge/references/saas.website.runtime.context.md +23 -4
  488. package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
  489. package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
  490. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
  491. package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
  492. package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
  493. package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
  494. package/dist/knowledge/references/website-plan.config.md +39 -6
  495. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +2 -1
  496. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +21 -0
  497. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +1 -2
  498. package/dist/knowledge/references/zod.decorators.file-schema.md +11 -10
  499. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +7 -4
  500. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +8 -2
  501. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +5 -1
  502. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +5 -1
  503. package/dist/knowledge/references/zod.factories.address.md +7 -7
  504. package/dist/knowledge/references/zod.factories.code.md +2 -2
  505. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  506. package/dist/knowledge/references/zod.factories.money.md +3 -3
  507. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  508. package/dist/knowledge/registries/framework-topics.json +1238 -54
  509. package/dist/knowledge/registries/playbooks.json +81 -109
  510. package/dist/knowledge/registries/source-tags.json +3191 -1126
  511. package/dist/knowledge/rules/live-context-door.md +29 -0
  512. package/dist/knowledge/skills/INDEX.md +27 -24
  513. package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
  514. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
  515. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
  516. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
  517. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
  518. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
  519. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
  520. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
  521. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
  522. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +31 -0
  523. package/dist/knowledge/skills/application-database-migrations/SKILL.md +1 -0
  524. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +1 -0
  525. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +9 -0
  526. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  527. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +94 -16
  528. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +21 -8
  529. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +7 -0
  530. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +13 -5
  531. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +30 -6
  532. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +160 -32
  533. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +20 -0
  534. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +14 -2
  535. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +88 -0
  536. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +112 -14
  537. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
  538. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
  539. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
  540. package/dist/knowledge/skills/config-app-shell/SKILL.md +21 -0
  541. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +2 -2
  542. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +276 -0
  543. package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
  544. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -0
  545. package/dist/knowledge/skills/config-navigation/SKILL.md +114 -16
  546. package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
  547. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +11 -7
  548. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +29 -5
  549. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +40 -27
  550. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +22 -20
  551. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +112 -5
  552. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +10 -10
  553. package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
  554. package/dist/knowledge/skills/config-saas/SKILL.md +3 -1
  555. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +7 -0
  556. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +21 -11
  557. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +5 -1
  558. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +59 -9
  559. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +46 -0
  560. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +251 -12
  561. package/dist/knowledge/skills/config-saas-backend/SKILL.md +8 -0
  562. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +81 -0
  563. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +37 -15
  564. package/dist/knowledge/skills/configure-billing/SKILL.md +64 -24
  565. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +35 -2
  566. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +14 -0
  567. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +3 -0
  568. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +25 -2
  569. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +73 -1
  570. package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
  571. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +27 -12
  572. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +11 -2
  573. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +26 -2
  574. package/dist/knowledge/skills/email-add-template/SKILL.md +61 -24
  575. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +5 -2
  576. package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
  577. package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
  578. package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
  579. package/dist/knowledge/skills/engine-component-registration/SKILL.md +1 -0
  580. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +6 -0
  581. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +27 -3
  582. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
  583. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
  584. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
  585. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
  586. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
  587. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +31 -4
  588. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +26 -3
  589. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
  590. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
  591. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +202 -0
  592. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +93 -15
  593. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +96 -11
  594. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +2 -1
  595. package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
  596. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -0
  597. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -2
  598. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +14 -9
  599. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +1 -0
  600. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +1 -0
  601. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +5 -0
  602. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
  603. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +5 -0
  604. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +8 -1
  605. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +5 -0
  606. package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
  607. package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
  608. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
  609. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
  610. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
  611. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
  612. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
  613. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
  614. package/dist/knowledge/skills/infra-environment-config/SKILL.md +150 -44
  615. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +83 -74
  616. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +176 -0
  617. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
  618. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +223 -0
  619. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +103 -0
  620. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +256 -0
  621. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
  622. package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +29 -0
  623. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
  624. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +32 -1
  625. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
  626. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +36 -4
  627. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +2 -1
  628. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
  629. package/dist/knowledge/skills/market-alternatives/SKILL.md +3 -2
  630. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
  631. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
  632. package/dist/knowledge/skills/market-category/SKILL.md +2 -1
  633. package/dist/knowledge/skills/market-channels/SKILL.md +2 -1
  634. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +7 -4
  635. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +6 -4
  636. package/dist/knowledge/skills/market-generation-cli/SKILL.md +28 -13
  637. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +18 -3
  638. package/dist/knowledge/skills/market-icp/SKILL.md +2 -1
  639. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +4 -3
  640. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -1
  641. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
  642. package/dist/knowledge/skills/market-persona/SKILL.md +2 -1
  643. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
  644. package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
  645. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +3 -2
  646. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
  647. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1 -0
  648. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +2 -1
  649. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +3 -2
  650. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +1 -0
  651. package/dist/knowledge/skills/minion-authoring/SKILL.md +5 -1
  652. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
  653. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
  654. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
  655. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
  656. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
  657. package/dist/knowledge/skills/module-companion-exports/SKILL.md +17 -16
  658. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +6 -4
  659. package/dist/knowledge/skills/module-registration/SKILL.md +2 -1
  660. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +93 -15
  661. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +86 -1
  662. package/dist/knowledge/skills/module-relationships/SKILL.md +3 -2
  663. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
  664. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
  665. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
  666. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
  667. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
  668. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
  669. package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
  670. package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -33
  671. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
  672. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
  673. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
  674. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
  675. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
  676. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
  677. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +132 -23
  678. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
  679. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +29 -0
  680. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
  681. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
  682. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
  683. package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
  684. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
  685. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +75 -24
  686. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +3 -3
  687. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +61 -0
  688. package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
  689. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +17 -2
  690. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +15 -0
  691. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
  692. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +25 -0
  693. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +6 -0
  694. package/dist/knowledge/skills/resource-add-field/SKILL.md +1 -0
  695. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
  696. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +105 -6
  697. package/dist/knowledge/skills/resource-add-module/SKILL.md +1 -0
  698. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +2 -1
  699. package/dist/knowledge/skills/resource-add-resource/SKILL.md +3 -0
  700. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +124 -30
  701. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +1 -0
  702. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +8 -0
  703. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +9 -0
  704. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +17 -1
  705. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +124 -30
  706. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +7 -6
  707. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +142 -34
  708. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +98 -0
  709. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +86 -52
  710. package/dist/knowledge/skills/resource-custom-view/SKILL.md +1 -0
  711. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +100 -5
  712. package/dist/knowledge/skills/resource-external-data/SKILL.md +1026 -28
  713. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
  714. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
  715. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
  716. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +686 -11
  717. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +904 -31
  718. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +166 -6
  719. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
  720. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
  721. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
  722. package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
  723. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
  724. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
  725. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
  726. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
  727. package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
  728. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
  729. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +1 -0
  730. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +1 -0
  731. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +12 -0
  732. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
  733. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
  734. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
  735. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
  736. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
  737. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
  738. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
  739. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +2 -2
  740. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
  741. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
  742. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +2 -1
  743. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +28 -0
  744. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +5 -1
  745. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +34 -30
  746. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +5 -1
  747. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +101 -42
  748. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +21 -0
  749. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +1 -2
  750. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +125 -6
  751. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +8 -2
  752. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
  753. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +61 -1
  754. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +110 -9
  755. package/dist/knowledge/skills/seeding-authoring/SKILL.md +1 -0
  756. package/dist/knowledge/skills/seeding-operations/SKILL.md +1 -0
  757. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
  758. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
  759. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
  760. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
  761. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
  762. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
  763. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +1 -0
  764. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +61 -0
  765. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
  766. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
  767. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +14 -16
  768. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +6 -4
  769. package/dist/knowledge/skills/spec-component-update/SKILL.md +1 -0
  770. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
  771. package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
  772. package/dist/knowledge/skills/spec-feature-update/SKILL.md +1 -0
  773. package/dist/knowledge/skills/spec-resource-update/SKILL.md +13 -0
  774. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +158 -46
  775. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
  776. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
  777. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +5 -1
  778. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +1 -0
  779. package/dist/knowledge/skills/views-app-level/SKILL.md +2 -1
  780. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +43 -1
  781. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
  782. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +5 -1
  783. package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
  784. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -0
  785. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +29 -6
  786. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
  787. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +17 -4
  788. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +23 -28
  789. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +7 -22
  790. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +167 -20
  791. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
  792. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +63 -6
  793. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
  794. package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
  795. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -2
  796. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -2
  797. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +2 -1
  798. package/dist/knowledge/skills/website-page-authoring/SKILL.md +117 -33
  799. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
  800. package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
  801. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
  802. package/dist/knowledge/skills/website-section-contact/SKILL.md +65 -36
  803. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -11
  804. package/dist/knowledge/skills/website-section-cta/SKILL.md +32 -22
  805. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -11
  806. package/dist/knowledge/skills/website-section-faq/SKILL.md +99 -63
  807. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -11
  808. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +27 -18
  809. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -11
  810. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +33 -22
  811. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -11
  812. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +31 -20
  813. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -11
  814. package/dist/knowledge/skills/website-section-hero/SKILL.md +65 -44
  815. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -11
  816. package/dist/knowledge/skills/website-section-pricing/SKILL.md +217 -200
  817. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -11
  818. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
  819. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +45 -34
  820. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -11
  821. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
  822. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
  823. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +30 -25
  824. package/dist/knowledge/skills/worker-authoring/SKILL.md +1 -0
  825. package/dist/knowledge/topic-index.json +5887 -1695
  826. package/dist/tsconfig.build.tsbuildinfo +1 -1
  827. package/dist/tsconfig.tsbuildinfo +1 -1
  828. package/package.json +4 -4
  829. package/dist/knowledge/skills/journey-approve/SKILL.md +0 -63
  830. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -77
  831. package/dist/knowledge/skills/journey-next/SKILL.md +0 -82
  832. package/dist/knowledge/skills/journey-report/SKILL.md +0 -56
  833. package/dist/knowledge/skills/journey-run/SKILL.md +0 -140
  834. package/dist/knowledge/skills/journey-status/SKILL.md +0 -60
  835. /package/dist/{knowledge/skills/journey-approve → claude-marketplace/plugins/wildo}/references/specification-family-map.md +0 -0
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: website-section-faq
3
3
  description: Author an FAQ section using `defineWebsiteSection({ category: WebsiteSectionCategory.FAQ, … })` with first-class `FAQPage` JSON-LD for AEO/GEO ranking. Use when the user says "add an FAQ section", "compose questions and answers with structured data", "wire FAQ JSON-LD", or "customize the FAQ accordion layout".
4
+ user-invocable: false
4
5
  ---
5
6
 
6
7
  # Website Section: FAQ
@@ -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
@@ -609,10 +618,10 @@ strongest answer-engine ranking signals available; every consumer
609
618
  pricing / product / support page should ship one with `FAQPage`
610
619
  JSON-LD.
611
620
 
612
- The category drives:
621
+ What the category does — and, for structured data, does not — decide:
613
622
 
614
- 1. **SEO/AEO/GEO dispatch** — `category: FAQ` allows `FAQPage`
615
- exclusively.
623
+ 1. **SEO/AEO/GEO** — an FAQ section emits `FAQPage` and nothing
624
+ else. Nothing enforces this pairing — the structured-data audit checks each payload against the Schema.org catalog, never against the section's category.
616
625
  2. **Skill mapping** — 1:1 with `WebsiteSectionCategory.FAQ`.
617
626
  3. **Analytics labelling** — `data-section-category="faq"`.
618
627
 
@@ -620,7 +629,7 @@ The category drives:
620
629
 
621
630
  | Surface | Glob (relative to app root) |
622
631
  |---|---|
623
- | Section component + factory call | `website/src/sections/faq.section.tsx` |
632
+ | 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) |
624
633
  | Page composition | `website/src/pages-impl/<page-ref>.page.tsx` |
625
634
  | Label pack (per locale) | `website/src/i18n/<locale>.json` |
626
635
  | Question identifier registry | `website/src/sections/faq.config.ts` |
@@ -666,11 +675,16 @@ entry. The function is pure (no React hooks); answers must come from
666
675
  the same source the JSX renders, NOT a separately-authored copy
667
676
  (otherwise SERP and on-page diverge).
668
677
 
669
- > Note: in static-build mode the JSON-LD answers must be pre-resolved
670
- > against the active locale's label pack. The framework's SEO
671
- > dispatcher (Phase 2.5+) handles this resolution; section authors
672
- > only declare the structural shape with answer keys, not literal
673
- > answer strings.
678
+ > `getStructuredData()` takes no arguments, and nothing resolves label
679
+ > keys inside a payload — a payload carrying key names ships the key
680
+ > names. So build the `FAQPage` from a label PACK (a flat
681
+ > `label key → string` map): export a pure
682
+ > `build<Page>FaqStructuredData(labels)` next to the section, bind the
683
+ > default locale's pack (`import en from '../i18n/en.json'`) in
684
+ > `getStructuredData`, and in every locale's route pass the section
685
+ > rebound to the active pack, `runtime.labelPack`, to
686
+ > `renderPageStructuredData`. The answers then come from the same pack
687
+ > the JSX renders, in the language of the page.
674
688
 
675
689
  ### Step 4: Compose into the page
676
690
 
@@ -695,7 +709,7 @@ from the same registry the UI renders.
695
709
  - **What is NOT in this block**: hidden answers, synthetic Q/A copy, or
696
710
  a second manually-authored FAQ payload.
697
711
  - **Verification grep**:
698
- `rg -n "getStructuredData|FAQPage|mainEntity" website/src/sections/faq.section.tsx`
712
+ `rg -n "getStructuredData|FAQPage|mainEntity" website/src/sections/<page>.sections.tsx`
699
713
  (must return `>= 1` for an emitting FAQ section).
700
714
 
701
715
  ## Contribution to `llms.txt`
@@ -725,17 +739,17 @@ export const FAQ_QUESTIONS: readonly FaqQuestionConfig[] = [
725
739
  ] as const;
726
740
  ```
727
741
 
728
- <!-- TIER C WAIVER: This block IS the canonical FAQ contract — `category: WebsiteSectionCategory.FAQ`, the per-question `useWebsiteLabel('question-${ref}.q'|.a)` leaf-relative pattern, the `<details id="faq-${ref}">` anchor consistency Verification grep #3 enforces, and the `__questionKey`/`__answerKey` JSON-LD placeholders Common Rationalization #3 calls "the SEO dispatcher resolves per locale". Keep it as Tier C until a stable application usage example is deliberately anchored. -->
742
+ <!-- TIER C WAIVER: This block IS the canonical FAQ contract — `category: WebsiteSectionCategory.FAQ`, the per-question `useWebsiteLabel('question-${ref}.q'|.a)` leaf-relative pattern, the `<details id="faq-${ref}">` anchor consistency Verification grep #3 enforces, and the `buildPricingFaqStructuredData(labels)` builder that reads questions and answers from the same label pack the JSX renders. Keep it as Tier C until a stable application usage example is deliberately anchored. -->
729
743
  ```tsx
730
- // website/src/sections/faq.section.tsx
744
+ // website/src/sections/<page>.sections.tsx
731
745
  import {
732
746
  defineWebsiteSection,
733
747
  useWebsiteLabel,
734
- useWebsiteLabelByKey,
735
748
  WebsiteHeading,
736
749
  WebsiteSectionCategory,
737
750
  WebsiteText,
738
751
  } from '@wildo-ai/saas-website';
752
+ import enLabels from '../i18n/en.json';
739
753
  import { FAQ_QUESTIONS } from './faq.config';
740
754
 
741
755
  function FaqSectionComponent() {
@@ -767,6 +781,26 @@ function FaqEntry({ questionRef }: { questionRef: string }) {
767
781
  );
768
782
  }
769
783
 
784
+ /**
785
+ * The FAQPage JSON-LD, built from a label PACK so the answers are the
786
+ * on-page answers in the page's language. Pure: no hooks, no I/O.
787
+ */
788
+ export function buildPricingFaqStructuredData(labels: Readonly<Record<string, string>>) {
789
+ return {
790
+ '@context': 'https://schema.org',
791
+ '@type': 'FAQPage',
792
+ mainEntity: FAQ_QUESTIONS.map((q) => ({
793
+ '@type': 'Question',
794
+ '@id': `#faq-${q.ref}`,
795
+ name: labels[`website.pricing.faq.question-${q.ref}.q`],
796
+ acceptedAnswer: {
797
+ '@type': 'Answer',
798
+ text: labels[`website.pricing.faq.question-${q.ref}.a`],
799
+ },
800
+ })),
801
+ };
802
+ }
803
+
770
804
  export const FAQ_SECTION = defineWebsiteSection({
771
805
  sectionRef: 'faq',
772
806
  category: WebsiteSectionCategory.FAQ,
@@ -778,37 +812,34 @@ export const FAQ_SECTION = defineWebsiteSection({
778
812
  ]),
779
813
  ],
780
814
  Component: FaqSectionComponent,
781
- /**
782
- * Emit `FAQPage` JSON-LD. The SEO dispatcher resolves
783
- * `__answerKey` references against the active locale's label pack
784
- * at static-build time and inlines the resolved string into
785
- * `acceptedAnswer.text` per question. Section authors never inline
786
- * literal answer copy here.
787
- */
788
- getStructuredData: () => ({
789
- '@context': 'https://schema.org',
790
- '@type': 'FAQPage',
791
- mainEntity: FAQ_QUESTIONS.map((q) => ({
792
- '@type': 'Question',
793
- '@id': `#faq-${q.ref}`,
794
- __questionKey: `website.pricing.faq.question-${q.ref}.q`,
795
- acceptedAnswer: {
796
- '@type': 'Answer',
797
- __answerKey: `website.pricing.faq.question-${q.ref}.a`,
798
- },
799
- })),
800
- }),
815
+ // The default locale's pack: what `wildo website audit` checks and the
816
+ // default-locale route renders.
817
+ getStructuredData: () => buildPricingFaqStructuredData(enLabels),
801
818
  });
802
819
  ```
803
820
 
804
- ## Structured-data contract
805
-
806
- Allowed JSON-LD vocabularies for `category: FAQ`:
821
+ And in each locale's route (`website/src/pages/pricing.astro`, and its
822
+ copy under `website/src/pages/<locale path>/`), rebind it to the pack
823
+ the page renders:
824
+
825
+ <!-- TIER C WAIVER: route wiring template — the one place a locale-bound payload reaches the page; illustrative page names. -->
826
+ ```ts
827
+ const structuredDataHtml = renderPageStructuredData({
828
+ sections: PRICING_SECTIONS.map((section) =>
829
+ section.sectionRef === FAQ_SECTION.sectionRef
830
+ ? { ...section, getStructuredData: () => buildPricingFaqStructuredData(runtime.labelPack) }
831
+ : section,
832
+ ),
833
+ });
834
+ ```
807
835
 
808
- - `FAQPage` (with `mainEntity: Question[]`, each carrying an
809
- `acceptedAnswer: Answer`).
836
+ ## Structured-data contract
810
837
 
811
- Disallowed:
838
+ An FAQ section emits one `FAQPage` (with `mainEntity: Question[]`,
839
+ each carrying an `acceptedAnswer: Answer`). Keep the others in the
840
+ sections that own them — nothing rejects them here, since the audit
841
+ checks each payload against the catalog and never against the section's
842
+ category:
812
843
 
813
844
  - `Product` / `Offer` → `website-section-pricing`.
814
845
  - `Review` / `AggregateRating` → `website-section-social-proof`.
@@ -823,8 +854,7 @@ installed Schema.org catalog contract (canonical entry
823
854
  - **Required**: `mainEntity` (the `Question[]` list — the catalog flags
824
855
  emission sites that omit it).
825
856
  - **Optional**: `inLanguage`, `dateModified`, `description` —
826
- `recommendOptionals: true` for this entity (the companion warns
827
- "consider adding for richer AEO results" when missing).
857
+ `recommendOptionals: true` for this entity, so `wildo website audit` lists the missing ones as recommendations (information, never a finding, never failing `--strict`).
828
858
  - **Deprecated**: none.
829
859
 
830
860
  The page-shell wires every section's `getStructuredData()` through
@@ -858,8 +888,8 @@ D-AG4).
858
888
 
859
889
  | Invariant | Command |
860
890
  |---|---|
861
- | Section emits structured data | `rg -n "getStructuredData" website/src/sections/faq.section.tsx` (must return 1) |
862
- | Catalog `@type` matches | `rg -n "'FAQPage'" website/src/sections/faq.section.tsx` (must return 1) |
891
+ | Section emits structured data | `rg -n "getStructuredData" website/src/sections/<page>.sections.tsx` (must return ≥1 — a page's sections file holds each of its sections) |
892
+ | Catalog `@type` matches | `rg -n "'FAQPage'" website/src/sections/<page>.sections.tsx` (must return ≥1 — a page's sections file holds each of its sections) |
863
893
 
864
894
  ## References
865
895
 
@@ -881,9 +911,9 @@ D-AG4).
881
911
 
882
912
  | Invariant | Command |
883
913
  |---|---|
884
- | Factory used | `rg -n "defineWebsiteSection" website/src/sections/faq.section.tsx` (must return 1) |
885
- | FAQPage emitted | `rg -n "'FAQPage'" website/src/sections/faq.section.tsx` (must return 1) |
886
- | Anchor + JSON-LD ref consistency | `rg -oN "faq-[a-z-]+" website/src/sections/faq.section.tsx \| sort -u` (count must equal `FAQ_QUESTIONS.length`) |
914
+ | Factory used | `rg -n "defineWebsiteSection" website/src/sections/<page>.sections.tsx` (must return ≥1 — a page's sections file holds each of its sections) |
915
+ | FAQPage emitted | `rg -n "'FAQPage'" website/src/sections/<page>.sections.tsx` (must return ≥1 — a page's sections file holds each of its sections) |
916
+ | Anchor + JSON-LD ref consistency | `rg -oN "faq-[a-z-]+" website/src/sections/<page>.sections.tsx \| sort -u` (count must equal `FAQ_QUESTIONS.length`) |
887
917
 
888
918
  ## Common Rationalizations
889
919
 
@@ -891,8 +921,9 @@ D-AG4).
891
921
  |---|---|
892
922
  | "I'll skip JSON-LD; the FAQ is for humans" | FAQ JSON-LD is the single highest-ROI AEO/GEO signal. Ship it. |
893
923
  | "Different FAQs per locale" | The question SET is shape-stable across locales (the answers vary). If a locale has fundamentally different questions, that's a different section instance with a different `sectionRef`. |
894
- | "I'll write JSON-LD answers as literal strings here" | Section module is locale-neutral; literal answers in `getStructuredData` would diverge from on-page copy. Use answer keys; the SEO dispatcher resolves them per locale. |
895
- | "I'll re-use one `__answerKey` across two questions to deduplicate boilerplate" | Each answer key is the question's content identity — it also drives the `<details id="faq-<ref>">` anchor and the JSON-LD `@id`. Sharing collapses two distinct questions into a uniqueness collision the label-pack validator catches at build start. Author the duplicate text twice; the label-pack diff reviewer will surface it. |
924
+ | "I'll write JSON-LD answers as literal strings here" | Literal answers diverge from the on-page copy the first time someone edits a label, and they ship one language on every locale's page. Read them from the label pack through the builder. |
925
+ | "I'll emit the label KEYS and let something resolve them" | Nothing does. A payload carrying `__answerKey` ships the key name to search engines. Build from the pack. |
926
+ | "I'll re-use one answer key across two questions to deduplicate boilerplate" | Each question's `ref` is its content identity — it drives the label keys, the `<details id="faq-<ref>">` anchor and the JSON-LD `@id`. Sharing collapses two distinct questions into one. Author the duplicate text twice; the label-pack diff reviewer will surface it. |
896
927
 
897
928
  ## Red Flags
898
929
 
@@ -901,8 +932,12 @@ D-AG4).
901
932
  - A custom JS-driven accordion replacing `<details>` without
902
933
  preserving keyboard + screen-reader behavior — accessibility
903
934
  regression.
904
- - A `Question` whose `__answerKey` is not in `expectedLabelKeys` —
905
- the label-pack validator fails at build start.
935
+ - A `Question` whose `name` or `acceptedAnswer.text` is a label KEY
936
+ rather than the resolved text — nothing resolves keys inside a
937
+ payload, so the key ships to search engines.
938
+ - A locale route that renders the FAQ section without rebinding it to
939
+ `runtime.labelPack` — every locale's page then carries the default
940
+ locale's answers.
906
941
 
907
942
  ## Related Skills
908
943
 
@@ -910,7 +945,8 @@ D-AG4).
910
945
  product pages.
911
946
  - `website-label-pack` — Q + A copy across locales.
912
947
  - `website-section-pricing` — the canonical FAQ companion section.
913
- - `website-seo-aeo-geo` — broader SEO posture and how the SEO
914
- dispatcher consumes `getStructuredData()` output.
948
+ - `website-seo-aeo-geo` — broader SEO posture, and how the page route
949
+ renders `getStructuredData()` output through
950
+ `renderPageStructuredData`.
915
951
  - `website-primitive-overrides` — overriding the disclosure
916
952
  primitive if the project uses a custom accordion.
@@ -85,7 +85,8 @@ export const WebsiteSectionCategorySchema: z.ZodEnum<typeof WebsiteSectionCatego
85
85
  ## Section definition (the contract `defineWebsiteSection` produces)
86
86
 
87
87
  The schema declares the **observable contract** the page-manifest
88
- registration, label-pack validator, and SEO dispatcher depend on. The
88
+ registration, the label-pack validator, `renderPageStructuredData` and
89
+ the structured-data audit depend on. The
89
90
  factory layer adds type-preserving generics on top so JSX usage keeps
90
91
  compile-time prop checking.
91
92
 
@@ -104,7 +105,8 @@ compile-time prop checking.
104
105
  * `core/define-website-section.tsx` module in Phase 2 because it carries
105
106
  * React types in its inputs). The shape is declared in `schemas/`
106
107
  * because it is the **observable contract** the page-manifest
107
- * registration, label-pack validator, and SEO dispatcher depend on.
108
+ * registration, the label-pack validator, `renderPageStructuredData` and the
109
+ * structured-data audit depend on.
108
110
  *
109
111
  * **Shape rationale** (each field carries semantic weight — see
110
112
  * `design-philosophy.mdc`):
@@ -114,7 +116,8 @@ compile-time prop checking.
114
116
  * (a section can be reused with the same `sectionRef` across pages
115
117
  * when its label-key root is intentionally shared).
116
118
  * - `category` — see `WebsiteSectionCategory` JSDoc; tags the section
117
- * for SEO-dispatch, skill-mapping, and analytics labelling.
119
+ * for skill-mapping and analytics labelling. It does NOT select the
120
+ * section's structured data.
118
121
  * - `expectedLabelKeys` — the **fully-composed** label keys the section
119
122
  * commits to consuming. The plan originally proposed leaf-relative
120
123
  * keys (`'headline'`) resolved at runtime against the
@@ -127,9 +130,13 @@ compile-time prop checking.
127
130
  * graph — `wildo website audit` can list a page's required keys
128
131
  * without booting React.
129
132
  * 3. The leaf-relative ergonomics (`useWebsiteLabel('headline')`)
130
- * survive in Phase 2 — the hook composes the leaf with the
131
- * page+section context and validates the result against
132
- * `expectedLabelKeys`.
133
+ * survive — the hook composes the leaf with the page+section
134
+ * context and looks the result up in the active pack. It does
135
+ * NOT check the key against `expectedLabelKeys`: a leaf the
136
+ * section never declared renders its key (with a console warning)
137
+ * and is caught by nothing until a reviewer reads the page. The
138
+ * build and `wildo website audit` check the pack against the
139
+ * DECLARED keys, so declare every slot the component reads.
133
140
  * - `Component` — the React component that renders the section. Typed
134
141
  * as `ComponentType<unknown>` here because schema-layer cannot lock
135
142
  * the component's prop shape (props vary per section). The factory
@@ -139,8 +146,9 @@ compile-time prop checking.
139
146
  * - `getStructuredData?` — optional pure function the SEO/AEO/GEO
140
147
  * builder library invokes at static-build time to materialize JSON-LD
141
148
  * for the section. The return type is intentionally `unknown` here;
142
- * the SEO library narrows by `category` (e.g. `PRICING` →
143
- * `Product | AggregateOffer`).
149
+ * nothing narrows it by `category` — the section returns whatever
150
+ * vocabulary it emits, and `wildo website audit` reconciles that
151
+ * against the application's Schema.org catalog.
144
152
  *
145
153
  * **Why not `z.custom<ComponentType>(…)`**: a `z.custom` predicate
146
154
  * cannot meaningfully validate "is a React component" beyond
@@ -287,9 +295,9 @@ export interface TypedWebsiteSectionDefinition<TProps>
287
295
  * **Why a factory instead of constructing the literal directly**:
288
296
  * - Consumers don't have to remember to parse refs / keys
289
297
  * themselves before assembling the literal.
290
- * - The schema parse provides a single audited validation chokepoint
291
- * so `wildo website audit` (Phase 7) can re-validate definitions
292
- * without re-entering the React graph.
298
+ * - The schema parse provides a single audited validation chokepoint,
299
+ * and the parsed `expectedLabelKeys` are what `wildo website audit`
300
+ * checks every locale pack against, without re-entering the React graph.
293
301
  * - The factory is the documented authoring API the
294
302
  * `website_factory_authoring` skill targets — keeping the
295
303
  * authoring surface narrow lets the framework evolve the
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: website-section-feature-benefit-summary
3
3
  description: Author a Feature-Benefit Summary grid section (icon + headline + short blurb) using `defineWebsiteSection({ category: WebsiteSectionCategory.FEATURE_BENEFIT_SUMMARY, … })`. Use when the user says "add a feature grid", "compose a 3-up benefits section", "wire icons + headline + blurb", or "build a 'why us' summary band". The skill folder name MUST stay 1:1-aligned with `WebsiteSectionCategory.FEATURE_BENEFIT_SUMMARY = 'feature-benefit-summary'`.
4
+ user-invocable: false
4
5
  ---
5
6
 
6
7
  # Website Section: Feature-Benefit Summary
@@ -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
@@ -623,7 +632,7 @@ keeps the marketing copy grounded in the market truth — see
623
632
 
624
633
  | Surface | Glob (relative to app root) |
625
634
  |---|---|
626
- | Section component + factory call | `website/src/sections/feature-benefit-summary.section.tsx` |
635
+ | 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) |
627
636
  | Page composition | `website/src/pages-impl/<page-ref>.page.tsx` |
628
637
  | Label pack (per locale) | `website/src/i18n/<locale>.json` |
629
638
 
@@ -691,7 +700,7 @@ capability bullets for a page in `website/src/content/llms.txt`.
691
700
 
692
701
  <!-- TIER C WAIVER: This block IS the canonical Feature-Benefit Summary contract — `category: WebsiteSectionCategory.FEATURE_BENEFIT_SUMMARY`, the **typed `cells` tuple with `icon: ReactNode` props** that Verification check #4 ("Icon nodes come from typed props, not from the label pack") and Red Flag #2 ("icon passed as a label key") both reference, the per-cell `useWebsiteLabel('cell-<i>.title|.description')` leaf-relative pattern, and the `expectedLabelKeys` rooted at `website.<page>.<sectionRef>.cell-<i>.<leaf>`. Keep it as Tier C until a stable application usage example is deliberately anchored. -->
693
702
  ```tsx
694
- // website/src/sections/feature-benefit-summary.section.tsx
703
+ // website/src/sections/<page>.sections.tsx
695
704
  import type { ReactNode } from 'react';
696
705
  import {
697
706
  defineWebsiteSection,
@@ -817,7 +826,7 @@ that an `ItemList` emission would currently trigger (until
817
826
 
818
827
  | Invariant | Command |
819
828
  |---|---|
820
- | Section does NOT emit unsupported `@type`s | `rg -n "'Product'\|'Offer'\|'FAQPage'\|'ItemList'" website/src/sections/feature-benefit-summary.section.tsx` (must return 0) |
829
+ | Section emits nothing, and the page's payloads are valid | This section's own `defineWebsiteSection` call declares no `getStructuredData` (a page's sections file also holds its FAQ, pricing and other sections, so a file-wide grep for their types proves nothing); `wildo website audit` reports no finding for the page |
821
830
 
822
831
  ## References
823
832
 
@@ -837,10 +846,10 @@ that an `ItemList` emission would currently trigger (until
837
846
 
838
847
  | Invariant | Command |
839
848
  |---|---|
840
- | Factory used | `rg -n "defineWebsiteSection<" website/src/sections/feature-benefit-summary.section.tsx` (must return 1) |
841
- | Category enum (no string literal) | `rg -n "FEATURE_BENEFIT_SUMMARY" website/src/sections/feature-benefit-summary.section.tsx` (must return ≥1) |
842
- | Cell count consistent | `rg -oN "cell-\\d" website/src/sections/feature-benefit-summary.section.tsx \| sort -u` (count must match section's documented arity) |
843
- | Static label refs only | `rg -n "useWebsiteLabel\\(\`" website/src/sections/feature-benefit-summary.section.tsx` (must return empty — dynamic refs hide from `expectedLabelKeys` audit) |
849
+ | Factory used | `rg -n "defineWebsiteSection<" website/src/sections/<page>.sections.tsx` (must return ≥1 — a page's sections file holds each of its sections) |
850
+ | Category enum (no string literal) | `rg -n "FEATURE_BENEFIT_SUMMARY" website/src/sections/<page>.sections.tsx` (must return ≥1) |
851
+ | Cell count consistent | `rg -oN "cell-\\d" website/src/sections/<page>.sections.tsx \| sort -u` (count must match section's documented arity) |
852
+ | Static label refs only | `rg -n "useWebsiteLabel\\(\`" website/src/sections/<page>.sections.tsx` (must return empty — dynamic refs hide from `expectedLabelKeys` audit) |
844
853
 
845
854
  ## Common Rationalizations
846
855
 
@@ -85,7 +85,8 @@ export const WebsiteSectionCategorySchema: z.ZodEnum<typeof WebsiteSectionCatego
85
85
  ## Section definition (the contract `defineWebsiteSection` produces)
86
86
 
87
87
  The schema declares the **observable contract** the page-manifest
88
- registration, label-pack validator, and SEO dispatcher depend on. The
88
+ registration, the label-pack validator, `renderPageStructuredData` and
89
+ the structured-data audit depend on. The
89
90
  factory layer adds type-preserving generics on top so JSX usage keeps
90
91
  compile-time prop checking.
91
92
 
@@ -104,7 +105,8 @@ compile-time prop checking.
104
105
  * `core/define-website-section.tsx` module in Phase 2 because it carries
105
106
  * React types in its inputs). The shape is declared in `schemas/`
106
107
  * because it is the **observable contract** the page-manifest
107
- * registration, label-pack validator, and SEO dispatcher depend on.
108
+ * registration, the label-pack validator, `renderPageStructuredData` and the
109
+ * structured-data audit depend on.
108
110
  *
109
111
  * **Shape rationale** (each field carries semantic weight — see
110
112
  * `design-philosophy.mdc`):
@@ -114,7 +116,8 @@ compile-time prop checking.
114
116
  * (a section can be reused with the same `sectionRef` across pages
115
117
  * when its label-key root is intentionally shared).
116
118
  * - `category` — see `WebsiteSectionCategory` JSDoc; tags the section
117
- * for SEO-dispatch, skill-mapping, and analytics labelling.
119
+ * for skill-mapping and analytics labelling. It does NOT select the
120
+ * section's structured data.
118
121
  * - `expectedLabelKeys` — the **fully-composed** label keys the section
119
122
  * commits to consuming. The plan originally proposed leaf-relative
120
123
  * keys (`'headline'`) resolved at runtime against the
@@ -127,9 +130,13 @@ compile-time prop checking.
127
130
  * graph — `wildo website audit` can list a page's required keys
128
131
  * without booting React.
129
132
  * 3. The leaf-relative ergonomics (`useWebsiteLabel('headline')`)
130
- * survive in Phase 2 — the hook composes the leaf with the
131
- * page+section context and validates the result against
132
- * `expectedLabelKeys`.
133
+ * survive — the hook composes the leaf with the page+section
134
+ * context and looks the result up in the active pack. It does
135
+ * NOT check the key against `expectedLabelKeys`: a leaf the
136
+ * section never declared renders its key (with a console warning)
137
+ * and is caught by nothing until a reviewer reads the page. The
138
+ * build and `wildo website audit` check the pack against the
139
+ * DECLARED keys, so declare every slot the component reads.
133
140
  * - `Component` — the React component that renders the section. Typed
134
141
  * as `ComponentType<unknown>` here because schema-layer cannot lock
135
142
  * the component's prop shape (props vary per section). The factory
@@ -139,8 +146,9 @@ compile-time prop checking.
139
146
  * - `getStructuredData?` — optional pure function the SEO/AEO/GEO
140
147
  * builder library invokes at static-build time to materialize JSON-LD
141
148
  * for the section. The return type is intentionally `unknown` here;
142
- * the SEO library narrows by `category` (e.g. `PRICING` →
143
- * `Product | AggregateOffer`).
149
+ * nothing narrows it by `category` — the section returns whatever
150
+ * vocabulary it emits, and `wildo website audit` reconciles that
151
+ * against the application's Schema.org catalog.
144
152
  *
145
153
  * **Why not `z.custom<ComponentType>(…)`**: a `z.custom` predicate
146
154
  * cannot meaningfully validate "is a React component" beyond
@@ -287,9 +295,9 @@ export interface TypedWebsiteSectionDefinition<TProps>
287
295
  * **Why a factory instead of constructing the literal directly**:
288
296
  * - Consumers don't have to remember to parse refs / keys
289
297
  * themselves before assembling the literal.
290
- * - The schema parse provides a single audited validation chokepoint
291
- * so `wildo website audit` (Phase 7) can re-validate definitions
292
- * without re-entering the React graph.
298
+ * - The schema parse provides a single audited validation chokepoint,
299
+ * and the parsed `expectedLabelKeys` are what `wildo website audit`
300
+ * checks every locale pack against, without re-entering the React graph.
293
301
  * - The factory is the documented authoring API the
294
302
  * `website_factory_authoring` skill targets — keeping the
295
303
  * authoring surface narrow lets the framework evolve the