@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
@@ -102,6 +102,35 @@ export interface BackendOnlyFieldParams {
102
102
  * material is attributable.
103
103
  */
104
104
  isReturnedAtCreation?: boolean;
105
+ /**
106
+ * `true` declares that this backend-only value is the SUBJECT'S OWN DATA, so a person's ACCESS export (GDPR Art. 15)
107
+ * carries it: `isBackendOnly({ disclosedToSubject: true })`. It changes nothing else: the field is still stripped from
108
+ * every request and response DTO, every listing and every model or tool output.
109
+ *
110
+ * Why it exists (#2958). A subject export reads rows below the DTO projection, so it withholds every backend-only field
111
+ * as a security floor: that is what keeps a password hash or a token hash out of a bundle. Many backend-only fields are
112
+ * not secrets, though. They are kept off the API because a generic reader must not see them (who a pending decision is
113
+ * routed to, when it was decided, which chat card a person was sent), and to the person they are about they are plain
114
+ * personal data. Without this declaration such a row reached its subject with that substance withheld.
115
+ *
116
+ * Declare it only where the value is about the person who receives the export: never on a credential, a secret, a
117
+ * token or a lease, never on a field holding other people's data (a list of everyone a row names). When the row can also
118
+ * reach someone it is NOT about (a conversation's owner, for the id of the person who decided on it), the resource
119
+ * withholds the field from that path as other people's data (`subjectExportOthersDataFields`).
120
+ *
121
+ * A portability export (Art. 20) still withholds it: a backend-only value is written by the system and never provided
122
+ * by the subject through any request, so it is outside what Art. 20 covers.
123
+ *
124
+ * Refused, at the decorator chokepoint and in either order, beside `isPassword()`, `isOtp()`, `isWriteOnlySecret()`,
125
+ * `isEphemeral()` and `isReturnedAtCreation`: each marks a secret. A field the application declares
126
+ * `.dataCategories(CREDENTIALS)` is refused when its resource configuration is built.
127
+ *
128
+ * spec-cite: GDPR Art. 15(1), 15(3) (https://gdpr-info.eu/art-15-gdpr/); Art. 20(1) (https://gdpr-info.eu/art-20-gdpr/)
129
+ *
130
+ * assurance-control: WILDO.PRIVACY.SUBJECT_DATA_EXPORT — a backend-only value about the subject reaches their access
131
+ * export only by this declaration, never by loosening the floor.
132
+ */
133
+ disclosedToSubject?: true;
105
134
  }
106
135
 
107
136
  /**
@@ -279,6 +308,40 @@ export interface BusinessKeySetParams {
279
308
  conflictMessageReference?: string;
280
309
  }
281
310
 
311
+ /**
312
+ * One NON-UNIQUE index over several fields, declared with the object-level `compoundIndex([...])` decorator (#3142).
313
+ *
314
+ * Declare one for a read that filters on some fields and sorts on another, when the table grows without bound: "one
315
+ * organization's audit rows of one event type, newest first" is `['organizationId', 'eventType', 'createdAt']`. Order is
316
+ * the index's identity and decides which reads it serves: the equality filters come first, the sort field last. A read
317
+ * filtering on a leading PREFIX of the list is served as well, so `['organizationId', 'createdAt']` also serves "one
318
+ * organization's rows". The index is walked in either direction, so newest-first needs no descending declaration.
319
+ *
320
+ * Why separate per-field `.isDBIndexed()` declarations are not the same thing: the database may combine two of them for
321
+ * an equality filter, but it cannot use them to return a filtered set already in sort order, so it either sorts the whole
322
+ * filtered set or walks the sort field's index and discards every row of the other tenants. Measured on a 580,000-row
323
+ * PostgreSQL audit trail: 534 ms and 2.2 s through per-field indexes, 1 to 9 ms through the compound one.
324
+ *
325
+ * Uniqueness is NOT what this declares; a composite IDENTITY is `.businessKeySet([...])`. Every field must be declared
326
+ * on the object (checked at decoration time) and STORED (not `.isVirtual()`), there must be at least two (one field is
327
+ * `.isDBIndexed()`), and none may repeat. Several indexes are declared by calling the decorator once per index. An
328
+ * object derived with `.omit()` / `.pick()` keeps only the indexes whose fields it still has. Both storage adapters
329
+ * honour it: MongoDB builds the index (ended on `_id`, as every plain index is, so a paged read's total order is
330
+ * served), and the PostgreSQL plan records it so `wildo db generate` writes the migration that creates it. Not yet
331
+ * supported on the BASE schema of a polymorphic resource, which refuses outer-level metadata it cannot carry to its
332
+ * variants: declare it on a resource whose main schema is a plain object.
333
+ *
334
+ * @example
335
+ * // one tenant's trail, optionally of one event type, newest first
336
+ * z.object({ organizationId: z.string().optional(), eventType: z.string(), createdAt: z.date() })
337
+ * .compoundIndex(['organizationId', 'eventType', 'createdAt'])
338
+ * .compoundIndex(['organizationId', 'createdAt'])
339
+ */
340
+ export interface CompoundIndexParams {
341
+ /** The indexed fields, in index order: equality filters first, the sort field last. */
342
+ fields: string[];
343
+ }
344
+
282
345
  /**
283
346
  * Parameters for the object-level `isResourceReference({ targetSet })` decorator (#2471).
284
347
  *
@@ -110,10 +110,10 @@ export function createMoneySchema(
110
110
 
111
111
  /**
112
112
  * The chainable methods of `DecoratedMoneySchema`, returning `this` so a chain of several decorations keeps
113
- * the type it reached: `.isSummaryField()` turns the field into a `DecoratedPrimitiveZodType<DecoratedMoneySchema>`,
114
- * and a spec or UI method called after it must return that, not the bare factory type. A method
115
- * returning `DecoratedMoneySchema` itself won that overload inside the intersection, so a resource
116
- * specification's field map rejected `schemaShape.x.<factory>Spec(...)` on a decorated field.
113
+ * the type it reached, whatever the receiver is (`typeof field` in a resource specification's field map).
114
+ * A method returning the bare `DecoratedMoneySchema` once won the overload inside the intersection, so that
115
+ * field map rejected `schemaShape.x.<factory>Spec(...)` on a field decorated first. Every other decorator
116
+ * returns the receiver's own type too (#3031), so `.isSummaryField()` leaves the field a `DecoratedMoneySchema`.
117
117
  */
118
118
  export interface DecoratedMoneySchemaMethods {
119
119
  [ZodDecorator.IS_DB_INDEXED](): this;
@@ -572,10 +572,10 @@ export function createDurationSchema(
572
572
 
573
573
  /**
574
574
  * The chainable methods of `DecoratedDurationSchema`, returning `this` so a chain of several decorations keeps
575
- * the type it reached: `.isSummaryField()` turns the field into a `DecoratedPrimitiveZodType<DecoratedDurationSchema>`,
576
- * and a spec or UI method called after it must return that, not the bare factory type. A method
577
- * returning `DecoratedDurationSchema` itself won that overload inside the intersection, so a resource
578
- * specification's field map rejected `schemaShape.x.<factory>Spec(...)` on a decorated field.
575
+ * the type it reached, whatever the receiver is (`typeof field` in a resource specification's field map).
576
+ * A method returning the bare `DecoratedDurationSchema` once won the overload inside the intersection, so that
577
+ * field map rejected `schemaShape.x.<factory>Spec(...)` on a field decorated first. Every other decorator
578
+ * returns the receiver's own type too (#3031), so `.isSummaryField()` leaves the field a `DecoratedDurationSchema`.
579
579
  */
580
580
  export interface DecoratedDurationSchemaMethods {
581
581
  [ZodDecorator.IS_DB_INDEXED](): this;
@@ -685,10 +685,10 @@ export function createPhoneSchema(options: PhoneSchemaOptions = {}): DecoratedPh
685
685
 
686
686
  /**
687
687
  * The chainable methods of `DecoratedPhoneSchema`, returning `this` so a chain of several decorations keeps
688
- * the type it reached: `.isSummaryField()` turns the field into a `DecoratedPrimitiveZodType<DecoratedPhoneSchema>`,
689
- * and a spec or UI method called after it must return that, not the bare factory type. A method
690
- * returning `DecoratedPhoneSchema` itself won that overload inside the intersection, so a resource
691
- * specification's field map rejected `schemaShape.x.<factory>Spec(...)` on a decorated field.
688
+ * the type it reached, whatever the receiver is (`typeof field` in a resource specification's field map).
689
+ * A method returning the bare `DecoratedPhoneSchema` once won the overload inside the intersection, so that
690
+ * field map rejected `schemaShape.x.<factory>Spec(...)` on a field decorated first. Every other decorator
691
+ * returns the receiver's own type too (#3031), so `.isSummaryField()` leaves the field a `DecoratedPhoneSchema`.
692
692
  */
693
693
  export interface DecoratedPhoneSchemaMethods {
694
694
  [ZodDecorator.IS_DB_INDEXED](): this;
@@ -937,10 +937,10 @@ export function createCodeSchema(
937
937
 
938
938
  /**
939
939
  * The chainable methods of `DecoratedCodeSchema`, returning `this` so a chain of several decorations keeps
940
- * the type it reached: `.isSummaryField()` turns the field into a `DecoratedPrimitiveZodType<DecoratedCodeSchema>`,
941
- * and a spec or UI method called after it must return that, not the bare factory type. A method
942
- * returning `DecoratedCodeSchema` itself won that overload inside the intersection, so a resource
943
- * specification's field map rejected `schemaShape.x.<factory>Spec(...)` on a decorated field.
940
+ * the type it reached, whatever the receiver is (`typeof field` in a resource specification's field map).
941
+ * A method returning the bare `DecoratedCodeSchema` once won the overload inside the intersection, so that
942
+ * field map rejected `schemaShape.x.<factory>Spec(...)` on a field decorated first. Every other decorator
943
+ * returns the receiver's own type too (#3031), so `.isSummaryField()` leaves the field a `DecoratedCodeSchema`.
944
944
  */
945
945
  export interface DecoratedCodeSchemaMethods {
946
946
  [ZodDecorator.IS_DB_INDEXED](): this;
@@ -1096,10 +1096,10 @@ export function createBigDecimalSchema(
1096
1096
 
1097
1097
  /**
1098
1098
  * The chainable methods of `DecoratedBigDecimalSchema`, returning `this` so a chain of several decorations keeps
1099
- * the type it reached: `.isSummaryField()` turns the field into a `DecoratedPrimitiveZodType<DecoratedBigDecimalSchema>`,
1100
- * and a spec or UI method called after it must return that, not the bare factory type. A method
1101
- * returning `DecoratedBigDecimalSchema` itself won that overload inside the intersection, so a resource
1102
- * specification's field map rejected `schemaShape.x.<factory>Spec(...)` on a decorated field.
1099
+ * the type it reached, whatever the receiver is (`typeof field` in a resource specification's field map).
1100
+ * A method returning the bare `DecoratedBigDecimalSchema` once won the overload inside the intersection, so that
1101
+ * field map rejected `schemaShape.x.<factory>Spec(...)` on a field decorated first. Every other decorator
1102
+ * returns the receiver's own type too (#3031), so `.isSummaryField()` leaves the field a `DecoratedBigDecimalSchema`.
1103
1103
  */
1104
1104
  export interface DecoratedBigDecimalSchemaMethods {
1105
1105
  [ZodDecorator.IS_DB_INDEXED](): this;
@@ -1156,6 +1156,86 @@ export function z_bigdecimal(
1156
1156
  }
1157
1157
  ```
1158
1158
 
1159
+ ## Year-Month
1160
+
1161
+ ## Import Origins
1162
+
1163
+ - `@wildo-ai/zod-decorators`
1164
+
1165
+ ## Source Excerpts
1166
+
1167
+ ### Origin Package: `@wildo-ai/zod-decorators`
1168
+
1169
+ ```typescript
1170
+ /**
1171
+ * The shape of a YEAR-MONTH value: a calendar month written `YYYY-MM` (`2026-10`), month `01`–`12`.
1172
+ *
1173
+ * A year-month carries no day, no time and no time zone. It is stored as this string because the string is what every
1174
+ * party agrees on: it sorts chronologically as text, it makes a natural part of a unique key (one budget per department
1175
+ * per month), and no reader's zone can move it into the neighbouring month the way a `Date` at midnight can.
1176
+ */
1177
+ export const YEAR_MONTH_PATTERN: RegExp = /^\d{4}-(0[1-9]|1[0-2])$/;
1178
+
1179
+ /**
1180
+ * A YEAR-MONTH field: one calendar month, stored `YYYY-MM`. Use it for a period whose grain is the month — a monthly
1181
+ * budget, a billing month, a reporting period — instead of a `z.date()` pinned to the first of the month (whose day and
1182
+ * zone mean nothing) or a bare `z.string()` the user has to type.
1183
+ *
1184
+ * What the field gets from the framework:
1185
+ * - the stored value is validated against {@link YEAR_MONTH_PATTERN} on every write, server side included;
1186
+ * - it is READ as a month and a year in the reader's locale ("October 2026", "octobre 2026"), everywhere the value is
1187
+ * shown (`StringDisplayMode.YEAR_MONTH`);
1188
+ * - it is EDITED with a month-and-year picker that writes `YYYY-MM` (`StringEditMode.YEAR_MONTH`).
1189
+ *
1190
+ * Chain the structural decorators as on any string (`.isDBIndexed()`, `.isUnique({ compoundWith })`, `.optional()`).
1191
+ *
1192
+ * @example
1193
+ * ```typescript
1194
+ * import { z_yearMonth } from '@wildo-ai/zod-decorators';
1195
+ *
1196
+ * period: z_yearMonth().isDBIndexed().isUnique({ compoundWith: 'organizationUnitId' }),
1197
+ * ```
1198
+ */
1199
+ export function z_yearMonth(): z.ZodString {
1200
+ return z.string().regex(YEAR_MONTH_PATTERN).stringUI({
1201
+ display: { displayMode: StringDisplayMode.YEAR_MONTH },
1202
+ edit: { editMode: StringEditMode.YEAR_MONTH },
1203
+ });
1204
+ }
1205
+ ```
1206
+
1207
+ ### Origin Package: `@wildo-ai/zod-decorators`
1208
+
1209
+ ```typescript
1210
+ /**
1211
+ * Does this schema hold a YEAR-MONTH (`YYYY-MM`)? The one question a filter panel, a chip, the companion or a
1212
+ * specification asks of a field before treating it as a month, so none of them re-derives the answer from a UI mode.
1213
+ *
1214
+ * Answered from what the schema ENFORCES first: a string validated against {@link YEAR_MONTH_PATTERN} holds a
1215
+ * year-month whatever its UI says, which is the guarantee `z_yearMonth()` makes. That is the structural marker, and it
1216
+ * survives an author re-declaring the field's display or edit mode (`.stringUI({ display: … })` replaces the display
1217
+ * mode and nothing else). A field that declares the year-month display or edit mode without the pattern counts too:
1218
+ * its author said its values are months, and the picker writes nothing else. Wrappers (`.optional()`, `.default()`,
1219
+ * `.nullable()`, a pipe's input) are looked through; a year-month on the OUTPUT side of a pipe is not seen.
1220
+ *
1221
+ * Because the pattern wins, a `z_yearMonth()` whose author re-declares the edit mode as a text input still answers
1222
+ * `true`: the form then shows the text input the author chose, and a list filter over it still offers the month picker.
1223
+ *
1224
+ * @example
1225
+ * ```typescript
1226
+ * isYearMonthField(z_yearMonth().optional()); // true
1227
+ * isYearMonthField(z.string()); // false
1228
+ * ```
1229
+ */
1230
+ export function isYearMonthField(schema: z.ZodTypeAny | undefined): boolean {
1231
+ if (!schema) return false;
1232
+ if (getZodType(unwrapSchema(schema)) !== 'string') return false;
1233
+ if (enforcesYearMonthPattern(schema)) return true;
1234
+ const ui = getStringUI(schema);
1235
+ return ui?.edit?.editMode === StringEditMode.YEAR_MONTH || ui?.display?.displayMode === StringDisplayMode.YEAR_MONTH;
1236
+ }
1237
+ ```
1238
+
1159
1239
  ## File Schema
1160
1240
 
1161
1241
  ## Import Origins
@@ -1453,9 +1533,10 @@ export function createFileSchema(
1453
1533
  * re-declaring them made both interfaces below fail TS2320: an interface may not extend two types
1454
1534
  * whose same-named member differs, and `TSelf` is not `DecoratedPrimitiveZodType<this>`.
1455
1535
  *
1456
- * Removing the mixin costs nothing, because `DecoratedPrimitiveZodType<T>` is `T & { … }` — an
1457
- * INTERSECTION. `z_file().isHidden()` still returns something assignable to `DecoratedFileSchema`,
1458
- * and the full decorator surface is now available rather than the four this mixin listed.
1536
+ * Removing the mixin costs nothing: every `ZodObject` decorator returns `DecoratedPrimitiveZodType<this>`,
1537
+ * which is `this` itself (#3031), and `this` is `DecoratedFileSchema` here. So `z_file().isHidden()`
1538
+ * stays a `DecoratedFileSchema`, keeps `fileUI`/`fileSpec`, and offers every decorator the `ZodObject`
1539
+ * augmentation declares rather than the four this mixin listed.
1459
1540
  */
1460
1541
 
1461
1542
  /**
@@ -102,6 +102,35 @@ export interface BackendOnlyFieldParams {
102
102
  * material is attributable.
103
103
  */
104
104
  isReturnedAtCreation?: boolean;
105
+ /**
106
+ * `true` declares that this backend-only value is the SUBJECT'S OWN DATA, so a person's ACCESS export (GDPR Art. 15)
107
+ * carries it: `isBackendOnly({ disclosedToSubject: true })`. It changes nothing else: the field is still stripped from
108
+ * every request and response DTO, every listing and every model or tool output.
109
+ *
110
+ * Why it exists (#2958). A subject export reads rows below the DTO projection, so it withholds every backend-only field
111
+ * as a security floor: that is what keeps a password hash or a token hash out of a bundle. Many backend-only fields are
112
+ * not secrets, though. They are kept off the API because a generic reader must not see them (who a pending decision is
113
+ * routed to, when it was decided, which chat card a person was sent), and to the person they are about they are plain
114
+ * personal data. Without this declaration such a row reached its subject with that substance withheld.
115
+ *
116
+ * Declare it only where the value is about the person who receives the export: never on a credential, a secret, a
117
+ * token or a lease, never on a field holding other people's data (a list of everyone a row names). When the row can also
118
+ * reach someone it is NOT about (a conversation's owner, for the id of the person who decided on it), the resource
119
+ * withholds the field from that path as other people's data (`subjectExportOthersDataFields`).
120
+ *
121
+ * A portability export (Art. 20) still withholds it: a backend-only value is written by the system and never provided
122
+ * by the subject through any request, so it is outside what Art. 20 covers.
123
+ *
124
+ * Refused, at the decorator chokepoint and in either order, beside `isPassword()`, `isOtp()`, `isWriteOnlySecret()`,
125
+ * `isEphemeral()` and `isReturnedAtCreation`: each marks a secret. A field the application declares
126
+ * `.dataCategories(CREDENTIALS)` is refused when its resource configuration is built.
127
+ *
128
+ * spec-cite: GDPR Art. 15(1), 15(3) (https://gdpr-info.eu/art-15-gdpr/); Art. 20(1) (https://gdpr-info.eu/art-20-gdpr/)
129
+ *
130
+ * assurance-control: WILDO.PRIVACY.SUBJECT_DATA_EXPORT — a backend-only value about the subject reaches their access
131
+ * export only by this declaration, never by loosening the floor.
132
+ */
133
+ disclosedToSubject?: true;
105
134
  }
106
135
 
107
136
  /**
@@ -469,6 +498,40 @@ export interface BusinessKeySetParams {
469
498
  conflictMessageReference?: string;
470
499
  }
471
500
 
501
+ /**
502
+ * One NON-UNIQUE index over several fields, declared with the object-level `compoundIndex([...])` decorator (#3142).
503
+ *
504
+ * Declare one for a read that filters on some fields and sorts on another, when the table grows without bound: "one
505
+ * organization's audit rows of one event type, newest first" is `['organizationId', 'eventType', 'createdAt']`. Order is
506
+ * the index's identity and decides which reads it serves: the equality filters come first, the sort field last. A read
507
+ * filtering on a leading PREFIX of the list is served as well, so `['organizationId', 'createdAt']` also serves "one
508
+ * organization's rows". The index is walked in either direction, so newest-first needs no descending declaration.
509
+ *
510
+ * Why separate per-field `.isDBIndexed()` declarations are not the same thing: the database may combine two of them for
511
+ * an equality filter, but it cannot use them to return a filtered set already in sort order, so it either sorts the whole
512
+ * filtered set or walks the sort field's index and discards every row of the other tenants. Measured on a 580,000-row
513
+ * PostgreSQL audit trail: 534 ms and 2.2 s through per-field indexes, 1 to 9 ms through the compound one.
514
+ *
515
+ * Uniqueness is NOT what this declares; a composite IDENTITY is `.businessKeySet([...])`. Every field must be declared
516
+ * on the object (checked at decoration time) and STORED (not `.isVirtual()`), there must be at least two (one field is
517
+ * `.isDBIndexed()`), and none may repeat. Several indexes are declared by calling the decorator once per index. An
518
+ * object derived with `.omit()` / `.pick()` keeps only the indexes whose fields it still has. Both storage adapters
519
+ * honour it: MongoDB builds the index (ended on `_id`, as every plain index is, so a paged read's total order is
520
+ * served), and the PostgreSQL plan records it so `wildo db generate` writes the migration that creates it. Not yet
521
+ * supported on the BASE schema of a polymorphic resource, which refuses outer-level metadata it cannot carry to its
522
+ * variants: declare it on a resource whose main schema is a plain object.
523
+ *
524
+ * @example
525
+ * // one tenant's trail, optionally of one event type, newest first
526
+ * z.object({ organizationId: z.string().optional(), eventType: z.string(), createdAt: z.date() })
527
+ * .compoundIndex(['organizationId', 'eventType', 'createdAt'])
528
+ * .compoundIndex(['organizationId', 'createdAt'])
529
+ */
530
+ export interface CompoundIndexParams {
531
+ /** The indexed fields, in index order: equality filters first, the sort field last. */
532
+ fields: string[];
533
+ }
534
+
472
535
  /**
473
536
  * Parameters for the object-level `isResourceReference({ targetSet })` decorator (#2471).
474
537
  *
@@ -800,6 +863,50 @@ function assertCalendarDateNotDateTime(decorator: ZodDecorator, currentMetadata:
800
863
  }
801
864
  }
802
865
 
866
+ /**
867
+ * The decorators that mark a value as a SECRET, each with the reason a subject-disclosed backend-only field
868
+ * (`isBackendOnly({ disclosedToSubject: true })`, #2958) may never carry it. One table, consulted in both application
869
+ * orders by {@link assertSubjectDisclosureAdmissible}, at the same chokepoint as the RAG-source pairs, so no door into the
870
+ * metadata bypasses it.
871
+ */
872
+ const SUBJECT_DISCLOSURE_REFUSED_COMPANIONS: ReadonlyMap<ZodDecorator, string> = new Map([
873
+ [ZodDecorator.IS_PASSWORD, 'a password never leaves the backend, not even to the person it belongs to.'],
874
+ [ZodDecorator.IS_OTP, 'a one-time code never leaves the backend once it was sent.'],
875
+ [ZodDecorator.IS_WRITE_ONLY_SECRET, 'a write-only secret is masked on every response, so it is not disclosed to anyone.'],
876
+ [ZodDecorator.IS_EPHEMERAL, 'an ephemeral value is shown once, when it is minted, and never again.'],
877
+ ]);
878
+
879
+ /** Whether a stored `IS_BACKEND_ONLY` value declares the subject-disclosure opt-in. */
880
+ function declaresDisclosedToSubject(value: unknown): boolean {
881
+ return typeof value === 'object' && value !== null && (value as BackendOnlyFieldParams).disclosedToSubject === true;
882
+ }
883
+
884
+ /**
885
+ * Refuse `isBackendOnly({ disclosedToSubject: true })` on a field that holds a secret, in either order (#2958): applied to
886
+ * a field already marked a secret, applied with `isReturnedAtCreation` (a server-minted secret shown once), or a secret
887
+ * marker applied to a field already opted in. Run after an updater is resolved, so an updater that adds the opt-in is
888
+ * checked too, and before anything is written.
889
+ */
890
+ function assertSubjectDisclosureAdmissible(decorator: ZodDecorator, params: unknown, currentMetadata: CustomFieldMetadata): void {
891
+ if (decorator === ZodDecorator.IS_BACKEND_ONLY) {
892
+ if (!declaresDisclosedToSubject(params)) return;
893
+ if ((params as BackendOnlyFieldParams).isReturnedAtCreation) {
894
+ throw new Error('isBackendOnly() cannot declare both disclosedToSubject and isReturnedAtCreation: a value returned once at creation is a '
895
+ + 'server-minted secret, and a subject export never discloses a secret.');
896
+ }
897
+ for (const [companion, reason] of SUBJECT_DISCLOSURE_REFUSED_COMPANIONS) {
898
+ if (currentMetadata[companion] !== undefined) {
899
+ throw new Error(`isBackendOnly({ disclosedToSubject: true }) cannot be combined with ${companion}(): ${reason}`);
900
+ }
901
+ }
902
+ return;
903
+ }
904
+ const reason = SUBJECT_DISCLOSURE_REFUSED_COMPANIONS.get(decorator);
905
+ if (reason !== undefined && declaresDisclosedToSubject(currentMetadata[ZodDecorator.IS_BACKEND_ONLY])) {
906
+ throw new Error(`${decorator}() cannot be combined with isBackendOnly({ disclosedToSubject: true }): ${reason}`);
907
+ }
908
+ }
909
+
803
910
  function applySingleDecorator<T extends z.ZodTypeAny>(
804
911
  schema: T,
805
912
  decorator: ZodDecorator,
@@ -829,6 +936,8 @@ function applySingleDecorator<T extends z.ZodTypeAny>(
829
936
  params = (params as (current: unknown) => unknown)(currentValue) as typeof params;
830
937
  resolvedFromUpdater = true;
831
938
  }
939
+ // A subject-disclosed backend-only field never holds a secret (#2958). Checked on the RESOLVED params, before any write.
940
+ assertSubjectDisclosureAdmissible(decorator, params, currentMetadata);
832
941
  // After function resolution, params is a concrete value (never a function).
833
942
  // TypeScript can't narrow this from control flow. Use `rp<D>()` for typed
834
943
  // access in cases that read properties; use `p` for simple assignments.
@@ -988,6 +1097,9 @@ function applySingleDecorator<T extends z.ZodTypeAny>(
988
1097
  case ZodDecorator.IS_DECIDER:
989
1098
  currentMetadata[ZodDecorator.IS_DECIDER] = true;
990
1099
  break;
1100
+ case ZodDecorator.IS_ROLE_GRANT:
1101
+ currentMetadata[ZodDecorator.IS_ROLE_GRANT] = true;
1102
+ break;
991
1103
  case ZodDecorator.RAG_SOURCE: {
992
1104
  // NORMALIZE HERE, not in the doors — the impersonalizeWith discipline. A bare `.ragSource()`
993
1105
  // (the common case) stores `{}` rather than `true`/`undefined`, so every reader sees ONE
@@ -1065,6 +1177,17 @@ function applySingleDecorator<T extends z.ZodTypeAny>(
1065
1177
  case ZodDecorator.OBJECT_BUSINESS_KEY_SET:
1066
1178
  currentMetadata[ZodDecorator.OBJECT_BUSINESS_KEY_SET] = p;
1067
1179
  break;
1180
+ case ZodDecorator.OBJECT_COMPOUND_INDEX: {
1181
+ // ACCUMULATES: each call declares one more index. A fresh array, never a push, so the schema this one was
1182
+ // derived from keeps its own list (decorators are builders, #1308). The same field list twice is one index.
1183
+ const existing = (currentMetadata[ZodDecorator.OBJECT_COMPOUND_INDEX] ?? []) as CompoundIndexParams[];
1184
+ const declared = p as CompoundIndexParams;
1185
+ const key = declared.fields.join('\u0000');
1186
+ currentMetadata[ZodDecorator.OBJECT_COMPOUND_INDEX] = existing.some((index) => index.fields.join('\u0000') === key)
1187
+ ? existing
1188
+ : [...existing, { fields: [...declared.fields] }];
1189
+ break;
1190
+ }
1068
1191
  case ZodDecorator.RESOURCE_REFERENCE:
1069
1192
  currentMetadata[ZodDecorator.RESOURCE_REFERENCE] = p;
1070
1193
  break;
@@ -15,6 +15,7 @@ Use this file when you already know the field belongs in
15
15
  | Sensitive backend-only field | `.isBackendOnly()` | This is the security boundary. |
16
16
  | Discriminator field | `.isDiscriminator()` | Required when schema-family behavior depends on the field. |
17
17
  | Frequently queried field | `.isDBIndexed()` | Use for real query/filter/join needs, not by habit. |
18
+ | A read that filters on some fields and sorts on another, on a table that keeps growing | `.compoundIndex(['organizationId', 'status', 'createdAt'])` on the OBJECT schema, once per index | Not unique (a composite identity is `.businessKeySet([...])`). Order is the index: equality filters first, the sort field last; a read filtering on a leading prefix is served too, and either sort direction is. Per-field `.isDBIndexed()` cannot return a filtered set in sort order, so on a large table the database sorts or scans instead. At least two fields, all declared on the object and stored (not virtual). Not yet on a polymorphic resource's base schema. |
18
19
  | A reference to a row of a resource chosen at run time | `.isResourceReference({ targetSet })` on the `{ resourceType, resourceId }` object | For a reference whose resource TYPE is not fixed, such as a case of any work-unit resource. Reuse `WorkUnitRefSchema` (cases) or `AgentWorkSubjectRefSchema` (case subjects) from `@wildo-ai/saas-models` rather than declaring a new object. The form then offers the published types, then the rows of the chosen one. Not `.isForeignKey()`: a foreign key names one fixed target through a relationship, and inside a nested object it changes how the id is stored. |
19
20
  | What the last action said about itself | `.isLastActionRecord()` | For a row field an action REPLACES with its own words, such as the reason given for a decision or the justification for a reassignment. A verb's form starts from the row, so without it "Suspend" opens with the reason the previous acceptance was given. Never on a setting an action edits from its current value (a disclosure level, a list of admitted agents): starting from the current value is what makes that form safe to submit. |
20
21
  | Which person decided something on the row | `.isDecider()` | For a field recording WHO took a decision on the row (`approvedByUserId`, `decidedByUserId`, `placedByUserId`). Declare on the operation that writes it whether the decision is sealed, naming the field (`approvalSeal: { capture: ApprovalPresentationCapture.NONE, reason, decides: ['approvedByUserId'] }`: an application's operations do not seal; a decision on something proposed is taken on a decision plane, which seals it, see `config-saas`'s key-management reference). The engine checks this over its own resources; nothing checks an application's yet, so the marker and the declaration are yours to keep together. Not on a field naming who CREATED or INVITED something, which decides nothing. |
@@ -15,6 +15,7 @@ flattened into a plain primitive.
15
15
  | `z_address(options?)` | `{ line1, line2?, city, state?, postalCode?, country, coordinates? }` | Postal addresses that must be validated, normalized, compared (`isSameAddress`) or carry a geocode |
16
16
  | `z_code(options?)` | `{ content, language }` | Code snippets or editable code payloads |
17
17
  | `z_bigdecimal(options?)` | decimal string | Arbitrary precision numeric values |
18
+ | `z_yearMonth()` | `YYYY-MM` string | A period whose grain is the month (a monthly budget, a billing month): read as "October 2026" in the reader's language, picked as a month and a year, and filtered by a month picker (or a range of months, with `Resources_Filter_YearMonthRangeSchema` in `filterFields`). `isYearMonthField(schema)` answers whether a schema holds one. Never a `z.date()` pinned to the 1st, never a bare string the user types |
18
19
 
19
20
  ## Not a factory: `versioned` / `z_foreignKeyVersioned`
20
21
 
@@ -27,6 +28,47 @@ for document versions or an audit history: you would get an ordinary field whose
27
28
  mechanism that does not exist. Model the requirement explicitly instead — a child resource carrying
28
29
  the revisions, or a retained row (see `framework-erasure-scrub-treatments-api.md`).
29
30
 
31
+ ## Dates: always `z.date()`
32
+
33
+ Every date you declare is `z.date()`: on a resource, in a custom operation's request or response, in a batch's input
34
+ or output, in an inbound handler's payload, in an agent tool's arguments or an agent's structured output. JSON carries a
35
+ date as an RFC 3339 string (`"2026-11-07T10:00:00Z"`, or a calendar day `"2026-11-07"`), and the framework reads that
36
+ form for you wherever it parses JSON: requests and responses, WebSocket and queue messages, inbound deliveries, agent
37
+ tool calls and structured output, batch input. It reads RFC 3339 only: `"May 2"` or `"2026-02-30"` is refused, never
38
+ guessed into a date.
39
+
40
+ When your own code parses JSON the framework did not parse for you (a response your code fetched, a file it read), parse
41
+ it with `jsonParsingSchemaOf` from `@wildo-ai/saas-models` rather than with the schema you declared, which would refuse
42
+ the string:
43
+
44
+ ```ts
45
+ import { jsonParsingSchemaOf } from '@wildo-ai/saas-models';
46
+
47
+ const invoice = jsonParsingSchemaOf(InvoiceSchema).parse(await response.json()); // invoice.issuedAt is a Date
48
+ ```
49
+
50
+ That is for JSON from somewhere else. A response from your OWN backend comes through the framework client
51
+ (`doOperation` and the resource hooks), which already reads its dates; do not re-parse it with a shared schema, which may
52
+ declare fields the server strips before sending (a backend-only field) and would then refuse every real response.
53
+
54
+ Never write `z.coerce.date()`: it turns `null` into `1970-01-01T00:00:00.000Z` and accepts it as a date.
55
+
56
+ A date another system writes in its own form is not RFC 3339. A timestamp in SECONDS (Stripe's `created`, a Unix time)
57
+ is `z.number()`: a number is read as milliseconds, so seconds would land in January 1970. A `"YYYY-MM-DD HH:MM:SS"`
58
+ string, which names no zone, is `z.string()`. Convert either yourself.
59
+
60
+ Two providers are read for you, so their dates are `z.date()`: an OData v2 service's `/Date(<ms>)/`, and Odoo's
61
+ `"YYYY-MM-DD HH:MM:SS"`, which Odoo always writes in UTC. Odoo's form is read as UTC on an Odoo read-through field whose
62
+ schema is `z.date()` (a field declared `z.string()` keeps the text), and by a pipeline mapping declaring
63
+ `ISO_STRING_TO_DATE` on an Odoo source. A `Date` you filter on or write is sent to Odoo in that same form.
64
+
65
+ A rule about time (an expiry that must be in the future) belongs on the REQUEST of the operation that sets the value
66
+ (its `customRequestDto` field), never on the stored field: a date's checks also run when a record is read back, so a
67
+ "must be in the future" rule on the resource's own field would refuse every record whose date has since passed. Write
68
+ it as a refinement, checked against the clock at each parse, with some allowance for a client clock that runs behind:
69
+ `z.date().refine((at) => at.getTime() > Date.now() - 5 * 60_000, 'Must be in the future')`. Never `.min(new Date())`:
70
+ its bound is the moment the module loaded.
71
+
30
72
  ## Shared-Layer Rule
31
73
 
32
74
  These helpers still belong to the shared schema layer because they define
@@ -61,6 +103,36 @@ Two startup refusals to expect:
61
103
 
62
104
  A PDF-generated `z_file` cannot carry `scanPolicy`; it is an upload option.
63
105
 
106
+ ## Attaching an uploaded file is a second write
107
+
108
+ An uploadable `z_file` field gets an upload route on its resource wherever the resource exposes the
109
+ operation it belongs to: `POST …/<resource>/files/<field>` beside the API CREATE (before the record
110
+ exists) and `POST …/<resource>/<id>/files/<field>` beside the API UPDATE (`<field>` is the field name in kebab-case: `proofDocument` → `proof-document`). Either one only STAGES a
111
+ file: it checks the caller may write the record, validates the bytes against the field, stores and
112
+ scans them, and answers the new `fileId` with its `readiness`. **It never writes the record.** The
113
+ record carries the file once a CREATE or UPDATE sets the field, and that write is also where the
114
+ resource's own rules run (a field frozen in some status, a role that may not edit it). The generated
115
+ form does both steps for you.
116
+
117
+ Code that calls the API directly (a script, an integration, a test) must make the second write too:
118
+
119
+ 1. upload, and keep `file.fileId` from the answer;
120
+ 2. poll `GET /files/<fileId>/metadata` until `readiness` is `ready` (`processing` means the scanner
121
+ still holds it; `unavailable` means it can never be attached);
122
+ 3. `PUT …/<resource>/<id>` setting the field:
123
+ - a single-file field takes `{ "<field>": { "fileId": "…" } }`;
124
+ - a multi-file field takes `{ "<field>": { "fileIds": [ … ] } }`, and the list
125
+ REPLACES the field's files: send the files already attached plus the new one, or the ones you
126
+ leave out are detached.
127
+
128
+ `updatedAt` is optional on a write: the server sets it. Send back the value you read to leave it unchanged.
129
+
130
+ The same principal must upload and attach: a staged file can be attached only by its uploader, and
131
+ anyone else is answered as if the file did not exist. Once attached, the file is linked to the record
132
+ and its metadata reads `attached`. An upload nobody attaches is reaped by the cleanup batch, and
133
+ anything that reads the field (text extraction, retrieval, a verification that requires a proof)
134
+ sees no file.
135
+
64
136
  ## Do Not Flatten Them
65
137
 
66
138
  Avoid replacing a domain factory with a plain primitive just because it is
@@ -77,7 +77,25 @@ naming them. Give transitions a customer relies on `riskLevel: HIGH`, which audi
77
77
 
78
78
  Every variant of a transition needs its own `enabledCondition`: a second variant (an administrator's,
79
79
  say) without one is not checked against the starting state at all. Two transitions arriving at the
80
- same moment are not serialized; the worked example says why, and why that is not yours to fix.
80
+ same moment cannot both land: the engine makes the write conditional on the fields the condition read,
81
+ so the second is refused with 409 `version_conflict` (re-read the record and decide again). A transition
82
+ that runs in a transaction, as the engine's own status verbs do, is judged again on the committed row
83
+ instead, so its loser gets the same refusal a later call gets. That is why the condition should read
84
+ the row's scalar fields directly (`currentObject.status === …`): a condition that copies or enumerates
85
+ the row (`{ ...currentObject }`, `Object.keys`), or reads a date, an array or an object, also pins the
86
+ row's version, so any concurrent ordinary edit refuses the transition.
87
+
88
+ **The condition must say everything the transition refuses**, because the same function decides whether
89
+ the action is OFFERED. A handler that refuses on its own ("not while the request is a draft", "you cannot
90
+ approve your own request") while the condition says nothing offers an action that then fails: the person
91
+ clicks "Approve" on a draft and reads an error. So:
92
+
93
+ - **Write the lifecycle once, as data**: a table of the states each transition leaves from
94
+ (`Record<Operations, ReadonlySet<Status>>`) beside the operations enum, read by every condition and by
95
+ any check a handler keeps. Six inline comparisons drift apart; one table cannot.
96
+ - **Say who in the condition too.** A transition only the record's author may take, or that its author
97
+ may never take, compares the owner field with `initiatorIds.userId`, and lists that field in
98
+ `enabledConditionFields` so list rows carry it. See `references/framework-operation-condition-parameters-api.md`.
81
99
 
82
100
  ### Step 4 — Freeze what is locked or final
83
101
 
@@ -96,6 +114,16 @@ a `postfixCoreOperations` hook that creates the target through `utils.servicesRe
96
114
  The UI offers each operation as an action and hides it while its `enabledCondition` is false; show the
97
115
  status read-only (`resource-ui-behavior`), never as an editable select.
98
116
 
117
+ What the person sees when a transition is unavailable:
118
+
119
+ - a list row hides the action; a record page shows it disabled, with the reason generated from the
120
+ operation's `unavailableWhen` in its specification (`spec-resource-update`). Write that sentence for
121
+ every transition. Give the view `actionVisibility: WHEN_AVAILABLE` in the ui-behavior to hide it
122
+ there too;
123
+ - a call made anyway (an old tab, an API client) is refused by the engine before any hook, as 403
124
+ `service_resource_operation_disabled`, and the toast speaks the same `unavailableWhen` sentence.
125
+ A refusal the handler raises for any other reason carries a declared code (`backend-custom-operation`).
126
+
99
127
  ## Worked Example
100
128
 
101
129
  A quote's DRAFT → SENT → ACCEPTED / DECLINED lifecycle, frozen once sent, with what each line earns:
@@ -105,6 +133,7 @@ A quote's DRAFT → SENT → ACCEPTED / DECLINED lifecycle, frozen once sent, wi
105
133
 
106
134
  - `references/quote-lifecycle-worked-example.md` — the source-backed schema, relationship and configuration of a complete lifecycle.
107
135
  - `references/commercial-documents.md` — what makes a quote, order or invoice trustworthy (number, money, lines, server total, freeze, PDF), routed to the skill that owns each part.
136
+ - `references/framework-operation-condition-parameters-api.md` — what a condition receives (the row, the person asking), and why it must say everything the transition refuses.
108
137
 
109
138
  ## Verification
110
139
 
@@ -112,6 +141,8 @@ A quote's DRAFT → SENT → ACCEPTED / DECLINED lifecycle, frozen once sent, wi
112
141
  - [ ] Every transition has `resourceOperationLike: UPDATE`, an empty `requestDto`, an `enabledCondition` and `authoritativeFields`.
113
142
  - [ ] UPDATE has an `enabledCondition` when the resource has a locked or final state.
114
143
  - [ ] A transition that creates another resource has a `transactionalCore` implementation.
144
+ - [ ] Every state or person check a transition's handler makes is also in its `enabledCondition`, read from one table of source states.
145
+ - [ ] Every transition's specification states `unavailableWhen`.
115
146
 
116
147
  ### Grep invariants
117
148
 
@@ -125,7 +156,12 @@ rg -c "resourceOperationLike: CoreResourceOperation.UPDATE" shared-lib/src/modul
125
156
  # every transition declares an EMPTY body: this count equals T (an absent requestDto inherits UPDATE's whole body)
126
157
  rg -c "requestDto: z.object\(\{\}\)" shared-lib/src/modules --glob '*.resources-config.ts'
127
158
  # every transition names its starting state: this count is T, plus 1 when UPDATE is frozen (the worked example: 3 + 1 = 4)
128
- rg -c "enabledCondition" shared-lib/src/modules --glob '*.resources-config.ts'
159
+ rg -c "enabledCondition:" shared-lib/src/modules --glob '*.resources-config.ts'
160
+ # a handler refusing on state or person: each hit must be mirrored by its operation's enabledCondition
161
+ # (a lexical sweep: it finds comparisons and table look-ups, not a refusal written any other way, so read each handler too)
162
+ rg -n "status !==|status ===|initiatorIds|SOURCE_STATUSES|LeavesFrom" backend-api/src/modules
163
+ # every transition says why it can be unavailable: this count equals the enabledCondition count above
164
+ rg -c "unavailableWhen" specifications/src/modules --glob '*.resource.specification.ts'
129
165
  ```
130
166
 
131
167
  ## Common Rationalizations
@@ -134,6 +170,8 @@ rg -c "enabledCondition" shared-lib/src/modules --glob '*.resources-config.ts'
134
170
  |---|---|
135
171
  | "A status select on the edit form is simpler" | It lets any state jump to any other and stamps nothing. The engine can only refuse a move it sees as an operation. |
136
172
  | "`enabledCondition` just hides the button" | The engine evaluates it on the backend before the operation runs and refuses the call. It is the guard. |
173
+ | "The handler already refuses a draft, so the condition can stay simple" | The condition is also what OFFERS the action. A check only the handler makes shows the person an action that fails when they press it (measured: "Department-head decision" offered on a draft, then refused with 409). |
174
+ | "Who may act is the `roles` gate's job" | Roles say which people may ever act. "Not on your own request" and "only the requester" are about this row and this person, which a role cannot express: compare the owner field with `initiatorIds.userId` in the condition. |
137
175
  | "The prefix sets `status`, so I don't need `authoritativeFields`" | It works over HTTP, and silently writes nothing when an MCP tool or another service calls the transition with `status` already in its payload: the strict re-parse strips the excluded field. |
138
176
  | "Store the next action so the list can show it" | It drifts from the records the moment either changes. Derive it in a view. |
139
177
 
@@ -143,6 +181,8 @@ rg -c "enabledCondition" shared-lib/src/modules --glob '*.resources-config.ts'
143
181
  - A transition variant with no `authoritativeFields` (catch with the **declares what it writes** count).
144
182
  - A transition that accepts a body, or declares none and so inherits UPDATE's (catch with the **EMPTY body** counts).
145
183
  - A transition variant with no `enabledCondition`, such as an administrator's second variant (catch with the **starting state** count).
184
+ - A handler that refuses on the record's status or on who is asking while the condition does not (catch with the **handler refusing on state or person** grep).
185
+ - A transition with an `enabledCondition` and no `unavailableWhen` in its specification (catch with the **why it can be unavailable** count): the disabled action and the refusal explain nothing.
146
186
  - A conversion written straight to another resource's repository instead of `servicesRegistry.create` (catch by reading the operation file against `backend-custom-operation` Worked Example 2).
147
187
 
148
188
  ## Related Skills