@wildo-ai/framework-knowledge 1.1.11 → 1.1.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (803) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
  3. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
  4. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
  5. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
  6. package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
  7. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
  8. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
  9. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
  10. package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
  11. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  12. package/dist/esm/framework-knowledge.definitions.js +170 -32
  13. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  14. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  15. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  16. package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
  17. package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
  18. package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
  19. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  20. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  21. package/dist/esm/index.d.ts.map +1 -1
  22. package/dist/esm/index.js.map +1 -1
  23. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
  24. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
  31. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  32. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
  35. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
  45. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
  47. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
  50. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
  52. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
  54. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +29 -3
  56. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +80 -16
  58. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  61. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
  62. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  63. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
  64. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  65. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
  66. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
  68. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  69. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  71. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
  72. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
  74. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
  76. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
  78. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  80. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
  81. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
  82. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  83. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
  84. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
  85. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
  86. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
  88. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  89. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  90. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
  91. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  92. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
  93. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  94. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
  95. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
  96. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
  99. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
  101. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  103. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
  104. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  105. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  106. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
  107. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  108. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
  109. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  110. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
  111. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
  113. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  114. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
  115. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  116. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
  117. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  118. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
  119. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
  121. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  122. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
  123. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  124. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
  125. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
  127. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  129. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
  130. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  131. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
  132. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  133. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
  134. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  135. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  136. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  137. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
  138. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  139. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
  140. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  141. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  142. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  143. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  144. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
  145. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  146. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  147. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  148. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
  149. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  150. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  151. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  153. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
  154. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  156. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
  157. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  158. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
  159. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  160. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
  161. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  162. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
  163. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  164. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
  165. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  166. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
  167. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  168. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
  169. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  170. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
  171. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
  172. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
  173. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
  174. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
  175. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  176. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
  177. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  178. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
  179. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  180. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
  181. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  182. package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
  183. package/dist/esm/source-anchor-grammar.js.map +1 -1
  184. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  185. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  186. package/dist/knowledge/manifest.json +7 -7
  187. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
  188. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
  189. package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
  190. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
  191. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  192. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  193. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
  194. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
  195. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
  196. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
  197. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
  198. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
  199. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
  200. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
  201. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
  202. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  203. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  204. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
  205. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
  206. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
  207. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
  208. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
  209. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +51 -7
  210. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
  211. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
  212. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +10 -2
  213. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
  214. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
  215. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
  216. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
  217. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
  218. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
  219. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
  220. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
  221. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
  222. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
  223. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
  224. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
  225. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
  226. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
  227. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
  228. package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
  229. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
  230. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
  231. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
  232. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  233. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  234. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
  235. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
  236. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
  237. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
  238. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
  239. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
  240. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
  241. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
  242. package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
  243. package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
  244. package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
  245. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
  246. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
  247. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
  248. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
  249. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
  250. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
  251. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
  252. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
  253. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
  254. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
  255. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
  256. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
  257. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
  258. package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
  259. package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
  260. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
  261. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
  262. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
  263. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
  264. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
  265. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
  266. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
  267. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
  268. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  269. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  270. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
  271. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +10 -6
  272. package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
  273. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
  274. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
  275. package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
  276. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
  277. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
  278. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
  279. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
  280. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
  281. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
  282. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
  283. package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
  284. package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
  285. package/dist/knowledge/references/application-maturity.config.md +27 -1
  286. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
  287. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
  288. package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
  289. package/dist/knowledge/references/brand.name-screening.config.md +30 -3
  290. package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
  291. package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
  292. package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
  293. package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
  294. package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
  295. package/dist/knowledge/references/companion.market.generation-service.md +46 -5
  296. package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
  297. package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
  298. package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
  299. package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
  300. package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
  301. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
  302. package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
  303. package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
  304. package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
  305. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
  306. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
  307. package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
  308. package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
  309. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
  310. package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
  311. package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
  312. package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
  313. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
  314. package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
  315. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
  316. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
  317. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
  318. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
  319. package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
  320. package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
  321. package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
  322. package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
  323. package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
  324. package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
  325. package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
  326. package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
  327. package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
  328. package/dist/knowledge/references/example.website.section.stats.md +1 -1
  329. package/dist/knowledge/references/experience-plan.config.md +111 -1
  330. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
  331. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
  332. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
  333. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
  334. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
  335. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
  336. package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
  337. package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
  338. package/dist/knowledge/references/integration-plan.config.md +7 -7
  339. package/dist/knowledge/references/placement-plan.config.md +19 -0
  340. package/dist/knowledge/references/platform.config.backing-services.md +9 -11
  341. package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
  342. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
  343. package/dist/knowledge/references/platform.config.infrastructure-host.md +0 -1
  344. package/dist/knowledge/references/platform.config.platform-key-management.md +84 -8
  345. package/dist/knowledge/references/platform.config.saas.md +20 -18
  346. package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
  347. package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
  348. package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
  349. package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
  350. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
  351. package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
  352. package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
  353. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +4 -4
  354. package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
  355. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +29 -2
  356. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
  357. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
  358. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
  359. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  360. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
  361. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
  362. package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
  363. package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
  364. package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
  365. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
  366. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
  367. package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
  368. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
  369. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
  370. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +363 -2
  371. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
  372. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
  373. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
  374. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
  375. package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
  376. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
  377. package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
  378. package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
  379. package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
  380. package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
  381. package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
  382. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
  383. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
  384. package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
  385. package/dist/knowledge/references/saas.frontend.chart-dashboard.md +130 -0
  386. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
  387. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
  388. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
  389. package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
  390. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
  391. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
  392. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
  393. package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
  394. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
  395. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
  396. package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
  397. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
  398. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
  399. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
  400. package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
  401. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
  402. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
  403. package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
  404. package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
  405. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
  406. package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
  407. package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
  408. package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
  409. package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
  410. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
  411. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
  412. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
  413. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
  414. package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
  415. package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
  416. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
  417. package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
  418. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
  419. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
  420. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
  421. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
  422. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
  423. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
  424. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
  425. package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
  426. package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
  427. package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
  428. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
  429. package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
  430. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
  431. package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
  432. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
  433. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
  434. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
  435. package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
  436. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
  437. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
  438. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
  439. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
  440. package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
  441. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
  442. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
  443. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
  444. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
  445. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
  446. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
  447. package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
  448. package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
  449. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
  450. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
  451. package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
  452. package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
  453. package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
  454. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
  455. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
  456. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
  457. package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
  458. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
  459. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
  460. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
  461. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
  462. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
  463. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
  464. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
  465. package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
  466. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
  467. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
  468. package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
  469. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
  470. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
  471. package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
  472. package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
  473. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
  474. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
  475. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
  476. package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
  477. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
  478. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
  479. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
  480. package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
  481. package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
  482. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
  483. package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
  484. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
  485. package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
  486. package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
  487. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
  488. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
  489. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
  490. package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
  491. package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
  492. package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
  493. package/dist/knowledge/references/service-method.config.md +35 -2
  494. package/dist/knowledge/references/vision.constraint.config.md +4 -2
  495. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
  496. package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
  497. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
  498. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
  499. package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
  500. package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
  501. package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
  502. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
  503. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
  504. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
  505. package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
  506. package/dist/knowledge/references/zod.factories.code.md +4 -4
  507. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  508. package/dist/knowledge/references/zod.factories.money.md +4 -4
  509. package/dist/knowledge/references/zod.factories.phone.md +4 -4
  510. package/dist/knowledge/references/zod.factories.year-month.md +79 -0
  511. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  512. package/dist/knowledge/registries/framework-topics.json +415 -2
  513. package/dist/knowledge/registries/playbooks.json +51 -39
  514. package/dist/knowledge/registries/source-tags.json +2412 -1604
  515. package/dist/knowledge/rules/database-migration-obligation.md +6 -7
  516. package/dist/knowledge/rules/live-context-door.md +1 -1
  517. package/dist/knowledge/skills/INDEX.md +3 -1
  518. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
  519. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
  520. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
  521. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
  522. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
  523. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
  524. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
  525. package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
  526. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
  527. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
  528. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
  529. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
  530. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
  531. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
  532. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
  533. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
  534. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  535. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
  536. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
  537. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
  538. package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
  539. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
  540. package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
  541. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
  542. package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
  543. package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +79 -0
  544. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
  545. package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
  546. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
  547. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
  548. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
  549. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
  550. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
  551. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
  552. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
  553. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
  554. package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
  555. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
  556. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
  557. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
  558. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
  559. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
  560. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
  561. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
  562. package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
  563. package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
  564. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
  565. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
  566. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
  567. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
  568. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
  569. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +197 -9
  570. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
  571. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
  572. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
  573. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
  574. package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
  575. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
  576. package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
  577. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
  578. package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
  579. package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
  580. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
  581. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
  582. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
  583. package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
  584. package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +61 -0
  585. package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
  586. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
  587. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
  588. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
  589. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
  590. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
  591. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +1 -1
  592. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
  593. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +18 -7
  594. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
  595. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
  596. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +44 -4
  597. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
  598. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
  599. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
  600. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
  601. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
  602. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +375 -8
  603. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
  604. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
  605. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
  606. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +1 -1
  607. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
  608. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
  609. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +1 -1
  610. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
  611. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
  612. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +3 -3
  613. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +37 -14
  614. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
  615. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
  616. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
  617. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
  618. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
  619. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
  620. package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
  621. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
  622. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
  623. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
  624. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
  625. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
  626. package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
  627. package/dist/knowledge/skills/infra-environment-config/SKILL.md +125 -77
  628. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
  629. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
  630. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +0 -1
  631. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +84 -8
  632. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
  633. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
  634. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
  635. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
  636. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
  637. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
  638. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
  639. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
  640. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
  641. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
  642. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
  643. package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
  644. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
  645. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
  646. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
  647. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
  648. package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
  649. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
  650. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
  651. package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
  652. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
  653. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
  654. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
  655. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
  656. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
  657. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
  658. package/dist/knowledge/skills/provider-backend-package/SKILL.md +255 -12
  659. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
  660. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
  661. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
  662. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
  663. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
  664. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
  665. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
  666. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
  667. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
  668. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
  669. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
  670. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
  671. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
  672. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
  673. package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
  674. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
  675. package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
  676. package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
  677. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
  678. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
  679. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
  680. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
  681. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
  682. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +33 -7
  683. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
  684. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
  685. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
  686. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +7 -2
  687. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
  688. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
  689. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
  690. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
  691. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
  692. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
  693. package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
  694. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
  695. package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
  696. package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
  697. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
  698. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
  699. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
  700. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
  701. package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
  702. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
  703. package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
  704. package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
  705. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
  706. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
  707. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
  708. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
  709. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
  710. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
  711. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
  712. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
  713. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
  714. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
  715. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
  716. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
  717. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
  718. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
  719. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
  720. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
  721. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
  722. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  723. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
  724. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
  725. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
  726. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
  727. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
  728. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
  729. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
  730. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
  731. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
  732. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
  733. package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
  734. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
  735. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
  736. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
  737. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
  738. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
  739. package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
  740. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
  741. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
  742. package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
  743. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
  744. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
  745. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
  746. package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
  747. package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
  748. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
  749. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
  750. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
  751. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
  752. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
  753. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
  754. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
  755. package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
  756. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
  757. package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
  758. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
  759. package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
  760. package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
  761. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
  762. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
  763. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  764. package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
  765. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
  766. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
  767. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
  768. package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
  769. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
  770. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
  771. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
  772. package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
  773. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
  774. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
  775. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
  776. package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
  777. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
  778. package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
  779. package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
  780. package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
  781. package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
  782. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
  783. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
  784. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
  785. package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
  786. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
  787. package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
  788. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
  789. package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
  790. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
  791. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
  792. package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
  793. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
  794. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
  795. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
  796. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
  797. package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
  798. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
  799. package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
  800. package/dist/knowledge/topic-index.json +2275 -715
  801. package/dist/tsconfig.build.tsbuildinfo +1 -1
  802. package/package.json +6 -6
  803. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -41,6 +41,13 @@ export enum LabellingTypes {
41
41
  ROLES = "roles",
42
42
  SYSTEM_ENUMS = "system_enums",
43
43
  SIDEBAR_SECTIONS = "sidebar_sections",
44
+ /**
45
+ * The command menu's APPLICATION-defined categories (#3122): `command_categories.<ref>.label`, the heading of the
46
+ * group a command or a record search sits under. The engine's own categories (navigation, actions, help, other,
47
+ * settings) keep their words on the command menu component; an application's are its own ref space, like its
48
+ * sidebar sections, so they are planned from its launcher contributions.
49
+ */
50
+ COMMAND_CATEGORIES = "command_categories",
44
51
  SETTINGS_HUB = "settings_hub",
45
52
  COMPOSITE_VIEWS = "composite_views",
46
53
  VIEWS = "views",
@@ -53,6 +60,35 @@ export enum LabellingTypes {
53
60
  BILLING_CREDIT_POOLS = "billing_credit_pools",
54
61
  BACKEND_AUTH_MESSAGES = "backend_auth_messages",
55
62
  BACKEND_SMS = "backend_sms",
63
+ /**
64
+ * The words of documents the BACKEND writes outside a PDF template (#2907): today the approval page of an approved
65
+ * deliverable's manifested copy (`backend_documents.approval_manifestation.<word>`). Planned from the engine's
66
+ * declaration of each document's words (`APPROVAL_SEAL_MANIFESTATION_WORDS`), backend-only, read in ONE language.
67
+ */
68
+ BACKEND_DOCUMENTS = "backend_documents",
69
+ }
70
+
71
+ /**
72
+ * The command menu's OWN categories (#3122): the groups the engine heads with the command menu component's words
73
+ * (`components.APPLICATION_LEVEL_COMMAND_MENU.<category>`). Any other `category` a command or a record search names
74
+ * is the application's, and is headed by `command_categories.<category>.label`, which the labelling pipeline plans
75
+ * from the application's launcher contributions.
76
+ */
77
+ export enum CommandMenuEngineCategory {
78
+ NAVIGATION = 'navigation',
79
+ ACTIONS = 'actions',
80
+ HELP = 'help',
81
+ OTHER = 'other',
82
+ SETTINGS = 'settings',
83
+ /** The engine's billing command (`BILLING_COMMAND_MENU_ITEM`), which every application with billing lists. */
84
+ BILLING = 'billing',
85
+ }
86
+
87
+ const COMMAND_MENU_ENGINE_CATEGORIES: ReadonlySet<string> = new Set(Object.values(CommandMenuEngineCategory));
88
+
89
+ /** Whether `category` is one of the engine's own command-menu categories ({@link CommandMenuEngineCategory}). */
90
+ export function isCommandMenuEngineCategory(category: string): boolean {
91
+ return COMMAND_MENU_ENGINE_CATEGORIES.has(category);
56
92
  }
57
93
 
58
94
  /**
@@ -67,6 +103,8 @@ export const EAGER_I18N_SECTIONS: LabellingTypes[] = [
67
103
  LabellingTypes.ERRORS_REFUSALS,
68
104
  LabellingTypes.ERRORS_GUIDANCE,
69
105
  LabellingTypes.SIDEBAR_SECTIONS,
106
+ // Eager like the sidebar's sections: the command menu is global, opens from a shortcut, and heads each group with one.
107
+ LabellingTypes.COMMAND_CATEGORIES,
70
108
  LabellingTypes.SETTINGS_HUB,
71
109
  LabellingTypes.LIFECYCLE,
72
110
  // Eager since #1851: a feature's and a limit's words (a `SectionedVocabulary`) are read wherever a feature or limit
@@ -82,5 +120,6 @@ export const EAGER_I18N_SECTIONS: LabellingTypes[] = [
82
120
  export const BACKEND_ONLY_I18N_SECTIONS: LabellingTypes[] = [
83
121
  LabellingTypes.BACKEND_AUTH_MESSAGES,
84
122
  LabellingTypes.BACKEND_SMS,
123
+ LabellingTypes.BACKEND_DOCUMENTS,
85
124
  ];
86
125
  ```
@@ -41,6 +41,13 @@ export enum LabellingTypes {
41
41
  ROLES = "roles",
42
42
  SYSTEM_ENUMS = "system_enums",
43
43
  SIDEBAR_SECTIONS = "sidebar_sections",
44
+ /**
45
+ * The command menu's APPLICATION-defined categories (#3122): `command_categories.<ref>.label`, the heading of the
46
+ * group a command or a record search sits under. The engine's own categories (navigation, actions, help, other,
47
+ * settings) keep their words on the command menu component; an application's are its own ref space, like its
48
+ * sidebar sections, so they are planned from its launcher contributions.
49
+ */
50
+ COMMAND_CATEGORIES = "command_categories",
44
51
  SETTINGS_HUB = "settings_hub",
45
52
  COMPOSITE_VIEWS = "composite_views",
46
53
  VIEWS = "views",
@@ -53,6 +60,35 @@ export enum LabellingTypes {
53
60
  BILLING_CREDIT_POOLS = "billing_credit_pools",
54
61
  BACKEND_AUTH_MESSAGES = "backend_auth_messages",
55
62
  BACKEND_SMS = "backend_sms",
63
+ /**
64
+ * The words of documents the BACKEND writes outside a PDF template (#2907): today the approval page of an approved
65
+ * deliverable's manifested copy (`backend_documents.approval_manifestation.<word>`). Planned from the engine's
66
+ * declaration of each document's words (`APPROVAL_SEAL_MANIFESTATION_WORDS`), backend-only, read in ONE language.
67
+ */
68
+ BACKEND_DOCUMENTS = "backend_documents",
69
+ }
70
+
71
+ /**
72
+ * The command menu's OWN categories (#3122): the groups the engine heads with the command menu component's words
73
+ * (`components.APPLICATION_LEVEL_COMMAND_MENU.<category>`). Any other `category` a command or a record search names
74
+ * is the application's, and is headed by `command_categories.<category>.label`, which the labelling pipeline plans
75
+ * from the application's launcher contributions.
76
+ */
77
+ export enum CommandMenuEngineCategory {
78
+ NAVIGATION = 'navigation',
79
+ ACTIONS = 'actions',
80
+ HELP = 'help',
81
+ OTHER = 'other',
82
+ SETTINGS = 'settings',
83
+ /** The engine's billing command (`BILLING_COMMAND_MENU_ITEM`), which every application with billing lists. */
84
+ BILLING = 'billing',
85
+ }
86
+
87
+ const COMMAND_MENU_ENGINE_CATEGORIES: ReadonlySet<string> = new Set(Object.values(CommandMenuEngineCategory));
88
+
89
+ /** Whether `category` is one of the engine's own command-menu categories ({@link CommandMenuEngineCategory}). */
90
+ export function isCommandMenuEngineCategory(category: string): boolean {
91
+ return COMMAND_MENU_ENGINE_CATEGORIES.has(category);
56
92
  }
57
93
 
58
94
  /**
@@ -67,6 +103,8 @@ export const EAGER_I18N_SECTIONS: LabellingTypes[] = [
67
103
  LabellingTypes.ERRORS_REFUSALS,
68
104
  LabellingTypes.ERRORS_GUIDANCE,
69
105
  LabellingTypes.SIDEBAR_SECTIONS,
106
+ // Eager like the sidebar's sections: the command menu is global, opens from a shortcut, and heads each group with one.
107
+ LabellingTypes.COMMAND_CATEGORIES,
70
108
  LabellingTypes.SETTINGS_HUB,
71
109
  LabellingTypes.LIFECYCLE,
72
110
  // Eager since #1851: a feature's and a limit's words (a `SectionedVocabulary`) are read wherever a feature or limit
@@ -82,5 +120,6 @@ export const EAGER_I18N_SECTIONS: LabellingTypes[] = [
82
120
  export const BACKEND_ONLY_I18N_SECTIONS: LabellingTypes[] = [
83
121
  LabellingTypes.BACKEND_AUTH_MESSAGES,
84
122
  LabellingTypes.BACKEND_SMS,
123
+ LabellingTypes.BACKEND_DOCUMENTS,
85
124
  ];
86
125
  ```
@@ -61,6 +61,7 @@ barrel edit — the scanner discovers locale files by basename suffix.
61
61
  | Engine i18n barrel | `backend-api/src/engine/i18n/index.ts` (auto-discovers all locales via `scanCustomLabelsDirectory`) |
62
62
  | Lock file | `wildo-saas.lock.json` at the SaaS root (tracks per-unit per-locale `outputSha`) |
63
63
  | Translation CLI command | `wildo generate translate --locales=<csv>` |
64
+ | Translation glossary (authored) | `specifications/src/translation-glossary/index.ts`, exported as `translationGlossary` from `specifications/src/companion-exports.ts` |
64
65
 
65
66
  ## When to Use
66
67
 
@@ -75,7 +76,8 @@ barrel edit — the scanner discovers locale files by basename suffix.
75
76
  - Coordinating both label authoring + translation in one pass →
76
77
  `i18n-rerun-pipeline` (the **orchestration** step)
77
78
  - Hand-editing a per-unit `<slug>.<locale>.ts` file directly (the
78
- next pipeline run overwrites it)
79
+ next pipeline run overwrites it). To keep a word, declare it in the
80
+ glossary (Step 2b)
79
81
 
80
82
  ## Workflow
81
83
 
@@ -116,6 +118,31 @@ then verify that generated translation artifacts are updated consistently with
116
118
  the source-language change.
117
119
 
118
120
 
121
+ ### Step 2b: Keep a word you chose — the glossary
122
+
123
+ A translated word is the model's until the application declares otherwise. The same English can come back
124
+ worded differently in two units, or differently in the same unit after a re-translation. A hand edit of the
125
+ generated file does not hold: the next run sees the file no longer matches its lock and translates the unit
126
+ again. To keep a word, declare it in the **translation glossary**:
127
+
128
+ - **A term** applies to every string, email templates included. A string that IS the term is written as the
129
+ chosen translation with no model call. A string that CONTAINS it is sent with the chosen wording named,
130
+ and an answer that drops it is asked for again. If it is still dropped, the key stays owed and the run
131
+ reports it: a label key keeps the word it had (or its source words, if it had none), while an email,
132
+ translated whole, keeps the answer. Matching ignores case but is literal, so a plural or inflected form
133
+ needs its own term. Use `doNotTranslate: true` for a product name, a brand or an acronym.
134
+ - **A locked translation** pins one key of one unit (`--units` id) in one language. It is written as
135
+ declared and never sent. When the key's source words change, the lock is reported as stale, the word is
136
+ left alone and the key stays owed, so update the lock's `source` and `value` yourself (or remove it).
137
+ A lock naming no planned key is reported, and a lock on an email template refuses the run: an email is
138
+ translated whole, so use a term.
139
+
140
+ Declare it in the specifications package and export it from its companion exports as `translationGlossary`.
141
+ Read `references/framework-translation-glossary-api.md` for the shape. A declaration that does not parse
142
+ refuses the translate run rather than being ignored. Declaring or changing a term reaches the translations
143
+ that contradict it on the next ordinary run. Only those keys are re-sent, and every other word stays as it is.
144
+ The run reports which keys it wrote from a term or a lock, and which it could not.
145
+
119
146
  ### Step 3: Verify the per-unit target files
120
147
 
121
148
  For each unit, check that:
@@ -194,6 +221,7 @@ What this skill does **not** touch:
194
221
 
195
222
  - `references/translation-workflow.md` — translate command flow
196
223
  - `references/framework-labelling-sections-api.md` — `LabellingTypes` / eager vs backend-only sections
224
+ - `references/framework-translation-glossary-api.md` — the glossary's terms and locked translations
197
225
  - `i18n-label-generation/SKILL.md` — author the source-locale keys
198
226
  - `i18n-rerun-pipeline/SKILL.md` — coordinated label + translation rerun (the orchestration counterpart)
199
227
 
@@ -235,7 +263,8 @@ missed units or silently emitted blank strings.
235
263
 
236
264
  | Rationalization | Reality |
237
265
  |-----------------|---------|
238
- | "Just hand-edit the missing French strings in the per-unit file" | Hand edits to `<slug>.<locale>.ts` are overwritten on the next pipeline run. Run `wildo generate translate`; the source-of-truth is the source-locale file plus the translation engine. |
266
+ | "Just hand-edit the missing French strings in the per-unit file" | Hand edits to `<slug>.<locale>.ts` are overwritten on the next pipeline run. Run `wildo generate translate`; to keep a chosen word, declare it in the glossary (Step 2b). |
267
+ | "The model will keep the word it used last time" | It will not: a re-translated unit is worded again, and two units with the same English can disagree. Pin the word with a glossary term. |
239
268
  | "Machine-translate later, before release" | "Later" silently slips. The audit at release time shows N missing keys; rerunning per change-set keeps the gap at zero throughout. |
240
269
  | "Skip translation for non-customer-facing keys" | Generic-sounding keys often surface in unexpected places (error toasts, audit logs). Translate them all; suppress at the resolver layer if a locale truly intends to skip. |
241
270
  | "Just bump the source-locale string in place; the resolver will fall back" | Falling back to the source locale is a degraded experience, not the contract. Rerun translation so each locale carries the correct string. |
@@ -41,6 +41,13 @@ export enum LabellingTypes {
41
41
  ROLES = "roles",
42
42
  SYSTEM_ENUMS = "system_enums",
43
43
  SIDEBAR_SECTIONS = "sidebar_sections",
44
+ /**
45
+ * The command menu's APPLICATION-defined categories (#3122): `command_categories.<ref>.label`, the heading of the
46
+ * group a command or a record search sits under. The engine's own categories (navigation, actions, help, other,
47
+ * settings) keep their words on the command menu component; an application's are its own ref space, like its
48
+ * sidebar sections, so they are planned from its launcher contributions.
49
+ */
50
+ COMMAND_CATEGORIES = "command_categories",
44
51
  SETTINGS_HUB = "settings_hub",
45
52
  COMPOSITE_VIEWS = "composite_views",
46
53
  VIEWS = "views",
@@ -53,6 +60,35 @@ export enum LabellingTypes {
53
60
  BILLING_CREDIT_POOLS = "billing_credit_pools",
54
61
  BACKEND_AUTH_MESSAGES = "backend_auth_messages",
55
62
  BACKEND_SMS = "backend_sms",
63
+ /**
64
+ * The words of documents the BACKEND writes outside a PDF template (#2907): today the approval page of an approved
65
+ * deliverable's manifested copy (`backend_documents.approval_manifestation.<word>`). Planned from the engine's
66
+ * declaration of each document's words (`APPROVAL_SEAL_MANIFESTATION_WORDS`), backend-only, read in ONE language.
67
+ */
68
+ BACKEND_DOCUMENTS = "backend_documents",
69
+ }
70
+
71
+ /**
72
+ * The command menu's OWN categories (#3122): the groups the engine heads with the command menu component's words
73
+ * (`components.APPLICATION_LEVEL_COMMAND_MENU.<category>`). Any other `category` a command or a record search names
74
+ * is the application's, and is headed by `command_categories.<category>.label`, which the labelling pipeline plans
75
+ * from the application's launcher contributions.
76
+ */
77
+ export enum CommandMenuEngineCategory {
78
+ NAVIGATION = 'navigation',
79
+ ACTIONS = 'actions',
80
+ HELP = 'help',
81
+ OTHER = 'other',
82
+ SETTINGS = 'settings',
83
+ /** The engine's billing command (`BILLING_COMMAND_MENU_ITEM`), which every application with billing lists. */
84
+ BILLING = 'billing',
85
+ }
86
+
87
+ const COMMAND_MENU_ENGINE_CATEGORIES: ReadonlySet<string> = new Set(Object.values(CommandMenuEngineCategory));
88
+
89
+ /** Whether `category` is one of the engine's own command-menu categories ({@link CommandMenuEngineCategory}). */
90
+ export function isCommandMenuEngineCategory(category: string): boolean {
91
+ return COMMAND_MENU_ENGINE_CATEGORIES.has(category);
56
92
  }
57
93
 
58
94
  /**
@@ -67,6 +103,8 @@ export const EAGER_I18N_SECTIONS: LabellingTypes[] = [
67
103
  LabellingTypes.ERRORS_REFUSALS,
68
104
  LabellingTypes.ERRORS_GUIDANCE,
69
105
  LabellingTypes.SIDEBAR_SECTIONS,
106
+ // Eager like the sidebar's sections: the command menu is global, opens from a shortcut, and heads each group with one.
107
+ LabellingTypes.COMMAND_CATEGORIES,
70
108
  LabellingTypes.SETTINGS_HUB,
71
109
  LabellingTypes.LIFECYCLE,
72
110
  // Eager since #1851: a feature's and a limit's words (a `SectionedVocabulary`) are read wherever a feature or limit
@@ -82,5 +120,6 @@ export const EAGER_I18N_SECTIONS: LabellingTypes[] = [
82
120
  export const BACKEND_ONLY_I18N_SECTIONS: LabellingTypes[] = [
83
121
  LabellingTypes.BACKEND_AUTH_MESSAGES,
84
122
  LabellingTypes.BACKEND_SMS,
123
+ LabellingTypes.BACKEND_DOCUMENTS,
85
124
  ];
86
125
  ```
@@ -0,0 +1,87 @@
1
+ # Translation glossary (source)
2
+
3
+ Read this when a translated word must not change between runs, or when two units translate the same source wording
4
+ differently.
5
+
6
+ - **`ApplicationTranslationGlossarySchema`**: what the specifications package exports as `translationGlossary`.
7
+ - **`TranslationGlossaryTermSchema`**: one term. It has either `translations` per language or `doNotTranslate: true`.
8
+ - **`LockedTranslationSchema`**: one key of one unit in one language, with the `source` words it was chosen for.
9
+
10
+ ## Import Origins
11
+
12
+ - `@wildo-ai/saas-specifications`
13
+
14
+ ## Source Excerpts
15
+
16
+ ### Origin Package: `@wildo-ai/saas-specifications`
17
+
18
+ ```typescript
19
+ *
20
+ * The application's translation glossary, exported by its specifications package as `translationGlossary`
21
+ * (`import { ApplicationTranslationGlossaryDeclaration } from '@wildo-ai/saas-specifications'`). Terms apply to every
22
+ * string `wildo generate translate` writes; a locked translation pins one key of one unit in one language. Matching is
23
+ * literal and ignores case: an inflected form is a different string and needs its own term.
24
+ */
25
+
26
+ /** One term of the glossary: an English (primary-language) wording and what it becomes in each language. */
27
+ export const TranslationGlossaryTermSchema = z
28
+ .strictObject({
29
+ /**
30
+ * The wording in the application's PRIMARY language, as it appears in labels (`ERP supplier key`). Matched without
31
+ * regard to case and at word boundaries, so `ERP supplier key` also matches inside "Edit the ERP supplier key".
32
+ */
33
+ term: z.string().trim().min(1),
34
+ /** The chosen translation per target language. A language with no entry is translated freely. */
35
+ translations: z.partialRecord(z.enum(AvailableLanguage).systemEnum('AvailableLanguage'), z.string().trim().min(1)).optional(),
36
+ /** The term stays as written in every language: a product name, a brand, an acronym. Excludes `translations`. */
37
+ doNotTranslate: z.literal(true).optional(),
38
+ /** Why this wording: read by people, and given to the model beside the term. */
39
+ note: z.string().trim().min(1).optional(),
40
+ })
41
+ .refine((term) => (term.doNotTranslate === true) !== (term.translations !== undefined && Object.keys(term.translations).length > 0), {
42
+ message: 'A glossary term declares either translations (at least one language) or doNotTranslate: true, never both and never neither.',
43
+ });
44
+ export type TranslationGlossaryTerm = z.infer<typeof TranslationGlossaryTermSchema>;
45
+
46
+ /** One key of one label unit whose word in one language a person chose. */
47
+ export const LockedTranslationSchema = z.strictObject({
48
+ /** The label unit, as `wildo generate translate --units` names it (`resource:supplierDirectory`). */
49
+ unitId: z.string().trim().min(1),
50
+ /** The key's full dotted path, from the root of the label file (`resources.supplierDirectory.header.title`). A key that matches nothing is reported and does nothing. */
51
+ key: z.string().trim().min(1),
52
+ /** The language whose word is chosen. */
53
+ locale: z.enum(AvailableLanguage).systemEnum('AvailableLanguage'),
54
+ /** The primary-language words this translation was chosen for. When the key's words change, the lock is stale. */
55
+ source: z.string().min(1),
56
+ /** The chosen translation, written as is. */
57
+ value: z.string().min(1),
58
+ /** Why this word, and who chose it if that matters. */
59
+ reason: z.string().trim().min(1),
60
+ });
61
+ export type LockedTranslation = z.infer<typeof LockedTranslationSchema>;
62
+
63
+ /** The application's glossary: the terms every string honours, and the keys a person locked. */
64
+ export const ApplicationTranslationGlossarySchema = z
65
+ .strictObject({
66
+ terms: z.array(TranslationGlossaryTermSchema).default([]),
67
+ lockedTranslations: z.array(LockedTranslationSchema).default([]),
68
+ })
69
+ .superRefine((glossary, context) => {
70
+ // Two entries for one term, or two locks on one word, would make the outcome depend on declaration order.
71
+ const terms = new Set<string>();
72
+ glossary.terms.forEach((term, index) => {
73
+ const normalized = term.term.toLocaleLowerCase();
74
+ if (terms.has(normalized)) context.addIssue({ code: 'custom', path: ['terms', index, 'term'], message: `The term "${term.term}" is declared twice.` });
75
+ terms.add(normalized);
76
+ });
77
+ const locks = new Set<string>();
78
+ glossary.lockedTranslations.forEach((lock, index) => {
79
+ const identity = `${lock.unitId}\u0000${lock.key}\u0000${lock.locale}`;
80
+ if (locks.has(identity)) context.addIssue({ code: 'custom', path: ['lockedTranslations', index], message: `The ${lock.locale} word of ${lock.unitId} ${lock.key} is locked twice.` });
81
+ locks.add(identity);
82
+ });
83
+ });
84
+ export type ApplicationTranslationGlossary = z.infer<typeof ApplicationTranslationGlossarySchema>;
85
+ /** What an application authors: both lists may be omitted. */
86
+ export type ApplicationTranslationGlossaryDeclaration = z.input<typeof ApplicationTranslationGlossarySchema>;
87
+ ```
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: inbound-channels
3
- description: Declare code that runs when a message ARRIVES — a signed webhook from another system, or an email from a person — on `BackendDomainModule.inboundHandlers`, stored once, retried and replayable, with the sender's assurance deciding whether the handler runs and never what it may do. Use when the user says "receive a webhook from X", "add an inbound webhook endpoint", "handle Svix / Resend webhooks", "a client's system should create records in our app", "verify an HMAC-signed callback", "replay a failed webhook", "why does /webhooks/app/<key> answer 404", "clients should email documents to a case", "turn incoming email into tickets", "reply to the sender automatically", "only accept mail from known contacts", "let each organization receive mail at its own domain", or "give each client a mailbox on our domain". Also when a system of record notifies that records changed ("Odoo posts a webhook when a partner changes", "refresh the synced customers when the ERP says so").
3
+ description: Declare code that runs when a message ARRIVES — a signed webhook, or an email or text from a person — on `BackendDomainModule.inboundHandlers`, stored once, retried and replayable, with the sender's assurance deciding whether the handler runs and never what it may do. Use when the user says "receive a webhook from X", "add an inbound webhook endpoint", "handle Svix / Resend webhooks", "a client's system should create records in our app", "verify an HMAC-signed callback", "replay a failed webhook", "why does /webhooks/app/<key> answer 404", "clients should email documents to a case", "turn incoming email into tickets", "reply to the sender automatically", "only accept mail from known contacts", "let each organization receive mail at its own domain", "give each client a mailbox on our domain", or "people should text our number". Also when a system of record notifies that records changed ("Odoo posts a webhook when a partner changes", "refresh the synced customers when the ERP says so").
4
4
  user-invocable: false
5
5
  ---
6
6
 
@@ -21,8 +21,8 @@ Read and apply these patterns from the application-developer point of view:
21
21
  ## Overview
22
22
 
23
23
  An inbound handler is backend code that runs on one message sent to your application: a signed delivery
24
- from another system (an ENDPOINT handler), or an email from a person (a CHANNEL handler,
25
- `references/email-channel.md`). You declare WHAT the message means; the engine owns everything between the wire and your
24
+ from another system (an ENDPOINT handler), or an email or a text message from a person (a CHANNEL handler,
25
+ `references/email-channel.md`, `references/sms-channel.md`). You declare WHAT the message means; the engine owns everything between the wire and your
26
26
  code: body limits, signature verification, a durable dedup ledger, scope resolution, retries, a DEAD
27
27
  state and operator replay. The handler runs later, in a worker, with the roles you declare — in exactly
28
28
  the one organization (or the application) the message resolved to, never in more.
@@ -41,6 +41,8 @@ the one organization (or the application) the message resolved to, never in more
41
41
  | Shared receiving domain | `backend-api/src/saas-config.backend.ts` → `email.inbound.sharedDomain`, the default; an environment lays its own over it in `wildo.infra.<env>.config.ts` → `email.inbound.sharedDomain` (`infra-environment-config`) |
42
42
  | Organization domains, relationship mailboxes | engine resources `organizationEmailDomains` / `relationshipMailboxes` — organization settings, no code |
43
43
  | Reply templates | the module's email templates (`email-add-template`) |
44
+ | SMS channel handler | same folder and naming as the email one, with `channel: InboundChannelKind.SMS` |
45
+ | Receiving texts | the SMS capability with a provider that reports received messages, on the backend scope with `SMS_PROVIDER` + `WEBHOOK_ORIGINATOR` (its notification endpoint enabled), and each organization's number as an `smsNumberAssignments` row the application's super-administrator creates — no code |
44
46
 
45
47
  ## When to Use
46
48
 
@@ -48,6 +50,8 @@ the one organization (or the application) the message resolved to, never in more
48
50
  - You need each event stored once, retried until it succeeds or is dead, and a way to replay what failed.
49
51
  - People email your application — documents to a case, requests to a support address — and the message
50
52
  should file, create or answer something.
53
+ - People text an organization's number (move a booking, answer a reminder) and the text should reach code, or be
54
+ answered by text (`references/sms-channel.md`).
51
55
  - A system of record notifies that records changed and the application keeps a synced copy of them: the
52
56
  handler asks the pipeline to re-read exactly those records (`ctx.pipelines.requestPipelineKeys`,
53
57
  `references/framework-inbound-pipelines-api.md`).
@@ -96,13 +100,18 @@ the one organization (or the application) the message resolved to, never in more
96
100
  3. **Declare the handler** with `defineInboundHandler` and a `payloadSchema` for the body
97
101
  (`references/framework-inbound-handler-api.md`). Keep `actingRoles` to what the handler writes —
98
102
  never `APP_ADMIN_SUPER_ADMIN`.
99
- 4. **Register it** on the module's `inboundHandlers`. A misdeclaration stops the backend at startup
103
+ 4. **Declare `subjectKeys`** when the payload can name a person: their email address, their phone number or
104
+ their user id, written with `inboundSubjectKeyForEmailAddress` / `inboundSubjectKeyForPhoneNumber`
105
+ (`@wildo-ai/saas-models`). A person's erasure deletes the deliveries naming them by these keys, and nothing
106
+ else can find them
107
+ (`references/inbound-delivery-lifecycle.md` → "What a stored delivery keeps").
108
+ 5. **Register it** on the module's `inboundHandlers`. A misdeclaration stops the backend at startup
100
109
  with the rule it broke.
101
- 5. **Provide the secret** in each environment's `secrets.json`, under `inboundEndpointEnv`, keyed by the
110
+ 6. **Provide the secret** in each environment's `secrets.json`, under `inboundEndpointEnv`, keyed by the
102
111
  name the engine derives from the endpoint key: `todo-intake` → `WILDO_INBOUND_TODO_INTAKE__SECRET`
103
112
  (`deriveInboundEndpointSecretEnvVarName` from `@wildo-ai/saas-models`). `wildo config sync` delivers
104
113
  it to the backend only. Without it the route is not mounted and senders get `404`.
105
- 6. **Verify** with the checks below, then send a signed test delivery.
114
+ 7. **Verify** with the checks below, then send a signed test delivery.
106
115
 
107
116
  **For email** (`references/email-channel.md`), the steps differ:
108
117
 
@@ -123,6 +132,11 @@ the one organization (or the application) the message resolved to, never in more
123
132
  the returned copy in the record's `z_file` field — never the attachment's own `fileId`, which belongs to the
124
133
  received message (`references/email-channel.md` → "Attachments onto your records").
125
134
 
135
+ **For SMS** (`references/sms-channel.md`), as for email, plus: give each organization its number
136
+ (`smsNumberAssignments`), pick the minimum on the SMS ladder (`UNVERIFIED` < `KNOWN_CONTACT` <
137
+ `VERIFIED_MEMBER_NUMBER`), and answer with `ctx.reply({ text })`, never a template. STOP, START and HELP never
138
+ reach the handler.
139
+
126
140
  ## Worked Example
127
141
 
128
142
  A client system asks for a todo in one list. Svix-verified; the organization is the one that OWNS that
@@ -273,6 +287,8 @@ export const matterMailInboundHandler = defineInboundChannelHandler({
273
287
  replying, threads and the linked record, why a message never authorizes a payment or an approval.
274
288
  - `references/framework-inbound-channel-api.md` — the channel handler and conversation contracts, and
275
289
  `ctx.attachments.adopt` (source-backed).
290
+ - `references/sms-channel.md` — the SMS channel: control messages, which number routes to which organization, the
291
+ SMS ladder, route tags as a text's first word, threads by number pair, and replying by text at most once.
276
292
  - `references/receiving-email.md` — receiving: the four route kinds and which address reaches which
277
293
  organization, configuring the provider and the shared domain, an organization's own domain (claim → TXT →
278
294
  verify), relationship mailboxes on a representing organization's domain, the answer's From, what a stored message
@@ -287,12 +303,15 @@ export const matterMailInboundHandler = defineInboundChannelHandler({
287
303
  - [ ] Every handler has a unique `ref` and its module lists it in `inboundHandlers`.
288
304
  - [ ] A handler on `HMAC_SHA256_HEADER` declares `dedupKey`.
289
305
  - [ ] `actingRoles` names only roles the handler's writes need, and never the super-administrator role.
306
+ - [ ] A handler whose payload names a person declares `subjectKeys`, every address and phone number written through the saas-models key helpers.
290
307
  - [ ] The backend starts (a misdeclared handler refuses startup and names the rule).
291
308
  - [ ] `POST /webhooks/app/<endpointKey>` answers `401` to an unsigned body — not `404` (secret missing)
292
309
  and not `200`.
293
310
  - [ ] Each email channel has exactly one `isDefault: true` handler, and every handler declares `replyMode`
294
311
  and a `minimumSenderAssurance` from the email ladder.
295
312
  - [ ] No channel handler writes payment details, approvals or recipients from a message's content.
313
+ - [ ] An SMS channel's handlers declare exactly one `isDefault: true`, a minimum from the SMS ladder, and answer with
314
+ `ctx.reply({ text })`; each organization that should receive texts has its `smsNumberAssignments` row.
296
315
  - [ ] A channel handler names an attachment on a record only through `ctx.attachments.adopt`'s returned copy.
297
316
  - [ ] With `EMAIL_INBOUND` enabled, `POST /api/v1/webhooks/<provider>/<endpoint>` answers `401` to an unsigned
298
317
  body, and a shared receiving domain is set wherever organizations should receive mail with no setup —
@@ -303,6 +322,8 @@ export const matterMailInboundHandler = defineInboundChannelHandler({
303
322
  - `rg "inboundHandlers:" backend-api/src/modules` — every handler file is registered somewhere.
304
323
  - `rg "APP_ADMIN_SUPER_ADMIN" backend-api/src/modules/*/inbound` — must return nothing.
305
324
  - `rg "HMAC_SHA256_HEADER" -l backend-api/src/modules/*/inbound | xargs rg --files-without-match "dedupKey"` — must return nothing.
325
+ - `rg -l "defineInboundHandler" backend-api/src/modules | xargs rg --files-without-match "subjectKeys"` — every handler
326
+ listed has a payload that names no person; review each one that does.
306
327
  - `rg -c "isDefault: true" backend-api/src/modules/*/inbound` — sums to one per channel.
307
328
  - `rg -l "requestPipelineKeys" backend-api/src/modules | xargs rg --files-without-match "pipelineKeyRequests"` — must return nothing.
308
329
  - `rg -n "ctx\.resources\.(create|update)" backend-api/src/modules/*/inbound` — none may target a resource that declares an `externalDataPipeline`.
@@ -310,7 +331,7 @@ export const matterMailInboundHandler = defineInboundChannelHandler({
310
331
  - `rg -n "message\.(text|strippedReply)" backend-api/src/modules/*/inbound` — every read of the body; none may
311
332
  choose an organization, a record to write into, or a recipient.
312
333
  - `rg -n "fileId: attachment\.fileId|attachment\.fileId \}" backend-api/src/modules/*/inbound` — must return nothing: an
313
- attachment's own id written into a record is refused (`FILE_ALREADY_LINKED`); write the adopted copy's id.
334
+ attachment's own id written into a record is refused (`FILE_NOT_LINKABLE`); write the adopted copy's id.
314
335
 
315
336
  ## Common Rationalizations
316
337
 
@@ -320,6 +341,7 @@ export const matterMailInboundHandler = defineInboundChannelHandler({
320
341
  | "The provider retries, so I don't need dedup." | Retries are exactly why you need it: without the ledger each retry runs the handler again. Declare `dedupKey` when the scheme signs no id. |
321
342
  | "I'll give the handler an admin role so it never gets refused." | The roles are its whole authority, in one organization. A broader role turns a forged-but-verified message into broad access. Declare what it writes. |
322
343
  | "The payload says which organization it is for." | A signature proves who SENT it, not whose tenant it is: one secret serves the whole application. Resolve the organization from your own data bound to something the delivery names. |
344
+ | "The payload is the sender's, so its people are the sender's problem." | The stored delivery is yours, and so is answering an erasure request about it. Without `subjectKeys` nothing can find the person in a base64 body, and they stay until the retention period ends. |
323
345
  | "The handler won't run twice, the delivery is deduplicated." | The delivery is STORED once; the handler runs at least once (a crash after your writes is retried). Make it idempotent per `ctx.delivery.id`. |
324
346
  | "If the organization isn't found I'll put it in the application scope." | There is no fallback on purpose: the handler was written for a tenant. The delivery is `UNROUTABLE`, audited, and visible to the operator. |
325
347
  | "The email came from the client's address, so it is the client." | The From line is typed by the sender. `DOMAIN_ALIGNED` proves the domain, not the person; even `THREAD_TOKEN_BOUND` proves only that someone holds the reply address. Set the minimum for what the handler does, and never let a message authorize a payment or an approval. |
@@ -327,7 +349,7 @@ export const matterMailInboundHandler = defineInboundChannelHandler({
327
349
  | "The ERP's webhook carries the new values, so I'll write them into the synced resource." | A synced resource's fields belong to its pipeline, and a notification can be stale, partial or replayed. Call `ctx.pipelines.requestPipelineKeys` with the record keys; the pipeline re-reads them from the source. |
328
350
  | "The attachment already has a `fileId`, I'll put it in my record's file field." | That file is the received message's, kept and erased with it; the write is refused. `ctx.attachments.adopt` makes your record its own copy, checked against your field's rules. |
329
351
  | "The handler knows the thread, so it should tell the agent which conversation to continue." | `ctx.chat.converse()` takes nothing. The engine reads the conversation, the sender and the message from the verified request, so a handler cannot point a member's turn at another conversation or put words in their mouth. |
330
- | "The chat click says who clicked, so the handler can approve for them with its own roles." | The handler's roles are the scope's, not the person's. `ctx.chat.answerDecision` answers as the member the chat account is linked to, under the decision's own rules, and the decision's audit row names the delivery it came through. |
352
+ | "The chat click says who clicked, so the handler can approve for them with its own roles." | The handler's roles are the scope's, not the person's. `ctx.chat.answerDecision` answers as the member the chat account is linked to, under the decision's own rules, and the decision's audit row names the delivery it came through. When the decision cannot be answered in chat (it requires a step-up, or its kind does not admit a chat answer), the result carries `openInApplicationUrl`: post it as the message's link rather than a bare refusal. |
331
353
  | "I'll call the agent directly from the handler." | `ctx` has no actor call. Hand the delivery to a declared autonomous agent with `ctx.agents.startAutonomousTurn` — it runs under the principal the organization bound to that agent, is idempotent per delivery, and is offered only read or reviewer-gated tools (`flows-actors-autonomous-agents`). |
332
354
 
333
355
  ## Red Flags
@@ -341,7 +363,7 @@ export const matterMailInboundHandler = defineInboundChannelHandler({
341
363
  - A channel handler at `UNVERIFIED` that writes records a client relies on — catch with the second
342
364
  Verification item; raise the minimum or route the message to a review handler.
343
365
  - Two `isDefault: true` handlers on one channel — catch with the fourth grep (startup refuses it too).
344
- - A record created from an email with no file, or a delivery ending DEAD on `FILE_ALREADY_LINKED` — the handler wrote
366
+ - A record created from an email with no file, or a delivery ending DEAD on `FILE_NOT_LINKABLE` — the handler wrote
345
367
  the attachment's own id; catch with the attachment-id grep above and adopt instead.
346
368
  - A handler that reads the organization or the list from the message BODY — routing already chose the
347
369
  organization from the envelope; read the route tag (`message.payload.routeTag`) and your own data. Catch
@@ -58,13 +58,21 @@ tag each. Two defaults, or two handlers on one tag, stop the backend at startup.
58
58
  ## Answering: reply mode
59
59
 
60
60
  `replyMode` is required. `NONE` means the handler never answers, and `ctx.reply` does not exist on its
61
- context. `THREAD` gives it `ctx.reply({ templateRef, variables })`:
61
+ context. `THREAD` gives it `ctx.reply({ templateRef, variables, attachmentFileIds? })`:
62
62
 
63
63
  - the reply goes out through your transactional email provider, on the thread the message arrived on,
64
64
  with `Message-ID`, `In-Reply-To` and `References` set so the client's mail program files it in the same
65
65
  conversation — no other header can be set;
66
66
  - the template is yours: register it like any other email template (`email-add-template`);
67
- - a handler that runs twice for one message (a retry) queues ONE reply per template.
67
+ - a handler that runs twice for one message (a retry) queues ONE reply per template;
68
+ - `attachmentFileIds` sends files with the reply (a signed copy, a receipt, the document the sender asked for), at most
69
+ ten. Each must be a file the HANDLER can read with its own roles in the message's organization: a file one of a
70
+ record's file fields holds, on a record it can READ through `ctx.resources`, or one this delivery produced (a copy
71
+ `ctx.attachments.adopt` made, a generated document). A file a record no longer holds is refused like any other. Anything else is refused when the reply is queued, with the file named, and no reply is queued: another
72
+ organization's file answers `NOT_FOUND` like a missing one, a file it cannot read answers `AUTHORIZATION`, and a file
73
+ still being scanned answers `BUSINESS_RULE`, so the delivery retries. The ids are kept on the reply's message row and
74
+ checked against the organization again when the reply is sent; a file deleted or moved in between fails the reply
75
+ rather than sending it without the file.
68
76
 
69
77
  ## Threads and the linked record
70
78
 
@@ -96,7 +104,7 @@ whatever happens to the thread.
96
104
  `message.attachments` lists the CLEAN attachments; the withheld ones are in `message.withheldAttachments` with their
97
105
  reason and never reach a handler. Each clean attachment's `fileId` is the file the EMAIL keeps — linked to the
98
106
  received message, kept for the message's retention and erased with it. A file belongs to exactly one record, so that
99
- id cannot also go into a `z_file` field of yours: the write is refused (`FILE_ALREADY_LINKED`).
107
+ id cannot also go into a `z_file` field of yours: the write is refused (`FILE_NOT_LINKABLE`).
100
108
 
101
109
  To make an attachment part of a record — a document, a claim, a case's evidence — adopt it:
102
110
 
@@ -107,6 +115,10 @@ await ctx.resources.create('sourceDocuments', { title: attachment.filename, file
107
115
 
108
116
  <!-- TIER C WAIVER: two lines naming the call order; the full handler shape is the anchored example in SKILL.md. -->
109
117
 
118
+ A handler may link only what its own delivery produced. An id read from a sender's payload is refused whoever uploaded
119
+ that file, usually with a `NOT_FOUND`, which is retried until the delivery's budget is spent, so never ask a sender for a
120
+ file id.
121
+
110
122
  `adopt` makes a COPY: a new file of the delivery's organization, carrying the attachment's clean scan verdict, made
111
123
  for that field. Your record's copy then lives — and is erased — with your record (an accounting document kept for
112
124
  years), while the email keeps its own for as long as correspondence is kept. Text extraction, OCR and retrieval run
@@ -158,7 +170,7 @@ a reviewer (`flows-actors-autonomous-agents`).
158
170
  |---|---|
159
171
  | `INBOUND_DELIVERY_ACCEPTED` | A message was admitted; carries the channel and the sender assurance. |
160
172
  | `INBOUND_DELIVERY_BELOW_ASSURANCE` | A message was below its handler's minimum; says where it went. |
161
- | `INBOUND_REPLY_SENT` / `INBOUND_REPLY_FAILED` | A reply was accepted by the provider, or finally failed. |
173
+ | `INBOUND_REPLY_SENT` / `INBOUND_REPLY_FAILED` | A reply was accepted by the provider (naming the ids of the files it carried), or finally failed. |
162
174
  | `INBOUND_REPLY_TOKEN_REVOKED` | Reply addresses stopped binding (closed, counterpart changed, member removed, rotated). |
163
175
  | `INBOUND_REPLY_TOKEN_DOWNGRADED` | A reply address was used by another sender than its recipient. |
164
176
  | `INBOUND_ATTACHMENT_ADOPTED` | A handler adopted an attachment onto a record; names the original, the copy and the field. |