@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
@@ -27,8 +27,10 @@ in `call`:
27
27
 
28
28
  | you want | `target` | `call` |
29
29
  |---|---|---|
30
- | an Odoo recordset method (`action_post`, `action_confirm`) | `record` | `{ shape: 'odoo-execute-kw', method, inputPlacement }` |
31
- | an Odoo model method (`create`) | `none` | `{ shape: 'odoo-execute-kw', method, model?, inputPlacement }` |
30
+ | an Odoo recordset method (`action_post`, `action_confirm`), JSON-RPC instance | `record` | `{ shape: 'odoo-execute-kw', method, inputPlacement }` |
31
+ | an Odoo model method (`create`), JSON-RPC instance | `none` | `{ shape: 'odoo-execute-kw', method, model?, inputPlacement }` |
32
+ | an Odoo recordset method, JSON-2 instance | `record` | `{ shape: 'odoo-json2-method', method, inputPlacement }` |
33
+ | an Odoo model method, JSON-2 instance | `none` | `{ shape: 'odoo-json2-method', method, model?, inputPlacement, inputParameter? }` |
32
34
  | an OData bound action | `record` | `{ shape: 'odata-bound-action', qualifiedName: 'Namespace.Action' }` |
33
35
  | an OData unbound action import | `none` | `{ shape: 'odata-unbound-action', actionImport }` |
34
36
 
@@ -39,9 +41,13 @@ the binding of the model it is called on.
39
41
  Each declaration also carries:
40
42
 
41
43
  - `input` — a Zod OBJECT schema. It is parsed STRICTLY: a key it does not name is refused, never
42
- forwarded to the vendor. For Odoo, `inputPlacement` says where it goes — `keyword-arguments` (the
43
- default), `positional` (`create(vals)`), or `none` (the method takes only its records; the input must
44
- then be `z.object({})`).
44
+ forwarded to the vendor. For Odoo, `inputPlacement` says where it goes. On `odoo-execute-kw`:
45
+ `keyword-arguments` (the default), `positional` (`create(vals)`), or `none` (the method takes only its
46
+ records; the input must then be `z.object({})`). On `odoo-json2-method`, where every argument is NAMED:
47
+ `named-parameters` (the default; each input member is one of the method's parameters),
48
+ `single-parameter` with `inputParameter` (the whole input is one parameter — for `create`,
49
+ `inputParameter: 'vals_list'`), or `none`. A JSON-2 input may not name `ids` or `context`: those are the
50
+ request's own members, and the engine fills `ids` from the target record.
45
51
  - `output` (optional) — a Zod schema the vendor's answer is parsed through before you receive it.
46
52
  - `writes` — whether it changes remote state. A writing action REQUIRES an Idempotency-Key from every
47
53
  caller, and an interrupted attempt is an unknown outcome rather than a failure.
@@ -87,8 +93,27 @@ export enum SystemOfRecordActionCallShape {
87
93
  * argument, which is how Odoo addresses a recordset method such as `action_post`.
88
94
  *
89
95
  * spec-cite: Odoo 18.0 developer documentation, External API — "Calling methods" (the execute_kw argument layout).
96
+ *
97
+ * Spoken over `ODOO_JSONRPC` only: `execute_kw` is a function of the `object` service at `/jsonrpc`, which Odoo removes
98
+ * at Online 21.1 and Odoo 22. An instance on JSON-2 declares {@link ODOO_JSON2_METHOD} instead (#3391).
90
99
  */
91
100
  ODOO_EXECUTE_KW = 'odoo-execute-kw',
101
+ /**
102
+ * Odoo's External JSON-2 API (#3391): `POST /json/2/<model>/<method>` with a body of NAMED parameters — any public
103
+ * model method, the same as `execute_kw`, with the credential in an `Authorization: bearer` header. A record-targeted
104
+ * call names the record ids in the body's `ids` member, which is how JSON-2 addresses a recordset method such as
105
+ * `action_post`.
106
+ *
107
+ * A shape of its own rather than `ODOO_EXECUTE_KW` reused, because the two place an input differently and only one of
108
+ * them can say where: JSON-2 has no positional arguments, so an input that `execute_kw` passed by POSITION (`create`'s
109
+ * `vals`) must be given the parameter's NAME (`vals_list`), and `execute_kw` has no such field to carry it.
110
+ *
111
+ * spec-cite: Odoo 19.0 developer documentation, External JSON-2 API
112
+ * (https://www.odoo.com/documentation/19.0/developer/reference/external_api.html), "Request" — the body members `ids`
113
+ * ("An array of record ids on which to execute the method. Empty or omitted when calling an @api.model-decorated
114
+ * method."), `context`, and `param` ("As many time as needed, the method's parameters.").
115
+ */
116
+ ODOO_JSON2_METHOD = 'odoo-json2-method',
92
117
  /**
93
118
  * An OData v4 BOUND action: `POST <EntitySet>(<key>)/<Namespace>.<Action>`, parameters in the JSON body.
94
119
  *
@@ -109,6 +134,7 @@ export enum SystemOfRecordActionCallShape {
109
134
  */
110
135
  export const SYSTEM_OF_RECORD_ACTION_CALL_SHAPE_DIALECT: Readonly<Record<SystemOfRecordActionCallShape, HttpApiTransportDialect>> = Object.freeze({
111
136
  [SystemOfRecordActionCallShape.ODOO_EXECUTE_KW]: HttpApiTransportDialect.ODOO_JSONRPC,
137
+ [SystemOfRecordActionCallShape.ODOO_JSON2_METHOD]: HttpApiTransportDialect.ODOO_JSON2,
112
138
  [SystemOfRecordActionCallShape.ODATA_BOUND_ACTION]: HttpApiTransportDialect.ODATA,
113
139
  [SystemOfRecordActionCallShape.ODATA_UNBOUND_ACTION]: HttpApiTransportDialect.ODATA,
114
140
  });
@@ -138,6 +164,36 @@ export enum SystemOfRecordOdooActionInputPlacement {
138
164
  NONE = 'none',
139
165
  }
140
166
 
167
+ /**
168
+ * Where an Odoo JSON-2 action's validated input goes in the request body (#3391). The counterpart of
169
+ * {@link SystemOfRecordOdooActionInputPlacement}, with POSITIONAL replaced by a NAMED parameter: JSON-2 binds every body
170
+ * member to the method's signature by name and has no positional form.
171
+ *
172
+ * spec-cite: Odoo 19.0 developer documentation, External JSON-2 API, "Migrating from XML-RPC / JSON-RPC" — "All the
173
+ * arguments are named; there is no way in JSON-2 to call a function with positional arguments."
174
+ */
175
+ export enum SystemOfRecordOdooJson2ActionInputPlacement {
176
+ /**
177
+ * Each member of the input object is one of the method's named parameters. The default, and the counterpart of
178
+ * `KEYWORD_ARGUMENTS`: a recordset method's options are its parameters.
179
+ */
180
+ NAMED_PARAMETERS = 'named-parameters',
181
+ /**
182
+ * The whole input object is the value of ONE named parameter, `inputParameter`: the body is
183
+ * `{ "<inputParameter>": <input> }`. The counterpart of `POSITIONAL`, and `create` is the canonical case: its signature
184
+ * is `create(self, vals_list)`, and Odoo's `model_create_multi` accepts one mapping there and treats it as a list of
185
+ * one, so `{ "vals_list": { …values… } }` creates one record. JSON-2 answers a created recordset as its ids, so that
186
+ * call answers `[<id>]`, a list, where `execute_kw('create', [vals])` answered the bare id.
187
+ *
188
+ * spec-cite: Odoo 19.0 source, `odoo/orm/decorators.py` `model_create_multi` ("if isinstance(vals_list, Mapping):
189
+ * vals_list = [vals_list]") and `addons/rpc/controllers/json2.py` `web_json_2_rpc` ("if isinstance(result, BaseModel):
190
+ * result = result.ids") — https://github.com/odoo/odoo/tree/19.0.
191
+ */
192
+ SINGLE_PARAMETER = 'single-parameter',
193
+ /** The method takes nothing beyond its records (`action_post`, `button_confirm`). The declared input must then be empty. */
194
+ NONE = 'none',
195
+ }
196
+
141
197
  /**
142
198
  * How a RECORD-FREE action relates to the instance's partitions (#1058), required at boot when the instance is
143
199
  * partitioned. A record-targeted action needs none: the record it reads first carries its partition.
@@ -166,7 +222,8 @@ export const SystemOfRecordActionPartitionStanceSchema = z.discriminatedUnion('k
166
222
  kind: z.literal(SystemOfRecordActionPartitionStanceKind.MEMBER_UNIT_PARTITION),
167
223
  /**
168
224
  * The REMOTE parameter the placed partition value is written into (`company_id`): a key of the Odoo keyword
169
- * arguments or of the positional input object, or a member of the OData body. The caller's input may not carry it.
225
+ * arguments or of the positional input object (`execute_kw`), a named parameter or a member of the single-parameter
226
+ * object (JSON-2), or a member of the OData body. The caller's input may not carry it.
170
227
  */
171
228
  parameter: z.string().min(1).max(120),
172
229
  }),
@@ -186,6 +243,19 @@ export const SystemOfRecordActionCallSchema = z.discriminatedUnion('shape', [
186
243
  model: z.string().regex(/^[a-z_][a-z0-9_.]*$/, 'An Odoo model name is dotted snake_case.').max(120).optional(),
187
244
  inputPlacement: z.enum(SystemOfRecordOdooActionInputPlacement).default(SystemOfRecordOdooActionInputPlacement.KEYWORD_ARGUMENTS),
188
245
  }),
246
+ z.strictObject({
247
+ shape: z.literal(SystemOfRecordActionCallShape.ODOO_JSON2_METHOD),
248
+ /** The model method, in Odoo's own spelling (`action_post`, `create`) — the last segment of `/json/2/<model>/<method>`. */
249
+ method: z.string().regex(/^[a-z_][a-z0-9_]*$/, 'An Odoo method name is snake_case.').max(120),
250
+ /** As for `ODOO_EXECUTE_KW`: for a RECORD-FREE action only; absent means the binding's `entityRef`. */
251
+ model: z.string().regex(/^[a-z_][a-z0-9_.]*$/, 'An Odoo model name is dotted snake_case.').max(120).optional(),
252
+ inputPlacement: z.enum(SystemOfRecordOdooJson2ActionInputPlacement).default(SystemOfRecordOdooJson2ActionInputPlacement.NAMED_PARAMETERS),
253
+ /**
254
+ * The method parameter the whole input becomes, for `SINGLE_PARAMETER` only (`vals_list` for `create`). Required with
255
+ * that placement and refused with any other, so a declaration cannot name a parameter nothing is sent in.
256
+ */
257
+ inputParameter: z.string().regex(/^[a-z_][a-z0-9_]*$/, 'An Odoo parameter name is snake_case.').max(120).optional(),
258
+ }),
189
259
  z.strictObject({
190
260
  shape: z.literal(SystemOfRecordActionCallShape.ODATA_BOUND_ACTION),
191
261
  /** The namespace-qualified action name (`Microsoft.Dynamics.CRM.WinOpportunity`). */
@@ -119,6 +119,14 @@ redeemed by a command when the agent's host can run one, and otherwise by the pe
119
119
  grant's `uploadPageUrl` (a public drop page the engine ships — the fallback, not the design). See
120
120
  `references/framework-file-upload-grant-contract.md`.
121
121
 
122
+ **Retries need nothing extra either, on an operation that declares `idempotencyKey`.** An agent calls a
123
+ tool again when a call fails, and a create that committed before the error then creates a second row.
124
+ On a variant declaring `idempotencyKey` (see `resource-config-wiring`, its idempotency-key reference) the
125
+ engine advertises an `idempotencyKey` argument — required for `REQUIRED`, optional for `ACCEPTED` — and
126
+ tells the agent to send a new value per change and the same value when it retries one; the repeat is
127
+ answered with the first result. Do not add such a field to the request DTO yourself: the application
128
+ refuses to start when a field of that name would collide with the argument.
129
+
122
130
  ### Step 3b (OPTIONAL): Split the catalog across NAMED servers
123
131
  One `/mcp` serves ONE flat tool list, so when different consumers need different capability
124
132
  postures — a read-only support surface vs a destructive operations one — declare **named servers**
@@ -84,13 +84,14 @@ with unknown arm outcomes when reliable reports were not returned. This is not a
84
84
  interpreting missing context as missing source data. The framework owns these indexes; do not
85
85
  create a separate application chunk store or re-indexing job.
86
86
 
87
- **A cross-adapter resource is a separate architectural choice, not a RAG prerequisite.** If you
88
- intentionally choose a different adapter, pair `persistenceAdapter` with
89
- `persistenceAdapterIsolation: ResourcePersistenceAdapterIsolation.NO_CROSS_ADAPTER_TRANSACTION`.
90
- This declares that the resource will not join a cross-adapter atomic write. Do not add the claim
91
- merely to silence validation: native transactions cannot span PostgreSQL and MongoDB, and a
92
- later cross-adapter unit of work still refuses. A corpus on the application's default supported
93
- adapter needs neither a resource override nor that isolation exception.
87
+ **A corpus lives on the application's one database.** An application uses exactly one
88
+ transactional store, MongoDB or PostgreSQL, and both serve retrieval (MongoDB through `mongot`,
89
+ PostgreSQL through pgvector). So never move a corpus resource to the other store: startup refuses a
90
+ resource whose `persistenceAdapter` is a transactional store other than the application default,
91
+ and no declaration admits it. If the deployment you have cannot search (a MongoDB without
92
+ `mongot`), fix the deployment, or move the whole application's `applicationDatabase`, not one
93
+ resource. A corpus built from uploaded documents keeps its file records on that same store, so a
94
+ row and its files commit and roll back together.
94
95
 
95
96
  ### Step 2: Decide which fields belong in the corpus
96
97
 
@@ -357,7 +358,7 @@ Run from the app root.
357
358
  | Enumerate every corpus declaration in the application | `rg -n -e "\.ragSource\(" -e "ragSource:" shared-lib/src` |
358
359
  | No corpus source shares a field with a refused companion | `rg -n -e "ragSource" -e "isPassword" -e "isOtp" -e "isWriteOnlySecret" -e "isEphemeral" -e "ttl" shared-lib/src` — inspect the declarations together, including multiline schemas; a corpus resource with a TTL policy is also refused even on another field |
359
360
  | Every corpus resource uses a supported stored adapter | `rg -l -e "\.ragSource\(" -e "ragSource:" shared-lib/src` then `rg -n "persistenceAdapter" shared-lib/src/modules/*/resources/*/*.resources-config.ts` — resolve each named resource against its override or application database default; PostgreSQL and MongoDB are supported |
360
- | An intentional stored-corpus adapter override carries its isolation claim | `rg -n -e "persistenceAdapter:" -e "persistenceAdapterIsolation:" shared-lib/src` — check the deliberately overridden PostgreSQL/MongoDB corpus resources identified above; do not add isolation to HTTP_API resources, which forbid it |
361
+ | No corpus resource sits on a second store | `rg -n -e "PersistenceAdapter.MONGODB" -e "PersistenceAdapter.POSTGRESQL" shared-lib/src` — each hit must name the application's own database; startup refuses any other, and no declaration admits it |
361
362
  | Every authored overlap is smaller than its size | `rg -n -A1 "chunkSize:" shared-lib/src` — read each pair |
362
363
  | Embeddings are configured or deliberately omitted | `rg -n "AI_EMBEDDINGS" wildo.saas.config.ts` — when semantic retrieval is required, expect the capability block, provider and selection; otherwise record lexical-only operation |
363
364
  | No field opts into OCR without the capability behind it | `rg -n "ocr:\s*true" shared-lib/src` then `rg -n "AI_DOCUMENT_EXTRACTION" wildo.saas.config.ts` — a hit in the first with none in the second is a field paying nothing and getting nothing |
@@ -383,7 +384,7 @@ Run from the app root.
383
384
  | "Nothing is retrievable until I configure an embeddings provider" | Once ingestion and search-index readiness complete, text is searchable lexically. A missing provider defers the semantic half of retrieval and nothing else — the corpus is still built, still erased with its rows, and still drains into vectors after a provider appears and processing/index readiness complete. |
384
385
  | "I edited the field, so I should trigger a re-index" | The write already did. Old chunks are removed immediately — edited-away text must not keep answering questions — and the new text is re-derived after the write commits. |
385
386
  | "The framework refuses secrets, so it will catch whatever I miss" | The five refusals are a floor, not a review. The framework cannot know that a free-text field happens to collect card numbers. The field-by-field question is still yours to ask. |
386
- | "MongoDB needs a PostgreSQL exception for RAG" | Both stored adapters are supported. Check mongot and search-index readiness for MongoDB; reserve an adapter override and isolation claim for an intentional architecture decision. HTTP_API and INTROSPECTION cannot host a corpus. |
387
+ | "MongoDB needs a PostgreSQL exception for RAG" | Both stored adapters are supported, and an application uses one of them: there is no per-resource exception to the other. Check mongot and search-index readiness for MongoDB. HTTP_API and INTROSPECTION cannot host a corpus. |
387
388
  | "I should filter the results so users only see their own rows" | Already done, three times over — before the search (the caller's roles), inside the query (the caller's tenancy, as a pre-filter), and after matching (each row re-read on the caller's authority). A filter you add on top can only remove rows the framework already admitted, which hides a defect instead of reporting one. |
388
389
  | "Retrieval returned too little, so I will pass a system or elevated context" | That is a privilege escalation wearing a workaround's clothes: it makes one caller's query read another tenant's corpus. A short result is either the caller's roles, the resource's scope declaration, or a reported drop count — all three are visible, and all three are the thing to fix. |
389
390
  | "I will only use results scoring above 0.5" | The fused score orders passages *within one query*. It is not a probability and not comparable across queries, so a fixed cutoff keeps everything on one query and nothing on the next. Rank and take the top N. |
@@ -395,6 +396,8 @@ Run from the app root.
395
396
 
396
397
  - A declaration was authored before the resource's persistence adapter was checked — catch with the
397
398
  **Every corpus resource uses a supported stored adapter** grep
399
+ - A corpus resource was moved to the other database instead of fixing the deployment — catch with the
400
+ **No corpus resource sits on a second store** grep
398
401
  - A field holding ids, enum values, statuses or timestamps carries a declaration — catch with the
399
402
  **Enumerate every corpus declaration** grep and read each hit
400
403
  - A declaration sits on a field that also declares a secret, one-time code, ephemeral value or TTL
@@ -88,6 +88,16 @@ export enum EngineCapability {
88
88
  */
89
89
  EMAIL_INBOUND = 'EMAIL_INBOUND',
90
90
  SMS = 'SMS',
91
+ /**
92
+ * A deliverable signed by its signers' own electronic signatures, applied by a trust-service vendor (#2293): level 2 of
93
+ * epic #2916, opt-in per deliverable. Level 1 (the operator's seal over a decision, `KEY_MANAGEMENT`) needs no vendor.
94
+ *
95
+ * Its own slot: which vendor applies a client's signature is a legal and procurement decision (its levels, its
96
+ * environments, where it keeps the signed documents) that no other provider choice should make. Enabling it declares
97
+ * that deliverables are sent for signature, so an enabled slot with no provider refuses to start
98
+ * (`ENGINE_CAPABILITIES_REQUIRING_A_PROVIDER_WHEN_ENABLED`).
99
+ */
100
+ ELECTRONIC_SIGNATURE = 'ELECTRONIC_SIGNATURE',
91
101
 
92
102
  AI_LLM = 'AI_LLM',
93
103
  AI_IMAGE_GENERATION = 'AI_IMAGE_GENERATION',
@@ -205,8 +215,7 @@ export enum EngineCapability {
205
215
  * `BUILTIN_PROVIDER_CAPABILITY.BILLING` and fills `EngineCapability.BILLING`, which is the slot
206
216
  * applications enable and `getProvidersForEngineCapability` gates on. Payment EXECUTION is served
207
217
  * through that same provider's `BILLING_PROVIDER` protocol; splitting it into a second engine slot
208
- * was a plan-era intention (`provider-registry-materialization-workflow.md`) that the shipped
209
- * model settled the other way. So the withdrawal removes a name, not a capability.
218
+ * was an early plan that the shipped model settled the other way. So the withdrawal removes a name, not a capability.
210
219
  *
211
220
  * The reason a reserved slot is worse than no slot is `EngineCapabilityResolutionMode`: every
212
221
  * member must be classified, `BILLING_PAYMENTS` was classified `SELECT_ONE`, and `SELECT_ONE`
@@ -174,6 +174,32 @@ Do not require vectors before using a healthy lexical corpus. Equally, do not pr
174
174
  ingestion or an unavailable search index as an empty knowledge base. Keep deployment readiness,
175
175
  source derivation and optional vector enrichment distinct when reporting availability.
176
176
 
177
+ ## Lexical matching follows the application's primary language
178
+
179
+ The lexical arm analyses chunk text and the question in the language the application declares as
180
+ primary (`appPreferences.languages.defaultLanguage` in `./backend-api/src/saas-config.backend.ts`;
181
+ English when none is declared). That language's stopwords are dropped and its words are stemmed, so
182
+ a question matches by its content words ("stalls" meets "stalled"), and a passage that shares only
183
+ common words with the question loses its advantage over the one that answers it. Ranking also favours
184
+ a short passage about the terms over a long one that mentions them in passing.
185
+
186
+ PostgreSQL and MongoDB analyse the same language but do not rank identically, so do not assert one
187
+ order for both. Each engine ships its own stopword list and PostgreSQL's is wider: for English, "what"
188
+ and "who" are dropped on PostgreSQL and kept on MongoDB, where a passage sharing only those can still
189
+ be returned, and can lead when nothing in the corpus answers better. A question made only of words on
190
+ the engine's list matches nothing.
191
+
192
+ - Nothing to configure: the language is derived, and there is no separate retrieval-language setting.
193
+ - Changing the primary language makes the store build a lexical index for the new language. On
194
+ MongoDB the lexical arm reports itself unavailable until that index is built.
195
+ - All text is analysed in that one language. Content or a question in another enabled language is
196
+ still matched, but with the primary language's rules, so its stopwords stay in and its words are
197
+ not stemmed properly.
198
+ - Some languages have no analyzer both databases share (for example Chinese, Japanese, Korean,
199
+ Polish, Czech). For those, text is tokenised and lowercased but no stopwords are dropped and
200
+ nothing is stemmed, so plan queries and evaluation accordingly.
201
+ - Vector search is unaffected by any of this: it is the arm that answers across languages.
202
+
177
203
  ## What comes back
178
204
 
179
205
  ## Import Origins
@@ -574,8 +600,9 @@ export enum RagRetrievalRefusalReason {
574
600
  OPERATION_ROLES_DENIED = 'operation-roles-denied',
575
601
  /**
576
602
  * The READ authorization context for this resource could not be BUILT, so its role gate could not
577
- * be evaluated at all: the resource exposes no resolvable READ operation, or the sub-call budget
578
- * (depth / cycle detection) refused the context.
603
+ * be evaluated at all: the resource exposes no resolvable READ operation, the sub-call budget
604
+ * (depth / cycle detection) refused the context, or the store could not answer the reads that
605
+ * decide the resource's row confinement for the caller (#3066).
579
606
  *
580
607
  * Deliberately NOT folded into {@link OPERATION_ROLES_DENIED}. That one is an answer; this one is
581
608
  * the absence of a question, and reporting an unbuildable context as a role refusal would send an
@@ -129,26 +129,6 @@ export function getRagSourceConfig(schema: z.ZodTypeAny): RagSourceConfiguration
129
129
 
130
130
  ### Origin Package: `@wildo-ai/zod-decorators`
131
131
 
132
- ```typescript
133
- *
134
- * `.ragSource(config?)` — declare this field's text a source of the application's retrieval
135
- * corpus. Live on every string-backed schema (`z.string()` and every string FORMAT such as
136
- * `z.email()` / `z.url()`) and carried across the `.optional()` / `.nullable()` / `.default()`
137
- * wrappers, so it composes anywhere in a decorator chain.
138
- *
139
- * The config is OPTIONAL and there is no `enabled` flag: a bare `.ragSource()` is a complete
140
- * declaration that accepts the framework chunking defaults. Presence IS enablement.
141
- *
142
- * @example
143
- * z.string().ragSource()
144
- * @example
145
- * z.string().ragSource({ chunkingStrategy: RAGChunkingStrategy.MARKDOWN, chunkSize: 1200, chunkOverlap: 150 }).optional()
146
- */
147
- [ZodDecorator.RAG_SOURCE](config?: RagSourceConfiguration): DecoratedPrimitiveZodType<T>;
148
- ```
149
-
150
- ### Origin Package: `@wildo-ai/zod-decorators`
151
-
152
132
  ```typescript
153
133
  *
154
134
  * Standalone form of `.ragSource(config?)` — declare a field's text a RAG retrieval-corpus source.
@@ -183,3 +163,23 @@ export function addRagSource<T extends z.ZodTypeAny>(
183
163
  ]);
184
164
  }
185
165
  ```
166
+
167
+ ### Origin Package: `@wildo-ai/zod-decorators`
168
+
169
+ ```typescript
170
+ *
171
+ * `.ragSource(config?)` — declare this field's text a source of the application's retrieval
172
+ * corpus. Live on every string-backed schema (`z.string()` and every string FORMAT such as
173
+ * `z.email()` / `z.url()`) and carried across the `.optional()` / `.nullable()` / `.default()`
174
+ * wrappers, so it composes anywhere in a decorator chain.
175
+ *
176
+ * The config is OPTIONAL and there is no `enabled` flag: a bare `.ragSource()` is a complete
177
+ * declaration that accepts the framework chunking defaults. Presence IS enablement.
178
+ *
179
+ * @example
180
+ * z.string().ragSource()
181
+ * @example
182
+ * z.string().ragSource({ chunkingStrategy: RAGChunkingStrategy.MARKDOWN, chunkSize: 1200, chunkOverlap: 150 }).optional()
183
+ */
184
+ [ZodDecorator.RAG_SOURCE](config?: RagSourceConfiguration): DecoratedPrimitiveZodType<this>;
185
+ ```
@@ -32,7 +32,9 @@ says how long a row lives at all. A row an erasure retained is still deleted whe
32
32
  A statutory class RESTRICTS, it does not refuse. A resource bound to `BUSINESS_RECORDS` also declares
33
33
  `retentionPolicy.statutoryRetention` — the legal ground. A subject erasure then completes every other part
34
34
  of the request, keeps each of these rows RESTRICTED (retained, hidden from ordinary reads, frozen) until its
35
- statutory period ends, and lists each one in its report with the ground and the date it may go.
35
+ statutory period ends, and lists each one in its report with the ground and the date it may go. A record that cannot
36
+ be frozen because work still arrives for it after its owner goes declares `staysInUseBecause` with the reason, keeps
37
+ its edges disabled or refusing, and is left as it is. That is rare: billing is the case.
36
38
 
37
39
  ## App Paths
38
40
 
@@ -95,6 +97,20 @@ statutory period ends, and lists each one in its report with the ground and the
95
97
  migration (`wildo db generate`) when a field was added or `SCOPE_DELETED` injected `retentionStartedAt`.
96
98
  8. **Stop** when startup logs the resource as bound with no warning and `wildo db diff --check` is clean.
97
99
 
100
+ ## When a resource has no period
101
+
102
+ There is no default class, and a resource with no binding has no clock. That is normal when something else ends the row,
103
+ so do not bind a resource just to fill a gap. The framework works out what ends each resource's rows
104
+ (`ResourceRowLifetime`), and at startup it warns only about an application resource reading `UNDECIDED`: one that may
105
+ hold personal data and that nothing ever deletes.
106
+
107
+ - A resource under an owner whose deletion deletes it already has its answer: it ends with the tenant or the account.
108
+ - For a warned resource, bind a class, or give it a mandatory parent with a delete `onParentDelete`.
109
+ - `SCOPE_DELETED` counts from the row's owner going: the tenant purge for a row with `organizationId`, the person's erasure for a row with `userId` and no organization.
110
+ - Declare `rowLifetime: { lifetime, rationale }` only for a real mechanism no configuration can show, such as a batch you
111
+ wrote that deletes the rows. The declaration is a claim nothing checks, so never use it to quiet the warning. It may
112
+ not sit beside a binding, a `.ttl()` or a read-through resource.
113
+
98
114
  ## When the schedule must stop: legal holds
99
115
 
100
116
  A litigation, a claim, an investigation or a legal obligation can require data to be kept PAST its period.
@@ -182,7 +198,7 @@ Grep invariants: `rg -n "retentionBinding" shared-lib/src` lists every bound res
182
198
  - A closure field a client-routed create or update can write (the resource factory refuses it: a caller could backdate it into a delete).
183
199
  - A handler that spreads the caller's input straight through with the closure field in it (catch it with a unit test that a forged value never reaches the write).
184
200
  - A statutory record bound `SCOPE_DELETED` whose teardown edge deletes it (startup refuses it).
185
- - An owned edge into a statutory resource that is silent, disabled, `DELETE` or `REFUSE_WHILE_CHILDREN_EXIST` (startup refuses it; catch it with `rg -n "onParentDelete" shared-lib/src` on the edges naming the resource).
201
+ - An owned edge into a statutory resource that is silent, disabled, `DELETE` or `REFUSE_WHILE_CHILDREN_EXIST`, with no `staysInUseBecause` (startup refuses it, and refuses a silent or `DELETE` edge either way; catch it with `rg -n "onParentDelete" shared-lib/src` on the edges naming the resource).
186
202
  - A `BUSINESS_RECORDS` binding without `retentionPolicy.statutoryRetention` (the resource factory refuses it; catch it with the `rg -n "BUSINESS_RECORDS" shared-lib/src` grep beside `rg -n "statutoryRetention" shared-lib/src`).
187
203
 
188
204
  ## Related Skills
@@ -249,14 +249,58 @@ async function readTenantsMarkedForDeletion(utils: any, holds: readonly unknown[
249
249
  });
250
250
  }
251
251
 
252
+ /**
253
+ * How many ACTIVE holds each organization carries, in order (#1846): one read of the active holds of every distinct
254
+ * organization, so an operator's directory page of N tenants costs one query, not N.
255
+ *
256
+ * Every scope kind counts, because the question it answers is the organization purge's: a tenant is held while ANY of
257
+ * its holds is active, whether it holds the tenant, some of its rows or one of its people. Only the count leaves this
258
+ * function: never a hold's scope, ground, subject or matter text.
259
+ *
260
+ * `undefined` for an organization whose id is missing, and for EVERY organization when the holds cannot be read:
261
+ * unknown, never zero. A zero would tell an operator in an incident that a tenant is free to purge.
262
+ *
263
+ * Reads raw, below the operation tier, as every cross-resource virtual field does: the caller has already been
264
+ * admitted to the organization rows it hands in. Active holds are never retained rows (a hold's retention clock starts
265
+ * at `releasedAt`), so the status filter alone keeps the retention hide's population out.
266
+ */
267
+ export async function readActiveLegalHoldCountsOfOrganizations(utils: any, organizations: readonly unknown[]): Promise<Array<number | undefined>> {
268
+ const idOf = (organization: unknown): string | undefined => {
269
+ const id = (organization as Record<string, unknown> | undefined)?.['_id'];
270
+ return id === undefined || id === null || String(id).length === 0 ? undefined : String(id);
271
+ };
272
+ const organizationIds = [...new Set(organizations.map(idOf).filter((id): id is string => id !== undefined))];
273
+ if (organizationIds.length === 0) return organizations.map(() => undefined);
274
+ const holdsRepository = utils?.repositories?.getRepository?.(CoreResourceType.LEGAL_HOLDS);
275
+ if (!holdsRepository || typeof holdsRepository.findManyByRawFilter !== 'function') return organizations.map(() => undefined);
276
+ const counts = new Map<string, number>(organizationIds.map((id) => [id, 0]));
277
+ try {
278
+ const holds: Array<Record<string, unknown>> = await holdsRepository.findManyByRawFilter({
279
+ status: LegalHoldStatus.ACTIVE,
280
+ organizationId: { $in: organizationIds },
281
+ });
282
+ for (const hold of holds) {
283
+ const organizationId = hold['organizationId'] === undefined || hold['organizationId'] === null ? undefined : String(hold['organizationId']);
284
+ if (organizationId !== undefined && counts.has(organizationId)) counts.set(organizationId, counts.get(organizationId)! + 1);
285
+ }
286
+ } catch (error) {
287
+ utils?.logger?.warn?.(`[organizations.activeLegalHoldCount] the active holds of ${organizationIds.length} organization(s) could not be read; reporting unknown`, error);
288
+ return organizations.map(() => undefined);
289
+ }
290
+ return organizations.map((organization) => {
291
+ const id = idOf(organization);
292
+ return id === undefined ? undefined : counts.get(id);
293
+ });
294
+ }
295
+
252
296
  /** The `place` request. Coherence between `scopeKind` and the three optional selectors is checked server-side. */
253
297
  export const LegalHoldPlaceRequestSchema = z.object({
254
- scopeKind: z.enum(LegalHoldScopeKind).describe('What the hold covers: the whole organization, rows of one resource, or one person\'s data.'),
298
+ scopeKind: z.enum(LegalHoldScopeKind).systemEnum('LegalHoldScopeKind').describe('What the hold covers: the whole organization, rows of one resource, or one person\'s data.'),
255
299
  resourceType: z.string().min(1).max(200).optional().describe('For a resource-rows hold: the resource type whose rows are held.'),
256
300
  rowIds: z.array(z.string().min(1)).min(1).max(LEGAL_HOLD_MAXIMUM_ROW_IDS).optional()
257
301
  .describe('For a resource-rows hold: the rows held. Omit to hold every row of the resource type in the organization.'),
258
302
  subjectUserId: z.string().min(1).optional().describe('For a data-subject hold: the user whose data is held.'),
259
- legalGround: z.enum(LegalHoldGround).describe('Why the data must be preserved.'),
303
+ legalGround: z.enum(LegalHoldGround).systemEnum('LegalHoldGround').describe('Why the data must be preserved.'),
260
304
  justification: z.string().min(1).max(2000).describe('The matter or case the hold preserves data for.'),
261
305
  });
262
306
  export type LegalHoldPlaceRequest = z.infer<typeof LegalHoldPlaceRequestSchema>;
@@ -37,7 +37,7 @@ Read this when:
37
37
  * | {@link LAST_UPDATED} | the most recent update | `updatedAt` — infrastructure-owned on both adapters |
38
38
  * | {@link CLOSURE_EVENT} | the moment the declared closure date field is set | that field; null never expires |
39
39
  * | {@link END_OF_CALENDAR_YEAR} | 31 December 23:59:59.999 UTC of the creation year | `createdAt` |
40
- * | {@link SCOPE_DELETED} | the row's organization was marked for deletion | `retentionStartedAt`, stamped by the tenant purge |
40
+ * | {@link SCOPE_DELETED} | the row's owner went: its organization was marked for deletion, or its person was erased or deleted | `retentionStartedAt`, stamped by the tenant purge, the erasure or the sweep |
41
41
  *
42
42
  * Rejected: persisting a `retentionStartedAt` on EVERY bound row. `createdAt` and `updatedAt` are
43
43
  * already maintained by the persistence adapter on every write path (the Mongoose timestamps plugin;
@@ -75,6 +75,11 @@ export enum RetentionStartPoint {
75
75
  * - the row OUTLIVES its tenant (the edge is disabled, retains-and-impersonalizes, or is absent):
76
76
  * the purge stamps `retentionStartedAt` with the organization's `deletionRequestedAt`, and the
77
77
  * retention sweep deletes the row after its own class period.
78
+ *
79
+ * A row owned by a PERSON (it has `userId` and no `organizationId`) counts from that person going instead. Their
80
+ * erasure, which scrubs the user row and keeps it, stamps the clock in its transaction. The sweep stamps what is left:
81
+ * rows of a user an administrator deleted, and rows a late webhook created after they went. It then applies the class
82
+ * period the same way.
78
83
  */
79
84
  SCOPE_DELETED = "SCOPE_DELETED",
80
85
  }
@@ -108,4 +113,82 @@ export const ResourceRetentionBindingSchema = z.strictObject({
108
113
  closureFieldName: z.string().trim().min(1).optional(),
109
114
  });
110
115
  export type ResourceRetentionBinding = z.infer<typeof ResourceRetentionBindingSchema>;
116
+
117
+ /**
118
+ * **What ends a resource's rows.** One answer per resource, derived by `deriveResourceRowLifetimes` and total over
119
+ * the registry, so a resource added tomorrow is answered with no list to update.
120
+ *
121
+ * ## Why this replaced "kept until erased"
122
+ *
123
+ * Most resources have neither a class nor a `.ttl()`, and they used to be reported under one sentence, "kept until
124
+ * erased". Most of them were not: they end with their tenant's purge, with their account, or through a dedicated
125
+ * cleanup, or they are other doors onto rows another resource owns, or they hold no personal data. A line true of
126
+ * nearly everything tells a reader nothing, so the handful that really had no end could not be seen.
127
+ *
128
+ * ## Why a row with no period can be compliant
129
+ *
130
+ * The storage-limitation duty applies to personal data, and what a notice owes is the period OR, where a fixed period
131
+ * is not possible, the criteria that determine it. "For as long as the account exists, then deleted" is such a
132
+ * criterion. So {@link ENDS_WITH_TENANT} and {@link ENDS_WITH_ACCOUNT} are answers and not gaps, and only
133
+ * {@link UNDECIDED} is a gap.
134
+ *
135
+ * spec-cite: GDPR Art. 13(2)(a) (period or criteria), https://gdpr-info.eu/art-13-gdpr/ — and Art. 5(1)(e) (storage
136
+ * limitation), https://gdpr-info.eu/art-5-gdpr/. Read 2026-11-04.
137
+ */
138
+ export enum ResourceRowLifetime {
139
+ /** Bound to a retention class: the sweep deletes the row once the class period has passed since its start point. */
140
+ CLASS_PERIOD = "class_period",
141
+ /** A `.ttl()` expires the row after a fixed number of seconds. Framework plumbing that holds no business data. */
142
+ ROW_EXPIRY = "row_expiry",
143
+ /** A dedicated engine process removes the row once it has served its purpose: a token cleanup, a delivery buffer. Declared. */
144
+ DEDICATED_MECHANISM = "dedicated_mechanism",
145
+ /**
146
+ * A copy that follows its system of record: the pipeline re-reads the population, and a row that leaves the source is
147
+ * scrubbed. How long it is kept is the source's to answer. Only as long as the pipeline runs. Declared.
148
+ */
149
+ FOLLOWS_SYSTEM_OF_RECORD = "follows_system_of_record",
150
+ /** The immutable audit trail. Never deleted: it moves to the archive at the `AUDIT_LOGS` horizon. Declared. */
151
+ AUDIT_TRAIL = "audit_trail",
152
+ /** Uploaded files: bytes released from their row are destroyed by the files cleanup after the `FILES` period. Declared. */
153
+ FILE_CLEANUP = "file_cleanup",
154
+ /** The operator's own configuration of the application. No person is its subject, and it lives until replaced. Declared. */
155
+ OPERATOR_CONFIGURATION = "operator_configuration",
156
+ /** Another door onto rows a different resource owns; the owner's answer is the answer. */
157
+ ROWS_OWNED_BY_ANOTHER_RESOURCE = "rows_owned_by_another_resource",
158
+ /** Read through from a system of record on each request: nothing is stored locally to keep. */
159
+ NOT_STORED_LOCALLY = "not_stored_locally",
160
+ /** Deleted by the tenant purge, directly or through a delete cascade from `organizations`. */
161
+ ENDS_WITH_TENANT = "ends_with_tenant",
162
+ /**
163
+ * Ends with the person's account, through a delete cascade from `users`. A resource that declares a retention treatment
164
+ * is scrubbed rather than deleted when the person is erased: that treatment says which, and this says when.
165
+ */
166
+ ENDS_WITH_ACCOUNT = "ends_with_account",
167
+ /** Deleted in a delete cascade from a parent that has its own end: a class period, a `.ttl()`, a dedicated mechanism. */
168
+ ENDS_WITH_PARENT = "ends_with_parent",
169
+ /** Nothing deletes the row, and no field holds personal data, so storage limitation has nothing to limit. */
170
+ NO_PERSONAL_DATA = "no_personal_data",
171
+ /** The one real gap: the row holds personal data, or an application never said whether it does, and nothing ever ends it. */
172
+ UNDECIDED = "undecided",
173
+ }
174
+
175
+ /** The lifetimes a resource may DECLARE, because no configuration can show them: every other member is derived. */
176
+ export const DECLARABLE_RESOURCE_ROW_LIFETIMES = [
177
+ ResourceRowLifetime.DEDICATED_MECHANISM,
178
+ ResourceRowLifetime.FOLLOWS_SYSTEM_OF_RECORD,
179
+ ResourceRowLifetime.AUDIT_TRAIL,
180
+ ResourceRowLifetime.FILE_CLEANUP,
181
+ ResourceRowLifetime.OPERATOR_CONFIGURATION,
182
+ ] as const;
183
+
184
+ /**
185
+ * A resource's statement of what ends its rows, for the case nothing in its configuration can show.
186
+ *
187
+ * `rationale` names the mechanism, so a reader can check it. Strict for the reason a binding is.
188
+ */
189
+ export const ResourceRowLifetimeDeclarationSchema = z.strictObject({
190
+ lifetime: z.enum(DECLARABLE_RESOURCE_ROW_LIFETIMES),
191
+ rationale: z.string().trim().min(1),
192
+ });
193
+ export type ResourceRowLifetimeDeclaration = z.infer<typeof ResourceRowLifetimeDeclarationSchema>;
111
194
  ```
@@ -125,6 +125,16 @@ export const RetentionEnforcementRecordSchema = z.object({
125
125
  * no hold check ran for this resource this run — "not measured", which is not the same as zero.
126
126
  */
127
127
  heldSkippedCount: z.number().int().min(0).optional(),
128
+ /**
129
+ * Rows past their period the sweep did NOT delete because their tenant still exists (#3323): a purge that has not finished,
130
+ * or a clock left on a restored tenant. ABSENT means the resource's clock is not a tenant's, or no expired row was listed.
131
+ */
132
+ liveTenantSkippedCount: z.number().int().min(0).optional(),
133
+ /**
134
+ * Rows past their period kept because records that depend on them have not reached theirs yet: a billing account while
135
+ * its last invoices run out. The next run tries again. ABSENT means no delete was refused this way.
136
+ */
137
+ dependentsSkippedCount: z.number().int().min(0).optional(),
128
138
  /**
129
139
  * Rows retained under a statutory restriction (#1635) that are still inside their period — a count only.
130
140
  * ABSENT means nothing measured it this run.
@@ -56,9 +56,11 @@ Read this when:
56
56
  *
57
57
  * A resource declares `retentionBinding: { retentionClass, startPoint }` in its resource
58
58
  * configuration ({@link ResourceRetentionBindingSchema}). An engine sweep then deletes a bound row
59
- * once `retentionDays` of its class have passed since the row's {@link RetentionStartPoint}. A
60
- * resource with no binding is kept until it is erased, and is reported by
61
- * `unboundRetentionResources` so the gap stays visible.
59
+ * once `retentionDays` of its class have passed since the row's {@link RetentionStartPoint}. There is
60
+ * NO default class: a resource with no binding has no clock. That is normal for most resources, because
61
+ * a row usually ends with something else (its tenant, its account, its own process), and
62
+ * `deriveResourceRowLifetimes` answers for every resource which of those it is. Only a resource holding
63
+ * personal data that nothing ever ends reads {@link ResourceRowLifetime.UNDECIDED}.
62
64
  */
63
65
  export enum DataRetentionClass {
64
66
  /**
@@ -85,6 +85,15 @@ export interface ResourceRetentionPolicy {
85
85
  * reach RETAINED rows only, and the write refuses any field this list does not name. A field named here may not be
86
86
  * personal data (no `.dataCategories()`, no `.impersonalizeWith()`), may not be `.excludeFromUpdate()`, and may not
87
87
  * be the primary key or a retention marker: the build refuses each of those.
88
+ *
89
+ * ## Closing a retained record (#1841)
90
+ *
91
+ * A resource bound `RetentionStartPoint.CLOSURE_EVENT` may name its closure field here, the one `.excludeFromUpdate()`
92
+ * field allowed (on a closure clock that decorator means server-owned, not immutable). A record still OPEN when its
93
+ * subject is erased can then be closed: its own close operation, finding the row RETAINED, calls
94
+ * `SystemAccessBackendService.closeRetainedRecordAsSystem`, which writes the closure date only where it is still null.
95
+ * The retention-class sweep then deletes the row at closure + period. This is what lets a statutory record declare a
96
+ * period counted from the end of a contract or a matter; without it the build refuses that combination.
88
97
  */
89
98
  retainedRowCompletion?: ResourceRetainedRowCompletion;
90
99
  }
@@ -111,6 +120,18 @@ export interface ResourceStatutoryRetention {
111
120
  * claim nobody can check.
112
121
  */
113
122
  rationale: string;
123
+ /**
124
+ * WHY these rows stay in use after their owner goes, for a resource whose teardown edges do not restrict them.
125
+ *
126
+ * The default, and the right answer for almost every statutory record, is restriction: every owning edge authors
127
+ * `IMPERSONALIZE_AND_RETAIN`, and startup refuses anything else. A few records cannot be frozen, because work still
128
+ * arrives for them after the owner has gone: a billing provider's webhooks and reconciliation reach an invoice long
129
+ * after its customer left. Declaring this keeps the edges as they are and states why, in words a reader can dispute.
130
+ * Required non-empty when present. It changes nothing about the period, which still ends the rows. Because such rows
131
+ * are never restricted, their handlers close them through ordinary writes, so a `CLOSURE_EVENT` binding is accepted
132
+ * with it (#1841).
133
+ */
134
+ staysInUseBecause?: string;
114
135
  }
115
136
  ```
116
137