@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
@@ -4,7 +4,8 @@ This file exposes `idempotencyKey` — the per-operation-variant declaration tha
4
4
  `Idempotency-Key` request header, so a caller's retry receives the first request's outcome instead of running the
5
5
  effect a second time.
6
6
 
7
- Read it when an operation does something your database cannot roll back: charging or changing a subscription at a
7
+ Read it when a caller may retry an operation after losing its answer — a create above all, where the retry is a second
8
+ row — and whenever an operation does something your database cannot roll back: charging or changing a subscription at a
8
9
  payment provider, sending a message, writing to a third-party system.
9
10
 
10
11
  ## Why a retry is the danger
@@ -36,19 +37,23 @@ whose effect must not run twice is not a read — borrow a mutation verb in `res
36
37
  exactly like a browser does, so it is bound exactly like one. Engine code calling the operation internally, a provider
37
38
  webhook, a queued worker and a nested sub-call are exempt: none of them has a client retry to deduplicate.
38
39
 
39
- Two planes need a decision before a `REQUIRED` operation reaches them:
40
-
41
- - **MCP tools.** `tools/call` carries no key, so an operation that is both `REQUIRED` and `mcp.exposed` would be listed
42
- and refused on every call. The application refuses to start in that state. Keep the operation off MCP, or declare
43
- `ACCEPTED` when a keyless retry is genuinely safe.
44
- - **Agent function tools.** A tool you author that dispatches a `REQUIRED` operation passes a key as
45
- `options: { idempotencyKey }` to `dispatchResourceOperationAsTool`, and reuses that key when it retries. Know what that
46
- covers: a tool mints its key inside one execution, so the key deduplicates the retries the tool makes itself — not the
47
- model calling the tool again after a failure, which is a new execution and therefore a new request. If a repeated model
48
- call must not repeat the effect, derive the key from something stable in the tool's own arguments instead.
49
- - **The built-in resource write tool** dispatches a resource's default create or update and carries no key, so it refuses
50
- to target a `REQUIRED` operation rather than offering the model a tool that fails on every call. Author a dedicated tool
51
- for that operation.
40
+ The tool planes have no headers, so they carry the key as an `idempotencyKey` ARGUMENT, which the framework takes out
41
+ of the arguments and treats exactly as the header. A model calls a write tool again when a call fails, so these are the
42
+ planes where a retry is most likely:
43
+
44
+ - **MCP tools.** The tool of a variant that declares `idempotencyKey` advertises an `idempotencyKey` argument (required
45
+ for `REQUIRED`, optional for `ACCEPTED`) and tells the model to send a new value for each change and the same value
46
+ when it retries one. A `REQUIRED` operation can therefore be `mcp.exposed`. The application refuses to start when such
47
+ a tool's request DTO, or its resource's id field, already has a field named `idempotencyKey`, which would be taken as
48
+ the key: rename the field, or keep the operation off MCP.
49
+ - **The built-in resource write tool** (`resourceWriteTool`) takes the same argument. Declare it in the tool's
50
+ `inputSchema`, `idempotencyKey: z.string().describe(IDEMPOTENCY_KEY_TOOL_ARGUMENT_DESCRIPTION)`, optional for an
51
+ `ACCEPTED` operation, so the model is told to send one. A call to a `REQUIRED` operation without it is refused before
52
+ anything runs, naming the argument.
53
+ - **An agent function tool you author** passes a key as `options: { idempotencyKey }` to
54
+ `dispatchResourceOperationAsTool`. Take it from the model as the same `idempotencyKey` argument: a key the tool mints
55
+ inside one execution deduplicates only the retries the tool makes itself, never the model calling the tool again
56
+ after a failure, which is a new execution and therefore a new request.
52
57
 
53
58
  ## What the framework does, and what it leaves to you
54
59
 
@@ -67,13 +72,39 @@ The framework does the transport half:
67
72
  - refuses a key sent to a variant whose runtime mode is not `INLINE`: queued and background execution cannot carry it to
68
73
  your implementation, so accepting it would promise a protection nothing delivers.
69
74
 
70
- Your implementation does the other half, because only it knows what "the same request" and "its outcome" mean:
75
+ It also REMEMBERS the outcome. The first request sent with a key is recorded per (caller, resource, key) before it runs,
76
+ and what became of it after it committed; the record is kept for 24 hours (`IDEMPOTENT_REQUEST_OUTCOME_RETENTION_HOURS`)
77
+ and an hourly sweep deletes it after that. A repeat is answered from the record:
78
+
79
+ | the first request | a repeat of the same request is answered |
80
+ |---|---|
81
+ | succeeded | with the first response, replayed: nothing runs again, no hook, no write, no notification |
82
+ | is still running | 409 `idempotency_key_in_progress`: retry the same request later |
83
+ | was refused before anything landed (validation, permission, not found, a rule) | by running it: the key binds nothing yet, so a corrected request runs too |
84
+ | failed in a way that may have landed (an unclassified error, an unknown commit, a crash) | 409 `idempotency_key_outcome_unknown`: read before acting. It never runs again under the key |
85
+ | succeeded, and its response carried a value shown once (an `.isEphemeral()` secret) | 409 `idempotency_key_outcome_not_replayable`, naming the row in `idempotentRequestResourceId` |
86
+
87
+ The same key with a DIFFERENT request — another operation of the resource, another variant, target or payload — is
88
+ refused 422 with `ErrorCustomMessageReference.IDEMPOTENCY_KEY_REUSED` (a 422 strips error context on the wire, so the
89
+ reference is the signal a client can branch on). Two callers sending the same key are two requests. The 409 codes are
90
+ `IdempotentRequestRefusalCode`.
91
+
92
+ What is kept is the response the caller received, through the operation's response DTO: backend-only fields are not in
93
+ it and write-only secrets are masked. A response carrying a one-time secret is never stored, which is why its repeat is
94
+ refused rather than replayed: the secret exists only in the one response that discloses it.
95
+
96
+ A read-through resource (`httpApiBinding`) is the exception: its writes are remembered by the system-of-record admission
97
+ ledger, which replays by reading the row back and never keeps a copy of it.
98
+
99
+ What is left to you is the effect OUTSIDE your database. A local write is covered; a provider call is not, because a
100
+ crash can land between the provider applying it and the framework recording the outcome. Pass the key, or a key derived
101
+ from it, to the provider so the provider deduplicates the call, or keep your own record of the effect. When your
102
+ implementation replaces the core write (`OVERRIDE_ALL`, `REPLACE_CORE_OPERARTIONS`) or runs an effect before it
103
+ (`BEFORE_TRANSACTIONAL_CORE`), an attempt whose outcome is unknown is NOT refused: the repeat runs again and reaches your
104
+ implementation, which answers it from its own record. So such an implementation must own that answer:
71
105
 
72
106
  - remember that a key was used, durably, in the same transaction as the effect's local write;
73
- - on a repeat of the same request, answer the recorded outcome without running the effect again;
74
- - on the same key with a DIFFERENT request, refuse with 422 using `ErrorCustomMessageReference.IDEMPOTENCY_KEY_REUSED`
75
- (a 422 strips error context on the wire, so the reference is the signal a client can branch on);
76
- - while the first request is still running, refuse the repeat with 409 rather than running it concurrently.
107
+ - on a repeat of the same request, answer the recorded outcome without running the effect again.
77
108
 
78
109
  One concurrency trap is worth naming, because it passes every sequential test. If you check "has this key's request
79
110
  already started?" against one read of your state and then record the new request against a LATER read, two concurrent
@@ -82,8 +113,6 @@ effect again. Record the request only against the exact state you checked (a com
82
113
  fails, repeat the check once from a fresh read — the first request's recorded outcome or in-flight marker is then there
83
114
  to answer it.
84
115
 
85
- Declaring the variant without doing that half ships a header nothing deduplicates.
86
-
87
116
  ## Operation Idempotency Key
88
117
 
89
118
  ## Import Origins
@@ -99,9 +128,10 @@ Declaring the variant without doing that half ships a header nothing deduplicate
99
128
  * Whether this variant takes the `Idempotency-Key` request header, so a caller's retry receives the first request's
100
129
  * outcome instead of running the effect again.
101
130
  *
102
- * Declare it on a mutation whose effect happens OUTSIDE your database — a payment provider, an email, a third-party
103
- * write — where a retry after a lost response is the duplicate you cannot roll back. A pure database write already
104
- * gets optimistic locking from `If-Match`; this is for what a transaction cannot undo.
131
+ * Declare it on a mutation a caller may retry after losing the answer — a CREATE above all, where a retry is a second
132
+ * row — and on every mutation whose effect happens OUTSIDE your database (a payment provider, an email, a third-party
133
+ * write), where the duplicate cannot be rolled back. `If-Match` protects an update from a stale read; it does nothing
134
+ * for a create sent twice.
105
135
  *
106
136
  * - `ACCEPTED`: the header is honored when sent, and a request without it runs unkeyed. Right for an effect that
107
137
  * converges when repeated (cancelling something twice leaves it cancelled).
@@ -124,9 +154,18 @@ Declaring the variant without doing that half ships a header nothing deduplicate
124
154
  * nothing, so the key would protect no retry and `REQUIRED` would only refuse harmless repeats. A custom operation whose
125
155
  * effect must not run twice is not a read: borrow a mutation verb in `resourceOperationLike` and declare the key there.
126
156
  *
127
- * What it does NOT do: remember outcomes. Deciding that a key was seen, replaying its result and refusing the same key
128
- * sent with a different request (422, `ErrorCustomMessageReference.IDEMPOTENCY_KEY_REUSED`) is the implementation's
129
- * job, because only it knows what "the same request" and "its result" mean for its effect.
157
+ * It also REMEMBERS the outcome (#747): the first response to a keyed request is kept for a day per (caller, resource,
158
+ * key), and a repeat of the same request is answered from it without running again. A repeat while the first is still
159
+ * running is refused 409 (`idempotency_key_in_progress`); the same key with a different request (another operation,
160
+ * target or payload) is refused 422 (`ErrorCustomMessageReference.IDEMPOTENCY_KEY_REUSED`). A first request refused
161
+ * before anything landed (validation, permission, a rule) leaves the key free, so the corrected retry runs; one whose
162
+ * outcome is unknown (an unclassified failure, a lost commit, a crash) is never run again under the key (409 `idempotency_key_outcome_unknown`:
163
+ * read before acting). A response carrying a one-time secret (`.isEphemeral()`) is never stored, so its repeat is refused
164
+ * 409 (`idempotency_key_outcome_not_replayable`) naming the row instead. `IdempotentRequestRefusalCode` lists the codes.
165
+ *
166
+ * Your implementation still receives the key, because an effect outside your database needs its own bracket: pass the
167
+ * key (or a key derived from it) to the provider, so the provider deduplicates the call itself. A read-through
168
+ * resource's writes are remembered by its system-of-record admission ledger instead, which never stores the row.
130
169
  *
131
170
  * @example a provider-backed mutation that must not run twice
132
171
  * variants: [{
@@ -16,7 +16,7 @@ together: the resource factory refuses either one alone.
16
16
  | **about no person, but naming one** — a pipeline stage or a quote with a `createdByUserId`, a job pointing at a homeowner | `RETAIN_ONLY` | `NO_PRINCIPAL` | **`ALLOWED`** (or `FORBIDDEN` to keep it out on purpose): the link puts it on that person's export graph, and an undeclared resource there makes the subject-access export refuse when it is requested | nothing of its own |
17
17
  | **about no person, but keeping the name of the party it describes** — a billing record naming the customer account billed, a record of a relationship naming the other organization | `RETAIN_ONLY` | `NO_PRINCIPAL` | as the row above | the copied name: `.dataCategories(PersonalDataCategory.IDENTITY, { personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON, aboutAnotherParty: true })`. It is a person's data only where that party is a sole trader, and it is about that OTHER party, so `RETAIN_ONLY` still holds; the notice states it under that condition. Leave `aboutAnotherParty` off a record's OWN party's name (a customer account's own name): that is the record's subject, and `RETAIN_ONLY` refuses it |
18
18
  | **a person with no account** — a CRM contact, a lead, a homeowner on a quote | `RETAIN_AND_IMPERSONALIZE` | `NO_PRINCIPAL` | `ALLOWED` | every personal field: `.dataCategories(...)` and `.impersonalizeWith(...)` |
19
- | **a person who signs in** — the row IS the user, or names the user it belongs to | `RETAIN_AND_IMPERSONALIZE` | `SELF_PRINCIPAL` (the row's id is the user), or `LINKED_PRINCIPAL` with `sessionPrincipalField` (a field names the user) | `ALLOWED` | as above; erasing the row also ends that user's sessions |
19
+ | **a person who signs in** — the row IS the user, or names the user it belongs to | `RETAIN_AND_IMPERSONALIZE` | `LINKED_PRINCIPAL` with `sessionPrincipalField`, the foreign key to `users`, when only erasing that person scrubs this row; `NO_PRINCIPAL` for a row merely about them. `SELF_PRINCIPAL` is the engine's own `users` row and is refused anywhere else | `ALLOWED` | as above; erasing the row also ends that user's sessions |
20
20
  | **a business record carrying free text about people** — notes, descriptions, comments | `RETAIN_AND_IMPERSONALIZE` (the text is personal data of its own, so not `RETAIN_ONLY`) | whichever of the rows above fits the record itself | `ALLOWED` when the record names a person, as above | the text field, optional: `.dataCategories(PersonalDataCategory.USER_CONTENT)` and `.impersonalizeWith(RedactionType.REMOVE)` |
21
21
 
22
22
  `REMOVE` clears the field, so it is accepted only on an optional field; a required one takes
@@ -242,26 +242,28 @@ export enum ResourceSystemAccessMode {
242
242
  /**
243
243
  * Declares that THIS resource is the application's subject-erasure request lane, and how to read it.
244
244
  *
245
- * ## Why the application declares it rather than the framework knowing it
245
+ * ## Who declares it, and why it is still a declaration
246
246
  *
247
- * The erasure lane is application-owned — four of the five marked sites for
248
- * `WILDO.PRIVACY.SUBJECT_ERASURE` are in an application, not the engine — and its evidence demand
249
- * (`evidence-requirement:subject-erasure-execution-record`) says so in terms: *"the row's schema and
250
- * status vocabulary are the application's, so a collector queries it against that application's
251
- * specification"*, and its verification step adds *"do NOT assert a specific channel vocabulary:
252
- * that is one application's modelling choice"*.
247
+ * Since #2296 the lane is the ENGINE's: the core resource `dataSubjectRequests`, which every application
248
+ * has, carries this declaration, and the evidence door refuses an application where a second resource
249
+ * declares one. An application does not declare its own. (Before #2296 the lane was an application's to
250
+ * build, which is why this declaration exists at all: Your Application' `accountErasureRequests` was the
251
+ * first declarer and was harvested into the engine.)
253
252
  *
254
- * So a collector may not know that a request is raised through a field called `channel` carrying a
255
- * value called `SUBJECT`. It has to be TOLD, by the application, in a form it can read. Before this
256
- * existed, three clauses of that demand had a durable row holding every fact they wanted and no way
257
- * to find it (#1209): not a missing control, a control nobody could point at.
253
+ * It stays a DECLARATION rather than the door reading the engine's fields by name, because the door
254
+ * and the collector read the lane through it and never through the engine's vocabulary: they count the
255
+ * field and value the declaration names (`evidence-requirement:subject-erasure-execution-record` asks
256
+ * them to), so their reading follows the resource and cannot drift from it. Before this existed, three
257
+ * clauses of that demand had a durable row holding every fact they wanted and no way to find it
258
+ * (#1209): not a missing control, a control nobody could point at.
258
259
  *
259
260
  * ## It binds FIELDS, never values the framework invents
260
261
  *
261
- * Every member below names something the application already authored. The one value the
262
- * declaration carries — {@link ResourceSubjectErasureLane.raisedBy}`.subjectValue` — is the
263
- * application's OWN enum member, quoted back so a reader can tell the two populations apart. The
264
- * framework supplies no vocabulary here and must never grow one.
262
+ * Every member below names something the declaring resource already has. The one value the
263
+ * declaration carries — {@link ResourceSubjectErasureLane.raisedBy}`.subjectValue` — is that
264
+ * resource's OWN enum member (`DataSubjectRequestChannel.SELF` on the engine's lane), quoted back so a
265
+ * reader can tell the two populations apart. The declaration supplies no vocabulary of its own and must
266
+ * never grow one.
265
267
  *
266
268
  * ## What is deliberately NOT declared
267
269
  *
@@ -332,6 +334,21 @@ export type ResourceSubjectErasureLane = {
332
334
  },
333
335
  /** The scheduled operation that executes due requests. Its `cronExpression` IS the declared schedule. */
334
336
  executionOperationIdentifier: string,
337
+ /**
338
+ * How a row says it is an ERASURE request at all, when the declaring resource also records requests for other rights
339
+ * (#2296: the engine's `dataSubjectRequests` carries access and portability requests beside erasure). The same shape
340
+ * as {@link withdrawnMarker}, and for the same reason: the vocabulary is the resource's.
341
+ *
342
+ * A collector counts only the rows carrying it. Without it, an export request — answered at intake, with a
343
+ * `completedAt` and no erasure — would be counted as an erasure executed, which is the false evidence this lane
344
+ * exists to prevent. Omitting it is a positive claim that every row of the resource is an erasure request.
345
+ */
346
+ erasureMarker?: {
347
+ /** The field carrying it. Must be a persisted field of this resource. */
348
+ fieldName: string,
349
+ /** The value of that field meaning the row is an erasure request. */
350
+ erasureValue: string,
351
+ },
335
352
  };
336
353
 
337
354
  export type ResourceSystemAccessPolicy = {
@@ -537,6 +554,15 @@ export interface ResourceRetentionPolicy {
537
554
  * reach RETAINED rows only, and the write refuses any field this list does not name. A field named here may not be
538
555
  * personal data (no `.dataCategories()`, no `.impersonalizeWith()`), may not be `.excludeFromUpdate()`, and may not
539
556
  * be the primary key or a retention marker: the build refuses each of those.
557
+ *
558
+ * ## Closing a retained record (#1841)
559
+ *
560
+ * A resource bound `RetentionStartPoint.CLOSURE_EVENT` may name its closure field here, the one `.excludeFromUpdate()`
561
+ * field allowed (on a closure clock that decorator means server-owned, not immutable). A record still OPEN when its
562
+ * subject is erased can then be closed: its own close operation, finding the row RETAINED, calls
563
+ * `SystemAccessBackendService.closeRetainedRecordAsSystem`, which writes the closure date only where it is still null.
564
+ * The retention-class sweep then deletes the row at closure + period. This is what lets a statutory record declare a
565
+ * period counted from the end of a contract or a matter; without it the build refuses that combination.
540
566
  */
541
567
  retainedRowCompletion?: ResourceRetainedRowCompletion;
542
568
  }
@@ -563,6 +589,18 @@ export interface ResourceStatutoryRetention {
563
589
  * claim nobody can check.
564
590
  */
565
591
  rationale: string;
592
+ /**
593
+ * WHY these rows stay in use after their owner goes, for a resource whose teardown edges do not restrict them.
594
+ *
595
+ * The default, and the right answer for almost every statutory record, is restriction: every owning edge authors
596
+ * `IMPERSONALIZE_AND_RETAIN`, and startup refuses anything else. A few records cannot be frozen, because work still
597
+ * arrives for them after the owner has gone: a billing provider's webhooks and reconciliation reach an invoice long
598
+ * after its customer left. Declaring this keeps the edges as they are and states why, in words a reader can dispute.
599
+ * Required non-empty when present. It changes nothing about the period, which still ends the rows. Because such rows
600
+ * are never restricted, their handlers close them through ordinary writes, so a `CLOSURE_EVENT` binding is accepted
601
+ * with it (#1841).
602
+ */
603
+ staysInUseBecause?: string;
566
604
  }
567
605
 
568
606
  /**
@@ -627,30 +665,15 @@ export type ResourceConfiguration_BuilderParameters<
627
665
  * If not specified, uses `appConfig.database.defaultAdapter` — which is the normal case and
628
666
  * should stay the normal case.
629
667
  *
630
- * **Declaring a value that DISAGREES with the application default is refused at registration
631
- * unless {@link ResourceConfiguration_BuilderParameters.persistenceAdapterIsolation} is also
632
- * declared.** An application is wholly one adapter by default because two adapters cannot
633
- * share a native transaction; the isolation declaration is the only way past that refusal,
634
- * and it is a claim about this resource's write topology rather than a way to silence the
635
- * error. Declaring an adapter that AGREES with the default is always fine and needs nothing.
668
+ * **An application uses exactly ONE transactional store** (#3328, decided 2026-11-06), so a
669
+ * `mongodb` or `postgresql` value that DISAGREES with the application default is refused at
670
+ * registration, with no declaration that admits it. Declaring an adapter that AGREES with the
671
+ * default is always fine and needs nothing. The non-default values a resource may declare are
672
+ * the ones that hold no transaction: `http-api` (read through from another system) and
673
+ * `introspection` (computed from the application itself).
636
674
  */
637
675
  persistenceAdapter?: PersistenceAdapterType,
638
676
 
639
- /**
640
- * This resource's declared relationship to cross-adapter atomic write boundaries.
641
- *
642
- * Required — and only meaningful — when {@link
643
- * ResourceConfiguration_BuilderParameters.persistenceAdapter} disagrees with
644
- * `appConfig.database.defaultAdapter`. Without it, the resources registry refuses the
645
- * application at startup; with it, the registry admits the resource and LOGS the admitted
646
- * set, so a mixed configuration is always named and never ambient.
647
- *
648
- * Read {@link ResourcePersistenceAdapterIsolation} before declaring one: the member is an
649
- * assertion about the resource's design that the persistence unit of work will still enforce
650
- * at every real boundary.
651
- */
652
- persistenceAdapterIsolation?: ResourcePersistenceAdapterIsolationType,
653
-
654
677
  /**
655
678
  * REQUIRED companion declaration when `persistenceAdapter` is `HTTP_API`; forbidden otherwise.
656
679
  *
@@ -726,9 +749,9 @@ export type ResourceConfiguration_BuilderParameters<
726
749
 
727
750
  /**
728
751
  * Declares this resource as the application's SUBJECT-ERASURE REQUEST LANE and binds the fields an
729
- * evidence collector reads. Omitted ⇒ this resource is not that lane, which is the honest default:
730
- * most resources are not, and an application that never built an erasure lane has declared none
731
- * rather than failed a control. See {@link ResourceSubjectErasureLane}.
752
+ * evidence collector reads. Omitted ⇒ this resource is not that lane, the default for every resource
753
+ * but one: since #2296 the engine's `dataSubjectRequests` declares it in every application, and the
754
+ * evidence door refuses an application where a second resource does. See {@link ResourceSubjectErasureLane}.
732
755
  */
733
756
  subjectErasureLane?: ResourceSubjectErasureLane,
734
757
  coreOperations: TCoreOperationEnum[],
@@ -842,14 +865,22 @@ export type ResourceConfiguration_BuilderParameters<
842
865
  * scrub); this is how long a row lives at all. The two compose: a row an erasure retained is still
843
866
  * deleted when its class period ends.
844
867
  *
845
- * Optional. An unbound resource is kept until it is erased, and is reported as unbound
846
- * (`unboundRetentionResources`) so the undecided period stays visible. A resource that binds a class
847
- * may not also declare a `.ttl()` field — one row, one retention authority.
868
+ * Optional, with no default class: an unbound row has no clock. That is normal when something else ends the
869
+ * row, and `deriveResourceRowLifetimes` says what does for every resource. A resource that binds a class may not
870
+ * also declare a `.ttl()` field — one row, one retention authority.
848
871
  *
849
872
  * {@link RetentionStartPoint.SCOPE_DELETED} injects a server-owned `retentionStartedAt` field.
850
873
  */
851
874
  retentionBinding?: ResourceRetentionBinding,
852
875
 
876
+ /**
877
+ * What ends this resource's rows, for the case its configuration cannot show: a dedicated cleanup, the audit
878
+ * archive, the files cleanup, or operator configuration. Everything else is derived, so declare this only when
879
+ * `deriveResourceRowLifetimes` would otherwise answer `UNDECIDED` and a real mechanism exists. It may not sit beside
880
+ * a {@link retentionBinding}: one row, one retention authority.
881
+ */
882
+ rowLifetime?: ResourceRowLifetimeDeclaration,
883
+
853
884
  /**
854
885
  * Resource-level DEFAULT provenance for GDPR Art. 20 (portability) scoping; per-field overrides
855
886
  * are `.portabilityProvenance()`. Optional — Art. 15 (access) never consults provenance, so an
@@ -866,6 +897,40 @@ export type ResourceConfiguration_BuilderParameters<
866
897
  */
867
898
  subjectExportOthersDataFields?: readonly string[],
868
899
 
900
+ /**
901
+ * The same withholding, for rows reached through ONE edge (#2958 follow-up): keyed by the foreign-key field of a
902
+ * relationship edge to this resource, the fields a subject export withholds and lists as other people's data when it
903
+ * reaches a row THROUGH THAT EDGE, for both rights, on top of {@link subjectExportOthersDataFields}.
904
+ *
905
+ * For a resource two people reach by two edges with different standing. A data-subject request is the SUBJECT's
906
+ * (`userId`, whole) and names the operator who recorded it (`requestedByUserId`): the operator's own act (that they
907
+ * recorded a request, of which kind, when) is personal data concerning them (Art. 15(1)), the subject's identity and
908
+ * the request's content are another person's (Art. 15(4)). A resource-wide declaration cannot say that, since it
909
+ * would withhold the subject's own request from the subject.
910
+ *
911
+ * Not read by the retained-row scrub (`resolveRetainedRowScrubSurface`), unlike the resource-wide list: these fields
912
+ * are the row's OWN subject's data, removed by that subject's erasure, not a third person's.
913
+ *
914
+ * Each key and each listed name must be a top-level field of the main schema; the factory refuses one that is not.
915
+ */
916
+ subjectExportOthersDataFieldsByForeignKey?: Readonly<Record<string, readonly string[]>>,
917
+
918
+ /**
919
+ * #2958: columns of this resource that hold a USER's id on no edge of that user's export graph, and that their ACCESS
920
+ * export reads (Art. 15 only): who acted on the row (`ACTED`: proposed, granted, verified, ended, triaged, kept as
921
+ * accountability evidence and never severed) or who owns it (`OWNS`: a user-private file). Keyed by the column; each
922
+ * declares its relation and the fields of a row found through it that are about that person (`shownFields`, an
923
+ * allow-list: every other field is withheld and listed as other people's data). A person-naming column a SEVERER
924
+ * reaches is declared beside the severer instead (`SubjectReferenceSeverer.subjectReferenceColumns`).
925
+ *
926
+ * Not an edge, on purpose: `exportSubject` is per resource, so an `invitedByUserId` edge on `organizationMembers` would
927
+ * put every member the person invited, whole, into their export.
928
+ *
929
+ * Each key and each shown name must be a top-level field of the main schema (a variant's included); the factory refuses
930
+ * one that is not. The resource must declare `systemAccessPolicy.exportSubject`.
931
+ */
932
+ subjectExportPersonColumns?: SubjectExportPersonColumns,
933
+
869
934
  /**
870
935
  * Declares every row of this resource a CASE: the unit of work an application sells an outcome for (a
871
936
  * matter, a file, a claim, a ticket). Model calls made while working on a row are attributed to it, so the
@@ -955,26 +1020,28 @@ export enum ResourceSystemAccessMode {
955
1020
  /**
956
1021
  * Declares that THIS resource is the application's subject-erasure request lane, and how to read it.
957
1022
  *
958
- * ## Why the application declares it rather than the framework knowing it
1023
+ * ## Who declares it, and why it is still a declaration
959
1024
  *
960
- * The erasure lane is application-owned — four of the five marked sites for
961
- * `WILDO.PRIVACY.SUBJECT_ERASURE` are in an application, not the engine — and its evidence demand
962
- * (`evidence-requirement:subject-erasure-execution-record`) says so in terms: *"the row's schema and
963
- * status vocabulary are the application's, so a collector queries it against that application's
964
- * specification"*, and its verification step adds *"do NOT assert a specific channel vocabulary:
965
- * that is one application's modelling choice"*.
1025
+ * Since #2296 the lane is the ENGINE's: the core resource `dataSubjectRequests`, which every application
1026
+ * has, carries this declaration, and the evidence door refuses an application where a second resource
1027
+ * declares one. An application does not declare its own. (Before #2296 the lane was an application's to
1028
+ * build, which is why this declaration exists at all: Your Application' `accountErasureRequests` was the
1029
+ * first declarer and was harvested into the engine.)
966
1030
  *
967
- * So a collector may not know that a request is raised through a field called `channel` carrying a
968
- * value called `SUBJECT`. It has to be TOLD, by the application, in a form it can read. Before this
969
- * existed, three clauses of that demand had a durable row holding every fact they wanted and no way
970
- * to find it (#1209): not a missing control, a control nobody could point at.
1031
+ * It stays a DECLARATION rather than the door reading the engine's fields by name, because the door
1032
+ * and the collector read the lane through it and never through the engine's vocabulary: they count the
1033
+ * field and value the declaration names (`evidence-requirement:subject-erasure-execution-record` asks
1034
+ * them to), so their reading follows the resource and cannot drift from it. Before this existed, three
1035
+ * clauses of that demand had a durable row holding every fact they wanted and no way to find it
1036
+ * (#1209): not a missing control, a control nobody could point at.
971
1037
  *
972
1038
  * ## It binds FIELDS, never values the framework invents
973
1039
  *
974
- * Every member below names something the application already authored. The one value the
975
- * declaration carries — {@link ResourceSubjectErasureLane.raisedBy}`.subjectValue` — is the
976
- * application's OWN enum member, quoted back so a reader can tell the two populations apart. The
977
- * framework supplies no vocabulary here and must never grow one.
1040
+ * Every member below names something the declaring resource already has. The one value the
1041
+ * declaration carries — {@link ResourceSubjectErasureLane.raisedBy}`.subjectValue` — is that
1042
+ * resource's OWN enum member (`DataSubjectRequestChannel.SELF` on the engine's lane), quoted back so a
1043
+ * reader can tell the two populations apart. The declaration supplies no vocabulary of its own and must
1044
+ * never grow one.
978
1045
  *
979
1046
  * ## What is deliberately NOT declared
980
1047
  *
@@ -1045,6 +1112,21 @@ export type ResourceSubjectErasureLane = {
1045
1112
  },
1046
1113
  /** The scheduled operation that executes due requests. Its `cronExpression` IS the declared schedule. */
1047
1114
  executionOperationIdentifier: string,
1115
+ /**
1116
+ * How a row says it is an ERASURE request at all, when the declaring resource also records requests for other rights
1117
+ * (#2296: the engine's `dataSubjectRequests` carries access and portability requests beside erasure). The same shape
1118
+ * as {@link withdrawnMarker}, and for the same reason: the vocabulary is the resource's.
1119
+ *
1120
+ * A collector counts only the rows carrying it. Without it, an export request — answered at intake, with a
1121
+ * `completedAt` and no erasure — would be counted as an erasure executed, which is the false evidence this lane
1122
+ * exists to prevent. Omitting it is a positive claim that every row of the resource is an erasure request.
1123
+ */
1124
+ erasureMarker?: {
1125
+ /** The field carrying it. Must be a persisted field of this resource. */
1126
+ fieldName: string,
1127
+ /** The value of that field meaning the row is an erasure request. */
1128
+ erasureValue: string,
1129
+ },
1048
1130
  };
1049
1131
 
1050
1132
  export type ResourceSystemAccessPolicy = {
@@ -38,8 +38,13 @@ stayed green.
38
38
 
39
39
  Ask the question the backend will ask, without starting it: run `wildo config check-resources` at the
40
40
  application root. It builds every resource configuration and the resources registry from the compiled
41
- backend, offline, and prints the factory's refusal and the resource it names. Exit 1 is a refused
42
- configuration; exit 2 means it could not ask (rebuild, then ask again).
41
+ backend, offline, and prints the factory's refusal and the resource it names. It then runs the startup
42
+ validation checks that read the registry alone, the same ones the backend runs after the registry builds,
43
+ among them the statutory-retention teardown rule: a resource kept on a statutory ground whose parent edge
44
+ does not declare `onParentDelete: { enabled: true, mode: IMMEDIATE, strategy: IMPERSONALIZE_AND_RETAIN }`
45
+ fails with `[LIFECYCLE] The '<parent> → <child>' teardown edge …`. Exit 1 is a refused configuration;
46
+ exit 2 means it could not ask (rebuild, then ask again). Checks that read implementations, providers or
47
+ the application configuration still run only when the backend starts.
43
48
 
44
49
  ## The factory's other start-time refusals a worker trips
45
50
 
@@ -18,23 +18,35 @@ writes the caller never asked for.
18
18
 
19
19
  ## What it answers, and what it does not
20
20
 
21
- It answers **how high**, not **where**. The caller's effective roles are unioned across every
22
- membership they hold, without checking that the granting membership targets the same organization as
23
- the write — safe because the operation-authorization layer has already confined the write to a scope
24
- the caller may act in.
21
+ It answers **how high**, and counts only the roles the caller holds IN the organization the write acts
22
+ inside, organization-wide (a role held on one unit grants nothing across the tenant), plus their
23
+ application roles. An `ORG_ADMIN` of one tenant is not an `ORG_ADMIN` of another.
25
24
 
26
25
  The comparison is hierarchy-aware: a role expands through its `inheritFrom` chain, so an `ORG_ADMIN`
27
26
  whose membership row holds only the literal `ORG_ADMIN` can still grant the roles that role confers.
28
27
  A role string unknown in the passed scope expands to the empty set — fail-closed by construction.
29
28
 
30
- ## Two populations it deliberately skips
29
+ It also admits your application's own roles that are OFF the caller's chain when everything they confer
30
+ is within a role the caller holds: their `inheritFrom` chain is on the caller's, and every operation
31
+ naming them admits the caller too, at the same row reach. So an owner or administrator can grant a
32
+ supervisor role that inherits `ORG_MANAGER` and is named beside `ORG_ADMIN`, and a manager cannot. A
33
+ custom role named alone on an operation the caller cannot call exceeds the caller and is refused. The
34
+ same holds wherever else a role name confers authority: an approval route (`requiresApproval.eligibleRole`,
35
+ a function tool's `humanApproval.eligibleRole`, an actor's or a flow's question route), a reference
36
+ constraint's `requiredRoles`, a system-of-record action's `roles` and a provider browser operation's
37
+ `allowedRoles`. A custom role named as the ONLY role a decision route admits can be given by the platform
38
+ super-administrator alone, since no administrator answers that route. Where the application keeps agent
39
+ correction content, a tenant may name any role as its reader, so a custom organization role is grantable
40
+ only by a role at or above `ORG_ADMIN` there. The engine's own roles are never admitted this way:
41
+ `ORG_OWNER` stays above `ORG_ADMIN` whatever the operations say.
42
+
43
+ ## What it deliberately skips, and what it does not
31
44
 
32
45
  - **Internally initiated writes.** A seed, a provisioning step or a system-authored write carries no
33
46
  human ceiling and assigns whatever it is told.
34
- - **Machine credentials, after creation.** The gate runs at CREATE only, because those resources
35
- expose no ordinary update verb and their secret-reissue verb accepts an empty request body
36
- precisely so a reissue cannot smuggle a new roles array past the ceiling. The roles a credential
37
- carries are fixed when it is minted.
47
+ - **Nothing else, for machine credentials.** They are checked at mint, on an update that names roles,
48
+ and on every reissue or expiry extension, where the credential's STORED roles face the caller's
49
+ ceiling: handing out a working secret, or extending one, administers that authority.
38
50
 
39
51
  ## Role Ceiling
40
52
 
@@ -69,7 +81,10 @@ A role string unknown in the passed scope expands to the empty set — fail-clos
69
81
  *
70
82
  * SEMANTICS. Every requested role must lie within the caller's EFFECTIVE authority — the union of the
71
83
  * `inheritFrom` hierarchies of the roles the caller actually holds, each expanded within the scope of
72
- * the membership that granted it. Hierarchy-awareness is not a convenience: with the default table
84
+ * the membership that granted it, plus every application-declared role whose whole authority is within a held
85
+ * role's (a custom role off the core chain, such as a supervisor inheriting `ORG_MANAGER`, which an `ORG_OWNER`
86
+ * may grant when every operation, approval or decision route and action naming the supervisor also admits the owner,
87
+ * measured against the live registries by `AuthorizationsBackendService.getRolesWithinAuthority`). Hierarchy-awareness is not a convenience: with the default table
73
88
  * (`ORG_OWNER → ORG_ADMIN → ORG_MANAGER → ORG_MEMBER → ORG_GUEST`) an `ORG_ADMIN`'s membership row
74
89
  * holds the literal string `ORG_ADMIN` and nothing else, so a raw set-membership test would reject
75
90
  * that admin granting the DEFAULT `ORG_MEMBER` role and break the entire invite flow — while still
@@ -94,6 +109,13 @@ A role string unknown in the passed scope expands to the empty set — fail-clos
94
109
  * `createAsSystem`) is the framework itself, not a user principal (it synthesises a super-admin
95
110
  * system EC), and carries no human ceiling — it is trusted to assign any role.
96
111
  *
112
+ * ONE RULE, SHARED WITH THE FORMS (#3248). The ceiling itself is `resolveRoleGrantCeiling` in
113
+ * `@wildo-ai/saas-models`, which this gate calls with the live role tables and a role-offering form calls with the same
114
+ * tables and the backend's own role entries, so the form and this gate make the same ceiling decision (a form that knew
115
+ * less offered `ORG_OWNER` to an `ORG_ADMIN`, and picking it answered 403). The form decides from the role entries it
116
+ * loaded with the session, so a role changed since can still be refused here, and the write's other checks (a role the
117
+ * organization's type does not offer) still apply: the gate stays the control.
118
+ *
97
119
  * SCOPE OF THE COMPARISON. Only the roles the caller holds IN the organization the write acts inside
98
120
  * (`executionContext.organizationId`) are counted, plus their APPLICATION roles. Until 2026-09-25 the
99
121
  * roles were unioned across every membership, on the stated premise that the authorization layer had
@@ -106,6 +128,8 @@ A role string unknown in the passed scope expands to the empty set — fail-clos
106
128
  * `roles` field is caller-settable, passing the roles AS AUTHORED BY THE CALLER — not the
107
129
  * post-resolution set. Framework-injected defaults (e.g. an organization type's `defaultMemberRole`)
108
130
  * are policy-derived, not a caller request, and must not be measured against the caller's ceiling.
131
+ * Declare the field `.isRoleGrant()` in the same change: a form then offers only the roles the person filling it may
132
+ * grant (plus any the record already holds), decided by this same rule, instead of offering roles this gate refuses.
109
133
  *
110
134
  * THE REFUSAL IS RECORDED — as a `RESOURCE_OPERATION_DENIED` audit event with
111
135
  * `denialReason: role_ceiling_exceeded`, carrying the roles that were refused. A privilege-escalation
@@ -112,16 +112,17 @@ export enum ResourceOperationFrontendSurface {
112
112
  }
113
113
 
114
114
  /**
115
- * Display mode for resource operation action bars — controls operation bar density.
116
- * SUMMARY = compact row actions (icon-only, in list/table rows).
115
+ * Display mode for resource operation action bars — which surface the actions are drawn on, and so how many stay in
116
+ * view. Every direct action shows its words by default (`DEFAULT_ACTION_LABEL_DISPLAY_MODE`, #3066); the rest wait in
117
+ * the `…` menu, which shows words too.
117
118
  *
118
119
  * Note: "summary" here is about *UI density*, not API data shape (see DataMode.SUMMARY)
119
120
  * or FK rendering (see ForeignKeyDisplayMode.SUMMARY).
120
121
  */
121
122
  export enum ResourceOperationDisplayMode {
122
- /** In a list/table row — compact, icon-only, includes "View Details" */
123
+ /** In a list/table row — one direct action beside the record's name (none on a phone), the rest in `…`. The row itself opens the record, so it offers no "View Details". */
123
124
  SUMMARY = 'summary',
124
- /** In a full read/detail view — can show inline labels */
125
+ /** In a full read/detail view (the record header) — three direct actions (one on a phone), the rest in `…`. */
125
126
  DETAIL = 'detail',
126
127
  }
127
128
  ```