@wildo-ai/framework-knowledge 1.1.11 → 1.1.12

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 (803) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
  3. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
  4. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
  5. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
  6. package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
  7. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
  8. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
  9. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
  10. package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
  11. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  12. package/dist/esm/framework-knowledge.definitions.js +170 -32
  13. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  14. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  15. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  16. package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
  17. package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
  18. package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
  19. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  20. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  21. package/dist/esm/index.d.ts.map +1 -1
  22. package/dist/esm/index.js.map +1 -1
  23. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
  24. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
  31. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  32. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
  35. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
  45. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
  47. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
  50. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
  52. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
  54. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +29 -3
  56. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +80 -16
  58. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  61. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
  62. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  63. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
  64. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  65. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
  66. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
  68. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  69. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  71. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
  72. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
  74. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
  76. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
  78. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  80. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
  81. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
  82. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  83. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
  84. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
  85. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
  86. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
  88. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  89. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  90. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
  91. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  92. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
  93. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  94. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
  95. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
  96. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
  99. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
  101. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  103. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
  104. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  105. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  106. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
  107. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  108. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
  109. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  110. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
  111. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
  113. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  114. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
  115. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  116. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
  117. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  118. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
  119. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
  121. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  122. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
  123. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  124. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
  125. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
  127. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  129. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
  130. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  131. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
  132. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  133. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
  134. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  135. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  136. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  137. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
  138. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  139. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
  140. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  141. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  142. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  143. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  144. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
  145. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  146. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  147. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  148. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
  149. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  150. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  151. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  153. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
  154. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  156. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
  157. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  158. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
  159. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  160. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
  161. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  162. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
  163. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  164. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
  165. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  166. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
  167. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  168. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
  169. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  170. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
  171. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
  172. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
  173. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
  174. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
  175. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  176. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
  177. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  178. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
  179. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  180. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
  181. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  182. package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
  183. package/dist/esm/source-anchor-grammar.js.map +1 -1
  184. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  185. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  186. package/dist/knowledge/manifest.json +7 -7
  187. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
  188. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
  189. package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
  190. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
  191. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  192. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  193. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
  194. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
  195. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
  196. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
  197. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
  198. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
  199. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
  200. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
  201. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
  202. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  203. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  204. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
  205. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
  206. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
  207. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
  208. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
  209. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +51 -7
  210. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
  211. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
  212. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +10 -2
  213. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
  214. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
  215. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
  216. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
  217. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
  218. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
  219. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
  220. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
  221. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
  222. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
  223. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
  224. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
  225. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
  226. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
  227. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
  228. package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
  229. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
  230. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
  231. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
  232. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  233. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  234. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
  235. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
  236. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
  237. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
  238. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
  239. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
  240. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
  241. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
  242. package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
  243. package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
  244. package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
  245. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
  246. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
  247. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
  248. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
  249. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
  250. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
  251. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
  252. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
  253. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
  254. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
  255. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
  256. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
  257. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
  258. package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
  259. package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
  260. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
  261. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
  262. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
  263. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
  264. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
  265. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
  266. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
  267. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
  268. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  269. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  270. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
  271. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +10 -6
  272. package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
  273. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
  274. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
  275. package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
  276. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
  277. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
  278. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
  279. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
  280. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
  281. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
  282. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
  283. package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
  284. package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
  285. package/dist/knowledge/references/application-maturity.config.md +27 -1
  286. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
  287. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
  288. package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
  289. package/dist/knowledge/references/brand.name-screening.config.md +30 -3
  290. package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
  291. package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
  292. package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
  293. package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
  294. package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
  295. package/dist/knowledge/references/companion.market.generation-service.md +46 -5
  296. package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
  297. package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
  298. package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
  299. package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
  300. package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
  301. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
  302. package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
  303. package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
  304. package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
  305. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
  306. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
  307. package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
  308. package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
  309. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
  310. package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
  311. package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
  312. package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
  313. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
  314. package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
  315. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
  316. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
  317. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
  318. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
  319. package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
  320. package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
  321. package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
  322. package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
  323. package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
  324. package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
  325. package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
  326. package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
  327. package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
  328. package/dist/knowledge/references/example.website.section.stats.md +1 -1
  329. package/dist/knowledge/references/experience-plan.config.md +111 -1
  330. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
  331. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
  332. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
  333. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
  334. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
  335. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
  336. package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
  337. package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
  338. package/dist/knowledge/references/integration-plan.config.md +7 -7
  339. package/dist/knowledge/references/placement-plan.config.md +19 -0
  340. package/dist/knowledge/references/platform.config.backing-services.md +9 -11
  341. package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
  342. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
  343. package/dist/knowledge/references/platform.config.infrastructure-host.md +0 -1
  344. package/dist/knowledge/references/platform.config.platform-key-management.md +84 -8
  345. package/dist/knowledge/references/platform.config.saas.md +20 -18
  346. package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
  347. package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
  348. package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
  349. package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
  350. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
  351. package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
  352. package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
  353. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +4 -4
  354. package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
  355. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +29 -2
  356. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
  357. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
  358. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
  359. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  360. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
  361. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
  362. package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
  363. package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
  364. package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
  365. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
  366. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
  367. package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
  368. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
  369. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
  370. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +363 -2
  371. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
  372. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
  373. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
  374. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
  375. package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
  376. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
  377. package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
  378. package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
  379. package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
  380. package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
  381. package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
  382. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
  383. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
  384. package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
  385. package/dist/knowledge/references/saas.frontend.chart-dashboard.md +130 -0
  386. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
  387. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
  388. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
  389. package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
  390. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
  391. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
  392. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
  393. package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
  394. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
  395. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
  396. package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
  397. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
  398. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
  399. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
  400. package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
  401. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
  402. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
  403. package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
  404. package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
  405. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
  406. package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
  407. package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
  408. package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
  409. package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
  410. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
  411. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
  412. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
  413. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
  414. package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
  415. package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
  416. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
  417. package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
  418. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
  419. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
  420. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
  421. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
  422. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
  423. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
  424. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
  425. package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
  426. package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
  427. package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
  428. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
  429. package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
  430. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
  431. package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
  432. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
  433. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
  434. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
  435. package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
  436. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
  437. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
  438. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
  439. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
  440. package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
  441. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
  442. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
  443. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
  444. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
  445. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
  446. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
  447. package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
  448. package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
  449. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
  450. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
  451. package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
  452. package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
  453. package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
  454. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
  455. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
  456. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
  457. package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
  458. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
  459. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
  460. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
  461. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
  462. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
  463. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
  464. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
  465. package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
  466. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
  467. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
  468. package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
  469. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
  470. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
  471. package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
  472. package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
  473. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
  474. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
  475. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
  476. package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
  477. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
  478. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
  479. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
  480. package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
  481. package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
  482. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
  483. package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
  484. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
  485. package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
  486. package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
  487. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
  488. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
  489. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
  490. package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
  491. package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
  492. package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
  493. package/dist/knowledge/references/service-method.config.md +35 -2
  494. package/dist/knowledge/references/vision.constraint.config.md +4 -2
  495. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
  496. package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
  497. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
  498. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
  499. package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
  500. package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
  501. package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
  502. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
  503. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
  504. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
  505. package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
  506. package/dist/knowledge/references/zod.factories.code.md +4 -4
  507. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  508. package/dist/knowledge/references/zod.factories.money.md +4 -4
  509. package/dist/knowledge/references/zod.factories.phone.md +4 -4
  510. package/dist/knowledge/references/zod.factories.year-month.md +79 -0
  511. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  512. package/dist/knowledge/registries/framework-topics.json +415 -2
  513. package/dist/knowledge/registries/playbooks.json +51 -39
  514. package/dist/knowledge/registries/source-tags.json +2412 -1604
  515. package/dist/knowledge/rules/database-migration-obligation.md +6 -7
  516. package/dist/knowledge/rules/live-context-door.md +1 -1
  517. package/dist/knowledge/skills/INDEX.md +3 -1
  518. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
  519. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
  520. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
  521. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
  522. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
  523. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
  524. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
  525. package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
  526. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
  527. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
  528. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
  529. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
  530. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
  531. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
  532. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
  533. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
  534. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  535. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
  536. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
  537. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
  538. package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
  539. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
  540. package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
  541. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
  542. package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
  543. package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +79 -0
  544. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
  545. package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
  546. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
  547. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
  548. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
  549. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
  550. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
  551. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
  552. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
  553. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
  554. package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
  555. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
  556. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
  557. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
  558. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
  559. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
  560. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
  561. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
  562. package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
  563. package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
  564. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
  565. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
  566. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
  567. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
  568. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
  569. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +197 -9
  570. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
  571. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
  572. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
  573. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
  574. package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
  575. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
  576. package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
  577. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
  578. package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
  579. package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
  580. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
  581. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
  582. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
  583. package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
  584. package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +61 -0
  585. package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
  586. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
  587. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
  588. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
  589. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
  590. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
  591. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +1 -1
  592. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
  593. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +18 -7
  594. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
  595. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
  596. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +44 -4
  597. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
  598. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
  599. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
  600. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
  601. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
  602. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +375 -8
  603. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
  604. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
  605. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
  606. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +1 -1
  607. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
  608. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
  609. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +1 -1
  610. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
  611. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
  612. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +3 -3
  613. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +37 -14
  614. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
  615. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
  616. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
  617. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
  618. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
  619. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
  620. package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
  621. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
  622. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
  623. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
  624. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
  625. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
  626. package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
  627. package/dist/knowledge/skills/infra-environment-config/SKILL.md +125 -77
  628. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
  629. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
  630. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +0 -1
  631. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +84 -8
  632. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
  633. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
  634. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
  635. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
  636. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
  637. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
  638. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
  639. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
  640. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
  641. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
  642. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
  643. package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
  644. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
  645. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
  646. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
  647. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
  648. package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
  649. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
  650. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
  651. package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
  652. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
  653. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
  654. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
  655. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
  656. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
  657. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
  658. package/dist/knowledge/skills/provider-backend-package/SKILL.md +255 -12
  659. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
  660. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
  661. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
  662. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
  663. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
  664. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
  665. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
  666. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
  667. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
  668. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
  669. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
  670. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
  671. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
  672. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
  673. package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
  674. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
  675. package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
  676. package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
  677. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
  678. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
  679. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
  680. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
  681. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
  682. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +33 -7
  683. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
  684. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
  685. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
  686. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +7 -2
  687. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
  688. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
  689. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
  690. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
  691. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
  692. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
  693. package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
  694. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
  695. package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
  696. package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
  697. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
  698. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
  699. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
  700. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
  701. package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
  702. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
  703. package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
  704. package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
  705. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
  706. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
  707. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
  708. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
  709. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
  710. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
  711. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
  712. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
  713. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
  714. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
  715. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
  716. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
  717. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
  718. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
  719. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
  720. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
  721. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
  722. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  723. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
  724. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
  725. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
  726. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
  727. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
  728. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
  729. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
  730. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
  731. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
  732. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
  733. package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
  734. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
  735. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
  736. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
  737. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
  738. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
  739. package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
  740. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
  741. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
  742. package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
  743. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
  744. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
  745. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
  746. package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
  747. package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
  748. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
  749. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
  750. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
  751. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
  752. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
  753. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
  754. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
  755. package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
  756. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
  757. package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
  758. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
  759. package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
  760. package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
  761. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
  762. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
  763. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  764. package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
  765. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
  766. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
  767. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
  768. package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
  769. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
  770. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
  771. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
  772. package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
  773. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
  774. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
  775. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
  776. package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
  777. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
  778. package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
  779. package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
  780. package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
  781. package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
  782. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
  783. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
  784. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
  785. package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
  786. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
  787. package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
  788. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
  789. package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
  790. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
  791. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
  792. package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
  793. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
  794. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
  795. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
  796. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
  797. package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
  798. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
  799. package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
  800. package/dist/knowledge/topic-index.json +2275 -715
  801. package/dist/tsconfig.build.tsbuildinfo +1 -1
  802. package/package.json +6 -6
  803. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -0,0 +1,244 @@
1
+ # `ChartDashboard` — charts from several resources on one page
2
+
3
+ A dashboard declared as data: tiles, each naming a resource and one of the chart views it
4
+ declares. Read this when you need to:
5
+
6
+ - build a home or overview page of charts that DIFFERENT resources own (cases by status beside
7
+ revenue by month beside SLA breaches by team);
8
+ - put KPI tiles (open cases, revenue this month, a completion rate) beside them;
9
+ - make a whole composite view that is only such a dashboard;
10
+ - decide what a viewer who may not read one of the resources sees.
11
+
12
+ ## What it does
13
+
14
+ - Each tile renders through `EmbedChart`: the chart's feature gate, the host composite's
15
+ organization scope, and a failure kept inside its own tile. The tile is headed by the chart
16
+ view's own title (the words its route and launcher use), so it needs no label of its own.
17
+ - A tile the viewer may not read is not drawn, and the grid closes up. "May read" is the role set
18
+ the backend's chart gate asks about: one of the default LIST roles of the chart's main resource
19
+ and of every resource it joins, narrowed by the chart's `accessControl.roles`. A dashboard the
20
+ viewer can read nothing of renders nothing.
21
+ - A role that reaches only SOME rows of a resource does not count: one the application confines to
22
+ its holder's own rows (`organizationOwnRows`) or to the rows they are assigned to
23
+ (`organizationAssignedRows`, every role but the declared organization-wide ones). A chart reads
24
+ every row in scope, so the backend refuses it to such a viewer rather than charting their rows,
25
+ and the dashboard hides the tile. To show a confined member their own figures, link them to the
26
+ resource's list, which the backend narrows to their rows.
27
+ - The grid follows its container: one column in a narrow pane, two from a medium one, four from a
28
+ wide one. `span: ChartDashboardTileSpan.TWO` gives a trend two columns; `FULL` a whole row.
29
+ - `columns` caps the grid. `ChartDashboardColumns.THREE` gives three narrow columns from a small
30
+ container, for a dashboard that shares its row with something else (a block of counters, a list);
31
+ `TWO` stops at two. A span applies only where the grid has that many columns, so a narrow pane
32
+ still stacks every tile.
33
+ - `rows: ChartDashboardTileRows.TWO` makes a tile two rows tall: a large chart beside two small ones
34
+ stacked. Order the tiles `[small, large, small]` so the second small one flows into the row under
35
+ the first. Give each tile the canvas `height` that fills its cell (a two-row tile is roughly two
36
+ small heights plus the gap).
37
+ - The charts themselves are unchanged: each is still a resource's `chartViews` entry, with its
38
+ `ChartDefinition` registered backend-side through the module's `chartDefinitions`. A tile naming
39
+ a chart view the resource does not declare is refused when it renders.
40
+
41
+ ## KPI tiles: a figure is a chart
42
+
43
+ A KPI tile (a count, a sum, a rate) is not a second mechanism. It is a chart of the resource whose
44
+ `chartType` is `ChartType.KPI`, placed on the dashboard like any other tile:
45
+
46
+ - its `dataQuery` declares NO dimension (`dimensions: []`), so the backend answers one row for the whole
47
+ scope, and an empty scope still answers one row (a count of 0, every other aggregate `null`);
48
+ - it declares exactly ONE series, whose `measureRef` names the figure (a measure, or a computed measure
49
+ such as `completed / total * 100`);
50
+ - `chartTypeConfig: { valueFormat: ChartKpiValueFormat.NUMBER | PERCENT, maximumFractionDigits?, showProgress? }`
51
+ says how the figure is written. `PERCENT` reads the value as already in percent units, and
52
+ `showProgress` draws a bar under it. Round where the figure is written (`maximumFractionDigits`),
53
+ not in the expression.
54
+
55
+ A filtered count is a measure with a `filter` (`{ status: { $in: [...] } }`). The tile is headed by its
56
+ chart view's title, hidden by the same gate as every chart, and takes the height of its figure (`height`
57
+ sizes only its loading placeholder). A rate over an organization with nothing in it shows no value, never
58
+ 0 %: the division by zero answers `null`.
59
+
60
+ The chart definition refuses the mixed shapes: a KPI with a dimension or two series, and any other chart
61
+ type with no dimension. The backend also refuses, at startup, a computed measure whose expression does not
62
+ parse, calls a function the engine does not provide, or reads a name that is not a measure, a dimension or an
63
+ earlier computed measure listed in its `dependsOn`.
64
+
65
+ ## Two ways to place it
66
+
67
+ - Inside a composite you write: `<ChartDashboard tiles={[…]} />` in a `<Section>` of your
68
+ `CompositeLayout`, beside the composite's other content.
69
+ - As the whole view: `defineChartDashboardView({ tiles: […], …composite config })` in the frontend
70
+ module's `compositeViews` map. The rest of the config (`icon`, `sectionRefs`,
71
+ `requiredFeatures`) is the composite view's own.
72
+
73
+ ## Source
74
+
75
+ ## Import Origins
76
+
77
+ - `@wildo-ai/saas-frontend-lib`
78
+
79
+ ## Source Excerpts
80
+
81
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
82
+
83
+ ```tsx
84
+ /** How many grid columns a dashboard tile spans, where the dashboard is wide enough to have them. */
85
+ export enum ChartDashboardTileSpan {
86
+ /** One column (the default): a donut, a bar of a few categories. */
87
+ ONE = 'one',
88
+ /** Two columns: a trend over time, a bar of many categories. One column where the dashboard has one. */
89
+ TWO = 'two',
90
+ /** The whole row: a long timeline, a wide table-like chart. */
91
+ FULL = 'full',
92
+ }
93
+
94
+ /** How many grid rows a dashboard tile spans, where the dashboard has more than one column. */
95
+ export enum ChartDashboardTileRows {
96
+ /** One row (the default). */
97
+ ONE = 'one',
98
+ /**
99
+ * Two rows: a large chart beside two smaller ones stacked in the next column. Place it right after the first
100
+ * small tile, so the second small tile flows into the row beneath the first: `[small, large (TWO rows), small]`.
101
+ */
102
+ TWO = 'two',
103
+ }
104
+
105
+ /**
106
+ * The most columns a dashboard's grid reaches, as its container widens. Every dashboard is one column in a narrow pane.
107
+ */
108
+ export enum ChartDashboardColumns {
109
+ /** Two columns from a medium container (42rem). */
110
+ TWO = 'two',
111
+ /**
112
+ * Three narrow columns from a small container (28rem): small charts beside a large one, in a dashboard that shares
113
+ * its row with something else (a block of counters, a list).
114
+ */
115
+ THREE = 'three',
116
+ /** Two columns from a medium container (42rem), four from a wide one (64rem). The default. */
117
+ FOUR = 'four',
118
+ }
119
+
120
+ /**
121
+ * One tile of a {@link ChartDashboard}: a chart a resource declares in its `chartViews`. A chart whose `chartType` is
122
+ * `ChartType.KPI` is a KPI tile: one figure under its title instead of a drawing.
123
+ */
124
+ export interface ChartDashboardTile {
125
+ /** The resource whose `chartViews` declares the chart. */
126
+ resourceType: string;
127
+ /** The chart view's `ref` on that resource (`InsertedChartDeclaration.ref`, usually `<chartDefinition>.ref`). */
128
+ chartViewRef: string;
129
+ /** Grid columns the tile spans. Default: {@link ChartDashboardTileSpan.ONE}. */
130
+ span?: ChartDashboardTileSpan;
131
+ /** Grid rows the tile spans. Default: {@link ChartDashboardTileRows.ONE}. */
132
+ rows?: ChartDashboardTileRows;
133
+ /**
134
+ * Chart canvas height in px (the canvas is sized by this, not by the tile). Default: 280 for a chart; a KPI tile takes
135
+ * the height of its figure, and this only sizes its loading placeholder (default 64).
136
+ */
137
+ height?: number;
138
+ }
139
+
140
+ export interface ChartDashboardProps {
141
+ /** The tiles, in reading order. Tiles may name charts of any number of resources. */
142
+ tiles: readonly ChartDashboardTile[];
143
+ /** The most columns the grid reaches. Default: {@link ChartDashboardColumns.FOUR}. */
144
+ columns?: ChartDashboardColumns;
145
+ className?: string;
146
+ }
147
+
148
+ /**
149
+ * Lays charts from several resources on one responsive grid: one column in a narrow pane, then up to `columns`
150
+ * ({@link ChartDashboardColumns}, four by default) as the container widens (container queries, so a dashboard in a
151
+ * split pane is laid out for the pane). A tile may span two columns or the whole row, and two rows.
152
+ *
153
+ * Each tile is headed by the chart view's own title (`views.chart.resources.<resourceType>.<ref>.title`, the words
154
+ * its route and launcher use) and drawn through `EmbedChart`: the chart's feature gate, the host composite's scope and
155
+ * a failure kept inside the tile. A tile whose chart the viewer may not read — the backend's aggregation gate would
156
+ * refuse it: no LIST role on its resource or on a resource it joins, or outside the chart's own `accessControl.roles`,
157
+ * or only a role confined there to its holder's own or assigned rows (a chart reads every row in scope) — is not drawn,
158
+ * and the grid closes up. A dashboard with nothing the viewer may read renders nothing.
159
+ *
160
+ * A KPI tile (a chart view whose chart is `ChartType.KPI`) shows one figure under that title, hidden by the same rule.
161
+ *
162
+ * Place it inside a composite view (`CompositeLayout`), or declare a whole view as one with
163
+ * {@link defineChartDashboardView}.
164
+ *
165
+ * @example
166
+ * ```tsx
167
+ * <ChartDashboard
168
+ * tiles={[
169
+ * { resourceType: R.TODOS, chartViewRef: todosByStatusChartDefinition.ref },
170
+ * { resourceType: R.TASKS, chartViewRef: todoTaskPriorityChartDefinition.ref },
171
+ * { resourceType: R.TODOS, chartViewRef: todosCreatedTimelineChartDefinition.ref, span: ChartDashboardTileSpan.TWO },
172
+ * ]}
173
+ * />
174
+ * ```
175
+ */
176
+ export function ChartDashboard({ tiles, columns = ChartDashboardColumns.FOUR, className }: ChartDashboardProps): React.JSX.Element | null {
177
+ const { registry } = useResourceRegistry();
178
+ const viewer = useViewerEffectiveRoles();
179
+ const visibleTiles = useMemo(
180
+ () => tiles.flatMap((tile) => {
181
+ const chartView = registry.resourceConfigurations[tile.resourceType]?.frontendConfiguration?.chartViews
182
+ ?.find((candidate) => candidate.ref === tile.chartViewRef);
183
+ // An unknown chart is an authoring error, and `EmbedChart` throws it with the resource and ref named.
184
+ if (chartView !== undefined && !viewerMayReadChart(chartView.chartDefinition, registry, viewer)) return [];
185
+ return [{ tile, isFigure: chartView?.chartDefinition.chartType === ChartType.KPI }];
186
+ }),
187
+ [tiles, registry, viewer],
188
+ );
189
+
190
+ if (visibleTiles.length === 0) return null;
191
+ const grid = GRID_CLASSES[columns];
192
+ return (
193
+ <div className={cn('@container w-full', className)} data-chart-dashboard>
194
+ <div className={cn('grid grid-cols-1 gap-group', grid.columns)}>
195
+ {visibleTiles.map(({ tile, isFigure }) => (
196
+ <ChartDashboardTileCell key={`${tile.resourceType}:${tile.chartViewRef}`} tile={tile} isFigure={isFigure} grid={grid} />
197
+ ))}
198
+ </div>
199
+ </div>
200
+ );
201
+ }
202
+ ```
203
+
204
+ ## Import Origins
205
+
206
+ - `@wildo-ai/saas-frontend-lib`
207
+
208
+ ## Source Excerpts
209
+
210
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
211
+
212
+ ```tsx
213
+ /**
214
+ * A whole composite view that is a chart dashboard, declared as data — register it under the frontend domain module's
215
+ * `compositeViews` like any app-level composite. The rest of the config is the composite view's
216
+ * own (`sectionRefs`, `icon`, `requiredFeatures`, …).
217
+ *
218
+ * @example
219
+ * ```ts
220
+ * compositeViews: {
221
+ * 'operations-dashboard': defineChartDashboardView({
222
+ * tiles: [
223
+ * { resourceType: R.CASES, chartViewRef: casesByStatusChart.ref },
224
+ * { resourceType: R.INVOICES, chartViewRef: revenueByMonthChart.ref, span: ChartDashboardTileSpan.TWO },
225
+ * { resourceType: R.SLA_BREACHES, chartViewRef: breachesByTeamChart.ref },
226
+ * ],
227
+ * }),
228
+ * }
229
+ * ```
230
+ */
231
+ export function defineChartDashboardView(
232
+ config: { tiles: readonly ChartDashboardTile[] } & Omit<CompositeViewAuthoringConfig, 'viewComponent'>,
233
+ ): CompositeViewAuthoringConfig {
234
+ const { tiles, ...compositeConfig } = config;
235
+ function ChartDashboardView(): React.JSX.Element {
236
+ return (
237
+ <CompositeLayout>
238
+ <ChartDashboard tiles={tiles} />
239
+ </CompositeLayout>
240
+ );
241
+ }
242
+ return defineCompositeView(ChartDashboardView, compositeConfig);
243
+ }
244
+ ```
@@ -305,6 +305,14 @@ export const ExecutionViewDefinitionSchema = z.object({
305
305
  * stripped wherever the definition is Zod-parsed.
306
306
  */
307
307
  icon: z.custom<IconLike>().optional(),
308
+
309
+ /**
310
+ * Zone geometry this view asks for when it is the PRIMARY destination — see
311
+ * {@link ResourceExecutionViewAuthoringConfig.zoneContentFillsHeight}. Declared on the schema as
312
+ * well as the interface so a parse of the compiled definition cannot strip the authored value.
313
+ */
314
+ zoneContentMaxWidth: z.enum(RESPONSIVE_MAX_WIDTH_VALUES).optional(),
315
+ zoneContentFillsHeight: z.boolean().optional(),
308
316
  });
309
317
 
310
318
  /**
@@ -344,6 +352,10 @@ export interface ExecutionViewDefinition {
344
352
  requiredFeatures?: RequiredFeaturesConfig;
345
353
  /** View icon (lucide component reference or StandardIconReference string) for launcher surfaces. */
346
354
  icon?: IconLike;
355
+ /** See {@link ResourceExecutionViewAuthoringConfig.zoneContentMaxWidth}. Mirrored from authoring. */
356
+ zoneContentMaxWidth?: ResponsiveMaxWidth;
357
+ /** See {@link ResourceExecutionViewAuthoringConfig.zoneContentFillsHeight}. Mirrored from authoring. */
358
+ zoneContentFillsHeight?: boolean;
347
359
  }
348
360
 
349
361
  export const EXECUTION_ROUTE_CONTEXT_QUERY_PARAM_PREFIX = 'execution_ctx_';
@@ -379,6 +391,34 @@ export interface ResourceExecutionViewAuthoringConfig {
379
391
  * resourceExecutionView(MyFlowView, { icon: ListChecks, surfaceInOperations: [Op.READ] });
380
392
  */
381
393
  icon: IconLike;
394
+ /**
395
+ * How wide this view's content may grow when it occupies the PRIMARY zone, in the framework's
396
+ * shared width vocabulary — the same `ResponsiveMaxWidth` a composite view declares.
397
+ *
398
+ * Omitted is `'content'`: capped and centred at the page-content width. A canvas whose value is the
399
+ * space it occupies declares `'none'`.
400
+ */
401
+ zoneContentMaxWidth?: ResponsiveMaxWidth;
402
+ /**
403
+ * Whether this view's content fills the PRIMARY zone's height as well.
404
+ *
405
+ * `true` makes the zone's content boundary a definite-height flex column, so the view's root can
406
+ * use `flex-1 min-h-0` and size a canvas against the zone instead of naming a pixel height. Ignored
407
+ * in an adjacent zone, which scrolls.
408
+ *
409
+ * It belongs HERE and not on the host operation: an execution view is its own destination, reached
410
+ * from a launcher on the record (and by deep link), so the host READ page never contains it and a
411
+ * declaration there cannot reach it (#1259).
412
+ *
413
+ * @example
414
+ * resourceExecutionView(MyFlowView, {
415
+ * icon: ListChecks,
416
+ * surfaceInOperations: [Op.READ],
417
+ * zoneContentMaxWidth: 'none',
418
+ * zoneContentFillsHeight: true,
419
+ * });
420
+ */
421
+ zoneContentFillsHeight?: boolean;
382
422
  }
383
423
 
384
424
  export type ResourceExecutionViewsConfig = Record<string, ResourceExecutionViewAuthoringConfig>;
@@ -106,20 +106,22 @@ the consumer's website module at these paths:
106
106
 
107
107
  ### Step 1: Wire the MDX integration once per site
108
108
 
109
- In `website/astro.config.ts`, register `mdx()`, then `websiteBlogReactMdx()` (from
109
+ Declare `@astrojs/mdx` and `@astrojs/markdown-remark` in `website/package.json` (Astro 7 no longer installs the
110
+ second; it carries the MDX compiler the posts are compiled with, and `websiteBlogReactMdx()` refuses with this remedy
111
+ when it is missing). Then, in `website/astro.config.ts`, register `mdx()`, then `websiteBlogReactMdx()` (from
110
112
  `@wildo-ai/saas-website/astro`), then `react()`:
111
113
 
112
114
  ```ts
113
115
  integrations: [mdx(), websiteBlogReactMdx(), react()],
114
116
  ```
115
117
 
116
- A post's body renders INSIDE the page's React island, and `@astrojs/mdx` compiles an `.mdx` file to Astro JSX, which
118
+ A post's body renders INSIDE the page's React island, and `@astrojs/mdx` compiles an `.mdx` file for Astro, which
117
119
  React cannot render: without the second integration every post page shows its header and no body. The integration
118
120
  compiles for React only the imports the bridges make with the query `?website-react-mdx` (Step 5); the content
119
121
  collection keeps using the plain `.mdx` id. It also tells Vite to optimize `@mdx-js/react` at startup, which the
120
122
  dependency scan cannot see.
121
123
 
122
- It compiles them with the MDX compiler `@astrojs/mdx` already ships and exactly two remark plugins, `remark-gfm`
124
+ It compiles them with the MDX compiler `@astrojs/markdown-remark` ships and exactly two remark plugins, `remark-gfm`
123
125
  (tables, task lists, autolinks) and `remark-smartypants` (typographic quotes). Nothing else of the site's Markdown
124
126
  setup reaches a post body: the site's own remark and rehype plugins do not apply, and neither do Astro's defaults —
125
127
  no Shiki code highlighting, no heading ids. Style code blocks, and give headings an anchor if a post needs one, in
@@ -127,7 +129,7 @@ the components `BLOG_POST_MDX_COMPONENTS` maps (Step 4).
127
129
 
128
130
  In `website/src/content.config.ts`, define the `blog` collection by
129
131
  spreading `buildBlogPostCollectionConfig({ astroZ: z, glob })` — `z` from
130
- `astro:content`, `glob` from `astro/loaders`. The engine supplies the
132
+ `astro/zod` (the `astro:content` re-export is deprecated), `glob` from `astro/loaders`. The engine supplies the
131
133
  content-layer LOADER (every `src/content/blog/<locale>/*.mdx`, each id'd by
132
134
  its path) and the schema (a passthrough record; the strict Zod-4
133
135
  validation runs at render time inside `<BlogPost>`). Never write
@@ -190,7 +192,7 @@ exports a single `BlogPostXxBridgeIsland` built from
190
192
  (the pattern AND the options MUST be literals — Vite parses them AST-side at build time, so the query is written
191
193
  out rather than imported; `WEBSITE_REACT_MDX_QUERY`, exported from `@wildo-ai/saas-website/mdx`, names the same
192
194
  string for code that inspects a module id, and cannot stand in for the literal here). Without the query the glob
193
- imports `@astrojs/mdx`'s Astro-JSX module, which the React island cannot render;
195
+ imports `@astrojs/mdx`'s Astro module, which the React island cannot render;
194
196
  - `frontendProviderModules` — the site's generated provider modules, as every page bridge passes them;
195
197
  - `navigation: { headerComponent: HeaderComponent, footerComponent: FooterComponent }`, imported directly (the root config's graph would pull every page into this island);
196
198
  - `mdxComponents: BLOG_POST_MDX_COMPONENTS`.
@@ -706,7 +708,7 @@ rg -n "resolveWebsiteBlogPostCover\(frontmatter\)|cover=\{cover\}" website/src/p
706
708
 
707
709
  | Rationalization | Reality |
708
710
  |---|---|
709
- | "I'll author the frontmatter Zod schema directly in `src/content.config.ts` instead of using `buildBlogPostCollectionConfig`" | Two sources of truth that silently drift on every field change. Astro's bundled `z` is Zod 3 and cannot share schema instances with the engine's Zod 4 — passthrough at the collection layer + strict Zod 4 at render time is the deliberate single-source-of-truth posture. |
711
+ | "I'll author the frontmatter Zod schema directly in `src/content.config.ts` instead of using `buildBlogPostCollectionConfig`" | Two sources of truth that silently drift on every field change, and the collection sees an unquoted YAML timestamp as a `Date` where the engine's schema takes the ISO string — passthrough at the collection layer + strict Zod 4 at render time is the deliberate single-source-of-truth posture. |
710
712
  | "I'll style the post page from scratch in the site stylesheet: the article width, the title, the table" | The engine already draws all of it from the theme, so a full restyle only creates a second copy that drifts from the tokens. Write only what this site reads differently, against the post's hooks (Step 7b). |
711
713
  | "I'll use one bridge module that globs ALL locales together" | Conflates the per-route island bundle (an FR visitor downloads the EN MDX bodies for no reason) AND removes the locale-clean separation `getStaticPaths` already enforces. Per-locale bridges keep the route bundle tight + match the per-locale `[slug].astro` shell shape. |
712
714
  | "I'll pass `mdxComponents` as an island prop instead of closing it over in the bridge factory" | The map values are `ComponentType` references — Astro's hydration boundary serializes props to JSON, and a `ComponentType` cannot survive serialization. Closing over them at module load time inside the factory is the only valid shape. |
@@ -61,8 +61,8 @@ export const WEBSITE_BLOG_CONTENT_PATTERN = '*/*.mdx';
61
61
  * - `locale` — REQUIRED. The post's locale. Drives the URL prefix
62
62
  * (`/<locale>/blog/<slug>`) and `<html lang>`. Cross-locale
63
63
  * correspondence is established by sharing the `slug` across
64
- * per-locale MDX files (e.g. `en/why-context.md` and
65
- * `fr/why-context.md` are the same post in two locales).
64
+ * per-locale MDX files (e.g. `en/why-context.mdx` and
65
+ * `fr/why-context.mdx` are the same post in two locales).
66
66
  * - `publishedAt` — REQUIRED. ISO-8601 date-time string. Renders into
67
67
  * `og:article:published_time` and the listing-card date label.
68
68
  * Stored as string (not `z.coerce.date`) because YAML frontmatter
@@ -355,7 +355,7 @@ export async function resolveWebsiteBlogPostCover(
355
355
  // The measurement is shared by every post naming this file, so its error names the file and each post adds itself.
356
356
  throw new Error(
357
357
  `[blog-post-cover] The cover "${src}" of post "${frontmatter.slug}" (${frontmatter.locale}): ` +
358
- `${error instanceof Error ? error.message : String(error)}`,
358
+ `${describeCaughtError(error)}`,
359
359
  );
360
360
  }
361
361
  return { src, width: size.width, height: size.height };
@@ -431,8 +431,8 @@ every other section uses.
431
431
  *
432
432
  * The `createWebsitePageBridgeIsland` factory takes a `PageComponent`
433
433
  * — a React component the page author writes. A blog post has NO React
434
- * component; the MDX file IS the component (compiled by `@astrojs/mdx`
435
- * to a default-export React tree). Reusing the page-bridge factory
434
+ * component; the MDX file IS the component (compiled to a default-export
435
+ * React tree by `websiteBlogReactMdx()`). Reusing the page-bridge factory
436
436
  * would force the consumer to write a ten-line wrapper per post that
437
437
  * imports the MDX module, calls `<MdxBody />`, and re-passes the
438
438
  * frontmatter — a cold violation of the "every blog post is one MDX
@@ -797,8 +797,8 @@ WebsiteMdxProvider.displayName = 'WebsiteMdxProvider';
797
797
 
798
798
  ## `buildBlogPostCollectionConfig` + `parseBlogPostFrontmatter`
799
799
 
800
- The bridge between Astro's bundled Zod 3 (in `astro:content`)
801
- and the engine's canonical Zod 4 schema. The collection layer
800
+ The bridge between Astro's content collection and the engine's
801
+ canonical Zod 4 schema. The collection layer
802
802
  accepts any frontmatter (passthrough); the strict validation runs
803
803
  synchronously at render time inside `<BlogPost>` (and at build time
804
804
  inside `getStaticPaths` for typed locale/slug filtering — same
@@ -816,25 +816,28 @@ schema, no double source of truth).
816
816
  *
817
817
  * Astro content-collection bridge for blog posts.
818
818
  *
819
- * # The Zod-version bridge problem
820
- *
821
- * Astro's `astro:content` ships its own bundled Zod (currently 3.x).
822
- * Our `BlogPostFrontmatterSchema` is Zod 4 and uses Zod-4-only APIs
823
- * (`z.iso.datetime`, `z.url(...)`, `.brand<>()`). The two cannot share
824
- * a schema instance directly across the version boundary, and shimming
825
- * a Zod 4 schema down to a Zod 3 schema would create either:
826
- *
827
- * - a hand-mirrored copy — maintained in `src/content.config.ts`
828
- * using Astro's `z`, with silent-drift risk every time a field is
829
- * added/removed/refined; or
830
- * - a runtime bridge package — a non-trivial maintenance
831
- * surface for a marginal gain.
832
- *
833
- * This file sidesteps the bridge entirely: the consumer's
834
- * `src/content.config.ts` declares a `passthrough` collection schema
835
- * that lets Astro accept any frontmatter shape; the engine then
836
- * validates with the canonical Zod 4 schema at render time inside
837
- * `<BlogPost>`. Astro's static site generator runs the page render
819
+ * # Why the collection accepts any frontmatter
820
+ *
821
+ * This design was born when Astro's `astro:content` bundled Zod 3 and
822
+ * our `BlogPostFrontmatterSchema` was already Zod 4, so the two could
823
+ * not share a schema. That boundary is gone: since Astro 6 the `z`
824
+ * Astro hands a collection is Zod 4 (`import { z } from 'astro/zod'`;
825
+ * the `astro:content` re-export is deprecated and leaves in Astro 8).
826
+ * The passthrough stays for two reasons that still hold on Astro 7:
827
+ *
828
+ * - the collection layer sees frontmatter as Astro's YAML 1.1 parser
829
+ * delivers it, so an unquoted `publishedAt` arrives as a `Date`
830
+ * where the canonical schema takes the ISO string the author wrote
831
+ * (`withYamlTimestampsAsIsoStrings` below reconciles the two before
832
+ * the strict parse);
833
+ * - one validation site, with one error format (`[blog-post]` plus
834
+ * the file), rather than a second copy of the rules in
835
+ * `src/content.config.ts` that drifts each time a field changes.
836
+ *
837
+ * So the consumer's `src/content.config.ts` declares a `passthrough`
838
+ * collection schema that lets Astro accept any frontmatter shape; the
839
+ * engine then validates with the canonical Zod 4 schema at render time
840
+ * inside `<BlogPost>`. Astro's static site generator runs the page render
838
841
  * during the build, so a malformed frontmatter still surfaces as a
839
842
  * BUILD-TIME error (the `.parse()` call throws synchronously and Astro
840
843
  * reports it with the page URL) — the only practical difference from a
@@ -843,9 +846,10 @@ schema, no double source of truth).
843
846
  * # Why the engine ships an opaque shape (rather than the consumer
844
847
  * importing the Astro `z` directly)
845
848
  *
846
- * Astro's content-collection API has churned across Astro 4 → 5
849
+ * Astro's content-collection API has churned across Astro 4 → 5 → 6
847
850
  * (loaders moved from string-keyed `type` to a callable `loader`
848
- * factory; the `glob()` loader's signature changed). Every consumer
851
+ * factory; the `glob()` loader's signature changed; `z` moved to
852
+ * `astro/zod`). Every consumer
849
853
  * touching `defineCollection` directly inherits that churn; centralizing
850
854
  * the wiring in the engine means the framework absorbs the upgrade
851
855
  * cost in ONE place when Astro bumps a major.
@@ -856,8 +860,9 @@ schema, no double source of truth).
856
860
  *
857
861
  * ```ts
858
862
  * // website/src/content.config.ts
859
- * import { defineCollection, z } from 'astro:content';
863
+ * import { defineCollection } from 'astro:content';
860
864
  * import { glob } from 'astro/loaders';
865
+ * import { z } from 'astro/zod';
861
866
  * import { buildBlogPostCollectionConfig } from '@wildo-ai/saas-website/mdx';
862
867
  *
863
868
  * export const collections = {
@@ -866,9 +871,9 @@ schema, no double source of truth).
866
871
  * ```
867
872
  *
868
873
  * The consumer passes Astro's own `z` and `glob` in, because the engine
869
- * cannot import `astro:content` (a virtual module that only exists inside
870
- * the Astro build) nor `astro/loaders` (it would pull `astro` into the
871
- * engine's walked closure, which the bundle-isolation test forbids). The
874
+ * cannot import `astro/zod` nor `astro/loaders` (either would pull
875
+ * `astro` into the engine's walked closure, which the bundle-isolation
876
+ * test forbids, and `astro` is an optional peer the engine never loads). The
872
877
  * engine builds the passthrough schema and the loader from them.
873
878
  *
874
879
  * **The upgrade this exists for happened (#2570).** The recipe used to be a
@@ -904,9 +909,9 @@ schema, no double source of truth).
904
909
 
905
910
  /**
906
911
  * Minimal contract for the Astro-side Zod factory we accept. Typed
907
- * structurally (rather than imported from `astro:content`) so the
912
+ * structurally (rather than imported from `astro/zod`) so the
908
913
  * engine package can compile/test without an Astro install. Astro's
909
- * actual `z.object` returns a much richer Zod-3 schema; we narrow to
914
+ * actual `z.object` returns a full Zod 4 object schema; we narrow to
910
915
  * just the `.passthrough()` call we make below.
911
916
  */
912
917
  export interface AstroZodFactoryShape {
@@ -936,11 +941,10 @@ export function blogPostEntryId(entry: string): string {
936
941
 
937
942
  export interface BuildBlogPostCollectionConfigOptions {
938
943
  /**
939
- * Astro's bundled `z` object — pass `import { z } from 'astro:content'`
940
- * from the consumer-side `src/content.config.ts`. The engine cannot
941
- * import `astro:content` itself (virtual module, only present inside
942
- * the Astro build pipeline; would also bloat the bundle-isolation
943
- * walked closure with the `astro` runtime).
944
+ * Astro's `z` object — pass `import { z } from 'astro/zod'` from the
945
+ * consumer-side `src/content.config.ts`. The engine cannot import it
946
+ * itself (it would bring the `astro` runtime into the bundle-isolation
947
+ * walked closure, and `astro` is an optional peer).
944
948
  */
945
949
  astroZ: AstroZodFactoryShape;
946
950
  /** Astro's `glob` loader factory — pass `import { glob } from 'astro/loaders'`. */
@@ -1876,16 +1880,21 @@ export function createWebsiteBlogPostBridgeIsland(
1876
1880
  * query-suffixed id does not match), so the content collection, its frontmatter and `render()` are
1877
1881
  * untouched.
1878
1882
  *
1879
- * The compiler is the one `@astrojs/mdx` already ships (`@mdx-js/mdx`), resolved from the site's own
1880
- * `@astrojs/mdx` so the site takes no second MDX dependency to keep in step, with the two remark plugins
1881
- * `@astrojs/mdx` applies by default: `remark-gfm` (tables, task lists, autolinks) and `remark-smartypants`
1882
- * (typographic quotes). Nothing else from the site's Markdown setup reaches a post's island body: the site's
1883
- * own remark and rehype plugins, and Astro's rehype defaults (Shiki code highlighting, heading ids), do not
1884
- * apply. Style code blocks and link headings in the post's components rather than relying on them.
1883
+ * The compiler is MDX's own (`@mdx-js/mdx`), resolved through the site's `@astrojs/markdown-remark`, Astro's
1884
+ * unified Markdown package, so the site takes no second MDX dependency to keep in step. Since Astro 7,
1885
+ * `@astrojs/mdx` renders with Sätteri, Astro's native pipeline, and no longer carries `@mdx-js/mdx`; the unified
1886
+ * compiler and its plugins live in `@astrojs/markdown-remark`, which Astro 7 no longer installs by default. So a
1887
+ * site with a blog declares `@astrojs/markdown-remark` beside `@astrojs/mdx` (a version on the range Astro's own
1888
+ * peer declaration names). The two remark plugins applied are the ones `@astrojs/markdown-remark` ships:
1889
+ * `remark-gfm` (tables, task lists, autolinks) and `remark-smartypants` (typographic quotes). Nothing else from
1890
+ * the site's Markdown setup reaches a post's island body: the site's own remark and rehype plugins, and Astro's
1891
+ * rehype defaults (Shiki code highlighting, heading ids), do not apply. Style code blocks and link headings in
1892
+ * the post's components rather than relying on them.
1885
1893
  *
1886
- * Add it beside `mdx()` and `react()`:
1894
+ * Add it beside `mdx()` and `react()`, and declare both Markdown packages in the website's `package.json`:
1887
1895
  *
1888
1896
  * @example
1897
+ * // package.json: "@astrojs/mdx", "@astrojs/markdown-remark" (and "@astrojs/react")
1889
1898
  * // astro.config.ts
1890
1899
  * integrations: [mdx(), websiteBlogReactMdx(), react()],
1891
1900
  *
@@ -1940,27 +1949,29 @@ function defaultExport(module: unknown): unknown {
1940
1949
  }
1941
1950
 
1942
1951
  /**
1943
- * The MDX compiler and the two Markdown plugins Astro's own MDX compile uses, resolved through the site's
1944
- * `@astrojs/mdx`. Refuses with the remedy when the site has no `@astrojs/mdx`: a blog needs it anyway, for
1945
- * its content collection.
1952
+ * The MDX compiler and the two remark plugins Astro's unified Markdown pipeline applies, resolved through the
1953
+ * site's `@astrojs/markdown-remark` (Astro 7 moved them there from `@astrojs/mdx`, #3500). Refuses with the remedy
1954
+ * when the site has none: Astro 7 stopped installing it by default, so a site upgraded from Astro 6 meets this
1955
+ * first.
1946
1956
  */
1947
1957
  async function loadCompiler(siteRoot: URL): Promise<{ compiler: MdxCompilerModule; remarkPlugins: unknown[] }> {
1948
1958
  const fromSite = createRequire(new URL('package.json', siteRoot));
1949
- let astroMdxManifest: string;
1959
+ let markdownRemarkEntry: string;
1950
1960
  try {
1951
- astroMdxManifest = fromSite.resolve('@astrojs/mdx/package.json');
1961
+ markdownRemarkEntry = fromSite.resolve('@astrojs/markdown-remark');
1952
1962
  } catch {
1953
1963
  throw new Error(
1954
- `[saas-website] websiteBlogReactMdx() needs @astrojs/mdx, resolved from ${fileURLToPath(siteRoot)}. `
1955
- + 'Install it in the website package and add mdx() to its integrations: the blog content collection needs it too.',
1964
+ `[saas-website] websiteBlogReactMdx() needs @astrojs/markdown-remark, resolved from ${fileURLToPath(siteRoot)}. `
1965
+ + 'Astro 7 no longer installs it, and it carries the MDX compiler a post is compiled with: add it to the website '
1966
+ + 'package beside @astrojs/mdx, and add mdx() to its integrations: the blog content collection needs it too.',
1956
1967
  );
1957
1968
  }
1958
- const fromAstroMdx = createRequire(astroMdxManifest);
1959
- const importFromAstroMdx = (specifier: string): Promise<unknown> => import(fromAstroMdx.resolve(specifier));
1969
+ const fromMarkdownRemark = createRequire(markdownRemarkEntry);
1970
+ const importFromMarkdownRemark = (specifier: string): Promise<unknown> => import(fromMarkdownRemark.resolve(specifier));
1960
1971
  const [compiler, remarkGfm, remarkSmartypants] = await Promise.all([
1961
- importFromAstroMdx('@mdx-js/mdx'),
1962
- importFromAstroMdx('remark-gfm'),
1963
- importFromAstroMdx('remark-smartypants'),
1972
+ importFromMarkdownRemark('@mdx-js/mdx'),
1973
+ importFromMarkdownRemark('remark-gfm'),
1974
+ importFromMarkdownRemark('remark-smartypants'),
1964
1975
  ]);
1965
1976
  return {
1966
1977
  compiler: compiler as MdxCompilerModule,
@@ -2051,7 +2062,7 @@ The query the bridges write as a literal (`WEBSITE_REACT_MDX_QUERY`, exported fr
2051
2062
  * @example
2052
2063
  * const rawModules = import.meta.glob('../content/blog/en/*.mdx', { eager: true, query: '?website-react-mdx' });
2053
2064
  *
2054
- * A bridge that omits it imports `@astrojs/mdx`'s module instead, compiled to Astro JSX, which a React island cannot
2065
+ * A bridge that omits it imports `@astrojs/mdx`'s module instead, compiled for Astro rather than React, which a React island cannot
2055
2066
  * render (React refuses the object it returns as a child; see `websiteBlogReactMdx`). The constant names the literal
2056
2067
  * for code that checks a module id; it cannot stand in for the literal in the glob itself.
2057
2068
  */
@@ -37,7 +37,7 @@ following the theme, the motion vocabulary and every later fix.
37
37
  |---|---|
38
38
  | A page's sections (one file per page) | `website/src/sections/<page>.sections.tsx` |
39
39
  | The site's choices for the blocks (config builders: motif, icons, actions) | `website/src/sections/kit/**` |
40
- | The words each slot reads, per locale | `website/src/i18n/<locale>.json` (`website.<page>.<section>.<slot>`) |
40
+ | The words each slot reads, per locale | `website/src/i18n/<locale>/<page>.<section>.json`, the section's own file (`website.<page>.<section>.<slot>`) |
41
41
  | The site's adjustments to a block | `website/src/styles/**` (rules on `data-website-*` hooks) |
42
42
  | The theme every block reads | `website/src/website-root.config.ts` (`designTokens`) |
43
43
 
@@ -156,9 +156,9 @@ The week's plan: rows are completed one by one, a new todo is TYPED into the fie
156
156
  ```tsx
157
157
  /**
158
158
  * The week, as the application keeps it: the week IS a list (`todoLists`), and its rows are the commitments created in
159
- * it (`todos`, each with an owner, a due day and a priority). A todo captured with quick add goes to the Inbox list and
160
- * stays there: a todo's list is fixed when it is created (`todoListId` is excluded from update), so the drawing shows
161
- * the capture in its own list, never joining the week. Rank belongs to TASKS, not todos, so the rows carry no order
159
+ * it (`todos`, each with an owner, a due day and a priority). A todo captured with quick add goes to the Inbox list, and
160
+ * joins a week only when someone moves it there (`move_to_list`), so the drawing shows the capture in its own list,
161
+ * not appearing in the week by itself. Rank belongs to TASKS, not todos, so the rows carry no order
162
162
  * of their own; nothing here is drag-and-drop, and the drawing shows no list-level progress count, which lists do not
163
163
  * have.
164
164
  *