@wildo-ai/framework-knowledge 1.1.11 → 1.1.13

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 (812) 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 +180 -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 +30 -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 +87 -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 +55 -8
  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 +19 -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/method.md +14 -0
  272. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +11 -7
  273. package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
  274. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
  275. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
  276. package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
  277. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
  278. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
  279. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
  280. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
  281. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
  282. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
  283. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
  284. package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
  285. package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
  286. package/dist/knowledge/references/application-maturity.config.md +70 -1
  287. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
  288. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
  289. package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
  290. package/dist/knowledge/references/brand.name-screening.config.md +30 -3
  291. package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
  292. package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
  293. package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
  294. package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
  295. package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
  296. package/dist/knowledge/references/companion.market.generation-service.md +46 -5
  297. package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
  298. package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
  299. package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
  300. package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
  301. package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
  302. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
  303. package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
  304. package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
  305. package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
  306. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
  307. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
  308. package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
  309. package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
  310. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
  311. package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
  312. package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
  313. package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
  314. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
  315. package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +21 -0
  316. package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
  317. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
  318. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
  319. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
  320. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
  321. package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
  322. package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
  323. package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
  324. package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
  325. package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
  326. package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
  327. package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
  328. package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
  329. package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
  330. package/dist/knowledge/references/example.website.section.stats.md +1 -1
  331. package/dist/knowledge/references/experience-plan.config.md +111 -1
  332. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
  333. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
  334. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
  335. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
  336. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
  337. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
  338. package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
  339. package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
  340. package/dist/knowledge/references/integration-plan.config.md +7 -7
  341. package/dist/knowledge/references/placement-plan.config.md +19 -0
  342. package/dist/knowledge/references/platform.config.backing-services.md +9 -11
  343. package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
  344. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
  345. package/dist/knowledge/references/platform.config.infrastructure-host.md +1 -1
  346. package/dist/knowledge/references/platform.config.platform-key-management.md +89 -10
  347. package/dist/knowledge/references/platform.config.saas.md +20 -18
  348. package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
  349. package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
  350. package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
  351. package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
  352. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
  353. package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
  354. package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
  355. package/dist/knowledge/references/requirements.engine-substance.md +38 -0
  356. package/dist/knowledge/references/requirements.functional-requirement.config.md +11 -0
  357. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +15 -4
  358. package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
  359. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +49 -2
  360. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
  361. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
  362. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
  363. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  364. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
  365. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
  366. package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
  367. package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
  368. package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
  369. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
  370. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
  371. package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
  372. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
  373. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
  374. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +435 -2
  375. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
  376. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
  377. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
  378. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
  379. package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
  380. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
  381. package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
  382. package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
  383. package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
  384. package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
  385. package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
  386. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
  387. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
  388. package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
  389. package/dist/knowledge/references/saas.frontend.chart-dashboard.md +133 -0
  390. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
  391. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
  392. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
  393. package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
  394. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
  395. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
  396. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
  397. package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
  398. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
  399. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
  400. package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
  401. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
  402. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
  403. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
  404. package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
  405. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
  406. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
  407. package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
  408. package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
  409. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
  410. package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
  411. package/dist/knowledge/references/saas.models.chart-dashboard-tile-sizes.md +40 -0
  412. package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
  413. package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
  414. package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
  415. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
  416. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
  417. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
  418. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
  419. package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
  420. package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
  421. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
  422. package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
  423. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
  424. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
  425. package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails-environment.md +52 -0
  426. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
  427. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
  428. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
  429. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
  430. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
  431. package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
  432. package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
  433. package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
  434. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
  435. package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
  436. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
  437. package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
  438. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
  439. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
  440. package/dist/knowledge/references/saas.models.organization-dashboard-layout.md +61 -0
  441. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
  442. package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
  443. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
  444. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
  445. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
  446. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
  447. package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
  448. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
  449. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
  450. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
  451. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
  452. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
  453. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
  454. package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
  455. package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
  456. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
  457. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
  458. package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
  459. package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
  460. package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
  461. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
  462. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
  463. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
  464. package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
  465. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
  466. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
  467. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
  468. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
  469. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
  470. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
  471. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
  472. package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
  473. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
  474. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
  475. package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
  476. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
  477. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
  478. package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
  479. package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
  480. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
  481. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
  482. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
  483. package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
  484. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
  485. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
  486. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
  487. package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
  488. package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
  489. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
  490. package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
  491. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
  492. package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
  493. package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
  494. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
  495. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
  496. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
  497. package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
  498. package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
  499. package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
  500. package/dist/knowledge/references/service-method.config.md +35 -2
  501. package/dist/knowledge/references/vision.constraint.config.md +4 -2
  502. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
  503. package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
  504. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
  505. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
  506. package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
  507. package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
  508. package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
  509. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
  510. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
  511. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
  512. package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
  513. package/dist/knowledge/references/zod.factories.code.md +4 -4
  514. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  515. package/dist/knowledge/references/zod.factories.money.md +4 -4
  516. package/dist/knowledge/references/zod.factories.phone.md +4 -4
  517. package/dist/knowledge/references/zod.factories.year-month.md +79 -0
  518. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  519. package/dist/knowledge/registries/framework-topics.json +455 -2
  520. package/dist/knowledge/registries/playbooks.json +51 -39
  521. package/dist/knowledge/registries/source-tags.json +2505 -1627
  522. package/dist/knowledge/rules/database-migration-obligation.md +6 -7
  523. package/dist/knowledge/rules/live-context-door.md +1 -1
  524. package/dist/knowledge/skills/INDEX.md +3 -1
  525. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
  526. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
  527. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
  528. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
  529. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
  530. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
  531. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
  532. package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
  533. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
  534. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
  535. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
  536. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
  537. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
  538. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
  539. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
  540. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
  541. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  542. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
  543. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
  544. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
  545. package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
  546. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
  547. package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
  548. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
  549. package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
  550. package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +90 -0
  551. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
  552. package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
  553. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
  554. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
  555. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
  556. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
  557. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
  558. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
  559. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
  560. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
  561. package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
  562. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
  563. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
  564. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
  565. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
  566. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
  567. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
  568. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
  569. package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
  570. package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
  571. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
  572. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
  573. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
  574. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
  575. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
  576. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +240 -9
  577. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
  578. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
  579. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
  580. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
  581. package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
  582. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
  583. package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
  584. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
  585. package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
  586. package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
  587. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
  588. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
  589. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
  590. package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
  591. package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +78 -0
  592. package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
  593. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
  594. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
  595. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
  596. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
  597. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
  598. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +13 -3
  599. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
  600. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +34 -11
  601. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
  602. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
  603. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +188 -10
  604. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
  605. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
  606. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
  607. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
  608. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
  609. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +447 -8
  610. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
  611. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
  612. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
  613. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +13 -3
  614. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
  615. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
  616. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +13 -3
  617. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
  618. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
  619. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -1
  620. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +6 -5
  621. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +50 -14
  622. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
  623. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
  624. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
  625. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
  626. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
  627. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
  628. package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
  629. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
  630. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
  631. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
  632. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
  633. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
  634. package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
  635. package/dist/knowledge/skills/infra-environment-config/SKILL.md +149 -77
  636. package/dist/knowledge/skills/infra-environment-config/references/framework-agent-content-guardrails-environment-api.md +67 -0
  637. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
  638. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
  639. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +1 -1
  640. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +89 -10
  641. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
  642. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
  643. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
  644. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
  645. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
  646. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
  647. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
  648. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
  649. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
  650. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
  651. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
  652. package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
  653. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
  654. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
  655. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
  656. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
  657. package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
  658. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
  659. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
  660. package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
  661. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
  662. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
  663. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
  664. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
  665. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
  666. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
  667. package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -15
  668. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
  669. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
  670. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
  671. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
  672. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
  673. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
  674. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
  675. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
  676. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
  677. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
  678. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
  679. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
  680. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
  681. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
  682. package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
  683. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
  684. package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
  685. package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
  686. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
  687. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
  688. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
  689. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
  690. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
  691. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +34 -7
  692. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
  693. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
  694. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
  695. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +28 -2
  696. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
  697. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
  698. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
  699. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
  700. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
  701. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
  702. package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
  703. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
  704. package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
  705. package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
  706. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
  707. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
  708. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
  709. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
  710. package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
  711. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
  712. package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
  713. package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
  714. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
  715. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
  716. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
  717. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
  718. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
  719. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
  720. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
  721. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
  722. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
  723. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
  724. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
  725. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
  726. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
  727. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
  728. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
  729. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
  730. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
  731. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  732. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
  733. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
  734. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
  735. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
  736. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
  737. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
  738. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
  739. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
  740. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
  741. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
  742. package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
  743. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
  744. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
  745. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
  746. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
  747. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
  748. package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
  749. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
  750. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
  751. package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
  752. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
  753. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
  754. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
  755. package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
  756. package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
  757. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
  758. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
  759. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
  760. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
  761. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
  762. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
  763. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
  764. package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
  765. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
  766. package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
  767. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
  768. package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
  769. package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
  770. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
  771. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
  772. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  773. package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
  774. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
  775. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
  776. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
  777. package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +371 -0
  778. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
  779. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
  780. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
  781. package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
  782. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
  783. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
  784. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
  785. package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
  786. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
  787. package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
  788. package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
  789. package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
  790. package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
  791. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
  792. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
  793. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
  794. package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
  795. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
  796. package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
  797. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
  798. package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
  799. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
  800. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
  801. package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
  802. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
  803. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
  804. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
  805. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
  806. package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
  807. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
  808. package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
  809. package/dist/knowledge/topic-index.json +2422 -723
  810. package/dist/tsconfig.build.tsbuildinfo +1 -1
  811. package/package.json +6 -6
  812. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -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
  *
@@ -31,7 +31,7 @@ the same bundle** — namely:
31
31
  - App-side header and footer components (passed to each page's bridge as `navigation`)
32
32
  - App-side section authoring (`defineWebsiteSection` calls in each page's `website/src/sections/<page>.sections.tsx`)
33
33
  - App-side page composition (`website/src/pages/*.astro` routes, `website/src/pages-impl/*.page.tsx` / `*.bridge.tsx`)
34
- - App-side label packs (`website/src/i18n/<locale>.json`)
34
+ - App-side label packs (`website/src/i18n/<locale>.json` and each section's `<locale>/<page>.<sectionRef>.json`)
35
35
  - App-side Astro middleware (`website/src/middleware/*.ts`) — SSR-tier, see below
36
36
 
37
37
  The split between **island-tier** (ships to the browser) and
@@ -316,8 +316,10 @@ const ALLOWED_BARE_SPECIFIERS: ReadonlySet<string> = new Set([
316
316
  'node:path',
317
317
  /**
318
318
  * `node:module` and `node:url` — the blog's React MDX integration (`blog-react-mdx.integration.ts`, on the
319
- * `astro.ts` sub-entry) resolves the MDX compiler through the site's own `@astrojs/mdx` with `createRequire`,
319
+ * `astro.ts` sub-entry) resolves the MDX compiler through the site's own `@astrojs/markdown-remark` with `createRequire`,
320
320
  * and names the site root in its refusal with `fileURLToPath`. It runs in `astro.config.ts`, never in an island.
321
+ * The blog-cover resolver's `own-dependency-specifier.ts` (#2997) uses both too, inside the site's prerender
322
+ * chunks: it resolves `sharp` from this package's installed copy where the bundled bare import cannot.
321
323
  */
322
324
  'node:module',
323
325
  'node:url',
@@ -249,8 +249,10 @@ const ALLOWED_BARE_SPECIFIERS: ReadonlySet<string> = new Set([
249
249
  'node:path',
250
250
  /**
251
251
  * `node:module` and `node:url` — the blog's React MDX integration (`blog-react-mdx.integration.ts`, on the
252
- * `astro.ts` sub-entry) resolves the MDX compiler through the site's own `@astrojs/mdx` with `createRequire`,
252
+ * `astro.ts` sub-entry) resolves the MDX compiler through the site's own `@astrojs/markdown-remark` with `createRequire`,
253
253
  * and names the site root in its refusal with `fileURLToPath`. It runs in `astro.config.ts`, never in an island.
254
+ * The blog-cover resolver's `own-dependency-specifier.ts` (#2997) uses both too, inside the site's prerender
255
+ * chunks: it resolves `sharp` from this package's installed copy where the bundled bare import cannot.
254
256
  */
255
257
  'node:module',
256
258
  'node:url',
@@ -31,7 +31,8 @@ sections.
31
31
  | Surface | Application-relative location |
32
32
  |---|---|
33
33
  | Page/section manifest | `website/src/pages-impl/**` and `website/src/sections/**` |
34
- | Per-locale label pack | `website/src/i18n/**` |
34
+ | Per-locale label pack (site and page words) | `website/src/i18n/<locale>.json` |
35
+ | A section's own words, per locale | `website/src/i18n/<locale>/<page>.<sectionRef>.json` |
35
36
  | Label-consuming component | `website/src/**` |
36
37
  | Discovery content | `website/src/content/llms.txt` |
37
38
 
@@ -41,14 +42,25 @@ A locale's files are named by its SEGMENT, the locale code lower-cased (`languag
41
42
  its URL prefix (`/en-gb/pricing`). Wherever these skills write `<locale>` in a path, read the segment. The code keeps
42
43
  its case only where a language tag is meant (`<html lang>`, `hreflang`).
43
44
 
45
+ A SECTION's words live in a file of their own in each locale, `src/i18n/<locale>/<page>.<sectionRef>.json`, which the
46
+ website's pack loader merges into that locale's pack. Sections built at the same time then never edit one file, and a
47
+ section's words are found where its ref says. The pack itself keeps the site's chrome (menu, consent, legal links, blog
48
+ tags) and each page's own words. A key has ONE home: the loader refuses a key defined both in the pack and in a
49
+ fragment, or in two fragments, naming both files. So a section whose words already sit in a pack (a site authored
50
+ before section files) has them MOVED into its own file when it is next worked on, never copied: delete them from the
51
+ pack in the same change.
52
+
44
53
  ## Workflow
45
54
 
46
55
  1. Decide whether the copy belongs to a section, a page, a global site surface
47
56
  or an explicit raw key. Prefer the narrowest owner.
48
57
  2. Add the key to the owning manifest’s expected label set before adding a
49
58
  locale value.
50
- 3. Update every supported locale pack with the same semantic key. A fallback
51
- may be an application policy, not an accidental missing translation.
59
+ 3. Give every supported locale the same semantic key: a section's in its own
60
+ file of each locale (`<locale>/<page>.<sectionRef>.json`), a page's or the
61
+ chrome's in the locale's pack. A section key already in a pack is moved,
62
+ never copied. A fallback may be an application policy, not an accidental
63
+ missing translation.
52
64
  4. Consume a section-owned key through the section-relative label hook; do not
53
65
  hand-compose a global key in the component.
54
66
  5. Keep shared words shared: an audience or campaign page has its own sections
@@ -69,7 +81,8 @@ const expectedHeroLabels = [
69
81
  'website.landing.landing-hero.cta.primary',
70
82
  ] as const;
71
83
 
72
- const en = {
84
+ // website/src/i18n/en/landing.landing-hero.json: the section's own file, merged into the EN pack
85
+ const enLandingHero = {
73
86
  'website.landing.landing-hero.headline': 'Make the next step clear',
74
87
  'website.landing.landing-hero.cta.primary': 'Start now',
75
88
  };
@@ -173,7 +186,9 @@ export function useWebsiteLabel(slotPath: string): string {
173
186
  * `LabelPack` — flat string→string map keyed by fully-composed
174
187
  * `WebsiteLabelKey` (e.g. `"website.landing.hero.headline"` →
175
188
  * `"Welcome to Acme"`). One pack per locale, loaded by the
176
- * Astro adapter from `website/src/i18n/<segment>.json` (the locale code lower-cased).
189
+ * Astro adapter from `website/src/i18n/<segment>.json` (the locale code lower-cased),
190
+ * merged with that locale's per-section files `website/src/i18n/<segment>/<page>.<sectionRef>.json`
191
+ * (a key defined twice is refused).
177
192
  *
178
193
  * Stored as a plain `Record<string, string>` rather than
179
194
  * `Record<WebsiteLabelKey, string>` because runtime JSON parses to
@@ -71,6 +71,7 @@ Read this when:
71
71
  import { resolve as resolvePath } from 'node:path';
72
72
 
73
73
  import {
74
+ ConfigModuleResolution,
74
75
  loadApplicationServedPublicGovernedDocuments,
75
76
  loadConfig,
76
77
  loadMaterializedFrontendProviders,
@@ -81,7 +82,7 @@ import {
81
82
  type WildoSaasConfig,
82
83
  } from '@wildo-ai/platform-config-lib';
83
84
 
84
- import { legalNoticeOwed } from '@wildo-ai/saas-models/public-runtime';
85
+ import { legalNoticeOwed, describeCaughtError } from '@wildo-ai/saas-models/public-runtime';
85
86
 
86
87
  import { composeWebsiteSiteContext, type WebsiteSiteContext } from '../astro/website-site-context';
87
88
  import type { WebsiteRootConfig } from '../schemas/manifests/website-root-config.shared.schemas';
@@ -154,14 +155,16 @@ export async function loadWebsiteSiteContext(input: LoadWebsiteSiteContextInput)
154
155
  );
155
156
  }
156
157
  const saasRoot = workspaceScope.saasRoot;
157
- const saasConfig = await loadConfig<WildoSaasConfig>(workspaceScope.saasConfigPath);
158
+ // Against the built framework packages the website itself runs on, never their source (#3440): in a framework
159
+ // checkout the inferred `framework-source` evaluated `@wildo-ai/saas-models` again from source in every build process.
160
+ const saasConfig = await loadConfig<WildoSaasConfig>(workspaceScope.saasConfigPath, { moduleResolution: ConfigModuleResolution.LOADER_INSTANCES });
158
161
  const [websiteServiceKey] = resolveStaticWebsiteServiceEntry(saasConfig);
159
162
  const websiteConfig = await loadWebsiteConfig({ saasRoot, saasConfig });
160
163
  // Which public documents the application serves, asked of the application itself (#2987). `undefined` when it has
161
164
  // no backend configuration to read, or it cannot be loaded: the footer then keeps linking every public document.
162
165
  const servedPublicDocumentRefs = await loadApplicationServedPublicGovernedDocuments({ saasRoot, saasConfig }).catch((error: unknown) => {
163
166
  console.warn(
164
- `[saas-website] ${error instanceof Error ? error.message : String(error)} The footer will link every public document.`,
167
+ `[saas-website] ${describeCaughtError(error)} The footer will link every public document.`,
165
168
  );
166
169
  return undefined;
167
170
  });
@@ -724,7 +724,7 @@ the table still says which side the page is on; it never makes a cell say more t
724
724
  |---|---|
725
725
  | The configured section, and its entry in the page's `<PAGE>_SECTIONS` list | `website/src/sections/<page>.sections.tsx` |
726
726
  | The site's section factories and config builders (`comparisonSection(...)`, `comparisonConfig(...)`, `tableConfig(...)`) | `website/src/sections/kit/**` |
727
- | Label pack (per locale) | `website/src/i18n/<locale>.json` |
727
+ | This section's words, per locale | `website/src/i18n/<locale>/<page>.<sectionRef>.json`: the section's own file, merged into the locale's pack |
728
728
  | The site's adjustments to the blocks | `website/src/styles/**` (rules on `data-website-*` hooks) |
729
729
 
730
730
  ## When to Use
@@ -1123,7 +1123,7 @@ rg -n "defineWebsiteBlockSection\(" website/src/sections
1123
1123
  rg -n "highlight:" website/src/sections
1124
1124
 
1125
1125
  # Every table has a caption that names it: read each (none may be a bare "Comparison" or "Table")
1126
- rg -n '\.caption"' website/src/i18n/*.json
1126
+ rg -n '\.caption"' website/src/i18n/
1127
1127
 
1128
1128
  # Every alternative names its snapshot entry (must return >= 1)
1129
1129
  rg -n "alternative-source:" website/src/sections/<page>.sections.tsx
@@ -748,7 +748,7 @@ What the category does — and, for structured data, does not — decide:
748
748
  | The site's config builder for a feature row (its points' icons, its layout) | `website/src/sections/kit/**` |
749
749
  | The site's one anonymous-session client | `website/src/anonymous-session.client.ts` |
750
750
  | Page composition | `website/src/pages-impl/contact.page.tsx` |
751
- | Label pack (per locale) | `website/src/i18n/<locale>.json` |
751
+ | This section's words, per locale | `website/src/i18n/<locale>/<page>.<sectionRef>.json`: the section's own file, merged into the locale's pack |
752
752
 
753
753
  ## When to Use
754
754
 
@@ -743,7 +743,7 @@ What the category does — and, for structured data, does not — decide:
743
743
  | The configured section, and its entry in the page's `<PAGE>_SECTIONS` list | `website/src/sections/<page>.sections.tsx` (one file per page, holding all its sections) |
744
744
  | The site's config builder for the band (its motif, its primary action) and its section factory | `website/src/sections/kit/**` |
745
745
  | Page composition | `website/src/pages-impl/<page-ref>.page.tsx` |
746
- | Label pack (per locale) | `website/src/i18n/<locale>.json` |
746
+ | This section's words, per locale | `website/src/i18n/<locale>/<page>.<sectionRef>.json`: the section's own file, merged into the locale's pack |
747
747
  | The site's adjustments to the block | `website/src/styles/**` (rules on `data-website-*` hooks) |
748
748
 
749
749
  ## When to Use
@@ -730,7 +730,7 @@ What the category does — and, for structured data, does not — decide:
730
730
  | The configured section, and its entry in the page's `<PAGE>_SECTIONS` list | `website/src/sections/<page>.sections.tsx` (one file per page, holding all its sections) |
731
731
  | The site's config builder for the FAQ and its structured data, and its section factory | `website/src/sections/kit/**` |
732
732
  | Page composition | `website/src/pages-impl/<page-ref>.page.tsx` |
733
- | Label pack (per locale) | `website/src/i18n/<locale>.json` |
733
+ | This section's words, per locale | `website/src/i18n/<locale>/<page>.<sectionRef>.json`: the section's own file, merged into the locale's pack |
734
734
  | The routes that render the page's JSON-LD | `website/src/pages/**/*.astro` |
735
735
  | The site's adjustments to the block | `website/src/styles/**` (rules on `data-website-*` hooks) |
736
736
 
@@ -738,7 +738,7 @@ layout.
738
738
  | The configured section (`websiteCardGridBlock.section(...)`), and its entry in the page's `<PAGE>_SECTIONS` list | `website/src/sections/<page>.sections.tsx` (one file per page, holding all its sections) |
739
739
  | The site's icon set, its card-grid config builder and the section factory several pages share | `website/src/sections/kit/**` |
740
740
  | Page composition | `website/src/pages-impl/<page-ref>.page.tsx` |
741
- | Label pack (per locale) | `website/src/i18n/<locale>.json` |
741
+ | This section's words, per locale | `website/src/i18n/<locale>/<page>.<sectionRef>.json`: the section's own file, merged into the locale's pack |
742
742
  | The site's adjustments to the blocks | `website/src/styles/**` (rules on `data-website-*` hooks) |
743
743
 
744
744
  ## When to Use
@@ -736,7 +736,7 @@ What the category does — and, for structured data, does not — decide:
736
736
  | The configured section (`websiteFeatureRowBlock.section(...)`), and its entry in the page's `<PAGE>_SECTIONS` list | `website/src/sections/<page>.sections.tsx` (one file per page, holding all its sections) |
737
737
  | The site's feature-row config builder (its icon set, its link shape) and section factory | `website/src/sections/kit/**` |
738
738
  | Page composition | `website/src/pages-impl/<page-ref>.page.tsx` |
739
- | Label pack (per locale) | `website/src/i18n/<locale>.json` |
739
+ | This section's words, per locale | `website/src/i18n/<locale>/<page>.<sectionRef>.json`: the section's own file, merged into the locale's pack |
740
740
  | The site's adjustments to the block | `website/src/styles/**` (rules on `data-website-*` hooks) |
741
741
 
742
742
  ## When to Use
@@ -743,7 +743,7 @@ What the category does — and, for structured data, does not — decide:
743
743
  | The configured section, and its entry in the page's `<PAGE>_SECTIONS` list | `website/src/sections/<page>.sections.tsx` (one file per page, holding all its sections) |
744
744
  | The site's config builder for the close (its motif, its actions), shared by every page | `website/src/sections/kit/**` |
745
745
  | Page composition | `website/src/pages-impl/<page-ref>.page.tsx` |
746
- | Label pack (per locale) | `website/src/i18n/<locale>.json` |
746
+ | This section's words, per locale | `website/src/i18n/<locale>/<page>.<sectionRef>.json`: the section's own file, merged into the locale's pack |
747
747
  | The site's adjustments to the block | `website/src/styles/**` (rules on `data-website-*` hooks) |
748
748
 
749
749
  ## When to Use
@@ -757,7 +757,7 @@ application's website module:
757
757
  | The configured section (`websiteHeroBlock.section(...)`), and its entry in the page's `<PAGE>_SECTIONS` list | `website/src/sections/<page>.sections.tsx` (one file per page, holding all its sections) |
758
758
  | The site's hero config builder (its surface, motif and primary action, fixed once) and section factory | `website/src/sections/kit/**` |
759
759
  | Page composition | `website/src/pages-impl/<page-ref>.page.tsx` (calls `defineWebsitePageManifest`) |
760
- | Label pack (per locale) | `website/src/i18n/<locale>.json` |
760
+ | This section's words, per locale | `website/src/i18n/<locale>/<page>.<sectionRef>.json`: the section's own file, merged into the locale's pack |
761
761
  | The site's adjustments to the block | `website/src/styles/**` (rules on `data-website-*` hooks) |
762
762
 
763
763
  ## When to Use
@@ -723,7 +723,7 @@ perform today is a promise, and promises belong on a roadmap, not here.
723
723
  |---|---|
724
724
  | The configured section (`websiteStepsBlock.section(...)`), and its entry in the page's `<PAGE>_SECTIONS` list | `website/src/sections/<page>.sections.tsx` |
725
725
  | The site's steps config builder and section factory, when several pages share them | `website/src/sections/kit/**` |
726
- | Label pack (per locale) | `website/src/i18n/<locale>.json` |
726
+ | This section's words, per locale | `website/src/i18n/<locale>/<page>.<sectionRef>.json`: the section's own file, merged into the locale's pack |
727
727
  | Step visuals (optional) | `website/public/images/<page>/` |
728
728
  | The site's adjustments to the blocks | `website/src/styles/**` (rules on `data-website-*` hooks) |
729
729
 
@@ -728,7 +728,7 @@ Two shapes, often on one site: a **marquee** on the home page (the names scrolli
728
728
  |---|---|
729
729
  | The configured section, in the page's `<PAGE>_SECTIONS` list | `website/src/sections/<page>.sections.tsx` |
730
730
  | The site's config builders (a `marqueeConfig(...)` returning the block's props) | `website/src/sections/kit/**` |
731
- | Label pack (per locale): each connection's name and what it does | `website/src/i18n/<locale>.json` |
731
+ | This section's words, per locale: each connection's name and what it does | `website/src/i18n/<locale>/<page>.<sectionRef>.json` (the section's own file) |
732
732
  | Where the connections are declared (read, never edited here) | `wildo.saas.config.ts` (providers and their scopes; `engineCapabilities` such as `EMAIL_INBOUND`; `systemsOfRecord`, which are NOT integrations) · `backend-api/src/modules/*/inbound/*.inbound-handler.ts` and `*.inbound-channel-handler.ts` (`defineInboundHandler` / `defineInboundChannelHandler`, registered on the module's `inboundHandlers`) · `shared-lib/src/modules/*/resources/*/*.resources-config.ts` (`mcp: { exposed }`) · `backend-api/src/modules/*/addons/flows-actors/*.ts` (A2A) |
733
733
  | Whether the described environment can serve each one | the environment's provider credentials (`providerEnv` in its secrets) and app registrations — see `infra-environment-config` |
734
734
  | The site's adjustments to the blocks | `website/src/styles/**` (rules on `data-website-*` hooks) |
@@ -925,7 +925,7 @@ rg -n "<provider>" infrastructure/<env>/
925
925
 
926
926
  # No system of record listed: read the entries, then search the packs for each name (must return empty)
927
927
  rg -n "systemsOfRecord" -A20 wildo.saas.config.ts
928
- rg -n -i "<each name>" website/src/i18n/*.json
928
+ rg -n -i "<each name>" website/src/i18n/
929
929
 
930
930
  # A moving list is the engine's marquee, configured (>= 1 when the section scrolls), and no hand-made loop (must return empty)
931
931
  rg -n "websiteMarqueeBlock\.section\(" website/src/sections/
@@ -935,7 +935,7 @@ rg -n "infinite" website/src/styles/
935
935
  rg -n "defineWebsiteBlockSection\(" website/src/sections
936
936
 
937
937
  # The marquee's names, to count (past about a dozen in one strip, split it)
938
- rg -n "\.text\"" website/src/i18n/en.json
938
+ rg -n "\.text\"" website/src/i18n/en.json website/src/i18n/en/
939
939
 
940
940
  # No vendor logo images (must return empty for third-party marks)
941
941
  rg -n "\.(svg|png|webp)" website/src/sections/<page>.sections.tsx
@@ -892,7 +892,7 @@ rg -n "formatWebsitePublicationDate|websiteBlogTagLabelKey|toLocaleDateString|<i
892
892
 
893
893
  # Every tag used has its word (each tag of the posts must appear as website.chrome.blog-tag.<tag> in every pack)
894
894
  rg -n "^tags:" -A4 website/src/content/blog/
895
- rg -n "website\.chrome\.blog-tag\." website/src/i18n/*.json
895
+ rg -n "website\.chrome\.blog-tag\." website/src/i18n/
896
896
 
897
897
  # No link to the blog on the blog page itself (read the blog page's section and the builder it calls:
898
898
  # its config must not carry allPosts)