@wildo-ai/framework-knowledge 1.1.5 → 1.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (835) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
  3. package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
  4. package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
  5. package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
  6. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
  7. package/dist/{knowledge/skills/journey-run/references/framework-playbook-approval-policy.md → claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md} +10 -8
  8. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
  9. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
  10. package/dist/{knowledge/skills/journey-run → claude-marketplace/plugins/wildo}/references/expert-personas-and-deliberations.md +8 -8
  11. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
  12. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
  13. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
  14. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
  15. package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
  16. package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
  17. package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
  18. package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
  19. package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
  20. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
  21. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  22. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  23. package/dist/esm/framework-knowledge.definitions.js +320 -11
  24. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +0 -3
  28. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +12 -2
  30. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  31. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +33 -2
  32. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +8 -5
  34. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  35. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +55 -10
  36. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -6
  40. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
  42. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
  44. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  45. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
  46. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  47. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +0 -1
  48. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +2 -2
  50. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -4
  52. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +10 -3
  54. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +7 -3
  56. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  58. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +8 -3
  59. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +1 -1
  61. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  62. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +0 -1
  63. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  64. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +7 -3
  65. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  66. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +9 -4
  67. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  68. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +3 -2
  69. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +4 -3
  71. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  72. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +1 -1
  73. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  74. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +1 -3
  75. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  76. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
  77. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  78. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +0 -1
  79. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  80. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +10 -3
  81. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  82. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +8 -3
  83. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  84. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +12 -5
  85. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  86. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +33 -5
  87. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  88. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +1 -1
  89. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +1 -1
  90. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  91. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
  92. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
  93. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
  94. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
  95. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
  96. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
  97. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
  98. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
  99. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
  100. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
  101. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
  103. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
  104. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
  105. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
  106. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
  107. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +1 -1
  108. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  109. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +1 -1
  110. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
  111. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
  113. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  114. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +1 -1
  115. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +1 -1
  116. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  117. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +1 -1
  118. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +1 -1
  119. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +1 -1
  121. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +1 -1
  122. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  123. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +1 -1
  124. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +1 -1
  125. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +1 -1
  127. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  129. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +36 -17
  130. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  131. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +67 -17
  132. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  133. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +1 -1
  134. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +1 -1
  135. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  136. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
  137. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
  138. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
  139. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
  140. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +1 -1
  141. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  142. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +1 -1
  143. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  144. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +1 -1
  145. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  146. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  147. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +0 -1
  148. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  149. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +1 -1
  150. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +1 -1
  151. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +1 -1
  153. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +1 -1
  154. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +1 -1
  156. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +1 -1
  157. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  158. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +1 -1
  159. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +1 -1
  160. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  161. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +1 -1
  162. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  163. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +0 -1
  164. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  165. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +1 -1
  166. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  167. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -3
  168. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  169. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  170. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  171. package/dist/knowledge/manifest.json +8 -8
  172. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +0 -3
  173. package/dist/knowledge/playbooks/bottom_up.build/method.md +4 -2
  174. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +31 -7
  175. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  176. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  177. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +134 -26
  178. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +7 -4
  179. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +84 -29
  180. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -7
  181. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +12 -23
  182. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -7
  183. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +12 -14
  184. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -2
  185. package/dist/knowledge/playbooks/bottom_up.conception/method.md +20 -2
  186. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +15 -7
  187. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +8 -6
  188. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +11 -4
  189. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +2 -4
  190. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +3 -4
  191. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +18 -2
  192. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +1 -2
  193. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +2 -4
  194. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +8 -5
  195. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +16 -2
  196. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +3 -3
  197. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +1 -3
  198. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +1 -2
  199. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +8 -7
  200. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +11 -4
  201. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +27 -5
  202. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +1 -4
  203. package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
  204. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
  205. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
  206. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
  207. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +112 -21
  208. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
  209. package/dist/knowledge/playbooks/refinement.document-facts/method.md +7 -2
  210. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -4
  211. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
  212. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
  213. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +6 -0
  214. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
  215. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +0 -4
  216. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +1 -2
  217. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +1 -3
  218. package/dist/knowledge/playbooks/top_down.capability-map/method.md +2 -4
  219. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -2
  220. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +1 -3
  221. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +5 -3
  222. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +2 -4
  223. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +1 -3
  224. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +0 -4
  225. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +2 -4
  226. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -3
  227. package/dist/knowledge/playbooks/top_down.definition/method.md +7 -4
  228. package/dist/knowledge/playbooks/top_down.definition/playbook.json +52 -7
  229. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +1 -1
  230. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +2 -4
  231. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
  232. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
  233. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +0 -1
  234. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +0 -1
  235. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +0 -1
  236. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +2 -4
  237. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -2
  238. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +1 -1
  239. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +2 -6
  240. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +17 -1
  241. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +2 -5
  242. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -3
  243. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +15 -7
  244. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +2 -4
  245. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +2 -4
  246. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +1 -2
  247. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
  248. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +12 -5
  249. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
  250. package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
  251. package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
  252. package/dist/knowledge/references/build-plan.task-graph.config.md +71 -6
  253. package/dist/knowledge/references/capability-composition.config.md +20 -1
  254. package/dist/knowledge/references/cli.market.generate-command.md +18 -2
  255. package/dist/knowledge/references/engine.client-bundle.allow-list.md +7 -22
  256. package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
  257. package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
  258. package/dist/knowledge/references/example.backend.addon-wiring.module.md +5 -0
  259. package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
  260. package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
  261. package/dist/knowledge/references/example.config.app-shell.full.md +11 -0
  262. package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
  263. package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
  264. package/dist/knowledge/references/example.config.backend.required-floors.md +7 -0
  265. package/dist/knowledge/references/example.config.navigation.full.md +45 -2
  266. package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
  267. package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
  268. package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
  269. package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
  270. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
  271. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +26 -3
  272. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +1 -1
  273. package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
  274. package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
  275. package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
  276. package/dist/knowledge/references/example.infra.environment-config.local.md +14 -30
  277. package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
  278. package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
  279. package/dist/knowledge/references/example.module.companion-exports.full.md +8 -13
  280. package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
  281. package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
  282. package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
  283. package/dist/knowledge/references/example.provider.backend-module-shape.md +3 -0
  284. package/dist/knowledge/references/example.provider.frontend-app.module.md +9 -0
  285. package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
  286. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +14 -13
  287. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +18 -0
  288. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +11 -11
  289. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +5 -0
  290. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +2 -0
  291. package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
  292. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
  293. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +24 -6
  294. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +36 -25
  295. package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
  296. package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
  297. package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
  298. package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
  299. package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
  300. package/dist/knowledge/references/example.website.page.manifest.md +30 -0
  301. package/dist/knowledge/references/experience-plan.config.md +11 -4
  302. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +20 -0
  303. package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
  304. package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
  305. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
  306. package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
  307. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
  308. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
  309. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
  310. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +21 -0
  311. package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
  312. package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
  313. package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
  314. package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
  315. package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
  316. package/dist/knowledge/references/integration-plan.config.md +34 -2
  317. package/dist/knowledge/references/market.alternative.config.md +1 -1
  318. package/dist/knowledge/references/market.buying-journey.config.md +1 -1
  319. package/dist/knowledge/references/market.category.config.md +1 -1
  320. package/dist/knowledge/references/market.channel.config.md +1 -1
  321. package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
  322. package/dist/knowledge/references/market.gain.config.md +1 -1
  323. package/dist/knowledge/references/market.icp.config.md +1 -1
  324. package/dist/knowledge/references/market.job.config.md +1 -1
  325. package/dist/knowledge/references/market.message-template.config.md +1 -1
  326. package/dist/knowledge/references/market.objection.config.md +1 -1
  327. package/dist/knowledge/references/market.pain.config.md +1 -1
  328. package/dist/knowledge/references/market.persona.config.md +1 -1
  329. package/dist/knowledge/references/market.positioning.config.md +1 -1
  330. package/dist/knowledge/references/market.proof.config.md +1 -1
  331. package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
  332. package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
  333. package/dist/knowledge/references/market.trigger.config.md +1 -1
  334. package/dist/knowledge/references/placement-plan.config.md +7 -1
  335. package/dist/knowledge/references/platform.config.backing-services.md +15 -15
  336. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +57 -57
  337. package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
  338. package/dist/knowledge/references/presets.3d.layout-contract.md +213 -0
  339. package/dist/knowledge/references/presets.3d.register-layout.md +95 -0
  340. package/dist/knowledge/references/presets.models.labelling.sections.md +5 -0
  341. package/dist/knowledge/references/presets.models.shell-region.md +47 -0
  342. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
  343. package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
  344. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  345. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +7 -6
  346. package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
  347. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +7 -0
  348. package/dist/knowledge/references/saas.backend.domain-module.md +93 -15
  349. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
  350. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
  351. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +200 -0
  352. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +2 -0
  353. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
  354. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +33 -9
  355. package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
  356. package/dist/knowledge/references/saas.backend.system-access-service.md +98 -0
  357. package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
  358. package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
  359. package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
  360. package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
  361. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
  362. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +2 -2
  363. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +250 -0
  364. package/dist/knowledge/references/saas.frontend.billing-context.md +25 -2
  365. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
  366. package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
  367. package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
  368. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
  369. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +7 -5
  370. package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
  371. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +17 -2
  372. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
  373. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
  374. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +9 -0
  375. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +100 -5
  376. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
  377. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +61 -0
  378. package/dist/knowledge/references/saas.market.generation-agent.md +0 -1
  379. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
  380. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
  381. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
  382. package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
  383. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
  384. package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
  385. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
  386. package/dist/knowledge/references/saas.models.audit.trail-config.md +15 -9
  387. package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
  388. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +8 -0
  389. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +54 -1
  390. package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
  391. package/dist/knowledge/references/saas.models.config.organization-types.md +74 -0
  392. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +31 -14
  393. package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
  394. package/dist/knowledge/references/saas.models.data-mode-read-list.md +4 -4
  395. package/dist/knowledge/references/saas.models.engine-capabilities.md +12 -0
  396. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +5 -1
  397. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
  398. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
  399. package/dist/knowledge/references/saas.models.external-data-pipeline.md +667 -6
  400. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
  401. package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
  402. package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
  403. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
  404. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
  405. package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
  406. package/dist/knowledge/references/saas.models.http-api-binding.md +812 -29
  407. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
  408. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
  409. package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
  410. package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
  411. package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
  412. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
  413. package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
  414. package/dist/knowledge/references/saas.models.navigation.layout.md +11 -7
  415. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +32 -23
  416. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +8 -4
  417. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +22 -20
  418. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +14 -0
  419. package/dist/knowledge/references/saas.models.notifications.targets.md +20 -12
  420. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +61 -34
  421. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +9 -0
  422. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
  423. package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
  424. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
  425. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
  426. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
  427. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
  428. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
  429. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
  430. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
  431. package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
  432. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
  433. package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
  434. package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
  435. package/dist/knowledge/references/saas.models.provider-capabilities.md +34 -0
  436. package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
  437. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
  438. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +61 -0
  439. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +98 -13
  440. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
  441. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -28
  442. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
  443. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +6 -0
  444. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +8 -0
  445. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
  446. package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
  447. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
  448. package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
  449. package/dist/knowledge/references/saas.models.systems-of-record.md +242 -7
  450. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
  451. package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
  452. package/dist/knowledge/references/saas.public-runtime.contract.md +75 -7
  453. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +20 -0
  454. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +106 -13
  455. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
  456. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
  457. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
  458. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
  459. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
  460. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +6 -4
  461. package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
  462. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +14 -2
  463. package/dist/knowledge/references/saas.specifications.processor-register.md +77 -0
  464. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
  465. package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
  466. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +112 -45
  467. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +13 -1
  468. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
  469. package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
  470. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
  471. package/dist/knowledge/references/saas.website.astro.bridge.md +32 -9
  472. package/dist/knowledge/references/saas.website.astro.head-renderer.md +1 -1
  473. package/dist/knowledge/references/saas.website.astro.label-loader.md +7 -4
  474. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +15 -15
  475. package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
  476. package/dist/knowledge/references/saas.website.blog.bridge.md +17 -4
  477. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
  478. package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
  479. package/dist/knowledge/references/saas.website.consent.banner.md +10 -10
  480. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
  481. package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
  482. package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
  483. package/dist/knowledge/references/saas.website.page-layout.component.md +5 -2
  484. package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
  485. package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
  486. package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
  487. package/dist/knowledge/references/saas.website.runtime.context.md +23 -4
  488. package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
  489. package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
  490. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
  491. package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
  492. package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
  493. package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
  494. package/dist/knowledge/references/website-plan.config.md +39 -6
  495. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +2 -1
  496. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +21 -0
  497. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +1 -2
  498. package/dist/knowledge/references/zod.decorators.file-schema.md +11 -10
  499. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +7 -4
  500. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +8 -2
  501. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +5 -1
  502. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +5 -1
  503. package/dist/knowledge/references/zod.factories.address.md +7 -7
  504. package/dist/knowledge/references/zod.factories.code.md +2 -2
  505. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  506. package/dist/knowledge/references/zod.factories.money.md +3 -3
  507. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  508. package/dist/knowledge/registries/framework-topics.json +1238 -54
  509. package/dist/knowledge/registries/playbooks.json +81 -109
  510. package/dist/knowledge/registries/source-tags.json +3191 -1126
  511. package/dist/knowledge/rules/live-context-door.md +29 -0
  512. package/dist/knowledge/skills/INDEX.md +27 -24
  513. package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
  514. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
  515. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
  516. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
  517. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
  518. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
  519. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
  520. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
  521. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
  522. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +31 -0
  523. package/dist/knowledge/skills/application-database-migrations/SKILL.md +1 -0
  524. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +1 -0
  525. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +9 -0
  526. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  527. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +94 -16
  528. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +21 -8
  529. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +7 -0
  530. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +13 -5
  531. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +30 -6
  532. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +160 -32
  533. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +20 -0
  534. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +14 -2
  535. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +88 -0
  536. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +112 -14
  537. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
  538. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
  539. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
  540. package/dist/knowledge/skills/config-app-shell/SKILL.md +21 -0
  541. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +2 -2
  542. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +276 -0
  543. package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
  544. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -0
  545. package/dist/knowledge/skills/config-navigation/SKILL.md +114 -16
  546. package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
  547. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +11 -7
  548. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +29 -5
  549. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +40 -27
  550. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +22 -20
  551. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +112 -5
  552. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +10 -10
  553. package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
  554. package/dist/knowledge/skills/config-saas/SKILL.md +3 -1
  555. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +7 -0
  556. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +21 -11
  557. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +5 -1
  558. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +59 -9
  559. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +46 -0
  560. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +251 -12
  561. package/dist/knowledge/skills/config-saas-backend/SKILL.md +8 -0
  562. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +81 -0
  563. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +37 -15
  564. package/dist/knowledge/skills/configure-billing/SKILL.md +64 -24
  565. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +35 -2
  566. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +14 -0
  567. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +3 -0
  568. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +25 -2
  569. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +73 -1
  570. package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
  571. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +27 -12
  572. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +11 -2
  573. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +26 -2
  574. package/dist/knowledge/skills/email-add-template/SKILL.md +61 -24
  575. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +5 -2
  576. package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
  577. package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
  578. package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
  579. package/dist/knowledge/skills/engine-component-registration/SKILL.md +1 -0
  580. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +6 -0
  581. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +27 -3
  582. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
  583. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
  584. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
  585. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
  586. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
  587. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +31 -4
  588. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +26 -3
  589. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
  590. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
  591. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +202 -0
  592. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +93 -15
  593. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +96 -11
  594. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +2 -1
  595. package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
  596. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -0
  597. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -2
  598. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +14 -9
  599. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +1 -0
  600. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +1 -0
  601. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +5 -0
  602. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
  603. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +5 -0
  604. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +8 -1
  605. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +5 -0
  606. package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
  607. package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
  608. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
  609. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
  610. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
  611. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
  612. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
  613. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
  614. package/dist/knowledge/skills/infra-environment-config/SKILL.md +150 -44
  615. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +83 -74
  616. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +176 -0
  617. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
  618. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +223 -0
  619. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +103 -0
  620. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +256 -0
  621. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
  622. package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +29 -0
  623. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
  624. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +32 -1
  625. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
  626. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +36 -4
  627. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +2 -1
  628. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
  629. package/dist/knowledge/skills/market-alternatives/SKILL.md +3 -2
  630. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
  631. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
  632. package/dist/knowledge/skills/market-category/SKILL.md +2 -1
  633. package/dist/knowledge/skills/market-channels/SKILL.md +2 -1
  634. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +7 -4
  635. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +6 -4
  636. package/dist/knowledge/skills/market-generation-cli/SKILL.md +28 -13
  637. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +18 -3
  638. package/dist/knowledge/skills/market-icp/SKILL.md +2 -1
  639. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +4 -3
  640. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -1
  641. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
  642. package/dist/knowledge/skills/market-persona/SKILL.md +2 -1
  643. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
  644. package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
  645. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +3 -2
  646. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
  647. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1 -0
  648. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +2 -1
  649. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +3 -2
  650. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +1 -0
  651. package/dist/knowledge/skills/minion-authoring/SKILL.md +5 -1
  652. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
  653. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
  654. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
  655. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
  656. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
  657. package/dist/knowledge/skills/module-companion-exports/SKILL.md +17 -16
  658. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +6 -4
  659. package/dist/knowledge/skills/module-registration/SKILL.md +2 -1
  660. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +93 -15
  661. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +86 -1
  662. package/dist/knowledge/skills/module-relationships/SKILL.md +3 -2
  663. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
  664. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
  665. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
  666. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
  667. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
  668. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
  669. package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
  670. package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -33
  671. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
  672. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
  673. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
  674. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
  675. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
  676. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
  677. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +132 -23
  678. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
  679. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +29 -0
  680. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
  681. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
  682. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
  683. package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
  684. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
  685. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +75 -24
  686. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +3 -3
  687. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +61 -0
  688. package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
  689. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +17 -2
  690. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +15 -0
  691. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
  692. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +25 -0
  693. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +6 -0
  694. package/dist/knowledge/skills/resource-add-field/SKILL.md +1 -0
  695. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
  696. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +105 -6
  697. package/dist/knowledge/skills/resource-add-module/SKILL.md +1 -0
  698. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +2 -1
  699. package/dist/knowledge/skills/resource-add-resource/SKILL.md +3 -0
  700. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +124 -30
  701. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +1 -0
  702. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +8 -0
  703. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +9 -0
  704. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +17 -1
  705. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +124 -30
  706. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +7 -6
  707. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +142 -34
  708. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +98 -0
  709. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +86 -52
  710. package/dist/knowledge/skills/resource-custom-view/SKILL.md +1 -0
  711. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +100 -5
  712. package/dist/knowledge/skills/resource-external-data/SKILL.md +1026 -28
  713. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
  714. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
  715. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
  716. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +686 -11
  717. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +904 -31
  718. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +166 -6
  719. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
  720. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
  721. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
  722. package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
  723. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
  724. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
  725. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
  726. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
  727. package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
  728. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
  729. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +1 -0
  730. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +1 -0
  731. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +12 -0
  732. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
  733. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
  734. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
  735. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
  736. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
  737. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
  738. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
  739. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +2 -2
  740. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
  741. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
  742. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +2 -1
  743. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +28 -0
  744. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +5 -1
  745. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +34 -30
  746. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +5 -1
  747. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +101 -42
  748. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +21 -0
  749. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +1 -2
  750. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +125 -6
  751. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +8 -2
  752. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
  753. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +61 -1
  754. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +110 -9
  755. package/dist/knowledge/skills/seeding-authoring/SKILL.md +1 -0
  756. package/dist/knowledge/skills/seeding-operations/SKILL.md +1 -0
  757. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
  758. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
  759. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
  760. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
  761. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
  762. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
  763. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +1 -0
  764. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +61 -0
  765. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
  766. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
  767. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +14 -16
  768. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +6 -4
  769. package/dist/knowledge/skills/spec-component-update/SKILL.md +1 -0
  770. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
  771. package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
  772. package/dist/knowledge/skills/spec-feature-update/SKILL.md +1 -0
  773. package/dist/knowledge/skills/spec-resource-update/SKILL.md +13 -0
  774. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +158 -46
  775. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
  776. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
  777. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +5 -1
  778. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +1 -0
  779. package/dist/knowledge/skills/views-app-level/SKILL.md +2 -1
  780. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +43 -1
  781. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
  782. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +5 -1
  783. package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
  784. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -0
  785. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +29 -6
  786. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
  787. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +17 -4
  788. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +23 -28
  789. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +7 -22
  790. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +167 -20
  791. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
  792. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +63 -6
  793. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
  794. package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
  795. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -2
  796. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -2
  797. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +2 -1
  798. package/dist/knowledge/skills/website-page-authoring/SKILL.md +117 -33
  799. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
  800. package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
  801. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
  802. package/dist/knowledge/skills/website-section-contact/SKILL.md +65 -36
  803. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -11
  804. package/dist/knowledge/skills/website-section-cta/SKILL.md +32 -22
  805. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -11
  806. package/dist/knowledge/skills/website-section-faq/SKILL.md +99 -63
  807. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -11
  808. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +27 -18
  809. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -11
  810. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +33 -22
  811. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -11
  812. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +31 -20
  813. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -11
  814. package/dist/knowledge/skills/website-section-hero/SKILL.md +65 -44
  815. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -11
  816. package/dist/knowledge/skills/website-section-pricing/SKILL.md +217 -200
  817. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -11
  818. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
  819. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +45 -34
  820. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -11
  821. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
  822. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
  823. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +30 -25
  824. package/dist/knowledge/skills/worker-authoring/SKILL.md +1 -0
  825. package/dist/knowledge/topic-index.json +5887 -1695
  826. package/dist/tsconfig.build.tsbuildinfo +1 -1
  827. package/dist/tsconfig.tsbuildinfo +1 -1
  828. package/package.json +4 -4
  829. package/dist/knowledge/skills/journey-approve/SKILL.md +0 -63
  830. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -77
  831. package/dist/knowledge/skills/journey-next/SKILL.md +0 -82
  832. package/dist/knowledge/skills/journey-report/SKILL.md +0 -56
  833. package/dist/knowledge/skills/journey-run/SKILL.md +0 -140
  834. package/dist/knowledge/skills/journey-status/SKILL.md +0 -60
  835. /package/dist/{knowledge/skills/journey-approve → claude-marketplace/plugins/wildo}/references/specification-family-map.md +0 -0
@@ -0,0 +1,102 @@
1
+ # Framework — reading a chart's data without its canvas (saas-frontend-lib)
2
+
3
+ Source-backed contract for `useResourceChartData`, the hook that fetches a resource chart view's rows
4
+ scoped exactly as the rendered chart is.
5
+
6
+ Read this when:
7
+
8
+ - a view shows numbers derived from a chart (KPI tiles, a completion rate, a count in a sentence);
9
+ - you are about to call `useChartData` yourself — for a declared chart view, you almost certainly want
10
+ this hook instead;
11
+ - a hand-built chart fetch is refused with `aggregation_scope_unresolved`.
12
+
13
+ ## Import Origins
14
+
15
+ - `@wildo-ai/saas-frontend-lib`
16
+
17
+ ## Source Excerpts
18
+
19
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
20
+
21
+ ```typescript
22
+ /**
23
+ * Read the DATA of a resource's declared chart view, scoped exactly as the rendered chart is.
24
+ *
25
+ * Import from `@wildo-ai/saas-frontend-lib`. Use it when a view needs a chart's numbers without its
26
+ * canvas: KPI tiles, a summary sentence, a count on a badge. It resolves the chart the way an
27
+ * embedded chart does. It finds the resource's `chartViews` entry, turns the entry's declared
28
+ * `primaryScope` (for example the organization) into context from the signed-in session, then
29
+ * fetches.
30
+ *
31
+ * Do not call `useChartData` with a bare `ChartDefinition` for this. That hook is the transport and
32
+ * sends only the context you pass it, so a chart scoped to an organization is refused by the
33
+ * backend with `aggregation_scope_unresolved`.
34
+ *
35
+ * Throws when the resource declares no chart view with that `ref`, the same configuration error an
36
+ * embedded chart raises.
37
+ *
38
+ * @param params.resourceType - the resource whose `chartViews` declares the chart
39
+ * @param params.viewRef - that chart view's `ref`
40
+ * @param params.contextResourceIdentifiers - context you already hold (a parent record's id); merged
41
+ * with what the chart's scope resolves
42
+ * @param params.localErrorOnly - `true` when your view shows the failure itself (a tile), so no
43
+ * page-level error toast is raised
44
+ * @returns `{ data, loading, error, refetch }`; `data.data` holds one row per dimension value, keyed by
45
+ * the query's dimension and measure refs
46
+ *
47
+ * @example
48
+ * const { data, loading, error } = useResourceChartData({
49
+ * resourceType: MyModule_ResourceType.TODOS,
50
+ * viewRef: todosByStatusChartDefinition.ref,
51
+ * localErrorOnly: true,
52
+ * });
53
+ * const total = (data?.data ?? []).reduce((sum, row) => sum + Number(row.count ?? 0), 0);
54
+ */
55
+ export function useResourceChartData(params: {
56
+ /** The resource whose `frontendConfiguration.chartViews` declares the chart. */
57
+ resourceType: string;
58
+ /** The chart view's `ref` on that resource. */
59
+ viewRef: string;
60
+ /** Context the caller already holds; merged with what the chart's scope resolves. */
61
+ contextResourceIdentifiers?: Record<string, string>;
62
+ inputs?: ChartInputValues;
63
+ urlParamValues?: Record<string, string>;
64
+ /** `true` when the caller shows the failure itself (a tile), so no global error toast is raised. */
65
+ localErrorOnly?: boolean;
66
+ }): ChartDataState {
67
+ const { resourceType, viewRef, contextResourceIdentifiers, inputs, urlParamValues, localErrorOnly = false } = params;
68
+ const { registry } = useResourceRegistry();
69
+ const chartView = registry.resourceConfigurations[resourceType]
70
+ ?.frontendConfiguration
71
+ ?.chartViews
72
+ ?.find((candidate) => candidate.ref === viewRef);
73
+ if (!chartView) {
74
+ throw new Error(`useResourceChartData: resource "${resourceType}" declares no chart view "${viewRef}".`);
75
+ }
76
+
77
+ const runtimeDescriptor = useMemo(
78
+ () => buildResolvedInsertedChartDescriptor({
79
+ identity: buildResourceInsertedChartIdentity(resourceType, { ref: viewRef }),
80
+ chartView,
81
+ contextResourceIdentifiers: contextResourceIdentifiers ?? {},
82
+ }),
83
+ [resourceType, viewRef, chartView, contextResourceIdentifiers],
84
+ );
85
+ const runtime = useResolvedChartRuntimeDescriptor({
86
+ surfaceDefinition: chartView,
87
+ runtimeDescriptor,
88
+ explicitContextResourceIdentifiers: contextResourceIdentifiers,
89
+ explicitInputs: inputs,
90
+ urlParamValues,
91
+ });
92
+
93
+ return useChartData(
94
+ runtime?.chartDefinition,
95
+ runtime?.executionChartRef,
96
+ runtime?.resolvedInputs,
97
+ runtime?.contextResourceIdentifiers,
98
+ urlParamValues,
99
+ localErrorOnly,
100
+ );
101
+ }
102
+ ```
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: views-composite-authoring
3
3
  description: Author composite view layouts — sections, embed primitives (host vs related), stable section refs, and the `ResourceCompositeViewsConfig` registration map. Use when the user says "add a section to the workspace view", "embed the chart inside the read page", "rearrange the composite layout", "add a composite that mixes related lists with charts", or any change to a composite's JSX or its config map. Different from `views-add-composite-view` (which scaffolds a new composite end-to-end).
4
+ user-invocable: false
4
5
  ---
5
6
 
6
7
  # Views Composite Authoring
@@ -184,7 +185,10 @@ function MetricsChartCell({ resourceType, viewRef }: { resourceType: string; vie
184
185
  export function TodoWorkspaceCompositeView(): React.ReactElement {
185
186
  return (
186
187
  <CompositeLayout>
187
- <Section name="tasks" appearance={SectionMode.GRID}>
188
+ {/* A titled section with NO frame: the embedded task list already draws its own card, and a framed
189
+ section around it read as a card inside a card. Neither section has a description: its spec
190
+ documents none, because "Tasks that support this todo" only restated the title. */}
191
+ <Section name="tasks" appearance={SectionMode.DEFAULT}>
188
192
  <EmbedRelatedResourceOperation
189
193
  resourceType={TasksManager_ResourceType.TASKS}
190
194
  operationLike={CoreResourceOperation.LIST}
@@ -3,14 +3,15 @@
3
3
  - **Section appearance — solo vs container (high-signal).** A section holding a
4
4
  SINGLE embedded surface (the common case) MUST use a **solo** appearance —
5
5
  `SectionMode.CARD`, `SectionMode.DEFAULT`, or `SectionMode.GHOST` — so it
6
- renders its own chrome (padded card + the section's title + description).
6
+ renders its own chrome (padded card + the section's title, and its description
7
+ when the spec documents one).
7
8
  **Container** modes (`GRID`, `TABS`, `COLUMNS`, `ACCORDION`, …) only receive
8
9
  chrome when the layout host *groups* sibling `<Section>`s, and grouping only
9
10
  sees **direct** `<Section>` children of `<CompositeLayout>`. A `<Section>`
10
11
  returned by a **custom component** (e.g. one that calls a hook to build the
11
12
  embed context, like a `…Section` wrapper around `EmbedResourceOperation`) is
12
13
  invisible to grouping — a container mode there renders **bare**: no card, no
13
- padding, and it silently drops the authored title + description. The dev build
14
+ padding, and it silently drops the authored title (and description). The dev build
14
15
  warns `[Section] container-mode section "…" (appearance="…") is rendering
15
16
  ungrouped`. Rule of thumb: **one embed per section → solo mode**; reserve
16
17
  container modes for grouping multiple sibling sections written as direct
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: views-execution-authoring
3
3
  description: Author execution views — host components, anchor binding, parent-resource requirements, and the typed `resourceExecutionView` factory wired into a resource's `executionViews:{}` map. Use when the user says "embed an execution monitor in the read page", "add an execution view scoped to the parent todo", "wire the execution host with the right anchor", "change which operations the execution view surfaces in", or any execution-view authoring or wiring change.
4
+ user-invocable: false
4
5
  ---
5
6
 
6
7
  # Views Execution Authoring
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: website-anonymous-session
3
3
  description: Configure or debug an anonymous marketing-site session that can safely hand off into an application experience. Use when the user says "wire anonymous session on the marketing site", "share a session between website and app", "debug anonymous-session handoff", or "configure the anonymous-session cookie".
4
+ user-invocable: false
4
5
  ---
5
6
 
6
7
  # Website Anonymous Session
@@ -94,10 +95,10 @@ person or bypass a normal authentication decision.
94
95
  ```tsx
95
96
  *
96
97
  * `WebsiteRuntimeContext` — site-wide runtime state for the marketing
97
- * surface. Created **once per page render** by the host adapter
98
- * (Phase 5 `WebsitePageBridge.astro` reads `WebsiteRootConfig` and the
99
- * resolved label pack from disk and calls
100
- * `<WebsiteRuntimeContextProvider value={…}>` around the page tree).
98
+ * surface. Created **once per page render** by the host adapter: the
99
+ * page's `.astro` frontmatter loads the site context and the resolved label
100
+ * pack, and its bridge island (`createWebsitePageBridgeIsland`) calls
101
+ * `<WebsiteRuntimeContextProvider value={…}>` around the page tree.
101
102
  *
102
103
  * **Why "runtime" and not "config"**: the values here are the
103
104
  * locale-resolved subset of `WebsiteRootConfig` — only the active
@@ -234,6 +235,14 @@ export interface WebsiteRuntimeContextValue {
234
235
  * catalog for analytics / captcha / browser-monitoring slices.
235
236
  */
236
237
  frontendProviderRegistry?: FrontendWebsiteProviderRegistry;
238
+ /**
239
+ * Components the live providers contribute, keyed `capability:providerRef` (#1703) — the same
240
+ * registry the application builds, from the same `components` declaration. Built by the page bridge
241
+ * once per island from `frontendProviderRegistry`; read through `useWebsiteProviderComponent` and
242
+ * rendered by `WebsiteProviderComponent`. Optional for the same reason as the registry above: a
243
+ * provider-free site, or a test runtime, has none, and every slot then renders nothing.
244
+ */
245
+ providerComponentRegistry?: WebsiteProviderComponentRegistry;
237
246
  /**
238
247
  * Replaces the framework's visitor consent panel (#534). Reads `useWebsiteConsent()`; see
239
248
  * `WebsiteConsentBanner` for the three properties a replacement must keep. Absent uses the default.
@@ -255,6 +264,17 @@ export interface WebsiteRuntimeContextValue {
255
264
  * silently failing to submit.
256
265
  */
257
266
  apiOrigin?: string;
267
+ /**
268
+ * The application's public pricing catalogue (#1835), derived at build time from the billing
269
+ * catalogue the backend sells from — so a pricing section states the prices the application
270
+ * actually charges instead of a hand copy of them. Node-loaded
271
+ * (`loadWebsitePricingCatalog` on `/config-loader`) and carried as an island prop for the
272
+ * reason `appOrigin` above is. Read it with `useWebsitePricingCatalog()`.
273
+ *
274
+ * Optional because only pricing pages need it; a section that reads it on a page that did not
275
+ * pass it fails loudly rather than rendering no plans.
276
+ */
277
+ pricingCatalog?: PublicPricingCatalog;
258
278
  }
259
279
 
260
280
  /**
@@ -307,7 +327,8 @@ WebsiteRuntimeContextProvider.displayName = 'WebsiteRuntimeContextProvider';
307
327
  * `WebsiteRootConfig` (page registry, design tokens, navigation chrome,
308
328
  * site-level SEO branding) with the per-service `WildoMarketingWebsiteConfig`
309
329
  * loaded from `wildo.website.config.ts` (locales, default locale,
310
- * public origin, future `appOrigin` cross-origin handoff target).
330
+ * public origin, and the `appOrigin` / `apiOrigin` the site reaches the
331
+ * product through — settled for THIS build by `loadWebsiteSiteContext`).
311
332
  *
312
333
  * # Why a dedicated aggregator type (vs. threading both raw configs)
313
334
  *
@@ -381,7 +402,9 @@ export interface WebsiteSiteContext {
381
402
  * The per-service `WildoMarketingWebsiteConfig` loaded from
382
403
  * `wildo.website.config.ts`. Single source of truth for the
383
404
  * marketing-site ROUTING + ORIGIN surface (`defaultLocale`,
384
- * `locales`, `publicOrigin`, future `appOrigin`).
405
+ * `locales`, `publicOrigin`, `appOrigin`, `apiOrigin`). The two origins
406
+ * are the values for THIS build (override, local dev, authored — see
407
+ * `resolveWebsiteBuildOrigins`), which is why every page reads them here.
385
408
  */
386
409
  readonly websiteConfig: WildoMarketingWebsiteConfig;
387
410
  /**
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: website-blog-authoring
3
3
  description: Author marketing blog posts as per-locale MDX files (`src/content/blog/<locale>/<slug>.mdx`) with strict Zod-4 frontmatter validation, automatic `Article` Open Graph emission, and consumer-authored MDX tags (e.g. `<CTASection ref="post-cta" />`) bridged through `<WebsiteMdxProvider>`. Use when the user says "add a blog post", "publish an MDX article", "wire the blog adapter", "register a new MDX tag for blog posts", or "configure blog frontmatter".
4
+ user-invocable: false
4
5
  ---
5
6
 
6
7
  # Website Blog Authoring
@@ -395,8 +396,8 @@ the installed `BLOG_POSTING_CATALOG_ENTRY` contract
395
396
  `authorRef`).
396
397
  - **Optional**: `image`, `dateModified`, `wordCount`, `keywords`,
397
398
  `articleSection`, `inLanguage`, `publisher`, `description` —
398
- `recommendOptionals: true`, so missing fields trigger
399
- AEO-richness warnings (richer payloads earn richer AI citations).
399
+ `recommendOptionals: true`, so `wildo website audit` lists the missing ones as recommendations (information, never a finding, never failing `--strict`) — richer payloads earn
400
+ richer AI citations.
400
401
  - **Deprecated**: `dateCreated` (replaced by `datePublished`) —
401
402
  emitting it triggers a "use `datePublished` instead" warning.
402
403
 
@@ -1249,6 +1249,14 @@ export interface CreateWebsiteBlogPostBridgeIslandDeps {
1249
1249
  * Config sync emits a stable map, including an empty map when no providers are declared.
1250
1250
  */
1251
1251
  frontendProviderModules?: GeneratedWebsiteProviderModules;
1252
+ /**
1253
+ * Loaders for provider components an ENGINE provider module declares but cannot import (#1703) —
1254
+ * the website's facet-library door, the equivalent of the application's
1255
+ * `contributeProviderComponentLoaders`. A provider PACKAGE that ships its own component needs
1256
+ * nothing here: its module's `components[capability].load` is used. A DEPS entry because a loader
1257
+ * is a function, and island props are serialized.
1258
+ */
1259
+ providerComponentLoaders?: ReadonlyArray<ProviderComponentLoaderContribution>;
1252
1260
  /**
1253
1261
  * Per-slug map of compiled MDX bodies (each entry is a React
1254
1262
  * component — the `.default` export of the MDX module). Typically
@@ -1404,6 +1412,13 @@ export function createWebsiteBlogPostBridgeIsland(
1404
1412
  );
1405
1413
  }
1406
1414
 
1415
+ // After the missing-slug throw on purpose: that throw ends the render, so it never changes the
1416
+ // hook order of a render that completes, and the build-time error stays reachable.
1417
+ const { frontendProviderRegistry, providerComponentRegistry } = useWebsiteProviderRegistries({
1418
+ frontendProviders,
1419
+ frontendProviderModules: deps.frontendProviderModules,
1420
+ providerComponentLoaders: deps.providerComponentLoaders,
1421
+ });
1407
1422
  const runtimeValue: WebsiteRuntimeContextValue = {
1408
1423
  locale,
1409
1424
  defaultLocale,
@@ -1413,10 +1428,8 @@ export function createWebsiteBlogPostBridgeIsland(
1413
1428
  skipToMainContentLabelKey,
1414
1429
  appOrigin,
1415
1430
  ...(deps.consentBannerComponent !== undefined ? { consentBannerComponent: deps.consentBannerComponent } : {}),
1416
- frontendProviderRegistry: createFrontendWebsiteProviderRegistry({
1417
- entries: frontendProviders,
1418
- modules: deps.frontendProviderModules,
1419
- }),
1431
+ frontendProviderRegistry,
1432
+ providerComponentRegistry,
1420
1433
  };
1421
1434
  return (
1422
1435
  <WebsiteRuntimeContextProvider value={runtimeValue}>
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: website-bundle-discipline
3
3
  description: Discipline that keeps app-side marketing-website code bundle-safe — what to import (and what NOT to import) when authoring website primitive overrides, custom sections via `defineWebsiteSection`, page composition, label packs, or any code that lands in the Astro/React-island bundle. Use when the user says "the marketing site bundle exploded after I added X", "can I import something from saas-frontend-lib in my Hero section?", "where do I import locale enums on the website?", "I'm overriding WebsitePageLayout, can I pull a backend service from my override?", "is `axios` ok in my Astro middleware?", or any time bundle-size or import-discipline questions come up around the saas-website surface.
4
+ user-invocable: false
4
5
  ---
5
6
 
6
7
  # Website Bundle Discipline
@@ -28,9 +29,9 @@ the same bundle** — namely:
28
29
 
29
30
  - App-side L1 primitive overrides (e.g. `website/src/primitives/WebsiteButton.tsx`)
30
31
  - App-side L1.5 layout overrides (e.g. `website/src/layouts/WebsitePageLayout.tsx`)
31
- - App-side section authoring (`defineWebsiteSection`-built `*.section.tsx` files)
32
- - App-side page composition (`website/src/pages/*.tsx`, `*.astro`)
33
- - App-side label packs (`website/src/i18n/*.ts`)
32
+ - App-side section authoring (`defineWebsiteSection` calls in each page's `website/src/sections/<page>.sections.tsx`)
33
+ - App-side page composition (`website/src/pages/*.astro` routes, `website/src/pages-impl/*.page.tsx` / `*.bridge.tsx`)
34
+ - App-side label packs (`website/src/i18n/<locale>.json`)
34
35
  - App-side Astro middleware (`website/src/middleware/*.ts`) — SSR-tier, see below
35
36
 
36
37
  The split between **island-tier** (ships to the browser) and
@@ -50,9 +51,9 @@ ship as anchored JSDoc inlined below.
50
51
  |-----------------------------------------|----------------------------------------------------------------------|-----------|
51
52
  | L1 primitive overrides | `website/src/primitives/*.tsx` | Island |
52
53
  | L1.5 layout overrides | `website/src/layouts/{WebsitePageLayout,WebsiteSection}.tsx` | Island |
53
- | Sections (`defineWebsiteSection`) | `website/src/sections/<category>/*.section.tsx` | Island |
54
- | Page composition | `website/src/pages/*.tsx`, `website/src/pages/*.astro` | Island |
55
- | Label packs | `website/src/i18n/<page-ref>.<locale>.ts` | Island |
54
+ | Sections (`defineWebsiteSection`) | `website/src/sections/<page>.sections.tsx` | Island |
55
+ | Page composition | `website/src/pages-impl/*.page.tsx`, `*.bridge.tsx`; routes `website/src/pages/*.astro` | Island |
56
+ | Label packs | `website/src/i18n/<locale>.json` | Island |
56
57
  | Astro middleware (SSR-only) | `website/src/middleware/*.ts` | SSR |
57
58
  | Installed boundary contract (reference) | source-backed bundle-isolation reference | — |
58
59
 
@@ -284,29 +285,14 @@ const ALLOWED_BARE_SPECIFIERS: ReadonlySet<string> = new Set([
284
285
  * `FORBIDDEN_SPECIFIERS`.
285
286
  */
286
287
  '@wildo-ai/zod-decorators',
287
- /**
288
- * SSR / Astro-middleware tier. These four specifiers support server-side code paths
289
- * the marketing engine genuinely needs:
290
- * - `axios` — outbound HTTP from Astro middleware (proxy to
291
- * the SaaS backend, contact-form forwarding, webhook fan-out).
292
- * - `jsonwebtoken` — verify cross-frontend handoff JWTs in
293
- * middleware before letting a request reach a logged-in surface.
294
- * - `socket.io-client` — real-time push (e.g. live preview / status
295
- * events from the SaaS app to the marketing site).
296
- * - `reflect-metadata` — decorator metadata runtime; required
297
- * by any future build-time consumer of `@wildo-ai/zod-decorators`
298
- * metadata (the import IS side-effecting — it mutates
299
- * `globalThis.Reflect`; that side effect is acceptable in an
300
- * SSR context but would still be objectionable in a React
301
- * island bundle).
302
- * Allowing them here is a deliberate trade-off: this test no
303
- * longer guarantees a hard browser-bundle size budget on its own.
304
- * Application import discipline keeps the React-island side lean.
288
+ /*
289
+ * `axios`, `jsonwebtoken`, `socket.io-client` and `reflect-metadata` were allowed here from
290
+ * 2026-04-19 for an SSR middleware tier (backend proxying, handoff-JWT verification, live push)
291
+ * that was never built. Removed 2026-09-25: no source in this package imports any of them, and an
292
+ * allow-list wider than the code is a door nothing guards — the next import of one would pass
293
+ * this test unexamined. The tier that does exist (contact forms, anonymous sessions, consent
294
+ * recording) uses `fetch`. Re-add a specifier in the change that first imports it.
305
295
  */
306
- 'axios',
307
- 'jsonwebtoken',
308
- 'socket.io-client',
309
- 'reflect-metadata',
310
296
  /**
311
297
  * SSR / Astro-build-time tier. The
312
298
  * `astro.ts` sub-entry exposes the label-pack loader, which
@@ -394,6 +380,15 @@ a 200 KB regression in production.
394
380
  | Real-time push (live preview, status) | `socket.io-client` — SSR-tier preferred |
395
381
  | Decorator-metadata runtime polyfill | `reflect-metadata` — SSR-tier only (mutates `globalThis.Reflect`) |
396
382
 
383
+ **A provider's component is never imported by a website file.** A vendor
384
+ widget (an address lookup, a chat launcher) reaches the page through its
385
+ provider module's `components[capability].load`, a DYNAMIC `import()`
386
+ the registry calls only in the browser, and is mounted with
387
+ `<WebsiteProviderComponent>` from `@wildo-ai/saas-website`. A static
388
+ import of it from a section would put the vendor's code into every page's
389
+ initial bundle AND execute it during the Astro server render. The
390
+ `website-consent-gate-overrides` skill shows the slot.
391
+
397
392
  NEVER import from `@wildo-ai/saas-models` (root barrel),
398
393
  `@wildo-ai/presets-components-models` (root barrel),
399
394
  `@wildo-ai/saas-frontend-lib`, `@wildo-ai/saas-backend-lib`,
@@ -219,29 +219,14 @@ const ALLOWED_BARE_SPECIFIERS: ReadonlySet<string> = new Set([
219
219
  * `FORBIDDEN_SPECIFIERS`.
220
220
  */
221
221
  '@wildo-ai/zod-decorators',
222
- /**
223
- * SSR / Astro-middleware tier. These four specifiers support server-side code paths
224
- * the marketing engine genuinely needs:
225
- * - `axios` — outbound HTTP from Astro middleware (proxy to
226
- * the SaaS backend, contact-form forwarding, webhook fan-out).
227
- * - `jsonwebtoken` — verify cross-frontend handoff JWTs in
228
- * middleware before letting a request reach a logged-in surface.
229
- * - `socket.io-client` — real-time push (e.g. live preview / status
230
- * events from the SaaS app to the marketing site).
231
- * - `reflect-metadata` — decorator metadata runtime; required
232
- * by any future build-time consumer of `@wildo-ai/zod-decorators`
233
- * metadata (the import IS side-effecting — it mutates
234
- * `globalThis.Reflect`; that side effect is acceptable in an
235
- * SSR context but would still be objectionable in a React
236
- * island bundle).
237
- * Allowing them here is a deliberate trade-off: this test no
238
- * longer guarantees a hard browser-bundle size budget on its own.
239
- * Application import discipline keeps the React-island side lean.
222
+ /*
223
+ * `axios`, `jsonwebtoken`, `socket.io-client` and `reflect-metadata` were allowed here from
224
+ * 2026-04-19 for an SSR middleware tier (backend proxying, handoff-JWT verification, live push)
225
+ * that was never built. Removed 2026-09-25: no source in this package imports any of them, and an
226
+ * allow-list wider than the code is a door nothing guards — the next import of one would pass
227
+ * this test unexamined. The tier that does exist (contact forms, anonymous sessions, consent
228
+ * recording) uses `fetch`. Re-add a specifier in the change that first imports it.
240
229
  */
241
- 'axios',
242
- 'jsonwebtoken',
243
- 'socket.io-client',
244
- 'reflect-metadata',
245
230
  /**
246
231
  * SSR / Astro-build-time tier. The
247
232
  * `astro.ts` sub-entry exposes the label-pack loader, which