@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
@@ -0,0 +1,80 @@
1
+ # saas.specifications.translation-glossary
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-specifications`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-specifications`
10
+
11
+ ```typescript
12
+ *
13
+ * The application's translation glossary, exported by its specifications package as `translationGlossary`
14
+ * (`import { ApplicationTranslationGlossaryDeclaration } from '@wildo-ai/saas-specifications'`). Terms apply to every
15
+ * string `wildo generate translate` writes; a locked translation pins one key of one unit in one language. Matching is
16
+ * literal and ignores case: an inflected form is a different string and needs its own term.
17
+ */
18
+
19
+ /** One term of the glossary: an English (primary-language) wording and what it becomes in each language. */
20
+ export const TranslationGlossaryTermSchema = z
21
+ .strictObject({
22
+ /**
23
+ * The wording in the application's PRIMARY language, as it appears in labels (`ERP supplier key`). Matched without
24
+ * regard to case and at word boundaries, so `ERP supplier key` also matches inside "Edit the ERP supplier key".
25
+ */
26
+ term: z.string().trim().min(1),
27
+ /** The chosen translation per target language. A language with no entry is translated freely. */
28
+ translations: z.partialRecord(z.enum(AvailableLanguage).systemEnum('AvailableLanguage'), z.string().trim().min(1)).optional(),
29
+ /** The term stays as written in every language: a product name, a brand, an acronym. Excludes `translations`. */
30
+ doNotTranslate: z.literal(true).optional(),
31
+ /** Why this wording: read by people, and given to the model beside the term. */
32
+ note: z.string().trim().min(1).optional(),
33
+ })
34
+ .refine((term) => (term.doNotTranslate === true) !== (term.translations !== undefined && Object.keys(term.translations).length > 0), {
35
+ message: 'A glossary term declares either translations (at least one language) or doNotTranslate: true, never both and never neither.',
36
+ });
37
+ export type TranslationGlossaryTerm = z.infer<typeof TranslationGlossaryTermSchema>;
38
+
39
+ /** One key of one label unit whose word in one language a person chose. */
40
+ export const LockedTranslationSchema = z.strictObject({
41
+ /** The label unit, as `wildo generate translate --units` names it (`resource:supplierDirectory`). */
42
+ unitId: z.string().trim().min(1),
43
+ /** The key's full dotted path, from the root of the label file (`resources.supplierDirectory.header.title`). A key that matches nothing is reported and does nothing. */
44
+ key: z.string().trim().min(1),
45
+ /** The language whose word is chosen. */
46
+ locale: z.enum(AvailableLanguage).systemEnum('AvailableLanguage'),
47
+ /** The primary-language words this translation was chosen for. When the key's words change, the lock is stale. */
48
+ source: z.string().min(1),
49
+ /** The chosen translation, written as is. */
50
+ value: z.string().min(1),
51
+ /** Why this word, and who chose it if that matters. */
52
+ reason: z.string().trim().min(1),
53
+ });
54
+ export type LockedTranslation = z.infer<typeof LockedTranslationSchema>;
55
+
56
+ /** The application's glossary: the terms every string honours, and the keys a person locked. */
57
+ export const ApplicationTranslationGlossarySchema = z
58
+ .strictObject({
59
+ terms: z.array(TranslationGlossaryTermSchema).default([]),
60
+ lockedTranslations: z.array(LockedTranslationSchema).default([]),
61
+ })
62
+ .superRefine((glossary, context) => {
63
+ // Two entries for one term, or two locks on one word, would make the outcome depend on declaration order.
64
+ const terms = new Set<string>();
65
+ glossary.terms.forEach((term, index) => {
66
+ const normalized = term.term.toLocaleLowerCase();
67
+ if (terms.has(normalized)) context.addIssue({ code: 'custom', path: ['terms', index, 'term'], message: `The term "${term.term}" is declared twice.` });
68
+ terms.add(normalized);
69
+ });
70
+ const locks = new Set<string>();
71
+ glossary.lockedTranslations.forEach((lock, index) => {
72
+ const identity = `${lock.unitId}\u0000${lock.key}\u0000${lock.locale}`;
73
+ if (locks.has(identity)) context.addIssue({ code: 'custom', path: ['lockedTranslations', index], message: `The ${lock.locale} word of ${lock.unitId} ${lock.key} is locked twice.` });
74
+ locks.add(identity);
75
+ });
76
+ });
77
+ export type ApplicationTranslationGlossary = z.infer<typeof ApplicationTranslationGlossarySchema>;
78
+ /** What an application authors: both lists may be omitted. */
79
+ export type ApplicationTranslationGlossaryDeclaration = z.input<typeof ApplicationTranslationGlossarySchema>;
80
+ ```
@@ -22,6 +22,10 @@
22
22
  * **Convention** (the validator's contract):
23
23
  *
24
24
  * - One file per locale: `<packsDir>/<segment>.json`, the code lower-cased (`languagePathSegment`)
25
+ * - Plus that locale's FRAGMENTS, every `<packsDir>/<segment>/*.json`, read in name order and merged into it: a
26
+ * section's words live in a file of its own (`<segment>/<page>.<sectionRef>.json`), so two sections written at the
27
+ * same time never edit one file. A key defined twice, in the pack and a fragment or in two fragments, is refused,
28
+ * naming both files: a word has one home
25
29
  * - JSON object: flat key-value map, `Record<string, string>`
26
30
  * - Keys are fully-composed `WebsiteLabelKey`s (`website.<page>.<section>.<slot>`)
27
31
  * - Values are the localized strings
@@ -43,12 +47,15 @@
43
47
  * - JSON parse failure — error includes the file path and the
44
48
  * parser's own message.
45
49
  * - Top-level shape is not an object, or a value is not a string —
46
- * error names the offending key + observed type.
50
+ * error names the offending key + observed type. A section's own
51
+ * file is held to the same shape.
52
+ * - A key defined twice, in the pack and a section's file or in two
53
+ * section files — error names the key and both files.
47
54
  *
48
55
  * **Why three exports** (loader, multi-loader, validator-runner):
49
56
  * - `loadLabelPack(packsDir, locale)` is the atomic primitive
50
- * (one file → one validated `LabelPack`). Used by the bridge at
51
- * request time.
57
+ * (one locale → one validated `LabelPack`: its pack merged with
58
+ * its sections' own files). Used by the bridge at request time.
52
59
  * - `loadAllLabelPacks(packsDir, siteContext)` is the build-time
53
60
  * batch — every locale pack at once. Used by the CLI auditor
54
61
  * and by the build-start hook.
@@ -72,18 +79,44 @@
72
79
  *
73
80
  * @param packsDir Absolute or cwd-relative path to the directory
74
81
  * containing per-locale `<segment>.json` files, named by
75
- * `languagePathSegment` (`fr.json`, `en-gb.json`).
82
+ * `languagePathSegment` (`fr.json`, `en-gb.json`), and
83
+ * each locale's `<segment>/<page>.<sectionRef>.json`
84
+ * section files, merged into its pack.
76
85
  * @param locale The locale to load. Must be a member of
77
86
  * `WildoMarketingWebsiteConfig.locales`.
78
87
  * @returns A flat `LabelPack` (`Record<string, string>`) ready to
79
88
  * feed into `WebsiteRuntimeContextValue.labelPack`.
80
- * @throws When the file is missing, malformed JSON, not an object,
81
- * or contains a non-string value.
89
+ * @throws When the pack is missing, a file is malformed JSON, not an
90
+ * object, or contains a non-string value, or a key is defined
91
+ * twice.
82
92
  */
83
93
  export function loadLabelPack(packsDir: string, locale: AvailableLanguage): LabelPack {
84
- const packFile = `${languagePathSegment(locale)}.json`;
85
- const filePath = resolve(packsDir, packFile);
94
+ const segment = languagePathSegment(locale);
95
+ const packFile = `${segment}.json`;
96
+ const pack: Record<string, string> = { ...readLabelPackFile(resolve(packsDir, packFile), packFile, locale) };
97
+ const definedIn = new Map<string, string>(Object.keys(pack).map((key) => [key, packFile]));
98
+ const fragmentsDir = resolve(packsDir, segment);
99
+ if (existsSync(fragmentsDir) && statSync(fragmentsDir).isDirectory()) {
100
+ for (const name of readdirSync(fragmentsDir).filter((entry) => entry.endsWith('.json')).sort()) {
101
+ const fragmentFile = `${segment}/${name}`;
102
+ for (const [key, value] of Object.entries(readLabelPackFile(resolve(fragmentsDir, name), fragmentFile, locale))) {
103
+ const earlier = definedIn.get(key);
104
+ if (earlier !== undefined) {
105
+ throw new Error(
106
+ `[label-pack-loader] Key "${key}" is defined in both ${earlier} and ${fragmentFile} (locale="${locale}"). ` +
107
+ 'A word has one home: keep it in the file of the section that reads it, and remove the other.',
108
+ );
109
+ }
110
+ definedIn.set(key, fragmentFile);
111
+ pack[key] = value;
112
+ }
113
+ }
114
+ }
115
+ return pack as LabelPack;
116
+ }
86
117
 
118
+ /** One pack or fragment file, read and shape-checked. */
119
+ function readLabelPackFile(filePath: string, packFile: string, locale: AvailableLanguage): LabelPack {
87
120
  let raw: string;
88
121
  try {
89
122
  raw = readFileSync(filePath, 'utf-8');
@@ -320,7 +353,8 @@ export function assertLabelPacksValid(
320
353
  (key) => ` "${key}" ← ${keyOrigins.get(key) ?? 'unknown origin'}`,
321
354
  );
322
355
  blocks.push(
323
- ` missing ${result.missing.length} required key(s) in ${packsDir}/${languagePathSegment(locale)}.json:\n` +
356
+ ` missing ${result.missing.length} required key(s) in ${packsDir}/${languagePathSegment(locale)}.json or its fragments under ${languagePathSegment(locale)}/ ` +
357
+ `(a section's words go in ${languagePathSegment(locale)}/<page>.<section>.json):\n` +
324
358
  annotated.join('\n'),
325
359
  );
326
360
  }
@@ -330,7 +364,7 @@ export function assertLabelPacksValid(
330
364
  if (result.orphaned.length > 0) {
331
365
  console.warn(
332
366
  `[label-pack-loader] Locale "${locale}": ${result.orphaned.length} ` +
333
- `orphaned key(s) in ${languagePathSegment(locale)}.json (declared in pack but not consumed ` +
367
+ `orphaned key(s) in ${languagePathSegment(locale)}.json or its fragments (declared in pack but not consumed ` +
334
368
  `by any section or page manifest):\n ${result.orphaned.join('\n ')}`,
335
369
  );
336
370
  }
@@ -66,7 +66,8 @@
66
66
  * `rootConfig.skipToMainContentLabelKey`
67
67
  * (chrome key carried into the per-page
68
68
  * pack slice).
69
- * @param opts.labelPacksDir Directory holding `<segment>.json` packs (the locale code lower-cased).
69
+ * @param opts.labelPacksDir Directory holding `<segment>.json` packs (the locale code lower-cased),
70
+ * and each locale's section files under `<segment>/`.
70
71
  * Resolved relative to the cwd Astro runs
71
72
  * in (typically the project root).
72
73
  * @param opts.astroLocale Whatever `Astro.currentLocale` returned
@@ -80,7 +81,7 @@ export interface LoadWebsitePageRuntimeOptions {
80
81
  manifest: WebsitePageManifest;
81
82
  /** The site's composed `WebsiteSiteContext` — single source of truth. */
82
83
  siteContext: WebsiteSiteContext;
83
- /** Directory holding `<segment>.json` label-pack files, the locale code lower-cased (`languagePathSegment`). */
84
+ /** Directory holding `<segment>.json` label-pack files, the locale code lower-cased (`languagePathSegment`), and each locale's section files under `<segment>/`. */
84
85
  labelPacksDir: string;
85
86
  /** The value of `Astro.currentLocale` at the call site. */
86
87
  astroLocale: string | undefined;
@@ -12,25 +12,28 @@
12
12
  *
13
13
  * Astro content-collection bridge for blog posts.
14
14
  *
15
- * # The Zod-version bridge problem
16
- *
17
- * Astro's `astro:content` ships its own bundled Zod (currently 3.x).
18
- * Our `BlogPostFrontmatterSchema` is Zod 4 and uses Zod-4-only APIs
19
- * (`z.iso.datetime`, `z.url(...)`, `.brand<>()`). The two cannot share
20
- * a schema instance directly across the version boundary, and shimming
21
- * a Zod 4 schema down to a Zod 3 schema would create either:
22
- *
23
- * - a hand-mirrored copy — maintained in `src/content.config.ts`
24
- * using Astro's `z`, with silent-drift risk every time a field is
25
- * added/removed/refined; or
26
- * - a runtime bridge package — a non-trivial maintenance
27
- * surface for a marginal gain.
28
- *
29
- * This file sidesteps the bridge entirely: the consumer's
30
- * `src/content.config.ts` declares a `passthrough` collection schema
31
- * that lets Astro accept any frontmatter shape; the engine then
32
- * validates with the canonical Zod 4 schema at render time inside
33
- * `<BlogPost>`. Astro's static site generator runs the page render
15
+ * # Why the collection accepts any frontmatter
16
+ *
17
+ * This design was born when Astro's `astro:content` bundled Zod 3 and
18
+ * our `BlogPostFrontmatterSchema` was already Zod 4, so the two could
19
+ * not share a schema. That boundary is gone: since Astro 6 the `z`
20
+ * Astro hands a collection is Zod 4 (`import { z } from 'astro/zod'`;
21
+ * the `astro:content` re-export is deprecated and leaves in Astro 8).
22
+ * The passthrough stays for two reasons that still hold on Astro 7:
23
+ *
24
+ * - the collection layer sees frontmatter as Astro's YAML 1.1 parser
25
+ * delivers it, so an unquoted `publishedAt` arrives as a `Date`
26
+ * where the canonical schema takes the ISO string the author wrote
27
+ * (`withYamlTimestampsAsIsoStrings` below reconciles the two before
28
+ * the strict parse);
29
+ * - one validation site, with one error format (`[blog-post]` plus
30
+ * the file), rather than a second copy of the rules in
31
+ * `src/content.config.ts` that drifts each time a field changes.
32
+ *
33
+ * So the consumer's `src/content.config.ts` declares a `passthrough`
34
+ * collection schema that lets Astro accept any frontmatter shape; the
35
+ * engine then validates with the canonical Zod 4 schema at render time
36
+ * inside `<BlogPost>`. Astro's static site generator runs the page render
34
37
  * during the build, so a malformed frontmatter still surfaces as a
35
38
  * BUILD-TIME error (the `.parse()` call throws synchronously and Astro
36
39
  * reports it with the page URL) — the only practical difference from a
@@ -39,9 +42,10 @@
39
42
  * # Why the engine ships an opaque shape (rather than the consumer
40
43
  * importing the Astro `z` directly)
41
44
  *
42
- * Astro's content-collection API has churned across Astro 4 → 5
45
+ * Astro's content-collection API has churned across Astro 4 → 5 → 6
43
46
  * (loaders moved from string-keyed `type` to a callable `loader`
44
- * factory; the `glob()` loader's signature changed). Every consumer
47
+ * factory; the `glob()` loader's signature changed; `z` moved to
48
+ * `astro/zod`). Every consumer
45
49
  * touching `defineCollection` directly inherits that churn; centralizing
46
50
  * the wiring in the engine means the framework absorbs the upgrade
47
51
  * cost in ONE place when Astro bumps a major.
@@ -52,8 +56,9 @@
52
56
  *
53
57
  * ```ts
54
58
  * // website/src/content.config.ts
55
- * import { defineCollection, z } from 'astro:content';
59
+ * import { defineCollection } from 'astro:content';
56
60
  * import { glob } from 'astro/loaders';
61
+ * import { z } from 'astro/zod';
57
62
  * import { buildBlogPostCollectionConfig } from '@wildo-ai/saas-website/mdx';
58
63
  *
59
64
  * export const collections = {
@@ -62,9 +67,9 @@
62
67
  * ```
63
68
  *
64
69
  * The consumer passes Astro's own `z` and `glob` in, because the engine
65
- * cannot import `astro:content` (a virtual module that only exists inside
66
- * the Astro build) nor `astro/loaders` (it would pull `astro` into the
67
- * engine's walked closure, which the bundle-isolation test forbids). The
70
+ * cannot import `astro/zod` nor `astro/loaders` (either would pull
71
+ * `astro` into the engine's walked closure, which the bundle-isolation
72
+ * test forbids, and `astro` is an optional peer the engine never loads). The
68
73
  * engine builds the passthrough schema and the loader from them.
69
74
  *
70
75
  * **The upgrade this exists for happened (#2570).** The recipe used to be a
@@ -100,9 +105,9 @@
100
105
 
101
106
  /**
102
107
  * Minimal contract for the Astro-side Zod factory we accept. Typed
103
- * structurally (rather than imported from `astro:content`) so the
108
+ * structurally (rather than imported from `astro/zod`) so the
104
109
  * engine package can compile/test without an Astro install. Astro's
105
- * actual `z.object` returns a much richer Zod-3 schema; we narrow to
110
+ * actual `z.object` returns a full Zod 4 object schema; we narrow to
106
111
  * just the `.passthrough()` call we make below.
107
112
  */
108
113
  export interface AstroZodFactoryShape {
@@ -132,11 +137,10 @@ export function blogPostEntryId(entry: string): string {
132
137
 
133
138
  export interface BuildBlogPostCollectionConfigOptions {
134
139
  /**
135
- * Astro's bundled `z` object — pass `import { z } from 'astro:content'`
136
- * from the consumer-side `src/content.config.ts`. The engine cannot
137
- * import `astro:content` itself (virtual module, only present inside
138
- * the Astro build pipeline; would also bloat the bundle-isolation
139
- * walked closure with the `astro` runtime).
140
+ * Astro's `z` object — pass `import { z } from 'astro/zod'` from the
141
+ * consumer-side `src/content.config.ts`. The engine cannot import it
142
+ * itself (it would bring the `astro` runtime into the bundle-isolation
143
+ * walked closure, and `astro` is an optional peer).
140
144
  */
141
145
  astroZ: AstroZodFactoryShape;
142
146
  /** Astro's `glob` loader factory — pass `import { glob } from 'astro/loaders'`. */
@@ -85,7 +85,7 @@ export async function resolveWebsiteBlogPostCover(
85
85
  // The measurement is shared by every post naming this file, so its error names the file and each post adds itself.
86
86
  throw new Error(
87
87
  `[blog-post-cover] The cover "${src}" of post "${frontmatter.slug}" (${frontmatter.locale}): ` +
88
- `${error instanceof Error ? error.message : String(error)}`,
88
+ `${describeCaughtError(error)}`,
89
89
  );
90
90
  }
91
91
  return { src, width: size.width, height: size.height };
@@ -48,8 +48,8 @@ export const WEBSITE_BLOG_CONTENT_PATTERN = '*/*.mdx';
48
48
  * - `locale` — REQUIRED. The post's locale. Drives the URL prefix
49
49
  * (`/<locale>/blog/<slug>`) and `<html lang>`. Cross-locale
50
50
  * correspondence is established by sharing the `slug` across
51
- * per-locale MDX files (e.g. `en/why-context.md` and
52
- * `fr/why-context.md` are the same post in two locales).
51
+ * per-locale MDX files (e.g. `en/why-context.mdx` and
52
+ * `fr/why-context.mdx` are the same post in two locales).
53
53
  * - `publishedAt` — REQUIRED. ISO-8601 date-time string. Renders into
54
54
  * `og:article:published_time` and the listing-card date label.
55
55
  * Stored as string (not `z.coerce.date`) because YAML frontmatter
@@ -60,8 +60,8 @@
60
60
  *
61
61
  * The `createWebsitePageBridgeIsland` factory takes a `PageComponent`
62
62
  * — a React component the page author writes. A blog post has NO React
63
- * component; the MDX file IS the component (compiled by `@astrojs/mdx`
64
- * to a default-export React tree). Reusing the page-bridge factory
63
+ * component; the MDX file IS the component (compiled to a default-export
64
+ * React tree by `websiteBlogReactMdx()`). Reusing the page-bridge factory
65
65
  * would force the consumer to write a ten-line wrapper per post that
66
66
  * imports the MDX module, calls `<MdxBody />`, and re-passes the
67
67
  * frontmatter — a cold violation of the "every blog post is one MDX
@@ -26,16 +26,21 @@
26
26
  * query-suffixed id does not match), so the content collection, its frontmatter and `render()` are
27
27
  * untouched.
28
28
  *
29
- * The compiler is the one `@astrojs/mdx` already ships (`@mdx-js/mdx`), resolved from the site's own
30
- * `@astrojs/mdx` so the site takes no second MDX dependency to keep in step, with the two remark plugins
31
- * `@astrojs/mdx` applies by default: `remark-gfm` (tables, task lists, autolinks) and `remark-smartypants`
32
- * (typographic quotes). Nothing else from the site's Markdown setup reaches a post's island body: the site's
33
- * own remark and rehype plugins, and Astro's rehype defaults (Shiki code highlighting, heading ids), do not
34
- * apply. Style code blocks and link headings in the post's components rather than relying on them.
29
+ * The compiler is MDX's own (`@mdx-js/mdx`), resolved through the site's `@astrojs/markdown-remark`, Astro's
30
+ * unified Markdown package, so the site takes no second MDX dependency to keep in step. Since Astro 7,
31
+ * `@astrojs/mdx` renders with Sätteri, Astro's native pipeline, and no longer carries `@mdx-js/mdx`; the unified
32
+ * compiler and its plugins live in `@astrojs/markdown-remark`, which Astro 7 no longer installs by default. So a
33
+ * site with a blog declares `@astrojs/markdown-remark` beside `@astrojs/mdx` (a version on the range Astro's own
34
+ * peer declaration names). The two remark plugins applied are the ones `@astrojs/markdown-remark` ships:
35
+ * `remark-gfm` (tables, task lists, autolinks) and `remark-smartypants` (typographic quotes). Nothing else from
36
+ * the site's Markdown setup reaches a post's island body: the site's own remark and rehype plugins, and Astro's
37
+ * rehype defaults (Shiki code highlighting, heading ids), do not apply. Style code blocks and link headings in
38
+ * the post's components rather than relying on them.
35
39
  *
36
- * Add it beside `mdx()` and `react()`:
40
+ * Add it beside `mdx()` and `react()`, and declare both Markdown packages in the website's `package.json`:
37
41
  *
38
42
  * @example
43
+ * // package.json: "@astrojs/mdx", "@astrojs/markdown-remark" (and "@astrojs/react")
39
44
  * // astro.config.ts
40
45
  * integrations: [mdx(), websiteBlogReactMdx(), react()],
41
46
  *
@@ -90,27 +95,29 @@ function defaultExport(module: unknown): unknown {
90
95
  }
91
96
 
92
97
  /**
93
- * The MDX compiler and the two Markdown plugins Astro's own MDX compile uses, resolved through the site's
94
- * `@astrojs/mdx`. Refuses with the remedy when the site has no `@astrojs/mdx`: a blog needs it anyway, for
95
- * its content collection.
98
+ * The MDX compiler and the two remark plugins Astro's unified Markdown pipeline applies, resolved through the
99
+ * site's `@astrojs/markdown-remark` (Astro 7 moved them there from `@astrojs/mdx`, #3500). Refuses with the remedy
100
+ * when the site has none: Astro 7 stopped installing it by default, so a site upgraded from Astro 6 meets this
101
+ * first.
96
102
  */
97
103
  async function loadCompiler(siteRoot: URL): Promise<{ compiler: MdxCompilerModule; remarkPlugins: unknown[] }> {
98
104
  const fromSite = createRequire(new URL('package.json', siteRoot));
99
- let astroMdxManifest: string;
105
+ let markdownRemarkEntry: string;
100
106
  try {
101
- astroMdxManifest = fromSite.resolve('@astrojs/mdx/package.json');
107
+ markdownRemarkEntry = fromSite.resolve('@astrojs/markdown-remark');
102
108
  } catch {
103
109
  throw new Error(
104
- `[saas-website] websiteBlogReactMdx() needs @astrojs/mdx, resolved from ${fileURLToPath(siteRoot)}. `
105
- + 'Install it in the website package and add mdx() to its integrations: the blog content collection needs it too.',
110
+ `[saas-website] websiteBlogReactMdx() needs @astrojs/markdown-remark, resolved from ${fileURLToPath(siteRoot)}. `
111
+ + 'Astro 7 no longer installs it, and it carries the MDX compiler a post is compiled with: add it to the website '
112
+ + 'package beside @astrojs/mdx, and add mdx() to its integrations: the blog content collection needs it too.',
106
113
  );
107
114
  }
108
- const fromAstroMdx = createRequire(astroMdxManifest);
109
- const importFromAstroMdx = (specifier: string): Promise<unknown> => import(fromAstroMdx.resolve(specifier));
115
+ const fromMarkdownRemark = createRequire(markdownRemarkEntry);
116
+ const importFromMarkdownRemark = (specifier: string): Promise<unknown> => import(fromMarkdownRemark.resolve(specifier));
110
117
  const [compiler, remarkGfm, remarkSmartypants] = await Promise.all([
111
- importFromAstroMdx('@mdx-js/mdx'),
112
- importFromAstroMdx('remark-gfm'),
113
- importFromAstroMdx('remark-smartypants'),
118
+ importFromMarkdownRemark('@mdx-js/mdx'),
119
+ importFromMarkdownRemark('remark-gfm'),
120
+ importFromMarkdownRemark('remark-smartypants'),
114
121
  ]);
115
122
  return {
116
123
  compiler: compiler as MdxCompilerModule,
@@ -18,7 +18,7 @@
18
18
  * @example
19
19
  * const rawModules = import.meta.glob('../content/blog/en/*.mdx', { eager: true, query: '?website-react-mdx' });
20
20
  *
21
- * A bridge that omits it imports `@astrojs/mdx`'s module instead, compiled to Astro JSX, which a React island cannot
21
+ * A bridge that omits it imports `@astrojs/mdx`'s module instead, compiled for Astro rather than React, which a React island cannot
22
22
  * render (React refuses the object it returns as a child; see `websiteBlogReactMdx`). The constant names the literal
23
23
  * for code that checks a module id; it cannot stand in for the literal in the glob itself.
24
24
  */
@@ -27,6 +27,7 @@
27
27
  * **Node-only.** Lives on the `/config-loader` subpath; it must never reach a React-island bundle.
28
28
  */
29
29
  import {
30
+ ConfigModuleResolution,
30
31
  loadApplicationPublicPricingCatalog,
31
32
  loadConfig,
32
33
  resolveWorkspaceScope,
@@ -52,7 +53,8 @@ export async function loadWebsitePricingCatalog(input: LoadWebsitePricingCatalog
52
53
  + 'Run astro from inside the application workspace.',
53
54
  );
54
55
  }
55
- const saasConfig = await loadConfig<WildoSaasConfig>(workspaceScope.saasConfigPath);
56
+ // Against the built framework packages, as `loadWebsiteSiteContext` reads it (#3440).
57
+ const saasConfig = await loadConfig<WildoSaasConfig>(workspaceScope.saasConfigPath, { moduleResolution: ConfigModuleResolution.LOADER_INSTANCES });
56
58
  return loadApplicationPublicPricingCatalog({
57
59
  saasRoot: workspaceScope.saasRoot,
58
60
  saasConfig,
@@ -60,6 +60,7 @@
60
60
  import { resolve as resolvePath } from 'node:path';
61
61
 
62
62
  import {
63
+ ConfigModuleResolution,
63
64
  loadApplicationServedPublicGovernedDocuments,
64
65
  loadConfig,
65
66
  loadMaterializedFrontendProviders,
@@ -70,7 +71,7 @@ import {
70
71
  type WildoSaasConfig,
71
72
  } from '@wildo-ai/platform-config-lib';
72
73
 
73
- import { legalNoticeOwed } from '@wildo-ai/saas-models/public-runtime';
74
+ import { legalNoticeOwed, describeCaughtError } from '@wildo-ai/saas-models/public-runtime';
74
75
 
75
76
  import { composeWebsiteSiteContext, type WebsiteSiteContext } from '../astro/website-site-context';
76
77
  import type { WebsiteRootConfig } from '../schemas/manifests/website-root-config.shared.schemas';
@@ -143,14 +144,16 @@ export async function loadWebsiteSiteContext(input: LoadWebsiteSiteContextInput)
143
144
  );
144
145
  }
145
146
  const saasRoot = workspaceScope.saasRoot;
146
- const saasConfig = await loadConfig<WildoSaasConfig>(workspaceScope.saasConfigPath);
147
+ // Against the built framework packages the website itself runs on, never their source (#3440): in a framework
148
+ // checkout the inferred `framework-source` evaluated `@wildo-ai/saas-models` again from source in every build process.
149
+ const saasConfig = await loadConfig<WildoSaasConfig>(workspaceScope.saasConfigPath, { moduleResolution: ConfigModuleResolution.LOADER_INSTANCES });
147
150
  const [websiteServiceKey] = resolveStaticWebsiteServiceEntry(saasConfig);
148
151
  const websiteConfig = await loadWebsiteConfig({ saasRoot, saasConfig });
149
152
  // Which public documents the application serves, asked of the application itself (#2987). `undefined` when it has
150
153
  // no backend configuration to read, or it cannot be loaded: the footer then keeps linking every public document.
151
154
  const servedPublicDocumentRefs = await loadApplicationServedPublicGovernedDocuments({ saasRoot, saasConfig }).catch((error: unknown) => {
152
155
  console.warn(
153
- `[saas-website] ${error instanceof Error ? error.message : String(error)} The footer will link every public document.`,
156
+ `[saas-website] ${describeCaughtError(error)} The footer will link every public document.`,
154
157
  );
155
158
  return undefined;
156
159
  });
@@ -17,8 +17,9 @@
17
17
  * - `website.` — fixed namespace prefix that disambiguates marketing-site
18
18
  * labels from app i18n keys (`labels.`, `errors.`, `notifications.`).
19
19
  * Marketing-site label packs ship as a separate file per locale
20
- * (`website/src/i18n/<segment>.json`) so they never bloat the SaaS app
21
- * bundle.
20
+ * (`website/src/i18n/<segment>.json`, plus one file per section under
21
+ * `website/src/i18n/<segment>/`, merged into it) so they never bloat
22
+ * the SaaS app bundle.
22
23
  * - `<pageRef>` — kebab-case page ref (validated independently by
23
24
  * `WebsitePageRefSchema`).
24
25
  * - `<sectionRef>` — kebab-case section ref (validated independently by
@@ -13,7 +13,9 @@
13
13
  * `LabelPack` — flat string→string map keyed by fully-composed
14
14
  * `WebsiteLabelKey` (e.g. `"website.landing.hero.headline"` →
15
15
  * `"Welcome to Acme"`). One pack per locale, loaded by the
16
- * Astro adapter from `website/src/i18n/<segment>.json` (the locale code lower-cased).
16
+ * Astro adapter from `website/src/i18n/<segment>.json` (the locale code lower-cased),
17
+ * merged with that locale's per-section files `website/src/i18n/<segment>/<page>.<sectionRef>.json`
18
+ * (a key defined twice is refused).
17
19
  *
18
20
  * Stored as a plain `Record<string, string>` rather than
19
21
  * `Record<WebsiteLabelKey, string>` because runtime JSON parses to
@@ -58,6 +58,30 @@ export enum ServiceMethodStepPerformer {
58
58
  CLIENT = 'CLIENT',
59
59
  }
60
60
 
61
+ /**
62
+ * A part of the method the creator left NOT DECIDED YET (#3484), which the method then states as OWED rather than leaving
63
+ * absent: an absent part reads as an answer ("no qualified decisions", "no agent work") in a domain where that answer
64
+ * is consequential.
65
+ *
66
+ * A method-level declaration, because the two interview questions it answers are asked of the whole method, not of one
67
+ * service. Considered and rejected: a "not decided" member of {@link ServiceMethodStepPerformer} (it would put a standing
68
+ * among the performers and make every reader of a performer handle a non-performer), and per-decision "undetermined"
69
+ * routes (a deferred answer leaves WHICH decisions need a qualified person open, so there is no decision to mark).
70
+ */
71
+ export enum ServiceMethodOwedPart {
72
+ /**
73
+ * Which decisions in a case a qualified person must take, and who they must be (the `signatories` question). While
74
+ * owed, the method's `qualifications` and `decisionPoints` hold only what is known, and their emptiness is NOT a
75
+ * statement that no decision needs a qualified person.
76
+ */
77
+ QUALIFIED_DECISIONS = 'QUALIFIED_DECISIONS',
78
+ /**
79
+ * Which of the firm's work agents do (the `agent-work` question). While owed, a step whose performer depends on that
80
+ * answer names none, and no agent is derived for it; the client's own steps still name the client.
81
+ */
82
+ AGENT_WORK = 'AGENT_WORK',
83
+ }
84
+
61
85
  /** How a service is priced to the client. */
62
86
  export enum ServiceMethodPricing {
63
87
  /**
@@ -135,6 +159,9 @@ export const ServiceMethodQualificationSchema = z.strictObject({
135
159
  });
136
160
  export type ServiceMethodQualification = z.infer<typeof ServiceMethodQualificationSchema>;
137
161
 
162
+ /** The parts of a method owed (#3484): a fresh schema per use, for the reason {@link slug} gives. */
163
+ export const serviceMethodOwedParts = () => z.array(z.enum(ServiceMethodOwedPart).systemEnum('ServiceMethodOwedPart')).default([]);
164
+
138
165
  /** One case: the unit of work a service is delivered in, and the resource whose rows are the cases. */
139
166
  export const ServiceMethodCaseSchema = z.strictObject({
140
167
  /** The resource's planned ref (`closes`, `audit-engagements`): the domain plan inventories it, and the build plan makes it the work unit. */
@@ -162,8 +189,12 @@ export const ServiceMethodStepSchema = z.strictObject({
162
189
  stageRef: slug(),
163
190
  /** What the step does, in the firm's words. */
164
191
  does: text(),
165
- performedBy: z.enum(ServiceMethodStepPerformer).systemEnum('ServiceMethodStepPerformer'),
166
- /** AGENT steps only: how the agent is started and talked to. Refused on a PERSON or CLIENT step. */
192
+ /**
193
+ * Who does it. Absent only while the method declares {@link ServiceMethodOwedPart.AGENT_WORK} owed (#3484): the step's
194
+ * performer then waits on that answer, and nothing is derived for it.
195
+ */
196
+ performedBy: z.enum(ServiceMethodStepPerformer).systemEnum('ServiceMethodStepPerformer').optional(),
197
+ /** AGENT steps only: how the agent is started and talked to. Refused on a PERSON or CLIENT step, and on one with no performer. */
167
198
  agentShape: z.enum(BuildPlanAgentShape).systemEnum('BuildPlanAgentShape').optional(),
168
199
  /** What the step reads, by domain-plan resource refs. */
169
200
  readsRefs: z.array(slug()).default([]),
@@ -255,6 +286,7 @@ export type ServiceMethodCorrectionReason = z.infer<typeof ServiceMethodCorrecti
255
286
  * - `reviewCalendar` — when the firm's reviewers are working, the engine's own calendar. Required as soon as a decision
256
287
  * deadline counts business time; otherwise optional.
257
288
  * - `correctionReasons` — why an expert corrects an agent, recorded with each correction. Empty is an answer.
289
+ * - `owed` — the parts the creator left not decided yet ({@link ServiceMethodOwedPart}), each once. Empty: nothing is owed.
258
290
  */
259
291
  export const ServiceMethodSchema = z.object({
260
292
  version: z.enum(ServiceMethodVersion).default(ServiceMethodVersion.V1),
@@ -263,6 +295,7 @@ export const ServiceMethodSchema = z.object({
263
295
  clientParticipation: text(),
264
296
  reviewCalendar: ReviewCalendarSchema.optional(),
265
297
  correctionReasons: z.array(ServiceMethodCorrectionReasonSchema).default([]),
298
+ owed: serviceMethodOwedParts(),
266
299
  }).superRefine((method, context) => {
267
300
  for (const issue of serviceMethodIssues(method)) context.addIssue({ code: 'custom', message: issue.message, path: issue.path });
268
301
  });
@@ -17,8 +17,10 @@
17
17
  *
18
18
  * `kind` classifies the constraint so downstream surfaces can route it
19
19
  * — most importantly, `COMPLIANCE` constraints (data-residency,
20
- * privacy/health-data law, assurance commitments, sector rules) are the seam the top-down
21
- * compliance-posture playbook (U10) reads. At scaffold depth a
20
+ * privacy/health-data law, assurance commitments, sector rules) are the
21
+ * creator's own compliance seam, which the top-down compliance-posture
22
+ * playbook (U10) reads; the regimes it researches land in the separate
23
+ * `compliance-posture` family (#3362), never back here. At scaffold depth a
22
24
  * compliance constraint is a `kind: COMPLIANCE` entry with a prose
23
25
  * `statement` ("Must be GDPR-compliant for EU customer personal data")
24
26
  * — the DEEP per-regime obligation model (control catalogs, data-flow