@wildo-ai/framework-knowledge 1.1.11 → 1.1.13

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