@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
@@ -17,12 +17,17 @@ its minimum sender assurance, or read a conversation thread.
17
17
  /**
18
18
  * What a message arrived on.
19
19
  *
20
- * SMS, chat and Slack join this vocabulary when a provider can fill them — a channel nothing can
21
- * receive on is a slot no configuration can satisfy.
20
+ * Chat and Slack join this vocabulary when a provider can fill them — a channel nothing can receive on is a
21
+ * slot no configuration can satisfy.
22
22
  */
23
23
  export enum InboundChannelKind {
24
24
  /** Email received through the application's `EMAIL_INBOUND` provider and routed to an organization. */
25
25
  EMAIL = 'email',
26
+ /**
27
+ * A text message received by the application's SMS provider on a number the application assigned to an
28
+ * organization (#3394), routed to that organization by the number it was sent TO, never by its sender.
29
+ */
30
+ SMS = 'sms',
26
31
  /**
27
32
  * A signed HTTP delivery from another system (#1596). Derived for provider and application endpoint
28
33
  * deliveries; a handler never declares it.
@@ -63,6 +68,13 @@ export enum InboundSenderAssurance {
63
68
  * and `From` is the address that token was issued to.
64
69
  */
65
70
  THREAD_TOKEN_BOUND = 'thread_token_bound',
71
+ /**
72
+ * SMS: the sending number is the verified phone number (`UserCredentials.phoneNumberVerified`) of exactly one
73
+ * active member of the routed organization. Verified when the member confirmed a code sent to it; the sender of
74
+ * THIS text is still not authenticated (caller ID can be spoofed onto SMS), so it identifies the member and
75
+ * grants nothing. Two members holding one number identify nobody.
76
+ */
77
+ VERIFIED_MEMBER_NUMBER = 'verified_member_number',
66
78
  }
67
79
 
68
80
  /** The assurance levels meaningful on each channel — the type a channel's ladder and minimum are drawn from. */
@@ -72,6 +84,10 @@ export interface InboundSenderAssuranceByChannel {
72
84
  | InboundSenderAssurance.DOMAIN_ALIGNED
73
85
  | InboundSenderAssurance.KNOWN_CONTACT
74
86
  | InboundSenderAssurance.THREAD_TOKEN_BOUND;
87
+ [InboundChannelKind.SMS]:
88
+ | InboundSenderAssurance.UNVERIFIED
89
+ | InboundSenderAssurance.KNOWN_CONTACT
90
+ | InboundSenderAssurance.VERIFIED_MEMBER_NUMBER;
75
91
  [InboundChannelKind.WEBHOOK]: InboundSenderAssurance.UNVERIFIED | InboundSenderAssurance.SOURCE_SIGNED;
76
92
  }
77
93
 
@@ -89,6 +105,16 @@ export const INBOUND_SENDER_ASSURANCE_LADDERS: { readonly [C in InboundChannelKi
89
105
  InboundSenderAssurance.KNOWN_CONTACT,
90
106
  InboundSenderAssurance.THREAD_TOKEN_BOUND,
91
107
  ],
108
+ /*
109
+ * A member's verified number outranks a contact the application recognises: the member proved the number by a code
110
+ * the engine sent to it, while a contact's number is whatever the application recorded. Neither authenticates the
111
+ * sender of this text (SMS has no counterpart of DMARC), which is why the ladder only ever IDENTIFIES.
112
+ */
113
+ [InboundChannelKind.SMS]: [
114
+ InboundSenderAssurance.UNVERIFIED,
115
+ InboundSenderAssurance.KNOWN_CONTACT,
116
+ InboundSenderAssurance.VERIFIED_MEMBER_NUMBER,
117
+ ],
92
118
  [InboundChannelKind.WEBHOOK]: [InboundSenderAssurance.UNVERIFIED, InboundSenderAssurance.SOURCE_SIGNED],
93
119
  };
94
120
 
@@ -276,6 +302,49 @@ export function isEmailMessageId(value: unknown): value is string {
276
302
  return typeof value === 'string' && EMAIL_MESSAGE_ID_PATTERN.test(value);
277
303
  }
278
304
 
305
+ // ─────────────────────────────────────────────────────────────────────────────
306
+ // SMS: deriving sender assurance and a text's route tag
307
+ // ─────────────────────────────────────────────────────────────────────────────
308
+
309
+ /** What the routed organization knows about the number a text came from (#3394). */
310
+ export enum SmsSenderNumberMatch {
311
+ /** Not one member's verified number, and not a contact the application recognises. */
312
+ NONE = 'none',
313
+ /** The verified phone number of exactly one active member of the routed organization (sets `memberUserId`). */
314
+ VERIFIED_MEMBER = 'verified_member',
315
+ /** The handler's contact resolver recognised the number. The engine keeps no contacts of its own. */
316
+ APPLICATION_CONTACT = 'application_contact',
317
+ }
318
+
319
+ /**
320
+ * A text's sender assurance (#3394). PURE: the input is a lookup the engine made, never what the text says.
321
+ *
322
+ * SMS carries no sender authentication — no counterpart of DMARC, and caller ID can be spoofed onto a text — so every
323
+ * level above the floor IDENTIFIES the sender by a number someone verified or recorded, and none of them
324
+ * authenticates it. A handler's roles never depend on it (I8); a handler only states the minimum it acts on.
325
+ */
326
+ export function deriveSmsSenderAssurance(match: SmsSenderNumberMatch): SenderAssuranceOf<InboundChannelKind.SMS> {
327
+ switch (match) {
328
+ case SmsSenderNumberMatch.VERIFIED_MEMBER: return InboundSenderAssurance.VERIFIED_MEMBER_NUMBER;
329
+ case SmsSenderNumberMatch.APPLICATION_CONTACT: return InboundSenderAssurance.KNOWN_CONTACT;
330
+ case SmsSenderNumberMatch.NONE: return InboundSenderAssurance.UNVERIFIED;
331
+ default: {
332
+ const unhandled: never = match;
333
+ return unhandled;
334
+ }
335
+ }
336
+ }
337
+
338
+ /**
339
+ * What an SMS `routeTag` looks like: the first word of a text, lower-cased, when it is a tag a handler declares
340
+ * (`INBOUND_ROUTE_TAG_PATTERN`'s shape). A text has no sub-address, so its first word is the only place a tag can be.
341
+ */
342
+ export function smsRouteTagCandidate(text: string): string | undefined {
343
+ const first = text.normalize('NFKC').trim().split(/\s+/u)[0] ?? '';
344
+ const word = first.replace(/[^\p{L}\p{N}-]+$/gu, '').toLowerCase();
345
+ return /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(word) ? word : undefined;
346
+ }
347
+
279
348
  /**
280
349
  * What an inbound handler's `ref` looks like: lower-case, dot-separated segments of `[a-z0-9-]`
281
350
  * (`todos.intake`, `matters.mail-intake`). One definition for the backend's `inboundHandlerRef()`, which
@@ -308,8 +377,9 @@ export interface InboundChannelSource<C extends InboundChannelKind = InboundChan
308
377
  readonly kind: InboundSourceKind.CHANNEL;
309
378
  readonly channel: C;
310
379
  /**
311
- * The tag routing names — for email, `tag` in `cases+tag@firm.example`. Lower-case letters, digits
312
- * and hyphens.
380
+ * The tag routing names — for email, `tag` in `cases+tag@firm.example`; for SMS, the text's first word
381
+ * (`BOOKING tomorrow 9am` carries `booking`), since a text has no sub-address. Lower-case letters, digits
382
+ * and hyphens. An SMS text whose first word no handler claims goes to the default.
313
383
  */
314
384
  readonly routeTag?: string;
315
385
  /** Take every message no `routeTag` claims. */
@@ -318,11 +388,12 @@ export interface InboundChannelSource<C extends InboundChannelKind = InboundChan
318
388
 
319
389
  /** Who sent a message, as far as the engine could establish. */
320
390
  export interface InboundMessageSender<C extends InboundChannelKind = InboundChannelKind> {
391
+ /** The sender's address: an email address, or for SMS the sending number in E.164. */
321
392
  readonly address: string;
322
393
  readonly name?: string;
323
394
  /** Identification, never authentication — see `InboundSenderAssurance`. It grants nothing. */
324
395
  readonly assurance: SenderAssuranceOf<C>;
325
- /** Set when the sender is a verified, active member of the routed organization. */
396
+ /** Set when the sender is a verified, active member of the routed organization (for SMS: by their verified phone number). */
326
397
  readonly memberUserId?: string;
327
398
  }
328
399
 
@@ -368,9 +439,21 @@ export interface InboundEmailPayload {
368
439
  readonly routeTag?: string;
369
440
  }
370
441
 
442
+ /**
443
+ * What an SMS handler receives about a text beyond its words (#3394). A text has no subject and no copy list: only the
444
+ * application number it was sent to, which is also the number a reply goes out from.
445
+ */
446
+ export interface InboundSmsPayload {
447
+ /** The application's number the text was sent to, in E.164 — one the application assigned to the organization. */
448
+ readonly to: string;
449
+ /** The tag the text was routed on (its first word), when a handler claims it. */
450
+ readonly routeTag?: string;
451
+ }
452
+
371
453
  /** The payload each channel carries — total over the channels a handler can be declared for. */
372
454
  export interface InboundChannelPayloadByChannel {
373
455
  [InboundChannelKind.EMAIL]: InboundEmailPayload;
456
+ [InboundChannelKind.SMS]: InboundSmsPayload;
374
457
  }
375
458
 
376
459
  /** A channel a handler may be declared for. `WEBHOOK` is the endpoint handlers' channel, never declared here. */
@@ -406,6 +489,9 @@ export interface InboundContactLookups {
406
489
  * The application's answer to "is this address a contact of this organization?" (#1630 M6). The engine
407
490
  * keeps no contacts: without a resolver, only members of the organization reach `KNOWN_CONTACT`. Asked
408
491
  * only for a domain-aligned sender, and a resolver that throws counts as "no".
492
+ *
493
+ * SMS (#3394): `address` is the sending number in E.164, and the resolver is asked for every text that is
494
+ * not a member's verified number (SMS has no alignment to gate on, so the answer only ever identifies).
409
495
  */
410
496
  export type InboundContactResolver = (input: {
411
497
  readonly organizationId: string;
@@ -419,6 +505,29 @@ export interface InboundReplyRequest {
419
505
  readonly templateRef: string;
420
506
  /** Rendered into the template as `additionalContext`. Stored on the reply's message row until the reply's retention ends. */
421
507
  readonly variables: Readonly<Record<string, unknown>>;
508
+ /**
509
+ * Files to send with the reply (#1856): a signed copy, a receipt, the document the sender asked for. Each must be a
510
+ * file the HANDLER can read with its own roles in the delivery's organization — a file on a record it can READ, or one
511
+ * this delivery produced itself — and is refused, with the file named, when the reply is queued otherwise. Never
512
+ * another organization's file, whatever the handler learned its id from. At most `CONVERSATION_REPLY_MAX_ATTACHMENTS`.
513
+ */
514
+ readonly attachmentFileIds?: readonly string[];
515
+ }
516
+
517
+ /**
518
+ * What an SMS handler asks `ctx.reply` to send (#3394): the words of the reply. A text has no template; what it says
519
+ * is the handler's, at most `CONVERSATION_SMS_REPLY_MAX_LENGTH` characters (refused when queued, never cut). It goes
520
+ * out from the application number the text was sent to, only while the thread is open, and never to a number that
521
+ * replied STOP.
522
+ */
523
+ export interface InboundSmsReplyRequest {
524
+ readonly text: string;
525
+ }
526
+
527
+ /** The reply request each channel takes — total over the channels a handler can be declared for. */
528
+ export interface InboundReplyRequestByChannel {
529
+ [InboundChannelKind.EMAIL]: InboundReplyRequest;
530
+ [InboundChannelKind.SMS]: InboundSmsReplyRequest;
422
531
  }
423
532
 
424
533
  /** The reply that was queued — one per call, idempotent per delivery and template (see `ctx.reply`). */
@@ -462,19 +571,20 @@ export type InboundChannelHandlerContextBase = Omit<InboundHandlerContext, 'deli
462
571
  };
463
572
 
464
573
  /**
465
- * The context a handler of reply mode `M` receives. Under `THREAD` it can answer; under `NONE` `reply`
466
- * is `never`, so calling it does not compile.
574
+ * The context a handler of reply mode `M` on channel `C` receives. Under `THREAD` it can answer, with the
575
+ * channel's own reply request; under `NONE` `reply` is `never`, so calling it does not compile.
467
576
  */
468
- export type InboundChannelHandlerContext<M extends InboundReplyMode> = InboundChannelHandlerContextBase & (
577
+ export type InboundChannelHandlerContext<M extends InboundReplyMode, C extends DeclarableInboundChannel = DeclarableInboundChannel> = InboundChannelHandlerContextBase & (
469
578
  M extends InboundReplyMode.THREAD
470
579
  ? {
471
580
  /**
472
581
  * Answer on the thread the message arrived on, and only there (I7). Writes the reply as an OUTBOUND
473
- * message and queues it; the reply worker sends it through the application's transactional email
474
- * provider with the thread's headers. Calling it twice with the same template in one delivery
475
- * queues ONE reply — a retried handler does not answer twice.
582
+ * message and queues it; the reply worker sends it on the thread's channel: for email through the
583
+ * application's transactional email provider with the thread's headers, for SMS through the SMS
584
+ * provider from the number the text was sent to. Calling it twice with the same template (or, for
585
+ * SMS, the same text) in one delivery queues ONE reply — a retried handler does not answer twice.
476
586
  */
477
- readonly reply: (request: InboundReplyRequest) => Promise<InboundQueuedReply>;
587
+ readonly reply: (request: InboundReplyRequestByChannel[C]) => Promise<InboundQueuedReply>;
478
588
  }
479
589
  : { readonly reply?: never }
480
590
  );
@@ -498,7 +608,7 @@ export interface InboundChannelHandlerDefinition<C extends DeclarableInboundChan
498
608
  /** The handler's whole authority, in the routed organization. Never the super-administrator role. */
499
609
  readonly actingRoles: { readonly organization: readonly string[] };
500
610
  readonly retry?: InboundRetryPolicy;
501
- handle(ctx: InboundChannelHandlerContext<M>, message: InboundMessage<C>): Promise<void>;
611
+ handle(ctx: InboundChannelHandlerContext<M, C>, message: InboundMessage<C>): Promise<void>;
502
612
  }
503
613
 
504
614
  /** Identity function that infers the channel and the reply mode, so `ctx.reply` is typed from the declaration. */
@@ -558,8 +668,10 @@ export interface InboundAdoptedAttachment {
558
668
  * - **Recorded** — every adoption writes `inbound_attachment_adopted` on the organization's audit trail.
559
669
  *
560
670
  * What the copy MAY do is decided by your write, not here: `ctx.resources.create/update` authorizes the write with
561
- * the handler's roles as for any caller, and links the copy then. A copy your handler never names (the write failed,
562
- * or a retry found the record already filed) is swept a day later like any upload nobody attached.
671
+ * the handler's roles as for any caller, and links the copy then. Only this delivery may name it, and a handler can name
672
+ * no other unlinked file: an id taken from a sender's payload that names someone's upload answers `NOT_FOUND` (#3330). A
673
+ * copy your handler never names (the write failed, or a retry found the record already filed) is swept a day later like
674
+ * any upload nobody attached.
563
675
  */
564
676
  export interface InboundAttachmentOperations {
565
677
  adopt(fileId: string, target: InboundAttachmentAdoptionTarget): Promise<InboundAdoptedAttachment>;
@@ -652,7 +764,7 @@ export const ConversationThreadSchema = z.object({
652
764
  channel: z.enum(InboundChannelKind).systemEnum('InboundChannelKind').isSummaryField().excludeFromUpdate()
653
765
  .describe('The channel the thread runs on. Replies go out on this channel only.'),
654
766
  threadKey: z.string().min(1).max(998).isDBIndexed().excludeFromUpdate()
655
- .describe("The channel's correlation key: for email, the Message-ID of the message that opened the thread."),
767
+ .describe("The channel's correlation key: for email, the Message-ID of the message that opened the thread; for SMS, the two numbers and the opening text's provider id."),
656
768
  /** The address the application is exchanging messages with. Changing it revokes the previous counterpart's tokens. */
657
769
  counterpartAddress: address().isDBIndexed().isSummaryField()
658
770
  .describe('The address the application is exchanging messages with on this thread.'),
@@ -685,6 +797,20 @@ export const ConversationOutboundThreadingSchema = z.strictObject({
685
797
  references: z.array(z.string().max(998)).max(100).default([]).describe('The thread\'s Message-IDs, oldest first, ending with the one answered.'),
686
798
  });
687
799
 
800
+ /**
801
+ * The most files one reply carries. A reply answers one message, and a person reading it expects the few documents it
802
+ * is about (a signed copy, a receipt), not an archive; the email service also caps the attachments' total size
803
+ * (`OUTBOUND_ATTACHMENT_TOTAL_BYTES_LIMIT`), so the count is the bound a handler meets first, with the file named.
804
+ */
805
+ export const CONVERSATION_REPLY_MAX_ATTACHMENTS = 10;
806
+
807
+ /**
808
+ * The longest text reply (#3394): what the SMS vendors accept in one message body (Twilio's `Body` and Telnyx's `text`
809
+ * both stop at 1600 characters, split by the carrier into segments). A reply longer than this is refused when it is
810
+ * queued, rather than cut.
811
+ */
812
+ export const CONVERSATION_SMS_REPLY_MAX_LENGTH = 1600;
813
+
688
814
  /** One message of a thread, in either direction. */
689
815
  export const ConversationMessageSchema = z.object({
690
816
  _id: z.string().min(1).isPrimaryKey().isSummaryField(),
@@ -693,9 +819,13 @@ export const ConversationMessageSchema = z.object({
693
819
  .describe('The thread this message belongs to.'),
694
820
  direction: z.enum(ConversationMessageDirection).systemEnum('ConversationMessageDirection').isSummaryField().excludeFromUpdate()
695
821
  .describe('Whether the message was received from the counterpart or sent by the application.'),
696
- /** The RFC 5322 Message-ID on the wire — what a later In-Reply-To or References names. */
822
+ /**
823
+ * The RFC 5322 Message-ID on the wire — what a later In-Reply-To or References names. A text message has none: an
824
+ * SMS row carries `<providerMessageId@sms.invalid>` (the provider's id for the text, or the reply's submission id),
825
+ * which nothing on the wire ever names.
826
+ */
697
827
  rfcMessageId: z.string().min(1).max(998).isDBIndexed().excludeFromUpdate()
698
- .describe('The Message-ID the message carried on the wire, angle brackets included.'),
828
+ .describe('The Message-ID the message carried on the wire, angle brackets included; for a text message, the provider\'s id for it.'),
699
829
  fromAddress: address().isSummaryField().describe('Who sent the message.'),
700
830
  // RESET, not MASK: the treatment belongs to the ARRAY, and a mask string is not an array. Erasure returns
701
831
  // the list to its default — empty.
@@ -740,6 +870,15 @@ export const ConversationMessageSchema = z.object({
740
870
  outboundStatus: z.enum(ConversationOutboundStatus).systemEnum('ConversationOutboundStatus').isDBIndexed().nullable().default(null)
741
871
  .excludeFromCreate().excludeFromUpdate()
742
872
  .describe('For a reply, where it stands with the sending provider; null for a received message.'),
873
+ /**
874
+ * OUTBOUND, SMS (#3394): the words the handler answered a text with. A text reply has no template — what it says is
875
+ * the handler's, as for the other texts the application sends — so the row keeps it until the reply's retention ends,
876
+ * as an email reply keeps its template variables. Null on every other row.
877
+ */
878
+ replyText: addImpersonalizeWith(
879
+ z.string().max(CONVERSATION_SMS_REPLY_MAX_LENGTH).nullable().default(null).excludeFromUpdate().dataCategories(PersonalDataCategory.USER_CONTENT),
880
+ RedactionType.RESET,
881
+ ).describe('For a reply by text message, what it said.'),
743
882
  /** OUTBOUND: the template the HANDLER chose, and the variables it rendered with. */
744
883
  templateRef: z.string().max(200).nullable().default(null).excludeFromUpdate()
745
884
  .describe('For a reply, the email template the handler chose.'),
@@ -750,6 +889,15 @@ export const ConversationMessageSchema = z.object({
750
889
  ).describe('For a reply, the variables the template rendered with.'),
751
890
  locale: z.string().max(35).nullable().default(null).excludeFromUpdate()
752
891
  .describe('For a reply, the locale the template rendered in.'),
892
+ /**
893
+ * OUTBOUND: the files the handler attached to the reply (#1856), from the moment it is queued to the moment it is
894
+ * sent — this row is the reply's only record, so nothing else survives to the send attempt. Each was checked against
895
+ * the handler's own READ authority in the delivery's organization when the reply was queued, and the send confines
896
+ * them to that organization again. Ids only: a file's name and bytes stay with the file. Empty for a received message,
897
+ * whose attachments live in its channel record.
898
+ */
899
+ attachmentFileIds: z.array(z.string().min(1)).max(CONVERSATION_REPLY_MAX_ATTACHMENTS).default([]).excludeFromUpdate()
900
+ .describe('For a reply, the ids of the files sent with it as attachments.'),
753
901
  /**
754
902
  * For a reply, while it is QUEUED: the Reply-To address its first send attempt composed. It carries the
755
903
  * reply token IN PLAINTEXT (I12), so it is backend-only — no API returns it — and it is cleared when the
@@ -853,18 +1001,16 @@ export function EmbedLinkedConversations({ className }: EmbedLinkedConversations
853
1001
  { hostResourceType },
854
1002
  );
855
1003
  }
856
- const threads = compositeResourceContext.buildOperationContext({
1004
+ // Threads are linked by type and id, not by a relationship, so this embed confines them itself (#3072).
1005
+ return compositeResourceContext.buildOperationContext({
857
1006
  resourceType: CoreResourceType.CONVERSATION_THREADS,
858
1007
  operationLike: CoreResourceOperation.LIST,
859
1008
  requireAddressable: false,
860
- });
861
- return {
862
- ...threads,
863
1009
  pinnedFilters: {
864
1010
  [CONVERSATION_THREAD_LINKED_RESOURCE_FILTER.RESOURCE_TYPE]: hostResourceType,
865
1011
  [CONVERSATION_THREAD_LINKED_RESOURCE_FILTER.RESOURCE_ID]: hostResourceId,
866
1012
  },
867
- };
1013
+ });
868
1014
  }, [compositeResourceContext, hostResourceType, hostResourceId]);
869
1015
 
870
1016
  return renderEmbeddedResourceOperation(resourceContext, navigationZone, navigationInitiator, className);
@@ -279,7 +279,17 @@ export type InboundChatActingMember = Extract<InboundChatMember, { readonly stan
279
279
  * the decision notice's job (#2664 S5b), not the click's.
280
280
  */
281
281
  export type InboundChatDecisionAnswer =
282
- | { readonly member: InboundChatActingMember; readonly outcome: HumanDecision_ActOutcome }
282
+ | {
283
+ readonly member: InboundChatActingMember;
284
+ readonly outcome: HumanDecision_ActOutcome;
285
+ /**
286
+ * #2923: where the person answers this decision instead, when a chat answer cannot settle it (it requires a step-up,
287
+ * which a chat answer cannot carry, or its kind does not admit a chat answer): the decision's address in the
288
+ * application's inbox. Present exactly then, and when the application has a public address. A handler posts it as
289
+ * the message's link (`openInApplication`), never a refusal with nowhere to go.
290
+ */
291
+ readonly openInApplicationUrl?: string;
292
+ }
283
293
  | { readonly member: Exclude<InboundChatMember, InboundChatActingMember> };
284
294
 
285
295
  /**
@@ -353,6 +363,16 @@ export enum ChatConverseRefusal {
353
363
  BUSY_TOO_LONG = 'busy_too_long',
354
364
  /** The message said nothing once the bot's mention was removed. */
355
365
  EMPTY_MESSAGE = 'empty_message',
366
+ /**
367
+ * #2750: the message alone is larger than the chat agent's model can be sent, so it was refused rather than cut. Not
368
+ * kept; a shorter message is admitted.
369
+ */
370
+ MESSAGE_TOO_LONG = 'message_too_long',
371
+ /**
372
+ * The chosen agent's system is open only to the roles it declares (`config.accessControl[].roles`), and the linked
373
+ * member holds none of them in the organization (#2544 follow-up). Not kept; an administrator can give them a role.
374
+ */
375
+ SYSTEM_ROLE_NOT_HELD = 'system_role_not_held',
356
376
  }
357
377
 
358
378
  /** What a message waits for. */
@@ -635,6 +655,23 @@ export interface InboundHandlerDefinition<P = unknown> {
635
655
  readonly dedupKey?: (delivery: VerifiedInboundDelivery) => string;
636
656
  /** Deliveries sharing a non-null key run one at a time, in receive order. */
637
657
  readonly orderingKey?: (delivery: VerifiedInboundDelivery, payload: P) => string | null;
658
+ /**
659
+ * The people this delivery's payload names (#1642): each person's email address, LOWER-CASED, or their user id in
660
+ * this application. Computed once, at receipt, from the parsed payload, and stored on the delivery (`subjectKeys`).
661
+ *
662
+ * Declare it whenever the payload can name a person (a contact, a signer, a customer). The stored body cannot be
663
+ * searched, so these keys are the only way the delivery is found for that person: when they are erased, every stored
664
+ * delivery whose keys hold their user id or their email address is DELETED inside the erasure, and an administrator
665
+ * finds the deliveries for a person through the SEARCH filter `subjectKeys`. A delivery that names someone and
666
+ * declares nothing keeps them in its payload until its retention period ends.
667
+ *
668
+ * The receiver trims each key and drops duplicates and empty ones. More than 20 keys, or a key longer than 320
669
+ * characters, cannot be stored: the delivery is refused as malformed, like a dedup key that cannot be stored.
670
+ *
671
+ * @example
672
+ * subjectKeys: (_delivery, payload) => [payload.contact.email.toLowerCase()],
673
+ */
674
+ readonly subjectKeys?: (delivery: VerifiedInboundDelivery, payload: P) => readonly string[];
638
675
  readonly scopeMode: InboundHandlerScopeMode;
639
676
  /** Required for `ORGANIZATION_REQUIRED` and `RESOLVED_PER_DELIVERY`; refused for `APPLICATION`. */
640
677
  readonly resolveScope?: (delivery: VerifiedInboundDelivery, payload: P, lookups: InboundScopeLookups) => Promise<InboundResolvedScope>;
@@ -116,14 +116,53 @@ meanwhile.
116
116
 
117
117
  ## What a stored delivery keeps
118
118
 
119
- The raw payload, which can carry personal data. A person's erasure request does not yet reach the
120
- deliveries whose payload names them; they leave with the retention period below, or with their
121
- organization.
119
+ The raw payload, which can carry personal data, and the people that payload names as the handler declared
120
+ them (`subjectKeys`).
121
+
122
+ The body is stored base64, so nothing can search it: `subjectKeys` is the only way a delivery is found for
123
+ a person. Declare it on every handler whose payload can name someone:
124
+
125
+ ```ts
126
+ import { inboundSubjectKeyForEmailAddress, inboundSubjectKeyForPhoneNumber } from '@wildo-ai/saas-models';
127
+
128
+ subjectKeys: (_delivery, payload) => [
129
+ inboundSubjectKeyForEmailAddress(payload.contact.email),
130
+ inboundSubjectKeyForPhoneNumber(payload.contact.phone ?? ''),
131
+ ].filter((key): key is string => key !== undefined),
132
+ ```
133
+
134
+ - A key is one of three things: a person's email address, LOWER-CASED (`inboundSubjectKeyForEmailAddress`);
135
+ their phone number in E.164 form with its `+`, separators removed (`inboundSubjectKeyForPhoneNumber`,
136
+ which answers `undefined` for a national number, since nothing could match it); or their user id in this
137
+ application. The receiver trims the keys and drops empty and repeated ones; more than 20, or one longer
138
+ than 320 characters, refuses the delivery as malformed (`400`), like a dedup key that cannot be stored.
139
+ - When a person with an account is erased, every stored delivery whose keys hold their user id, their email
140
+ address, or a phone number on their profile or their sign-in credentials is DELETED inside the erasure, in
141
+ both delivery tables, unless a legal hold keeps it. The erasure receipt lists the deleted delivery ids
142
+ (`row_deleted`), never the payload.
143
+ - The engine keys its own deliveries the same way: an email received through the email channel by its
144
+ sender, recipients and copied addresses (cut to 20, sender first), an email provider's notification
145
+ likewise (a pushed message, or a fetched provider's notification, which names the sender and recipients
146
+ too), and an SMS provider notification by the number of the person it is about. The SMS report the
147
+ engine records from that notification carries the same key and is deleted with it.
148
+ - A person's access export reads the deliveries naming them by the same keys; a delivery that also names
149
+ someone else is handed without its payload.
150
+ - An administrator finds a person's deliveries with the SEARCH filter `subjectKeys` (an address or a user
151
+ id), for an access request or a person who has no account here.
152
+ - For a person with NO account here (a lead, a contact, someone who only wrote or texted), the scope's
153
+ administrator erases their deliveries with the `eraseForSubjectKey` operation: the person's email address,
154
+ phone number or a key your handler declared (`identifierKind` + `identifier`), and a written
155
+ `justification`. It deletes only that scope's deliveries (the application's also deletes the SMS reports
156
+ naming the person), keeps what a legal hold covers, and answers the deleted ids. Its audit event,
157
+ `INBOUND_DELIVERY_ERASED`, names the ids and a sha256 of the key, never the key.
158
+ - A delivery whose handler declares no keys keeps whoever it names until the retention period below ends,
159
+ or until its organization is purged. Declaring keys on a handler does not reach deliveries stored before
160
+ it did.
122
161
 
123
162
  ## Audit events
124
163
 
125
164
  `INBOUND_DELIVERY_REJECTED` · `_ACCEPTED` · `_UNROUTABLE` · `_PROCESSED` · `_FAILED` (each retry) ·
126
- `_DEAD` · `_REPLAYED`. None carries the payload; the stored delivery does.
165
+ `_DEAD` · `_REPLAYED` · `_ERASED`. None carries the payload; the stored delivery does.
127
166
 
128
167
  ## How long a delivery is kept
129
168
 
@@ -9,8 +9,8 @@ message gets to it.
9
9
 
10
10
  | Step | What happens | Fails closed how |
11
11
  |---|---|---|
12
- | Notification | The provider POSTs a small signed notification to `/api/v1/webhooks/<provider>/<endpoint>`; the engine verifies it and stores it once | Unsigned or forged → `401`, nothing stored |
13
- | Fetch | The engine fetches the message, its attachments and its raw bytes from the provider | Only from the provider's declared hosts, never following a redirect |
12
+ | Notification | The provider POSTs to `/api/v1/webhooks/<provider>/<endpoint>`: a small signed notification (Resend), or the whole message, attachments included (Postmark); the engine verifies it and stores it once | Unsigned, forged or wrong credentials → `401`, nothing stored; a pushed message over 10 MB of JSON → `413`, audited |
13
+ | Fetch | A notified provider: the engine fetches the message, its attachments and its raw bytes from it. A pushing provider: the engine reads them out of the body it verified, and empties that body once the message is stored | Only from the provider's declared hosts, never following a redirect; a pushed attachment the body lacks refuses the message |
14
14
  | Route | Each recipient address is routed to ONE organization (below) | An address no rule reaches is `UNROUTABLE` and audited, never guessed |
15
15
  | Store | One `inboundEmails` row per organization the message reached | A message over the size limit is kept as its envelope only (`REJECTED_LIMIT`) |
16
16
  | Scan | Every attachment, and the raw bytes, are scanned before anything may serve them | Infected, or unscannable (no scanner configured) → withheld, with the reason |
@@ -82,7 +82,19 @@ Three declarations, all required:
82
82
 
83
83
  3. **The secrets** in each environment: the provider's API key and its webhook signing secret
84
84
  (`wildo secrets list` names them; for Resend, `RESEND_API_KEY` and `RESEND_WEBHOOK_SECRET`). Then register
85
- the notification URL with the provider for the `email.received` event.
85
+ the notification URL with the provider for the `email.received` event. For Postmark (the registry provider,
86
+ `wildo registry add wildo/providers/postmark`), the secret is `POSTMARK_INBOUND_WEBHOOK_CREDENTIAL`, a
87
+ `user-id:password` you generate, and the URL you give the Postmark server's inbound webhook carries it:
88
+ `https://<user-id>:<password>@<api host>/api/v1/webhooks/postmark/inbound-email`. Postmark receives on ONE inbound
89
+ domain per server: make it the shared domain. For Mailgun (`wildo registry add wildo/providers/mailgun`), the
90
+ secrets are `MAILGUN_API_KEY` (it also hosts organizations' domains) and `MAILGUN_WEBHOOK_SIGNING_KEY`, the
91
+ account's webhook signing key (Settings, API Security; not the API key). Create a route whose `forward()` URL is
92
+ `https://<api host>/api/v1/webhooks/mailgun/inbound-email-json`: only a URL ending in `json` makes Mailgun post the
93
+ message as JSON with its signature in headers; any other URL posts a form, which is refused (`415`).
94
+
95
+ A provider that receives on one domain for the whole application (Postmark) hosts no organization's own domain: a
96
+ `claim` is refused with `EMAIL_DOMAIN_SINGLE_INBOUND_DOMAIN`, and organizations receive at their address on the
97
+ shared domain. It also reports no SPF, DKIM or DMARC result, so its senders are identified as unverified.
86
98
 
87
99
  `email.inbound` also takes `rawMimeRetention` (`KEEP` by default: only the original bytes can be re-verified),
88
100
  `organizationSendingDomainUse` (below) and `maxMessageSizeBytes` (25 MB by default).
@@ -0,0 +1,93 @@
1
+ # The SMS channel — texts people send to the application's numbers
2
+
3
+ Read this when people should be able to text the application (booking changes, a reply to a reminder, a short
4
+ request) and the text should reach code you write, or be answered by text.
5
+
6
+ ## What reaches your handler, and what never does
7
+
8
+ The SMS provider posts every text it receives to its notification endpoint. The engine verifies it, records it
9
+ (the `smsProviderEvents` row), and reads it for the carrier keywords first:
10
+
11
+ | the text | what happens |
12
+ |---|---|
13
+ | `STOP` (and the other opt-out words), `START`/`UNSTOP`, `HELP`/`INFO` — as the WHOLE message | a CONTROL message: the opt-out list moves (or the vendor answers HELP). It never reaches a handler |
14
+ | anything else, sent to a number the application gave an organization | admitted to that organization's SMS channel handler |
15
+ | anything else, sent to any other number (the application's own sender number, a withdrawn number, a short code) | stored as an UNROUTABLE inbound delivery, audited, run by nobody |
16
+
17
+ "Stop by tomorrow?" is a message, not a STOP: only the whole message counts as a keyword.
18
+
19
+ An application that declares no SMS channel handler still receives texts: they are recorded and read for STOP and
20
+ START, nothing more.
21
+
22
+ ## Which organization a text belongs to
23
+
24
+ A text has no sub-address, so the number it was sent TO is the only thing that says whose it is. The application's
25
+ super-administrator gives each organization a number it holds at its SMS provider, as an `smsNumberAssignments` row
26
+ (`phoneNumber` in E.164 with its `+`, `assignedOrganizationId`). One number belongs to one organization.
27
+
28
+ - An organization cannot claim a number itself. Every number sits in the application's own provider account, so no
29
+ organization can prove a number is its own, and a self-claim would let one tenant take another's texts.
30
+ - The application's own sender number (`providerConfigurations.<sms provider>.SMS_PROVIDER.fromNumber`) is never
31
+ assigned: sign-in codes and notifications go out from it, and the answers to them belong to no organization.
32
+ - Withdrawing a number (DELETE) stops routing at once; the next text to it is UNROUTABLE.
33
+
34
+ ## Who sent it — the SMS ladder
35
+
36
+ | level | means |
37
+ |---|---|
38
+ | `UNVERIFIED` | nothing is known about the number |
39
+ | `KNOWN_CONTACT` | your handler's `contactResolver` recognised the number (it is asked with the number, in E.164) |
40
+ | `VERIFIED_MEMBER_NUMBER` | the number is the VERIFIED phone number of exactly one active member of the organization; `message.sender.memberUserId` names them |
41
+
42
+ Two members holding the same number identify nobody. And SMS has no sender authentication at all (caller ID can be
43
+ spoofed onto a text), so every level IDENTIFIES and none authenticates: the handler's `actingRoles` are the same for
44
+ every sender. Choose `minimumSenderAssurance` for what the handler does, exactly as for email; a text below it goes
45
+ to your `belowMinimumHandlerRef`, or is stored and audited.
46
+
47
+ **A text never authorizes anything.** Not a payment change, not an approval, not a new recipient, not a cancellation
48
+ of something that costs money — record the request and have a person confirm it through a trusted channel.
49
+
50
+ ## Routing between handlers
51
+
52
+ One handler per channel declares `isDefault: true`. Another may declare a `routeTag`: a text whose FIRST WORD is
53
+ that tag goes to it (`CANCEL my 3pm` → `routeTag: 'cancel'`), with the tag in `message.payload.routeTag`. A first
54
+ word no handler claims goes to the default. Once you declare any SMS handler, the default is required (startup
55
+ refuses otherwise), so an untagged text always has an owner.
56
+
57
+ ## Threads
58
+
59
+ A thread is one exchange between the organization's number and the person's number: the next text of the same pair
60
+ joins the newest OPEN thread, another number or a closed thread starts a new one. `message.thread` and
61
+ `ctx.thread.link` work as for email; the thread's `counterpartAddress` is the person's number. A text carries no
62
+ attachments (MMS is not received).
63
+
64
+ ## Replying by text
65
+
66
+ Declare `replyMode: InboundReplyMode.THREAD`, then:
67
+
68
+ ```ts
69
+ await ctx.reply({ text: 'Friday at 10 works. Reply STOP to stop these messages.' });
70
+ ```
71
+
72
+ - The words are yours: no template. At most 1600 characters; longer, empty or not a string is refused (VALIDATION)
73
+ and nothing is queued.
74
+ - The reply goes FROM the number the text was sent to, TO the person who texted, and only while the thread is OPEN.
75
+ - It goes through the application's SMS send, so a number that replied STOP is never texted: the reply settles
76
+ FAILED with `recipient_opted_out`.
77
+ - Calling `ctx.reply` twice with the same text in one delivery queues one reply.
78
+ - A text reply is sent AT MOST ONCE. SMS vendors take no idempotency key, so a send whose answer was lost is never
79
+ retried (it would text twice): the reply row settles FAILED, `InboundReplySmsOutcomeUnknown`, and the operator sees
80
+ that the text may or may not have gone.
81
+ - A reply answers the person's own message. It does not imply consent to any other text: notifications still need
82
+ their recorded SMS consent.
83
+
84
+ ## Enabling it
85
+
86
+ 1. The SMS capability with a provider that declares a notification half (Twilio; Telnyx, `provider-telnyx`), on
87
+ the backend scope with `SMS_PROVIDER` and `WEBHOOK_ORIGINATOR`, its notification endpoint enabled, and the public
88
+ API URL set so the provider can reach it. Without the endpoint served, an SMS channel handler refuses startup.
89
+ 2. Give each organization its number: Settings → Administration → SMS numbers (the `application-sms-numbers`
90
+ destination, shown where the SMS capability is enabled), or `POST` on `smsNumberAssignments` — both as the
91
+ application's super-administrator.
92
+ 3. Declare the handler with `defineInboundChannelHandler`, `source: { kind: InboundSourceKind.CHANNEL, channel:
93
+ InboundChannelKind.SMS, isDefault: true }`, and list it in the module's `inboundHandlers`.