@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
@@ -752,9 +752,9 @@ website.
752
752
  | The billing catalogue (the prices, the grants) | `shared-lib/src/engine/product.ts` — or wherever the shared modules declare `productDefinitions` |
753
753
  | The site's words per catalogue plan, shared by every page that shows the plans | `website/src/sections/kit/**` |
754
754
  | Section component + factory call, and its entry in the page's `<PAGE>_SECTIONS` list | `website/src/sections/<page>.sections.tsx` |
755
- | The route: loads the catalogue, passes it to the island, renders the offers | `website/src/pages/pricing.astro` (and every route whose page shows plans) |
756
- | The offers of one page (called by the route), and the per-locale offers the audit reads | `website/src/structured-data/page-payloads.ts` |
757
- | Label pack (per locale) | `website/src/i18n/<locale>.json` |
755
+ | The route, or the page helper every route calls: loads the catalogue, passes it to the island, renders the offers | `website/src/pages/pricing.astro` (and every route whose page shows plans), or the helper it calls (`website/src/*.ts`) |
756
+ | The offers of one page (called by the route), and the per-locale payloads the audit reads | `website/src/structured-data/**` (e.g. `page-payloads.ts`) |
757
+ | This section's words, per locale | `website/src/i18n/<locale>/<page>.<sectionRef>.json`: the section's own file, merged into the locale's pack |
758
758
  | The site's adjustments to the block | `website/src/styles/**` (rules on `data-website-*` hooks) |
759
759
 
760
760
  ## When to Use
@@ -792,9 +792,9 @@ of exceptions in the website.
792
792
 
793
793
  ### Step 2: Load the catalogue in the route
794
794
 
795
- In the route's frontmatter, `await loadWebsitePricingCatalog()` (from `@wildo-ai/saas-website/config-loader`; pass
796
- `targetScope` when the catalogue sells to more than one audience) and pass the result to the bridge island as
797
- `pricingCatalog={pricingCatalog}`. The loader reads the catalogue from source, so it is current on every build.
795
+ In the route's frontmatter, or in the page helper every route calls, `await loadWebsitePricingCatalog()` (from
796
+ `@wildo-ai/saas-website/config-loader`; pass `targetScope` when the catalogue sells to more than one audience) and pass
797
+ the result to the bridge island as `pricingCatalog`. Load it once per build and share it: it costs seconds. The loader reads the catalogue from source, so it is current on every build.
798
798
  Every route whose page shows a pricing block does this, the home page's included; the block throws on a page that
799
799
  passed none, rather than stating that the application sells nothing.
800
800
 
@@ -861,18 +861,19 @@ phrase, and required when one is published), and a range never mixes flat and pe
861
861
  yearly ones. The unit is ONE per page: the catalogue does not record what a per-unit price is per, so a page whose
862
862
  per-unit plans charge for different things (seats and gigabytes) cannot be published truthfully by this builder.
863
863
 
864
- The offers belong to ONE page in ONE locale: its URL and its words. Build them in a single function of that page —
865
- its `pageUrl`, the `siteOrigin` and its `labelPack`, the fields of the route's `runtime.structuredData` — in
866
- `website/src/structured-data/page-payloads.ts`, and call it from both readers: the route renders it through
867
- `renderPageStructuredData({ sections, context: runtime.structuredData, pagePayloads })`, and
868
- `resolveStructuredDataPagePayloadsForManifest` returns it once per locale, each at that locale's route, for the
869
- audit. Never type an origin into it: with one URL written for every locale, the French page publishes the
870
- default-locale page's URL.
864
+ The offers belong to ONE page in ONE locale: its URL and its words. Build them in a single function under
865
+ `website/src/structured-data/`, from that page's locale, its `labelPack` and the site's origin, and call it from both
866
+ readers: the route (or its page helper) renders it through `renderPageStructuredData({ sections, context:
867
+ runtime.structuredData, pagePayloads })`, and `resolveStructuredDataPagePayloadsForManifest` returns it once per
868
+ locale, each at that locale's route, for the audit. The origin is the site's ONE declared origin, the page context's
869
+ `siteOrigin` or the constant the website config declares as `publicOrigin`, never a literal in the offers function;
870
+ and every URL goes through the localized route (`buildLocalizedRoutePath`). With one URL written for every locale, the
871
+ French page publishes the default-locale page's URL.
871
872
 
872
- The section's own `getStructuredData()` emits the `SoftwareApplication` the offers name as `itemOffered`, at
873
- `${siteOrigin}/#software-application`, and no price. It reads `siteOrigin` from the page context it receives; a
874
- payload that also carries a word (a `description`) reads it through `label('<slot>')`, in the page's locale. A
875
- teaser emits nothing: the pricing page publishes the offers.
873
+ The `SoftwareApplication` the offers name as `itemOffered`, at `${siteOrigin}/#software-application`, carries no
874
+ price, and where it is emitted is the site's choice: from the PLANS section's own `getStructuredData()` (which reads
875
+ `siteOrigin` from the page context it receives, and a word such as a `description` through `label('<slot>')`, in the
876
+ page's locale), or page-wide beside the offers. A teaser section emits nothing of its own.
876
877
 
877
878
  ### Step 8: Make it this site's own without forking the block
878
879
 
@@ -893,118 +894,159 @@ temporary promotions, coupon copy, or locale-specific price tables.
893
894
 
894
895
  ## Worked Example
895
896
 
896
- <!-- TIER C WAIVER: no anchored application usage composes `WebsitePricing`; the framework's reference application wraps it in site-local helpers that are not anchored. These blocks show the contract the workflow states: the site's words per catalogue plan in one kit constant, each feature line naming its grant and an on-request plan carrying its own `link`; the pricing page's PLANS section declaring the statements its catalogue needs in one options constant passed to the block and to `websitePricingSlots(...)`, with its band and intro composed by hand because pricing is the one section not configured as a block; the `offer.unit` word the offers read; and (in `examples/pricing-offers.example.md`) `page-payloads.ts` building the offers from the catalogue in one function of the page they are published on. Replace with a Tier A anchor once an application's pricing sections and offers are anchored. -->
897
- ```ts
898
- // website/src/sections/kit/pricing-words.ts
899
- import { WebsiteMenuLinkKind, type WebsitePricingPlanWords } from '@wildo-ai/saas-website';
897
+ The worked example is a site that renders its pricing from its billing catalogue. Its kit holds
898
+ the site's words per catalogue plan (`PLANS`, by each plan's catalogue key), and each feature line names the GRANT it
899
+ describes, so the block refuses a line its plan does not grant. It also holds the statements its prices need words for
900
+ (here a trial) and the two blocks built from the same constants, the home page's teaser and the pricing page's plans.
901
+ Each options set goes to the block AND to `websitePricingSlots(...)`, so the label pack asks for exactly the words the
902
+ block reads:
900
903
 
901
- /**
902
- * The site's words per catalogue plan, by the plan's catalogue key: never a price, and never which plans are sold.
903
- * Each feature line names the GRANT it describes (a feature or limit id of the plan's product), and the block refuses
904
- * a line its plan does not grant. A plan's `link` replaces sign-up as its call to action. Shared by every page that
905
- * shows the plans, so their words cannot disagree.
906
- */
907
- export const PRICING_PLAN_WORDS: readonly WebsitePricingPlanWords[] = [
908
- { key: 'starter', features: [{ ref: 'projects', grant: 'MAX_PROJECTS' }] },
909
- {
910
- key: 'team',
911
- features: [
912
- { ref: 'projects', grant: 'MAX_PROJECTS' },
913
- { ref: 'sso', grant: 'SINGLE_SIGN_ON' },
914
- ],
915
- },
916
- // Priced on request: its call to action goes to the contact page, not to sign-up.
917
- { key: 'enterprise', features: [{ ref: 'audit-export', grant: 'AUDIT_EXPORT' }], link: { kind: WebsiteMenuLinkKind.PAGE, routePath: '/contact' } },
918
- ];
919
904
 
920
- export const PRICING_PAGE = { kind: WebsiteMenuLinkKind.PAGE, routePath: '/pricing' } as const;
921
- ```
905
+ ## Usage Example
922
906
 
923
907
  ```tsx
924
- // website/src/sections/pricing.sections.tsx
925
908
  import type { ReactNode } from 'react';
909
+
926
910
  import {
927
- defineWebsiteBlockSection,
928
- WebsiteBand,
911
+ WebsiteMenuLinkKind,
929
912
  WebsitePricing,
930
913
  WebsitePricingLayout,
931
- websitePricingSlots,
932
914
  WebsitePricingStatement,
933
- WebsiteSectionCategory,
934
915
  WebsiteSectionIntro,
916
+ websitePricingSlots,
935
917
  websiteSectionIntroSlots,
918
+ type WebsitePricingPlanWords,
936
919
  } from '@wildo-ai/saas-website';
937
920
 
938
- import { PRICING_PLAN_WORDS } from './kit/pricing-words';
939
-
940
921
  /**
941
- * What this catalogue's prices need words for, read from its plans: a floor, a per-member price, a plan on request, a
942
- * trial, an announced plan. `periods` keeps the PLANS default (a month and a year), which also declares the switch.
943
- * If the catalogue changes, the block names the statement or period it now needs.
922
+ * Pricing, from the billing catalogue the backend sells from (`shared-lib/src/engine/product.ts`, delivered by the
923
+ * route as `pricingCatalog`), on the engine's `WebsitePricing` block. A price is never a label: amounts, currency,
924
+ * cadence, trial length and the recommended plan all come from the catalogue.
925
+ *
926
+ * `PLANS` is the site's words per catalogue plan: which plans it has words for, and what each feature line describes.
927
+ * A line names the GRANT it describes, and the block refuses a line its plan does not grant, so the page cannot promise
928
+ * what checkout does not sell. The grant ids are `ApplicationFeature` members of `shared-lib/src/engine/features.ts`,
929
+ * written as their wire values because the website does not depend on the shared library.
930
+ *
931
+ * The catalogue's `BULK_EXPORT`, `ADVANCED_REPORTS` and `CUSTOM_WORKFLOWS` grants gate no product behaviour yet, so no
932
+ * line names them; the add-ons are stated in the plans note.
933
+ */
934
+ const PLANS: readonly WebsitePricingPlanWords[] = [
935
+ { key: 'org-free', features: [{ ref: 'feature1', grant: 'MAX_TODO_LISTS' }] },
936
+ { key: 'org-professional', features: [{ ref: 'feature1', grant: 'MAX_TODO_LISTS' }] },
937
+ {
938
+ key: 'org-enterprise',
939
+ features: [
940
+ { ref: 'feature1', grant: 'MAX_TODO_LISTS' },
941
+ { ref: 'feature2', grant: 'AI_ASSISTANT' },
942
+ ],
943
+ },
944
+ ];
945
+
946
+ /** Every plan is a flat price, monthly or yearly; the Professional plan offers a trial, which the cards state. */
947
+ const PLANS_STATEMENTS = [WebsitePricingStatement.TRIAL];
948
+
949
+ const PRICING_PAGE = { kind: WebsiteMenuLinkKind.PAGE, routePath: '/pricing' } as const;
950
+
951
+ /*
952
+ * One options constant per layout, passed whole to the block AND to `websitePricingSlots(...)`, so the words a section
953
+ * declares are exactly the words its block reads.
944
954
  */
945
- const PRICING = {
946
- layout: WebsitePricingLayout.PLANS,
947
- plans: PRICING_PLAN_WORDS,
948
- statements: [
949
- WebsitePricingStatement.STARTING_AT,
950
- WebsitePricingStatement.PER_UNIT,
951
- WebsitePricingStatement.ON_REQUEST,
952
- WebsitePricingStatement.TRIAL,
953
- WebsitePricingStatement.UPCOMING,
954
- ],
955
- note: true,
956
- } as const;
957
-
958
- function PricingPlans(): ReactNode {
955
+ const TEASER = { layout: WebsitePricingLayout.TEASER, plans: PLANS, pricingPage: PRICING_PAGE } as const;
956
+ const PLANS_PAGE = { layout: WebsitePricingLayout.PLANS, plans: PLANS, note: true, statements: PLANS_STATEMENTS } as const;
957
+
958
+ // ── TEASER (home page) ───────────────────────────────────────────────────────────────────────────────────────────────
959
+
960
+ export function pricingTeaserSlots(): string[] {
961
+ return [...websiteSectionIntroSlots(), ...websitePricingSlots(TEASER)];
962
+ }
963
+
964
+ export function PricingTeaserBlock(): ReactNode {
959
965
  return (
960
- <WebsiteBand>
966
+ <>
961
967
  <WebsiteSectionIntro />
962
- <WebsitePricing {...PRICING} />
963
- </WebsiteBand>
968
+ <WebsitePricing {...TEASER} />
969
+ </>
970
+ );
971
+ }
972
+ PricingTeaserBlock.displayName = 'WonderTodosPricingTeaserBlock';
973
+
974
+ // ── PLANS (pricing page) ─────────────────────────────────────────────────────────────────────────────────────────────
975
+
976
+ export function pricingPlansSlots(): string[] {
977
+ return [...websiteSectionIntroSlots(), ...websitePricingSlots(PLANS_PAGE)];
978
+ }
979
+
980
+ export function PricingPlansBlock(): ReactNode {
981
+ return (
982
+ <>
983
+ <WebsiteSectionIntro />
984
+ <WebsitePricing {...PLANS_PAGE} />
985
+ </>
964
986
  );
965
987
  }
988
+ PricingPlansBlock.displayName = 'WonderTodosPricingPlansBlock';
989
+ ```
990
+
991
+ The pricing page's PLANS section is the block in a band, with its intro composed by hand, because pricing is the one
992
+ section not configured as a block:
993
+
994
+
995
+ ## Usage Example
966
996
 
997
+ ```tsx
998
+ // The pricing page's PLANS section: the block, in a tinted band. Its JSON-LD (the application and its offers) is
999
+ // page-wide, built in `structured-data/page-structured-data.ts`, so the section itself publishes none.
967
1000
  export const PRICING_PLANS_SECTION = defineWebsiteBlockSection({
968
- pageRef: 'pricing',
1001
+ pageRef: PAGE_REF,
969
1002
  sectionRef: 'pricing-plans',
970
1003
  category: WebsiteSectionCategory.PRICING,
971
- // The block's words, plus `offer.unit`: the NOUN the page's offers publish as a per-unit price's unit ("member").
972
- slots: [...websiteSectionIntroSlots(), ...websitePricingSlots(PRICING), 'offer.unit'],
973
- Component: PricingPlans,
974
- // The application the plans sell, at the site-wide `@id` the offers name as `itemOffered`; its OFFERS are
975
- // published by page-payloads.ts. A proper name and Schema.org values, so no word is read.
976
- getStructuredData: ({ siteOrigin }) => ({
977
- '@type': 'SoftwareApplication',
978
- '@id': `${siteOrigin}/#software-application`,
979
- name: 'Example Application',
980
- applicationCategory: 'BusinessApplication',
981
- operatingSystem: 'Web',
982
- }),
1004
+ slots: pricingPlansSlots(),
1005
+ Component: () => (
1006
+ <WebsiteBand tone={WebsiteSurfaceTone.TINTED}>
1007
+ <PricingPlansBlock />
1008
+ </WebsiteBand>
1009
+ ),
983
1010
  });
984
1011
  ```
985
1012
 
1013
+ Two shapes the worked example does not need, and how to write them:
1014
+
1015
+ - **A plan sold on request.** Give its `PLANS` entry a `link` (`{ kind: WebsiteMenuLinkKind.PAGE, routePath:
1016
+ '/contact' }`); the link replaces sign-up as its call to action, and the catalogue's on-request plan then needs
1017
+ `WebsitePricingStatement.ON_REQUEST` in the statements.
1018
+ - **A price per member, a floor, an announced plan.** Add `PER_UNIT`, `STARTING_AT` or `UPCOMING` to the statements.
1019
+ For a per-unit price, add the `offer.unit` slot to the section (the noun the offers publish as the unit, "member")
1020
+ and pass `perUnitName` to the offers builder. If the catalogue changes, the block names the statement or period it
1021
+ now needs.
1022
+
1023
+ Where the JSON-LD lives is the site's choice. The worked example publishes the application and its offers page-wide (next
1024
+ step), so its section returns no `getStructuredData`. A site that keeps the application on the section returns it from
1025
+ the PLANS section's `getStructuredData({ siteOrigin })`, at `${siteOrigin}/#software-application`, with no price.
1026
+
986
1027
  The offers come from one function of the page they are published on, called by the route and, once per locale,
987
- by the audit: follow `examples/pricing-offers.example.md` for `website/src/structured-data/page-payloads.ts` and the
988
- pricing route's frontmatter.
1028
+ by the audit: follow `examples/pricing-offers.example.md`.
989
1029
 
990
- A home page's teaser is the same shape with its own options constant — `{ layout: WebsitePricingLayout.TEASER, plans:
991
- PRICING_PLAN_WORDS, pricingPage: PRICING_PAGE, statements: [...] }`, the same statements minus `TRIAL`, which a
992
- teaser does not show — passed to the block and to `websitePricingSlots(...)`, and no `getStructuredData`. None of
993
- these files holds a price, a plan list, a currency or a sign-up URL: the block reads them from the catalogue.
1030
+ A home page's teaser is the same shape with its own options (`layout: WebsitePricingLayout.TEASER`, the same plan
1031
+ words and a `pricingPage` link), the same statements minus `TRIAL`, which a teaser does not show, and no
1032
+ `getStructuredData`. None of these files holds a price, a plan list, a currency or a sign-up URL: the block reads them
1033
+ from the catalogue.
994
1034
 
995
1035
  ## Structured-data contract
996
1036
 
997
1037
  What a pricing page emits:
998
1038
 
999
1039
  - `SoftwareApplication` — the application itself, the usual case for a Wildo site — from the PLANS section's
1000
- `getStructuredData()`.
1040
+ `getStructuredData()`, or page-wide beside the offers (as the worked example does).
1001
1041
  - `Product` instead, only when the plans sell a discrete good rather than the application.
1002
1042
  - One `AggregateOffer` per currency, amount basis and recurrence (plans that differ in any of them are separate
1003
1043
  groups), with an `Offer` per plan whose price may be published, from `buildWebsitePricingOfferStructuredData` as a
1004
1044
  page-level payload — top-level, so the audit checks it, linked to the application by `itemOffered.@id`.
1005
1045
 
1006
- Keep `FAQPage` in a sibling FAQ section (`website-section-faq`) and `Organization` / `WebSite` in the landing page's
1007
- hero (`website-section-hero`). Nothing rejects them here — the audit checks each payload against the Schema.org
1046
+ Keep `FAQPage` in a sibling FAQ section (`website-section-faq`). `Organization` / `WebSite` belong to the landing
1047
+ page's hero (`website-section-hero`) or to page-wide payloads; a pricing page that publishes the application beside its
1048
+ offers also publishes the `Organization` the application names as publisher, so every `@id` it references is defined
1049
+ on the page. Nothing rejects them here — the audit checks each payload against the Schema.org
1008
1050
  catalog, never against the section's category — so the split is yours to keep.
1009
1051
 
1010
1052
  ## Catalog integration (AEO)
@@ -1027,8 +1069,8 @@ renderer emits one `<script type="application/ld+json">` block per payload (not
1027
1069
  - `references/framework-pricing-catalog-api.md` — source-backed catalogue loader, `useWebsitePricingCatalog()` and
1028
1070
  offer builder.
1029
1071
  - `references/define-website-section-api.md` — source-backed factory + schema + section wrapper + label hook contracts.
1030
- - `examples/pricing-offers.example.md` — the page's offers built from the catalogue in `page-payloads.ts`, and the
1031
- route that renders them with the page's context.
1072
+ - `examples/pricing-offers.example.md` — the worked example's page offers built from the catalogue, the route's catalogue
1073
+ load, and the per-locale payloads the audit reads from the same function.
1032
1074
  - `../website-building-blocks/references/framework-website-blocks-api.md` — every block and the stylesheet's hooks.
1033
1075
 
1034
1076
  ## Verification
@@ -1039,7 +1081,8 @@ renderer emits one `<script type="application/ld+json">` block per payload (not
1039
1081
  `websiteSectionIntroSlots(...)` with the options the intro renders.
1040
1082
  - [ ] The website holds no price: every amount, currency and cadence comes from the catalogue, through the block
1041
1083
  (render) and `buildWebsitePricingOfferStructuredData` (JSON-LD).
1042
- - [ ] Every route whose page shows plans loads the catalogue and passes it to the island as `pricingCatalog`.
1084
+ - [ ] Every route whose page shows plans (itself or through its page helper) loads the catalogue and passes it to the
1085
+ island as `pricingCatalog`.
1043
1086
  - [ ] The site's words per plan are one kit constant keyed by catalogue plan key, and every feature line names a
1044
1087
  grant its plan grants.
1045
1088
  - [ ] The block's options are one constant passed to `WebsitePricing` and `websitePricingSlots(...)`, declaring the
@@ -1048,8 +1091,9 @@ renderer emits one `<script type="application/ld+json">` block per payload (not
1048
1091
  - [ ] A recommended plan is worded as a recommendation, never as popularity.
1049
1092
  - [ ] No sign-up URL is typed: the call to action is `signUp` (the application's sign-up by default) or a plan's own
1050
1093
  `link`, and a plan priced on request carries a `link` to where a quote is asked for.
1051
- - [ ] The offers are built by one function of the page they are published on (`pageUrl`, `siteOrigin`, its pack):
1052
- the route calls it with `runtime.structuredData`, the audit once per locale, and no origin is typed.
1094
+ - [ ] The offers are built by one function from the page's locale, its pack and the site's one declared origin: the
1095
+ route (or its page helper) calls it, the audit once per locale, every URL is localized, and no origin literal
1096
+ is typed in `website/src/structured-data/`.
1053
1097
 
1054
1098
  ### Grep invariants
1055
1099
 
@@ -1083,11 +1127,11 @@ rg -n "https?://[^'\"]*(sign-?up|register)" website/src/sections
1083
1127
  # No popularity claim in the packs (must return empty)
1084
1128
  rg -n -i "most popular|best seller" website/src/i18n/
1085
1129
 
1086
- # Catalogue passed to the island (must return >= 1 per route whose page shows plans)
1087
- rg -n "pricingCatalog" website/src/pages
1130
+ # Catalogue passed to the island (must return >= 1, in the routes or in the page helper they call)
1131
+ rg -n "pricingCatalog" website/src --glob '!**/sections/**' --glob '!**/structured-data/**'
1088
1132
 
1089
1133
  # Route passes the page context (must print nothing; a call wrapped over several lines prints its first line too, so open it and check)
1090
- rg -n "renderPageStructuredData\(\{" website/src/pages --glob '*.astro' | rg -v "context:"
1134
+ rg -n "renderPageStructuredData\(\{" website/src --glob '*.{astro,ts}' | rg -v "context:"
1091
1135
 
1092
1136
  # Offers derived, never typed, and no origin typed into them (the first >= 1, the second empty)
1093
1137
  rg -n "buildWebsitePricingOfferStructuredData" website/src/structured-data/
@@ -1,77 +1,189 @@
1
1
  # Publishing a pricing page's offers — worked example
2
2
 
3
- The offers half of the `website-section-pricing` workflow (Step 7): one function of the page builds its
4
- `AggregateOffer` from the catalogue, at that page's URL and in its words, and both readers call it — the route, which
5
- renders it with the page's own context, and the audit, which reads it once per locale at that locale's route. No
6
- origin, price, currency or plan list is typed anywhere.
7
-
8
- <!-- TIER C WAIVER: no anchored application usage builds pricing offers; the framework's reference application's offers are not anchored. These blocks show Step 7's contract: one function of the page building the offers with `buildWebsitePricingOfferStructuredData` from its `pageUrl`, `siteOrigin` and label pack, called by the route with `runtime.structuredData` and by `resolveStructuredDataPagePayloadsForManifest` once per locale. Replace with a Tier A anchor once an application's offers are anchored. -->
9
- ```ts
10
- // website/src/structured-data/page-payloads.ts — the offers of ONE page, and what `wildo website audit` reads
11
- import { fileURLToPath } from 'node:url';
12
-
13
- import {
14
- buildLocalizedRoutePath,
15
- buildWebsitePricingOfferStructuredData,
16
- type WebsiteStructuredDataPageContext,
17
- type WebsiteStructuredDataPayload,
18
- } from '@wildo-ai/saas-website';
19
- import { loadWebsiteStructuredDataLocales } from '@wildo-ai/saas-website/astro';
20
- import { loadWebsitePricingCatalog } from '@wildo-ai/saas-website/config-loader';
21
- import type { PublicPricingCatalog } from '@wildo-ai/saas-models/public-runtime';
22
-
23
- import { WEBSITE_SITE_CONTEXT } from '../website-site-context';
24
-
25
- /** The pricing page's offers as one locale publishes them: at its URL, in its words. */
26
- export function pricingOffers(
27
- catalog: PublicPricingCatalog,
28
- page: Pick<WebsiteStructuredDataPageContext, 'pageUrl' | 'siteOrigin' | 'labelPack'>,
29
- ): readonly WebsiteStructuredDataPayload[] {
30
- const word = (slot: string): string | undefined => page.labelPack[`website.pricing.pricing-plans.${slot}`];
3
+ The offers half of the `website-section-pricing` workflow (Step 7), as a site rendering from its catalogue writes it. One
4
+ function of the site builds the page's `AggregateOffer` from the billing catalogue, at that page's URL and in its
5
+ words, and both readers call it: the route, which renders it in the page's head, and `wildo website audit`, which reads
6
+ it once per locale at that locale's route. No origin, price, currency or plan list is typed anywhere.
7
+
8
+ ## The offers, built from the catalogue
9
+
10
+ The plan name is the same word the pricing block shows, read from the page's label pack. The `AggregateOffer`'s `url`
11
+ and ids are the localized PRICING route, on every page that publishes the offers (the home page too), and the builder
12
+ gives each nested `Offer` the url of its own plan card (`…/pricing#plan-<key>`), so the French page publishes the
13
+ French URLs. The origin is the site's one declared origin, never a literal in this function:
14
+
15
+
16
+ ## Usage Example
17
+
18
+ ```typescript
19
+ // The site's ONE declared origin (`MARKETING_SITE_URL`, which `wildo.website.config.ts` also declares as `publicOrigin`),
20
+ // never a literal here; every URL below goes through the localized route, so each locale publishes its own page's URL.
21
+ export const SCHEMA_ORG_IDS = {
22
+ organization: `${MARKETING_SITE_URL}/#organization`,
23
+ website: `${MARKETING_SITE_URL}/#website`,
24
+ softwareApplication: `${MARKETING_SITE_URL}/#software-application`,
25
+ } as const;
26
+
27
+ export interface BuildPageStructuredDataInput {
28
+ readonly pageRef: string;
29
+ readonly locale: string;
30
+ readonly defaultLocale: string;
31
+ readonly labelPack: Readonly<Record<string, string>>;
32
+ readonly pricingCatalog?: PublicPricingCatalog;
33
+ }
34
+
35
+ // The engine's localized-route rule, so a page's JSON-LD names the URL the site serves it at (#2810).
36
+ function localizedUrl(routePath: string, locale: string, defaultLocale: string): string {
37
+ return `${MARKETING_SITE_URL}${buildLocalizedRoutePath({ locale: locale as AvailableLanguage, defaultLocale: defaultLocale as AvailableLanguage, routePath })}`;
38
+ }
39
+
40
+ /**
41
+ * The billing catalogue's offers, in this locale's words, at this locale's PRICING page: every page that publishes them
42
+ * (home and pricing) names the pricing page as where they are offered, as each offer's own `url#plan-<key>` does.
43
+ */
44
+ function offers(input: BuildPageStructuredDataInput): readonly WebsiteStructuredDataPayload[] {
45
+ if (input.pricingCatalog === undefined) return [];
46
+ const pricingUrl = localizedUrl('/pricing', input.locale, input.defaultLocale);
31
47
  return buildWebsitePricingOfferStructuredData({
32
- catalog,
33
- itemOfferedId: `${page.siteOrigin}/#software-application`, // the section's SoftwareApplication
34
- aggregateOfferIdPrefix: `${page.pageUrl}#plans`, // each group appends what it aggregates
35
- url: page.pageUrl,
36
- planName: (planKey) => word(`plans.${planKey}.name`), // the same word the pricing block shows
37
- perUnitName: word('offer.unit'), // required when a published plan is priced per unit
48
+ catalog: input.pricingCatalog,
49
+ itemOfferedId: SCHEMA_ORG_IDS.softwareApplication,
50
+ aggregateOfferIdPrefix: `${pricingUrl}#plans`,
51
+ url: pricingUrl,
52
+ planName: (planKey) => input.labelPack[`website.pricing.pricing-plans.plans.${planKey}.name`],
38
53
  });
39
54
  }
55
+ ```
56
+
57
+ A catalogue with a per-unit price (a price per member) also passes `perUnitName` (the `offer.unit` word the PLANS
58
+ section declares as a slot). The builder publishes only plans on sale at a listed price, so an on-request or announced
59
+ plan publishes no offer.
60
+
61
+ ## The catalogue, loaded once and handed to the page
62
+
63
+ Every route calls one page helper. It loads the catalogue for the scope the site sells to (here, organizations), once
64
+ per build, and when the page shows prices passes it both to the offers above (through `buildPageStructuredData`,
65
+ rendered by `renderPageStructuredData` with the page's context) and to the pricing block's island (`pricingCatalog`
66
+ in the island props):
67
+
68
+
69
+ ## Usage Example
70
+
71
+ ```typescript
72
+ /** The catalogue is loaded once per build (it costs seconds), then shared by every page that shows prices. */
73
+ let pricingCatalogPromise: Promise<PublicPricingCatalog> | undefined;
40
74
 
41
- const LABEL_PACKS_DIR = fileURLToPath(new URL('../i18n', import.meta.url));
42
-
43
- export async function resolveStructuredDataPagePayloadsForManifest(manifest: { ref: string; routePath: string }) {
44
- if (manifest.ref !== 'pricing') return [];
45
- const catalog = await loadWebsitePricingCatalog();
46
- // One entry per locale, at that locale's route: each page has its own URL and its own words.
47
- return loadWebsiteStructuredDataLocales(LABEL_PACKS_DIR, WEBSITE_SITE_CONTEXT).map(({ locale, defaultLocale, siteOrigin, labelPack }) => {
48
- const routePath = buildLocalizedRoutePath({ locale, defaultLocale, routePath: manifest.routePath });
49
- return {
50
- pageRef: manifest.ref,
51
- routePath,
52
- sourceRef: `page:pricing:${locale}`,
53
- payloads: pricingOffers(catalog, { pageUrl: `${siteOrigin}${routePath}`, siteOrigin, labelPack }),
54
- };
75
+ function loadPricingCatalog(): Promise<PublicPricingCatalog> {
76
+ pricingCatalogPromise ??= loadWebsitePricingCatalog({ targetScope: 'organizations' });
77
+ return pricingCatalogPromise;
78
+ }
79
+
80
+ async function loadBlogIndex(locale: string, limit: number | undefined): Promise<WebsiteBlogIndex> {
81
+ return buildWebsiteBlogIndex(await getCollection('blog'), { locale, ...(limit === undefined ? {} : { limit }) });
82
+ }
83
+
84
+ export async function preparePage(input: {
85
+ readonly manifest: WebsitePageManifest;
86
+ readonly astroLocale: string | undefined;
87
+ readonly pricing?: boolean;
88
+ readonly blog?: { readonly limit?: number };
89
+ }): Promise<PreparedPage> {
90
+ const runtime = loadWebsitePageRuntime({
91
+ manifest: input.manifest,
92
+ siteContext: WEBSITE_SITE_CONTEXT,
93
+ labelPacksDir: './src/i18n',
94
+ astroLocale: input.astroLocale,
55
95
  });
96
+ const pageRef = String(input.manifest.ref);
97
+ const pricingCatalog = input.pricing === true ? await loadPricingCatalog() : undefined;
98
+ const blogIndex = input.blog === undefined ? undefined : await loadBlogIndex(runtime.locale, input.blog.limit);
99
+ const pagePayloads = buildPageStructuredData({
100
+ pageRef,
101
+ locale: runtime.locale,
102
+ defaultLocale: runtime.defaultLocale,
103
+ labelPack: runtime.labelPack as Readonly<Record<string, string>>,
104
+ ...(pricingCatalog === undefined ? {} : { pricingCatalog }),
105
+ });
106
+ const headHtml = [
107
+ renderWebsitePageHeadHtml({
108
+ manifest: input.manifest,
109
+ siteContext: WEBSITE_SITE_CONTEXT,
110
+ locale: runtime.locale,
111
+ labelPack: runtime.labelPack,
112
+ }),
113
+ WEBSITE_META_CSP_HEAD_HTML,
114
+ WEBSITE_ICON_HEAD_HTML,
115
+ '<link rel="preload" href="/fonts/InterVariable.woff2" as="font" type="font/woff2" crossorigin />',
116
+ // The sections' own JSON-LD (an FAQ's questions, in this locale) and the page-wide payloads.
117
+ renderPageStructuredData({ sections: resolveSectionsForManifest(input.manifest), context: runtime.structuredData, pagePayloads }),
118
+ ].join('\n');
119
+ return {
120
+ locale: runtime.locale,
121
+ headHtml,
122
+ designTokensCss: renderWebsiteDesignTokensCss(WEBSITE_SITE_CONTEXT.rootConfig.designTokens),
123
+ islandProps: {
124
+ locale: runtime.locale,
125
+ defaultLocale: runtime.defaultLocale,
126
+ locales: WEBSITE_SITE_CONTEXT.websiteConfig.locales.map((entry) => entry.locale),
127
+ appOrigin: WEBSITE_SITE_CONTEXT.websiteConfig.appOrigin,
128
+ // Whether the operator owes a legal notice (#2588): the footer links it, and refuses to render without the answer.
129
+ ...(WEBSITE_SITE_CONTEXT.legalNoticeOwed === undefined ? {} : { legalNoticeOwed: WEBSITE_SITE_CONTEXT.legalNoticeOwed }),
130
+ // Which public documents the application serves (#2987): the footer links only those. Absent: it links every one.
131
+ ...(WEBSITE_SITE_CONTEXT.servedPublicDocumentRefs === undefined ? {} : { servedPublicDocumentRefs: WEBSITE_SITE_CONTEXT.servedPublicDocumentRefs }),
132
+ apiOrigin: WEBSITE_SITE_CONTEXT.websiteConfig.apiOrigin,
133
+ labelPack: runtime.labelPack,
134
+ designTokens: WEBSITE_SITE_CONTEXT.rootConfig.designTokens,
135
+ skipToMainContentLabelKey: WEBSITE_SITE_CONTEXT.rootConfig.skipToMainContentLabelKey,
136
+ frontendProviders: WEBSITE_SITE_CONTEXT.frontendProviders,
137
+ ...(pricingCatalog === undefined ? {} : { pricingCatalog }),
138
+ ...(blogIndex === undefined ? {} : { blogIndex }),
139
+ },
140
+ };
56
141
  }
57
142
  ```
58
143
 
59
- The pricing route's frontmatter loads the catalogue, hands it to the island and renders the offers with the page's
60
- own context (`runtime` is the route's `loadWebsitePageRuntime(...)`):
61
-
62
- ```astro
63
- ---
64
- import { renderPageStructuredData } from '@wildo-ai/saas-website/astro';
65
- import { loadWebsitePricingCatalog } from '@wildo-ai/saas-website/config-loader';
66
- import { PRICING_SECTIONS } from '@/sections/pricing.sections';
67
- import { pricingOffers } from '@/structured-data/page-payloads';
68
-
69
- const pricingCatalog = await loadWebsitePricingCatalog();
70
- const structuredDataHtml = renderPageStructuredData({
71
- sections: PRICING_SECTIONS,
72
- context: runtime.structuredData,
73
- pagePayloads: pricingOffers(pricingCatalog, runtime.structuredData),
74
- });
75
- ---
76
- <!-- …and in the body: <PricingBridgeIsland client:idle pricingCatalog={pricingCatalog} … /> -->
144
+ ## The audit reads the same function, once per locale
145
+
146
+ `wildo website audit` reaches the payloads through `resolveStructuredDataPagePayloadsForManifest`. It calls the SAME
147
+ function the route calls, once per locale, with the same label packs and the same catalogue, so the audit checks exactly
148
+ what the site serves:
149
+
150
+
151
+ ## Usage Example
152
+
153
+ ```typescript
154
+ // The engine's own rules for a locale's pack and route, so this audit reads and addresses what the site serves (#2810).
155
+ function labelPack(locale: AvailableLanguage): Readonly<Record<string, string>> {
156
+ return loadLabelPack(LABEL_PACKS_DIR, locale);
157
+ }
158
+
159
+ function localizedRoutePath(routePath: string, locale: AvailableLanguage): string {
160
+ return buildLocalizedRoutePath({ locale, defaultLocale: websiteConfig.defaultLocale, routePath });
161
+ }
162
+
163
+ export function resolveStructuredDataPagePayloadsForManifest(
164
+ manifest: Pick<StructuredDataPageManifestLike, 'ref'> & { readonly routePath: string },
165
+ pricingCatalog: PublicPricingCatalog,
166
+ ): readonly StructuredDataPagePayloadLike[] {
167
+ const pageRef = String(manifest.ref);
168
+ if (pageRef === BLOG_POST_PAGE_REF) {
169
+ return resolveBlogPostStructuredDataPagePayloads(pageRef);
170
+ }
171
+ return websiteConfig.locales.flatMap((entry) => {
172
+ const locale = String(entry.locale);
173
+ const payloads = buildPageStructuredData({
174
+ pageRef,
175
+ locale,
176
+ defaultLocale: String(websiteConfig.defaultLocale),
177
+ labelPack: labelPack(entry.locale),
178
+ pricingCatalog,
179
+ });
180
+ return payloads.length === 0
181
+ ? []
182
+ : [{ pageRef, routePath: localizedRoutePath(manifest.routePath, entry.locale), sourceRef: `page:${pageRef}:${locale}`, payloads }];
183
+ });
184
+ }
77
185
  ```
186
+
187
+ The site's reconciliation adapter (`website/src/structured-data/reconcile-structured-data.ts` in the worked example),
188
+ which the audit calls, loads the catalogue with the same `loadWebsitePricingCatalog({ targetScope: 'organizations' })`
189
+ the page helper uses, and passes it in.
@@ -36,6 +36,7 @@ of it. Read this when:
36
36
  * **Node-only.** Lives on the `/config-loader` subpath; it must never reach a React-island bundle.
37
37
  */
38
38
  import {
39
+ ConfigModuleResolution,
39
40
  loadApplicationPublicPricingCatalog,
40
41
  loadConfig,
41
42
  resolveWorkspaceScope,
@@ -61,7 +62,8 @@ export async function loadWebsitePricingCatalog(input: LoadWebsitePricingCatalog
61
62
  + 'Run astro from inside the application workspace.',
62
63
  );
63
64
  }
64
- const saasConfig = await loadConfig<WildoSaasConfig>(workspaceScope.saasConfigPath);
65
+ // Against the built framework packages, as `loadWebsiteSiteContext` reads it (#3440).
66
+ const saasConfig = await loadConfig<WildoSaasConfig>(workspaceScope.saasConfigPath, { moduleResolution: ConfigModuleResolution.LOADER_INSTANCES });
65
67
  return loadApplicationPublicPricingCatalog({
66
68
  saasRoot: workspaceScope.saasRoot,
67
69
  saasConfig,