@wildo-ai/framework-knowledge 1.1.11 → 1.1.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (803) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
  3. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
  4. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
  5. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
  6. package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
  7. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
  8. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
  9. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
  10. package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
  11. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  12. package/dist/esm/framework-knowledge.definitions.js +170 -32
  13. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  14. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  15. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  16. package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
  17. package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
  18. package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
  19. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  20. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  21. package/dist/esm/index.d.ts.map +1 -1
  22. package/dist/esm/index.js.map +1 -1
  23. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
  24. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
  31. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  32. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
  35. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
  45. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
  47. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
  50. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
  52. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
  54. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +29 -3
  56. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +80 -16
  58. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  61. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
  62. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  63. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
  64. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  65. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
  66. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
  68. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  69. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  71. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
  72. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
  74. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
  76. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
  78. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  80. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
  81. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
  82. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  83. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
  84. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
  85. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
  86. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
  88. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  89. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  90. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
  91. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  92. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
  93. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  94. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
  95. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
  96. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
  99. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
  101. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  103. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
  104. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  105. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  106. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
  107. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  108. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
  109. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  110. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
  111. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
  113. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  114. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
  115. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  116. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
  117. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  118. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
  119. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
  121. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  122. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
  123. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  124. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
  125. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
  127. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  129. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
  130. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  131. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
  132. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  133. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
  134. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  135. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  136. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  137. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
  138. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  139. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
  140. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  141. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  142. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  143. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  144. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
  145. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  146. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  147. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  148. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
  149. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  150. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  151. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  153. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
  154. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  156. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
  157. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  158. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
  159. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  160. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
  161. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  162. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
  163. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  164. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
  165. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  166. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
  167. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  168. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
  169. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  170. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
  171. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
  172. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
  173. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
  174. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
  175. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  176. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
  177. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  178. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
  179. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  180. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
  181. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  182. package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
  183. package/dist/esm/source-anchor-grammar.js.map +1 -1
  184. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  185. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  186. package/dist/knowledge/manifest.json +7 -7
  187. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
  188. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
  189. package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
  190. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
  191. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  192. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  193. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
  194. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
  195. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
  196. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
  197. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
  198. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
  199. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
  200. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
  201. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
  202. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  203. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  204. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
  205. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
  206. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
  207. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
  208. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
  209. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +51 -7
  210. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
  211. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
  212. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +10 -2
  213. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
  214. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
  215. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
  216. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
  217. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
  218. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
  219. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
  220. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
  221. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
  222. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
  223. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
  224. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
  225. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
  226. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
  227. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
  228. package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
  229. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
  230. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
  231. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
  232. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  233. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  234. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
  235. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
  236. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
  237. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
  238. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
  239. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
  240. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
  241. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
  242. package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
  243. package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
  244. package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
  245. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
  246. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
  247. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
  248. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
  249. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
  250. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
  251. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
  252. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
  253. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
  254. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
  255. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
  256. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
  257. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
  258. package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
  259. package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
  260. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
  261. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
  262. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
  263. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
  264. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
  265. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
  266. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
  267. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
  268. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  269. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  270. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
  271. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +10 -6
  272. package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
  273. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
  274. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
  275. package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
  276. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
  277. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
  278. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
  279. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
  280. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
  281. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
  282. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
  283. package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
  284. package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
  285. package/dist/knowledge/references/application-maturity.config.md +27 -1
  286. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
  287. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
  288. package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
  289. package/dist/knowledge/references/brand.name-screening.config.md +30 -3
  290. package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
  291. package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
  292. package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
  293. package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
  294. package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
  295. package/dist/knowledge/references/companion.market.generation-service.md +46 -5
  296. package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
  297. package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
  298. package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
  299. package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
  300. package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
  301. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
  302. package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
  303. package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
  304. package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
  305. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
  306. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
  307. package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
  308. package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
  309. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
  310. package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
  311. package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
  312. package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
  313. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
  314. package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
  315. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
  316. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
  317. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
  318. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
  319. package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
  320. package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
  321. package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
  322. package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
  323. package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
  324. package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
  325. package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
  326. package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
  327. package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
  328. package/dist/knowledge/references/example.website.section.stats.md +1 -1
  329. package/dist/knowledge/references/experience-plan.config.md +111 -1
  330. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
  331. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
  332. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
  333. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
  334. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
  335. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
  336. package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
  337. package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
  338. package/dist/knowledge/references/integration-plan.config.md +7 -7
  339. package/dist/knowledge/references/placement-plan.config.md +19 -0
  340. package/dist/knowledge/references/platform.config.backing-services.md +9 -11
  341. package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
  342. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
  343. package/dist/knowledge/references/platform.config.infrastructure-host.md +0 -1
  344. package/dist/knowledge/references/platform.config.platform-key-management.md +84 -8
  345. package/dist/knowledge/references/platform.config.saas.md +20 -18
  346. package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
  347. package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
  348. package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
  349. package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
  350. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
  351. package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
  352. package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
  353. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +4 -4
  354. package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
  355. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +29 -2
  356. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
  357. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
  358. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
  359. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  360. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
  361. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
  362. package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
  363. package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
  364. package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
  365. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
  366. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
  367. package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
  368. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
  369. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
  370. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +363 -2
  371. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
  372. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
  373. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
  374. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
  375. package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
  376. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
  377. package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
  378. package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
  379. package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
  380. package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
  381. package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
  382. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
  383. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
  384. package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
  385. package/dist/knowledge/references/saas.frontend.chart-dashboard.md +130 -0
  386. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
  387. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
  388. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
  389. package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
  390. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
  391. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
  392. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
  393. package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
  394. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
  395. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
  396. package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
  397. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
  398. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
  399. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
  400. package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
  401. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
  402. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
  403. package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
  404. package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
  405. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
  406. package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
  407. package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
  408. package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
  409. package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
  410. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
  411. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
  412. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
  413. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
  414. package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
  415. package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
  416. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
  417. package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
  418. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
  419. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
  420. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
  421. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
  422. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
  423. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
  424. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
  425. package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
  426. package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
  427. package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
  428. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
  429. package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
  430. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
  431. package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
  432. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
  433. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
  434. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
  435. package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
  436. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
  437. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
  438. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
  439. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
  440. package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
  441. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
  442. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
  443. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
  444. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
  445. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
  446. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
  447. package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
  448. package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
  449. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
  450. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
  451. package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
  452. package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
  453. package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
  454. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
  455. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
  456. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
  457. package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
  458. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
  459. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
  460. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
  461. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
  462. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
  463. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
  464. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
  465. package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
  466. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
  467. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
  468. package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
  469. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
  470. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
  471. package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
  472. package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
  473. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
  474. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
  475. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
  476. package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
  477. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
  478. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
  479. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
  480. package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
  481. package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
  482. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
  483. package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
  484. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
  485. package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
  486. package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
  487. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
  488. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
  489. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
  490. package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
  491. package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
  492. package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
  493. package/dist/knowledge/references/service-method.config.md +35 -2
  494. package/dist/knowledge/references/vision.constraint.config.md +4 -2
  495. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
  496. package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
  497. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
  498. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
  499. package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
  500. package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
  501. package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
  502. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
  503. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
  504. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
  505. package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
  506. package/dist/knowledge/references/zod.factories.code.md +4 -4
  507. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  508. package/dist/knowledge/references/zod.factories.money.md +4 -4
  509. package/dist/knowledge/references/zod.factories.phone.md +4 -4
  510. package/dist/knowledge/references/zod.factories.year-month.md +79 -0
  511. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  512. package/dist/knowledge/registries/framework-topics.json +415 -2
  513. package/dist/knowledge/registries/playbooks.json +51 -39
  514. package/dist/knowledge/registries/source-tags.json +2412 -1604
  515. package/dist/knowledge/rules/database-migration-obligation.md +6 -7
  516. package/dist/knowledge/rules/live-context-door.md +1 -1
  517. package/dist/knowledge/skills/INDEX.md +3 -1
  518. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
  519. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
  520. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
  521. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
  522. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
  523. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
  524. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
  525. package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
  526. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
  527. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
  528. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
  529. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
  530. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
  531. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
  532. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
  533. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
  534. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  535. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
  536. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
  537. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
  538. package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
  539. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
  540. package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
  541. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
  542. package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
  543. package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +79 -0
  544. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
  545. package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
  546. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
  547. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
  548. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
  549. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
  550. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
  551. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
  552. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
  553. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
  554. package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
  555. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
  556. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
  557. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
  558. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
  559. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
  560. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
  561. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
  562. package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
  563. package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
  564. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
  565. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
  566. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
  567. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
  568. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
  569. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +197 -9
  570. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
  571. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
  572. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
  573. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
  574. package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
  575. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
  576. package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
  577. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
  578. package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
  579. package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
  580. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
  581. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
  582. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
  583. package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
  584. package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +61 -0
  585. package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
  586. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
  587. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
  588. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
  589. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
  590. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
  591. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +1 -1
  592. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
  593. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +18 -7
  594. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
  595. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
  596. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +44 -4
  597. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
  598. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
  599. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
  600. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
  601. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
  602. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +375 -8
  603. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
  604. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
  605. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
  606. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +1 -1
  607. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
  608. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
  609. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +1 -1
  610. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
  611. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
  612. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +3 -3
  613. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +37 -14
  614. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
  615. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
  616. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
  617. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
  618. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
  619. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
  620. package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
  621. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
  622. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
  623. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
  624. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
  625. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
  626. package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
  627. package/dist/knowledge/skills/infra-environment-config/SKILL.md +125 -77
  628. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
  629. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
  630. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +0 -1
  631. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +84 -8
  632. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
  633. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
  634. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
  635. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
  636. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
  637. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
  638. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
  639. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
  640. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
  641. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
  642. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
  643. package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
  644. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
  645. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
  646. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
  647. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
  648. package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
  649. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
  650. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
  651. package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
  652. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
  653. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
  654. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
  655. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
  656. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
  657. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
  658. package/dist/knowledge/skills/provider-backend-package/SKILL.md +255 -12
  659. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
  660. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
  661. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
  662. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
  663. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
  664. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
  665. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
  666. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
  667. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
  668. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
  669. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
  670. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
  671. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
  672. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
  673. package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
  674. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
  675. package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
  676. package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
  677. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
  678. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
  679. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
  680. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
  681. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
  682. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +33 -7
  683. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
  684. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
  685. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
  686. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +7 -2
  687. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
  688. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
  689. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
  690. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
  691. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
  692. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
  693. package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
  694. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
  695. package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
  696. package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
  697. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
  698. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
  699. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
  700. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
  701. package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
  702. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
  703. package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
  704. package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
  705. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
  706. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
  707. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
  708. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
  709. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
  710. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
  711. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
  712. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
  713. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
  714. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
  715. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
  716. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
  717. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
  718. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
  719. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
  720. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
  721. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
  722. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  723. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
  724. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
  725. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
  726. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
  727. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
  728. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
  729. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
  730. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
  731. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
  732. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
  733. package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
  734. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
  735. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
  736. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
  737. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
  738. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
  739. package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
  740. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
  741. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
  742. package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
  743. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
  744. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
  745. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
  746. package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
  747. package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
  748. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
  749. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
  750. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
  751. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
  752. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
  753. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
  754. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
  755. package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
  756. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
  757. package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
  758. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
  759. package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
  760. package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
  761. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
  762. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
  763. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  764. package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
  765. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
  766. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
  767. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
  768. package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
  769. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
  770. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
  771. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
  772. package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
  773. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
  774. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
  775. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
  776. package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
  777. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
  778. package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
  779. package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
  780. package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
  781. package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
  782. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
  783. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
  784. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
  785. package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
  786. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
  787. package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
  788. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
  789. package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
  790. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
  791. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
  792. package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
  793. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
  794. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
  795. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
  796. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
  797. package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
  798. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
  799. package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
  800. package/dist/knowledge/topic-index.json +2275 -715
  801. package/dist/tsconfig.build.tsbuildinfo +1 -1
  802. package/package.json +6 -6
  803. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -28,7 +28,7 @@ export type ReviewDeadlineAt = z.infer<typeof ReviewDeadlineAtSchema>;
28
28
  export const ReviewDeadlineTargetSchema = z.object({
29
29
  at: ReviewDeadlineAtSchema,
30
30
  /** Elapsed time (the default) or the application's business calendar. */
31
- basis: z.enum(ReviewClockBasis).optional(),
31
+ basis: z.enum(ReviewClockBasis).systemEnum('ReviewClockBasis').optional(),
32
32
  /** Arms a WARNING stage this long before the deadline, on the same basis. Absent: no warning stage. */
33
33
  warnBefore: ReviewDurationSchema.optional(),
34
34
  });
@@ -39,8 +39,8 @@ export type ReviewDeadlineTarget = z.infer<typeof ReviewDeadlineTargetSchema>;
39
39
  * target resolver, declared on the backend gate beside it.
40
40
  */
41
41
  export const ReviewEscalationRuleSchema = z.object({
42
- stage: z.enum(ReviewDeadlineStage),
43
- action: z.enum(ReviewEscalationActionKind),
42
+ stage: z.enum(ReviewDeadlineStage).systemEnum('ReviewDeadlineStage'),
43
+ action: z.enum(ReviewEscalationActionKind).systemEnum('ReviewEscalationActionKind'),
44
44
  });
45
45
  export type ReviewEscalationRuleDescriptor = z.infer<typeof ReviewEscalationRuleSchema>;
46
46
 
@@ -69,11 +69,11 @@ export type Flow_Condition = z.infer<typeof Flow_ConditionSchema>;
69
69
  */
70
70
  export const Flow_EdgeSchema = z.object({
71
71
  from: z.object({
72
- type: z.enum(Flow_Node_Type),
72
+ type: z.enum(Flow_Node_Type).systemEnum('Flow_Node_Type'),
73
73
  ref: z.string(),
74
74
  }),
75
75
  to: z.object({
76
- type: z.enum(Flow_Node_Type),
76
+ type: z.enum(Flow_Node_Type).systemEnum('Flow_Node_Type'),
77
77
  ref: z.string(),
78
78
  }),
79
79
  /** The condition under which the run takes this edge; absent, the node's default edge. */
@@ -164,6 +164,25 @@ export type Flow_HumanInTheLoop = {
164
164
  context?: Flow_HumanContextEntry[];
165
165
  /** The questions, as an agent asks its person (`AskPerson_Question`). */
166
166
  questions: AskPerson_Question[];
167
+ /**
168
+ * Whether the answer must carry a fresh step-up proof bound to this question (#2923): the person re-proves a factor
169
+ * (`POST /auth/reauth` with a `decisionBinding` naming the question and the presentation answered) and answers from the
170
+ * decision inbox with it. A chat answer carries none, so it is refused. Use it for a step whose answer commits the
171
+ * person: a sign-off, a payment release.
172
+ */
173
+ requiresStepUpAuthentication?: boolean;
174
+ /**
175
+ * What that step-up must ALSO be (#2923), with `requiresStepUpAuthentication: true` (refused without it):
176
+ * `maximumAgeSeconds` (at most 300) since the factor was proven, and a `minimumAssurance` of `reproven`, `possession`
177
+ * or `phishing_resistant`. Recorded on the decision and its approval seal as `decider.stepUpMethod` / `stepUpAt`.
178
+ */
179
+ stepUp?: HumanDecision_StepUpRequirement;
180
+ /**
181
+ * The channels that may answer this step (#2923): `web_session`, `chat`, `api_client`. Absent: every channel the other
182
+ * requirements allow. `chat` is refused beside a step-up; a chat card for a step it may not answer links to it in the
183
+ * application.
184
+ */
185
+ answerChannels?: HumanDecision_AnswerChannels;
167
186
  };
168
187
 
169
188
  /** One run value a person step shows, and the words that name it to the person (`"Proposed resolution"`). */
@@ -120,7 +120,7 @@ export const GuidanceAudienceSchema = z.object({
120
120
  equals: z.union([z.string(), z.number(), z.boolean()]),
121
121
  })).optional(),
122
122
  /** Only show to users created after this date (for new-user flows) */
123
- createdAfter: z.coerce.date().optional(),
123
+ createdAfter: z.date().nullish(),
124
124
  });
125
125
  export type GuidanceAudience = z.infer<typeof GuidanceAudienceSchema>;
126
126
 
@@ -135,7 +135,7 @@ export enum HttpApiWriteVerb {
135
135
 
136
136
  /**
137
137
  * What protects an UPDATE against overwriting a change made since its author read the row (#1724, #1726, #1728) —
138
- * declared by every binding that opens UPDATE, whatever its dialect (ODOO_JSONRPC, ODATA, REST_JSON).
138
+ * declared by every binding that opens UPDATE, whatever its dialect (ODOO_JSONRPC, ODOO_JSON2, ODATA, REST_JSON).
139
139
  *
140
140
  * ## Why a binding must say this at all
141
141
  *
@@ -685,7 +685,7 @@ const httpApiResourceBindingBaseShape = {
685
685
  * How an opened UPDATE is protected against overwriting a change made since its author read the row (#1724). See
686
686
  * {@link HttpApiWriteConcurrencyMode} for the two answers and the limit of the first.
687
687
  *
688
- * REQUIRED when the binding opens UPDATE — on ODOO_JSONRPC (#1724), ODATA (#1726) and REST_JSON (#1728) alike — and
688
+ * REQUIRED when the binding opens UPDATE — on both Odoo dialects (#1724, #3391), ODATA (#1726) and REST_JSON (#1728) alike — and
689
689
  * refused when the binding opens no UPDATE — a concurrency stance on a door that is shut decides nothing. `versionField` names the LOCAL field that
690
690
  * carries the version: it must map onto the vendor facet's `rowVersionField` (checked at boot, where the facet is
691
691
  * visible) — Odoo `write_date`, an OData service's `@odata.etag` — and the resource's schema must let an UPDATE carry
@@ -768,6 +768,16 @@ export const HttpApiResourceBindingSchema = z.discriminatedUnion('dialect', [
768
768
  // (called by the resource-configuration factory) — a refine here would wrap the union member
769
769
  // in effects, which discriminated unions do not admit.
770
770
  }),
771
+ z.strictObject({
772
+ /*
773
+ * Odoo's External JSON-2 API (#3391). The same declaration as ODOO_JSONRPC — `entityRef` is the model, read/list/
774
+ * count map mechanically, one INTEGER key — because what a binding states is what the rows ARE, and that does not
775
+ * change with the wire. Its own arm rather than a two-value literal on the arm above, so a reader narrowing a binding
776
+ * to one Odoo wire (the read client does) gets exactly one.
777
+ */
778
+ dialect: z.literal(HttpApiTransportDialect.ODOO_JSON2),
779
+ ...httpApiResourceBindingBaseShape,
780
+ }),
771
781
  ]);
772
782
 
773
783
  /**
@@ -862,15 +872,15 @@ function assertRestJsonKeysetCoherence(keyFields: readonly HttpApiKeyField[], op
862
872
  * path named.
863
873
  */
864
874
  export function assertHttpApiBindingDialectCoherence(binding: HttpApiResourceBinding): void {
865
- if (binding.dialect === HttpApiTransportDialect.ODOO_JSONRPC) {
866
- // Odoo row ids are INTEGERS, always — one key field, INTEGER codec, or the synthesized id
867
- // could never address a row.
875
+ if (isOdooTransportDialect(binding.dialect)) {
876
+ // Odoo row ids are INTEGERS, always, whichever wire reads them — one key field, INTEGER codec,
877
+ // or the synthesized id could never address a row.
868
878
  if (
869
879
  binding.keyFields.length !== 1
870
880
  || binding.keyFields[0].codec !== HttpApiKeyComponentCodec.INTEGER
871
881
  ) {
872
882
  throw new Error(
873
- "keyFields: an ODOO_JSONRPC binding must declare exactly one key field with the INTEGER codec — Odoo row ids are integers ('id').",
883
+ `keyFields: an ${binding.dialect} binding must declare exactly one key field with the INTEGER codec — Odoo row ids are integers ('id').`,
874
884
  );
875
885
  }
876
886
  }
@@ -954,7 +964,7 @@ export function assertHttpApiBindingDialectCoherence(binding: HttpApiResourceBin
954
964
  'writeConcurrency: declared on a binding that opens no UPDATE — it governs updates only. Remove it, or open the update.',
955
965
  );
956
966
  }
957
- if (opensUpdate && binding.writeConcurrency === undefined && binding.dialect === HttpApiTransportDialect.ODOO_JSONRPC) {
967
+ if (opensUpdate && binding.writeConcurrency === undefined && isOdooTransportDialect(binding.dialect)) {
958
968
  throw new Error(
959
969
  `writeConcurrency: this binding opens UPDATE toward '${binding.system}', and Odoo's external API has no conditional write — `
960
970
  + '`write(ids, vals)` applies the values whatever changed since they were read. State the stance: '
@@ -1022,7 +1032,8 @@ export function assertHttpApiBindingDialectCoherence(binding: HttpApiResourceBin
1022
1032
  // admits both forms; only the pairing below is executable, so an incoherent pairing must refuse
1023
1033
  // at authoring rather than on the first subject-erasure request:
1024
1034
  // - ODATA → `useCanonicalDelete` only (the canonical `DELETE /EntitySet(key)`);
1025
- // - ODOO_JSONRPC → `useCanonicalDelete` only (compiles to `execute_kw('unlink', [[ids]])`,
1035
+ // - ODOO_JSONRPC / ODOO_JSON2 → `useCanonicalDelete` only (compiles to Odoo's `unlink` on the ids — `execute_kw`
1036
+ // on JSON-RPC, `POST /json/2/<model>/unlink { ids }` on JSON-2 —
1026
1037
  // Odoo's own canonical delete);
1027
1038
  // - REST_JSON → an explicit operation spec only (there IS no canonical delete to rely on —
1028
1039
  // the binding declares the exact call, like every other REST_JSON operation).
@@ -15,6 +15,6 @@
15
15
  * A tool approval is always a proposal and needs no marker.
16
16
  */
17
17
  review: z.strictObject({
18
- surface: z.enum(AgentWorkDecisionSurface),
18
+ surface: z.enum(AgentWorkDecisionSurface).systemEnum('AgentWorkDecisionSurface'),
19
19
  }).optional(),
20
20
  ```
@@ -12,12 +12,17 @@
12
12
  /**
13
13
  * What a message arrived on.
14
14
  *
15
- * SMS, chat and Slack join this vocabulary when a provider can fill them — a channel nothing can
16
- * receive on is a slot no configuration can satisfy.
15
+ * Chat and Slack join this vocabulary when a provider can fill them — a channel nothing can receive on is a
16
+ * slot no configuration can satisfy.
17
17
  */
18
18
  export enum InboundChannelKind {
19
19
  /** Email received through the application's `EMAIL_INBOUND` provider and routed to an organization. */
20
20
  EMAIL = 'email',
21
+ /**
22
+ * A text message received by the application's SMS provider on a number the application assigned to an
23
+ * organization (#3394), routed to that organization by the number it was sent TO, never by its sender.
24
+ */
25
+ SMS = 'sms',
21
26
  /**
22
27
  * A signed HTTP delivery from another system (#1596). Derived for provider and application endpoint
23
28
  * deliveries; a handler never declares it.
@@ -58,6 +63,13 @@ export enum InboundSenderAssurance {
58
63
  * and `From` is the address that token was issued to.
59
64
  */
60
65
  THREAD_TOKEN_BOUND = 'thread_token_bound',
66
+ /**
67
+ * SMS: the sending number is the verified phone number (`UserCredentials.phoneNumberVerified`) of exactly one
68
+ * active member of the routed organization. Verified when the member confirmed a code sent to it; the sender of
69
+ * THIS text is still not authenticated (caller ID can be spoofed onto SMS), so it identifies the member and
70
+ * grants nothing. Two members holding one number identify nobody.
71
+ */
72
+ VERIFIED_MEMBER_NUMBER = 'verified_member_number',
61
73
  }
62
74
 
63
75
  /** The assurance levels meaningful on each channel — the type a channel's ladder and minimum are drawn from. */
@@ -67,6 +79,10 @@ export interface InboundSenderAssuranceByChannel {
67
79
  | InboundSenderAssurance.DOMAIN_ALIGNED
68
80
  | InboundSenderAssurance.KNOWN_CONTACT
69
81
  | InboundSenderAssurance.THREAD_TOKEN_BOUND;
82
+ [InboundChannelKind.SMS]:
83
+ | InboundSenderAssurance.UNVERIFIED
84
+ | InboundSenderAssurance.KNOWN_CONTACT
85
+ | InboundSenderAssurance.VERIFIED_MEMBER_NUMBER;
70
86
  [InboundChannelKind.WEBHOOK]: InboundSenderAssurance.UNVERIFIED | InboundSenderAssurance.SOURCE_SIGNED;
71
87
  }
72
88
 
@@ -84,6 +100,16 @@ export const INBOUND_SENDER_ASSURANCE_LADDERS: { readonly [C in InboundChannelKi
84
100
  InboundSenderAssurance.KNOWN_CONTACT,
85
101
  InboundSenderAssurance.THREAD_TOKEN_BOUND,
86
102
  ],
103
+ /*
104
+ * A member's verified number outranks a contact the application recognises: the member proved the number by a code
105
+ * the engine sent to it, while a contact's number is whatever the application recorded. Neither authenticates the
106
+ * sender of this text (SMS has no counterpart of DMARC), which is why the ladder only ever IDENTIFIES.
107
+ */
108
+ [InboundChannelKind.SMS]: [
109
+ InboundSenderAssurance.UNVERIFIED,
110
+ InboundSenderAssurance.KNOWN_CONTACT,
111
+ InboundSenderAssurance.VERIFIED_MEMBER_NUMBER,
112
+ ],
87
113
  [InboundChannelKind.WEBHOOK]: [InboundSenderAssurance.UNVERIFIED, InboundSenderAssurance.SOURCE_SIGNED],
88
114
  };
89
115
 
@@ -271,6 +297,49 @@ export function isEmailMessageId(value: unknown): value is string {
271
297
  return typeof value === 'string' && EMAIL_MESSAGE_ID_PATTERN.test(value);
272
298
  }
273
299
 
300
+ // ─────────────────────────────────────────────────────────────────────────────
301
+ // SMS: deriving sender assurance and a text's route tag
302
+ // ─────────────────────────────────────────────────────────────────────────────
303
+
304
+ /** What the routed organization knows about the number a text came from (#3394). */
305
+ export enum SmsSenderNumberMatch {
306
+ /** Not one member's verified number, and not a contact the application recognises. */
307
+ NONE = 'none',
308
+ /** The verified phone number of exactly one active member of the routed organization (sets `memberUserId`). */
309
+ VERIFIED_MEMBER = 'verified_member',
310
+ /** The handler's contact resolver recognised the number. The engine keeps no contacts of its own. */
311
+ APPLICATION_CONTACT = 'application_contact',
312
+ }
313
+
314
+ /**
315
+ * A text's sender assurance (#3394). PURE: the input is a lookup the engine made, never what the text says.
316
+ *
317
+ * SMS carries no sender authentication — no counterpart of DMARC, and caller ID can be spoofed onto a text — so every
318
+ * level above the floor IDENTIFIES the sender by a number someone verified or recorded, and none of them
319
+ * authenticates it. A handler's roles never depend on it (I8); a handler only states the minimum it acts on.
320
+ */
321
+ export function deriveSmsSenderAssurance(match: SmsSenderNumberMatch): SenderAssuranceOf<InboundChannelKind.SMS> {
322
+ switch (match) {
323
+ case SmsSenderNumberMatch.VERIFIED_MEMBER: return InboundSenderAssurance.VERIFIED_MEMBER_NUMBER;
324
+ case SmsSenderNumberMatch.APPLICATION_CONTACT: return InboundSenderAssurance.KNOWN_CONTACT;
325
+ case SmsSenderNumberMatch.NONE: return InboundSenderAssurance.UNVERIFIED;
326
+ default: {
327
+ const unhandled: never = match;
328
+ return unhandled;
329
+ }
330
+ }
331
+ }
332
+
333
+ /**
334
+ * What an SMS `routeTag` looks like: the first word of a text, lower-cased, when it is a tag a handler declares
335
+ * (`INBOUND_ROUTE_TAG_PATTERN`'s shape). A text has no sub-address, so its first word is the only place a tag can be.
336
+ */
337
+ export function smsRouteTagCandidate(text: string): string | undefined {
338
+ const first = text.normalize('NFKC').trim().split(/\s+/u)[0] ?? '';
339
+ const word = first.replace(/[^\p{L}\p{N}-]+$/gu, '').toLowerCase();
340
+ return /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(word) ? word : undefined;
341
+ }
342
+
274
343
  /**
275
344
  * What an inbound handler's `ref` looks like: lower-case, dot-separated segments of `[a-z0-9-]`
276
345
  * (`todos.intake`, `matters.mail-intake`). One definition for the backend's `inboundHandlerRef()`, which
@@ -20,7 +20,7 @@ export const ModelCostAccountingConfigSchema = z.object({
20
20
  try {
21
21
  assertUniqueProviderUsagePricingAuthorities(config.providerUsagePricingAuthorities);
22
22
  } catch (error) {
23
- context.addIssue({ code: 'custom', path: ['providerUsagePricingAuthorities'], message: error instanceof Error ? error.message : String(error) });
23
+ context.addIssue({ code: 'custom', path: ['providerUsagePricingAuthorities'], message: describeCaughtError(error) });
24
24
  }
25
25
  });
26
26
  export type ModelCostAccountingConfig = z.infer<typeof ModelCostAccountingConfigSchema>;
@@ -138,7 +138,9 @@ export function userNotificationTargetIsSuppressibleByRecipientPreference(target
138
138
  */
139
139
  export function userNotificationTargetReadsUserRoles(target: string, channel: string): boolean {
140
140
  if (target === CoreUserNotificationTarget.INBOUND_CONTACT) {
141
- return channel !== CoreUserNotificationChannel.EMAIL;
141
+ // Only the in-app alert reads roles. EMAIL reaches the contact by address, and SMS cannot reach the contact at all
142
+ // (an SMS goes only to a user's verified phone with their consent), so it is refused there (#1875).
143
+ return channel === CoreUserNotificationChannel.WEBSOCKET || channel === CoreUserNotificationChannel.FRONT_END_SUCCESS;
142
144
  }
143
145
  return target === CoreUserNotificationTarget.ORGANIZATION_BILLING
144
146
  || target === CoreUserNotificationTarget.ORGANIZATION_USER_MANAGEMENT
@@ -23,10 +23,17 @@
23
23
  *
24
24
  * ## What actually sends
25
25
  *
26
- * `EMAIL`, `WEBSOCKET` and `FRONT_END_SUCCESS` are the channels, and all three deliver. There is no
27
- * SMS or push notification channel: both were declaration vocabulary that the dispatcher logged and
28
- * dropped, and were removed. The framework's SMS transport serves authentication's one-time codes, not
29
- * resource notifications.
26
+ * `EMAIL`, `SMS`, `WEBSOCKET` and `FRONT_END_SUCCESS` are the channels, and all four deliver. There is no
27
+ * push channel.
28
+ *
29
+ * An `SMS` notification sends a short plain text through the application's SMS provider (the one that sends
30
+ * its one-time codes), and only to a recipient who switched SMS ON (`UserPreferences.notifications.sms`,
31
+ * off by default) and has a phone number verified on their account. Nothing overrides that consent: not a
32
+ * role-addressed target, not `alwaysDeliver`. Its words are a label, `notifications_custom.<identifier>.sms`,
33
+ * generated from the `text.purpose` you declare, in each recipient's language; write `text.params` for the
34
+ * values it interpolates. The words should fit ONE SMS segment (160 GSM-7 characters, 70 when any character
35
+ * needs UCS-2); a longer text still goes out, as a concatenated message, with a warning. A recipient whose
36
+ * label is missing gets no text at all, rather than a raw key on their phone.
30
37
  *
31
38
  * For an EMAIL, create the template the derived reference names: one per operation variant that declares a
32
39
  * `variantKey`, since the reference carries it. The startup validator resolves every declared reference through
@@ -58,10 +65,11 @@
58
65
  *
59
66
  * ## Emailing somebody who is not a user
60
67
  *
61
- * `recipientEmailField` names a TOP-LEVEL field on the record holding the address. There is no
62
- * recipient, so there are no recipient preferences and no recipient language: the message goes out in
63
- * the application's default locale. A nested address cannot be named, nor a list — the path sends
64
- * exactly one message per notification. Pair it with a `condition` when the same operation also
68
+ * `recipientEmailField` names a TOP-LEVEL field on the record holding the address. The message is
69
+ * written in the language of the user the record names in `userId` when that user's own address IS the
70
+ * recipient address (an invitation's membership row names the invited user), and in the application's
71
+ * primary language otherwise. Channel switches are not consulted on this path. A nested address cannot
72
+ * be named, nor a list — the path sends exactly one message per notification. Pair it with a `condition` when the same operation also
65
73
  * serves rows whose address belongs to somebody who must not be written to.
66
74
  *
67
75
  * Base fields shared by all user notification channel variants.
@@ -166,13 +174,15 @@ export const UserNotificationDefinition_EmailSchema = UserNotificationDefinition
166
174
  *
167
175
  * When set, the recipient is `currentObject[recipientEmailField]` (a top-level
168
176
  * string field — e.g. `'email'`). The dispatcher sends a single email directly to
169
- * that address using the application's default locale, BYPASSING the `userId`-based
170
- * `target` resolution entirely.
177
+ * that address, BYPASSING the `userId`-based `target` resolution entirely. It is
178
+ * written in the language of the user the record names in `userId` when that user's
179
+ * own address IS the recipient address, and in the application's primary language
180
+ * otherwise (#3110).
171
181
  *
172
- * This is the framework's mechanism for notifying a party who is **not (yet) a
173
- * platform user** — an organization-invitation invitee, an inbound lead — for whom
174
- * no `userId` exists. Without it, the only email recipients the dispatcher can
175
- * resolve are members/initiators by id (`fetchUserContext(userId).email`).
182
+ * This is the framework's mechanism for notifying a party known by an ADDRESS — an
183
+ * organization-invitation invitee (who may or may not hold an account), an inbound
184
+ * lead. Without it, the only email recipients the dispatcher can resolve are
185
+ * members/initiators by id (`fetchUserContext(userId).email`).
176
186
  *
177
187
  * When this is set, `target` no longer selects the recipient; it is retained only
178
188
  * to (a) classify the notification, (b) drive the email `templateRef` derivation,
@@ -222,6 +232,168 @@ export const UserNotificationDefinition_WebSocketSchema = UserNotificationDefini
222
232
  channel: z.literal(CoreUserNotificationChannel.WEBSOCKET),
223
233
  });
224
234
 
235
+ /** The operation context an SMS text parameter's `value` is computed from: the same shape `condition` receives. */
236
+ export interface UserNotificationSmsTextParamContext {
237
+ currentObject: any;
238
+ previousObject?: any;
239
+ inputDto: any;
240
+ objectContext: { parents: Record<string, any>; children: Record<string, any> };
241
+ initiatorIds: { userId?: string; organizationId?: string; applicationId?: string };
242
+ }
243
+
244
+ /**
245
+ * The name of an SMS text parameter: the `{name}` placeholder the generated words carry. Letters and digits only, so it
246
+ * is a valid placeholder in every label and a valid key in the generation request.
247
+ */
248
+ export const USER_NOTIFICATION_SMS_TEXT_PARAM_NAME_PATTERN = /^[A-Za-z][A-Za-z0-9]*$/;
249
+
250
+ /** One value an SMS notification's text interpolates (#1875). */
251
+ export const UserNotificationSmsTextParamSchema = z.object({
252
+ /** What the value is, for the writer of the words ("the title of the to-do"). Keep the value SHORT: it counts against the segment. */
253
+ meaning: z.string().trim().min(1),
254
+ /** The value, computed when the notification is sent. `null`/`undefined` interpolates as an empty string. */
255
+ value: z.custom<(params: UserNotificationSmsTextParamContext) => string | number | null | undefined>((val) => typeof val === 'function'),
256
+ });
257
+ export type UserNotificationSmsTextParam = z.infer<typeof UserNotificationSmsTextParamSchema>;
258
+
259
+ /**
260
+ * The short-text contract of an SMS notification (#1875): what the text must say, and the values it interpolates.
261
+ *
262
+ * The WORDS are not declared here. They are a label, {@link userNotificationSmsTextLabelKey}, which the labelling
263
+ * pipeline generates from `purpose` and the parameters' meanings and translates into every language the application
264
+ * offers, so a recipient reads the text in their own language (`display-text-comes-from-i18n.md`). An inline string
265
+ * was rejected for that reason, and an email-style template directory was rejected because an SMS is one plain
266
+ * sentence: a template file per notification would carry nothing a label does not.
267
+ *
268
+ * Plain text only: no markup, no link the recipient cannot see in full. The length rule is
269
+ * {@link USER_NOTIFICATION_SMS_TEXT_SEGMENT_BUDGET}.
270
+ */
271
+ export const UserNotificationSmsTextSchema = z.object({
272
+ /** What the text tells the recipient, in one or two sentences. The writer's only context besides the parameters. */
273
+ purpose: z.string().trim().min(1),
274
+ /** The values the text interpolates, by placeholder name. */
275
+ params: z.record(
276
+ z.string().regex(USER_NOTIFICATION_SMS_TEXT_PARAM_NAME_PATTERN, 'An SMS text parameter name is letters and digits, starting with a letter.'),
277
+ UserNotificationSmsTextParamSchema,
278
+ ).optional(),
279
+ });
280
+ export type UserNotificationSmsText = z.infer<typeof UserNotificationSmsTextSchema>;
281
+
282
+ /**
283
+ * SMS channel — a short plain text to each recipient's verified phone, with their consent (#1875).
284
+ *
285
+ * @example
286
+ * ```ts
287
+ * {
288
+ * target: CoreUserNotificationTarget.USERS_CUSTOM,
289
+ * channel: CoreUserNotificationChannel.SMS,
290
+ * customNotificationRef: 'notify-assignee',
291
+ * userIdsSelector: ({ currentObject }) => [currentObject.assigneeId],
292
+ * text: {
293
+ * purpose: 'Tells the person a to-do was just assigned to them, naming it.',
294
+ * params: { title: { meaning: 'the title of the to-do', value: ({ currentObject }) => currentObject.title } },
295
+ * },
296
+ * }
297
+ * ```
298
+ */
299
+ export const UserNotificationDefinition_SmsSchema = UserNotificationDefinition_BaseSchema.extend({
300
+ channel: z.literal(CoreUserNotificationChannel.SMS),
301
+ text: UserNotificationSmsTextSchema,
302
+ });
303
+
304
+ /** The label key an SMS notification's words live under: `notifications_custom.<identifier>.sms` (#1875). */
305
+ export function userNotificationSmsTextLabelKey(identifier: string): string {
306
+ return `${LabellingTypes.NOTIFICATIONS_CUSTOM}.${identifier}.sms`;
307
+ }
308
+
309
+ // =====================================================
310
+ // SMS segment measurement (#1875)
311
+ // =====================================================
312
+
313
+ /**
314
+ * The two encodings an SMS body is sent in. A body is GSM-7 when every character is in the GSM 03.38 default
315
+ * alphabet or its extension table, and UCS-2 otherwise: ONE character outside that alphabet switches the whole
316
+ * message, which is what makes an accented letter or an emoji cost more than half the length budget.
317
+ *
318
+ * spec-cite: 3GPP TS 23.038 (GSM 03.38) — default alphabet and extension table, as tabulated at
319
+ * https://en.wikipedia.org/wiki/GSM_03.38 and https://www.twilio.com/docs/glossary/what-is-gsm-7-character-encoding
320
+ */
321
+ export enum SmsTextEncoding {
322
+ GSM_7 = 'gsm_7',
323
+ UCS_2 = 'ucs_2',
324
+ }
325
+
326
+ /**
327
+ * Length units one segment holds, by encoding: 160 septets in GSM-7, 70 UTF-16 code units in UCS-2.
328
+ *
329
+ * spec-cite: https://www.twilio.com/docs/glossary/what-sms-character-limit — the single-segment row of its table.
330
+ */
331
+ export const SMS_SINGLE_SEGMENT_UNITS: Readonly<Record<SmsTextEncoding, number>> = Object.freeze({
332
+ [SmsTextEncoding.GSM_7]: 160,
333
+ [SmsTextEncoding.UCS_2]: 70,
334
+ });
335
+
336
+ /**
337
+ * Length units each segment of a CONCATENATED message holds (the rest carries the reassembly header): 153 and 67.
338
+ *
339
+ * spec-cite: https://www.twilio.com/docs/glossary/what-sms-character-limit — the multi-segment row of its table.
340
+ */
341
+ export const SMS_CONCATENATED_SEGMENT_UNITS: Readonly<Record<SmsTextEncoding, number>> = Object.freeze({
342
+ [SmsTextEncoding.GSM_7]: 153,
343
+ [SmsTextEncoding.UCS_2]: 67,
344
+ });
345
+
346
+ /**
347
+ * The length rule of an SMS notification text: it should fit ONE segment, so 160 GSM-7 units or 70 UCS-2 units.
348
+ *
349
+ * Decided by practice (#1875). A notification is an alert, not a conversation, and one segment is what every carrier
350
+ * delivers whole and bills once; Twilio's own guidance keeps messages under two segments for deliverability. The
351
+ * budget is given to the writer of the words (the labelling pipeline), and the dispatcher MEASURES each rendered text
352
+ * against it. A text over budget, usually because an interpolated value is long, is still sent, as a concatenated
353
+ * message, with a warning naming the notification: losing the notification would cost the recipient more than the
354
+ * second segment does. Rejected: refusing it (a long to-do title would silently cost someone their alert) and
355
+ * truncating it (it can cut the one word that mattered).
356
+ */
357
+ export const USER_NOTIFICATION_SMS_TEXT_SEGMENT_BUDGET = 1;
358
+
359
+ /**
360
+ * The GSM 03.38 default alphabet, one septet each. `Ç` is listed as the standard tabulates it (0x09); a `ç` therefore
361
+ * measures as UCS-2, which over-counts on a handset that maps 0x09 to `ç` — the safe direction for a length budget.
362
+ */
363
+ const GSM_7_DEFAULT_ALPHABET: ReadonlySet<string> = new Set(
364
+ '@£$¥èéùìòÇ\nØø\rÅåΔ_ΦΓΛΩΠΨΣΘΞÆæßÉ !"#¤%&\'()*+,-./0123456789:;<=>?¡ABCDEFGHIJKLMNOPQRSTUVWXYZÄÖÑܧ¿abcdefghijklmnopqrstuvwxyzäöñüà',
365
+ );
366
+
367
+ /** The GSM 03.38 extension table reachable through ESC: two septets each. */
368
+ const GSM_7_EXTENSION_TABLE: ReadonlySet<string> = new Set('\f^{}\\[~]|€');
369
+
370
+ /** What one SMS body costs: its encoding, its length in that encoding's units, and the segments it is sent as. */
371
+ export interface SmsTextMeasurement {
372
+ readonly encoding: SmsTextEncoding;
373
+ /** GSM-7 septets (an extension character counts two), or UCS-2 UTF-16 code units (a character outside the BMP counts two). */
374
+ readonly units: number;
375
+ readonly segments: number;
376
+ }
377
+
378
+ /** Measure an SMS body against the GSM-7 / UCS-2 segmenting rules. Pure. */
379
+ export function measureSmsText(text: string): SmsTextMeasurement {
380
+ let septets = 0;
381
+ let gsm7 = true;
382
+ for (const character of text) {
383
+ if (GSM_7_DEFAULT_ALPHABET.has(character)) septets += 1;
384
+ else if (GSM_7_EXTENSION_TABLE.has(character)) septets += 2;
385
+ else { gsm7 = false; break; }
386
+ }
387
+ const encoding = gsm7 ? SmsTextEncoding.GSM_7 : SmsTextEncoding.UCS_2;
388
+ const units = gsm7 ? septets : text.length;
389
+ const segments = units === 0
390
+ ? 0
391
+ : units <= SMS_SINGLE_SEGMENT_UNITS[encoding]
392
+ ? 1
393
+ : Math.ceil(units / SMS_CONCATENATED_SEGMENT_UNITS[encoding]);
394
+ return { encoding, units, segments };
395
+ }
396
+
225
397
  /**
226
398
  * FRONT_END_SUCCESS channel — frontend display with optional celebration + nextStep.
227
399
  *
@@ -257,9 +429,14 @@ export const UserNotificationDefinition_FrontEndSuccessSchema = UserNotification
257
429
  * of `CoreUserNotificationChannel`, and the resource factory parses every declared notification against this schema
258
430
  * (`processUserNotifications`), so an unknown one is refused when the configuration is built. A new channel is
259
431
  * added by giving it a member here AND a delivery arm in the dispatcher, never by naming it.
432
+ *
433
+ * DISCRIMINATED on `channel` (#1875), so a declaration that names a known channel is checked against that channel's
434
+ * variant alone and its refusal names the field at fault ("text.params…: An SMS text parameter name is…"). A plain
435
+ * union reported every variant's failure at once as one path-less "Invalid input".
260
436
  */
261
- export const UserNotificationDefinitionSchema = z.union([
437
+ export const UserNotificationDefinitionSchema = z.discriminatedUnion('channel', [
262
438
  UserNotificationDefinition_EmailSchema,
439
+ UserNotificationDefinition_SmsSchema,
263
440
  UserNotificationDefinition_WebSocketSchema,
264
441
  UserNotificationDefinition_FrontEndSuccessSchema,
265
442
  ])
@@ -275,6 +452,7 @@ export const UserNotificationDefinitionSchema = z.union([
275
452
  * - `USERS_CUSTOM` without a `userIdsSelector` resolves nobody.
276
453
  * - `INBOUND_CONTACT` on EMAIL resolves nobody by target: the contact is not a user, and is reached only
277
454
  * through `recipientEmailField`.
455
+ * - `INBOUND_CONTACT` on SMS resolves nobody at all: an SMS needs a user's verified phone and consent (#1875).
278
456
  *
279
457
  * The resource factory parses every declaration against this schema, so each is refused when the
280
458
  * configuration is built rather than discovered as an email nobody received.
@@ -332,6 +510,14 @@ export const UserNotificationDefinitionSchema = z.union([
332
510
  + 'not a user of the application. Name the field holding their address in recipientEmailField.',
333
511
  });
334
512
  }
513
+ if (notification.target === CoreUserNotificationTarget.INBOUND_CONTACT && notification.channel === CoreUserNotificationChannel.SMS) {
514
+ context.addIssue({
515
+ code: 'custom',
516
+ path: ['target'],
517
+ message: `An SMS to the "${CoreUserNotificationTarget.INBOUND_CONTACT}" target reaches nobody: an SMS goes only to a user's `
518
+ + 'verified phone with their consent, and the contact is not a user of the application (#1875).',
519
+ });
520
+ }
335
521
  });
336
522
  export type UserNotificationDefinition = z.infer<typeof UserNotificationDefinitionSchema>;
337
523
  ```
@@ -49,7 +49,8 @@
49
49
  * write never moves a row to a client the caller does not serve. A principal with no user (an API key, an OAuth client)
50
50
  * is assigned nothing, so a declared role reaches no row for it.
51
51
  *
52
- * A resource declares assigned rows, own rows or unit narrowing, never two of them together.
52
+ * A resource that declares assigned rows declares no other confinement. (Own rows and unit narrowing compose with each
53
+ * other: a department head reaches their department's rows and their own.)
53
54
  */
54
55
  export type OrganizationAssignedRowsDeclaration = {
55
56
  /** The resource whose rows assign a user to a row of this resource. */
@@ -26,7 +26,10 @@
26
26
  * field of the resource's main schema, declared as a foreign key: it becomes a query predicate on every read and a
27
27
  * write-time check on every create and update.
28
28
  * - `roles` are the roles whose ORGANIZATION-WIDE grant reaches only the holder's own rows on this resource, typically
29
- * the default member role. A role not listed keeps its organization depth: an organization-wide manager or finance
29
+ * the default member role. Held on a UNIT, a declared role supplies no unit and no own rows of its own (#3068): a
30
+ * directory that places every employee in their department with the member role therefore does not open the
31
+ * department's rows to them, and the department is reached through a role that is not listed (the department head's
32
+ * manager role on the unit). A role not listed keeps the depth of its grant: an organization-wide manager or finance
30
33
  * role still reaches every row. A role is judged as HELD: a manager whose role inherits the member role is not
31
34
  * confined, because what they hold is the manager role.
32
35
  *
@@ -42,7 +45,7 @@
42
45
  export type OrganizationOwnRowsDeclaration = {
43
46
  /** The field on the resource holding the owning user's id. */
44
47
  readonly ownerUserIdField: string;
45
- /** The roles whose organization-wide grant reaches only the holder's own rows on this resource. */
48
+ /** The roles whose organization-wide grant reaches only the holder's own rows on this resource, and which supply no unit. */
46
49
  readonly roles: readonly string[];
47
50
  };
48
51
  ```