@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
@@ -37,8 +37,13 @@ Pick the start point that names that moment for this resource; the class decides
37
37
  - **Every owned edge into a statutory resource authors `IMPERSONALIZE_AND_RETAIN`.** A silent edge is DELETE on
38
38
  a parent delete (a hard user delete, the tenant purge) and would destroy the records; a disabled or
39
39
  `REFUSE_WHILE_CHILDREN_EXIST` edge leaves them unrestricted after an erasure. Startup refuses all three.
40
- - **A statutory ground refuses `CLOSURE_EVENT` and `LAST_UPDATED`.** An erasure freezes a restricted row:
41
- an open record could never be closed, and the restriction write itself would restart an `updatedAt` clock.
40
+ - **A statutory ground refuses `LAST_UPDATED`.** The restriction write itself would restart an `updatedAt` clock.
41
+ - **A statutory ground refuses `CLOSURE_EVENT` unless a restricted record can still be closed.** An erasure
42
+ freezes a restricted row, so a record still open when its subject is erased would never close and would be
43
+ kept forever. Either name the closure field in `retentionPolicy.retainedRowCompletion.fields` (with a
44
+ rationale: the closure date names nobody) and let the close operation record a retained record's closure
45
+ (see below), or declare `statutoryRetention.staysInUseBecause` when these records are never restricted.
46
+ This is how a period counted from the end of a contract, a matter or a case is declared.
42
47
  - **No `.ttl()` beside a binding.** One row, one retention authority; `.ttl()` is for framework plumbing.
43
48
  - **A service-resolvable `DELETE_MANY` or `DELETE`.** The sweep deletes through the service layer so
44
49
  cascades, file release and RAG chunk removal run. An `INTERNAL_CALL` variant is route-less and enough.
@@ -53,3 +58,10 @@ Pick the start point that names that moment for this resource; the class decides
53
58
  must drop any closure date the caller sent: a caller reaching the service tier through a loose parse
54
59
  (an MCP tool call) can still carry one, and an authoritative field preserves whatever the handler
55
60
  passes through.
61
+ - For a statutory `CLOSURE_EVENT` record declared through `retainedRowCompletion`, an erasure may have
62
+ restricted the record while it was open, and a restricted record reads as absent to the close operation.
63
+ In that case the close operation calls `closeRetainedRecordAsSystem(resourceType, id, closedAt)` on the
64
+ system-access service (`utils.systemAccessService` in a custom implementation, passing the organization as
65
+ `scopeContext` when the resource is organization-scoped). It writes only the closure date, only where it
66
+ is still null, on a retained row, and answers whether it closed one; the row stays restricted and the
67
+ sweep deletes it at closure + period.
@@ -282,7 +282,7 @@ shared schema declares the **truth**, the UI behavior file declares the
282
282
  - `references/decorator-layer-map.md` — decide which file/layer owns the next change
283
283
  - `references/shared-layer-decorator-checklist.md` — common structural decorator patterns
284
284
  - `references/field-type-selection.md` — choose between primitive, enum, FK, and factory shapes
285
- - `references/special-factories.md` — dedicated `z_*` factory choices
285
+ - `references/special-factories.md` — dedicated `z_*` factory choices, and dates: always `z.date()`, `jsonParsingSchemaOf` for JSON your own code parses
286
286
  - `references/document-numbers.md` — server-allocated, gapless document numbers (`.documentSequence`), allocated at create or by an issuing operation (source-backed)
287
287
  - `references/computed-totals.md` — totals and other values the server computes: stored and server-owned (prefix + `authoritativeFields`) versus `.isVirtual()`, with a worked quote total, and a parent total kept right when its lines are their own resource (source-backed)
288
288
  - `references/schema-variants-and-discriminators.md` — schema-family guidance
@@ -534,7 +534,10 @@ What to know before choosing it:
534
534
  *
535
535
  * A prefix that authors a server-owned field (one marked `.excludeFromCreate()` /
536
536
  * `.excludeFromUpdate()`) relies on `preserveServerInjectedFields` to carry that value past the
537
- * repository's strict `requestDto` re-parse. That allow-list is normally derived by diffing the
537
+ * repository's strict `requestDto` re-parse. So does a prefix that sets a value BELOW a field: the
538
+ * request contract strips an `.isBackendOnly()` field at every depth, so the re-parse of the
539
+ * containing field drops what the prefix put there. Declare the TOP-LEVEL field that contains it
540
+ * (an SSO connection's prefix parses `saml.x509Certificates` from a PEM, and declares `saml`). That allow-list is normally derived by diffing the
538
541
  * prefix output against a snapshot of the payload keys taken BEFORE the prefix ran, so only keys
539
542
  * the hook *introduced* are preserved — which is what stops a client smuggling a value into a
540
543
  * field it may not write.
@@ -104,7 +104,8 @@ For an EXPLICIT sequence, the issuing operation's custom implementation numbers
104
104
  `issueDocumentSequenceNumberInOperation`, which reserves the number and writes it in one transaction. Register the
105
105
  implementation with `transactionalCore: true`, and name the counters in its `transactionParticipants` with the exported
106
106
  constant `DOCUMENT_SEQUENCE_COUNTERS_RESOURCE_TYPE` (never the string). Issuing an already-numbered row throws a
107
- CONFLICT and consumes no number:
107
+ CONFLICT and consumes no number (`error.code` `DocumentSequenceRefusalCode.ROW_ALREADY_NUMBERED`, worded by its own
108
+ `customMessageReference`, so the person reads that the document already has its number):
108
109
 
109
110
  ## Import Origins
110
111
 
@@ -152,7 +153,7 @@ export async function issueDocumentSequenceNumberInOperation(
152
153
  },
153
154
  ): Promise<string> {
154
155
  return issueDocumentSequenceNumber({
155
- registry: utils.repositoriesRegistry,
156
+ registry: engineRepositoriesRegistry(utils),
156
157
  errorBuilder: utils.errorBuilder,
157
158
  resourceType: input.resourceType,
158
159
  mainSchema: utils.resourcesRegistry.getResourceConfiguration(input.resourceType).mainSchema,
@@ -175,6 +176,12 @@ Two cases, both handled by raising a sequence's counter, never by writing number
175
176
  | A field that already held numbers gains `.documentSequence(...)` | `raiseDocumentSequenceFloorsToExistingRows({ …, rows })`, once, from a migration script | each organization and period continues after the highest number its rows hold, so no new number collides with an old one |
176
177
 
177
178
  - It only raises. A floor below the counter is refused, because lowering it would hand out numbers already issued.
179
+ - Every refusal a person can act on carries a `DocumentSequenceRefusalCode` in `error.code` and words of its own
180
+ (`customMessageReference`): `FLOOR_BELOW_COUNTER` and `COUNTER_MOVED` are 409s, `FLOOR_INVALID` and
181
+ `FLOOR_PERIOD_INVALID` are 400s. Declare the ones your operation can raise in its specification's `errorScenarios`
182
+ (`customMessageReference: ErrorCustomMessageReference.DOCUMENT_SEQUENCE_FLOOR_BELOW_COUNTER`, …) so the published
183
+ reference names them; a client branches on `error.code`. None names a form field: the counter is not a field of your operation's form, and the counter's value
184
+ is not in the response, so ask the person for a higher number rather than showing one.
178
185
  - The engine has no endpoint for it. Your operation decides who may do it and what the trail keeps:
179
186
  - **Who**: mount the operation under `/organizations/{organizationId}/…` with your organization administrator role
180
187
  for an ORGANIZATION sequence. `raiseDocumentSequenceFloorInOperation` takes the organization from that route and
@@ -183,8 +190,13 @@ Two cases, both handled by raising a sequence's counter, never by writing number
183
190
  - **Why**: a required, bounded `justification` string in the request DTO, declared with
184
191
  `auditableEvent: { reasonField: 'justification' }`, and a `HIGH` or `CRITICAL` risk level. The trail records who ran
185
192
  it, when, and the justification.
186
- - **Not recorded**: the counter's previous and new value. No other request value reaches the trail, so ask for the
187
- floor to be stated in the justification, and return the outcome (`previousValue`, `value`) from the operation.
193
+ - **What**: the engine records the move itself. Once your operation's transaction commits, a raise that moved the
194
+ counter writes a `DOCUMENT_SEQUENCE_FLOOR_RAISED` row with the resource, the field, the scope and organization, the
195
+ period and `previousValue` → `value`, attributed to your operation's caller. A refused raise, a raise that kept the
196
+ counter (`raised: false`) and a raise whose transaction rolled back record nothing. You do not ask for the floor in
197
+ the justification. `raiseDocumentSequenceFloorInOperation` reads the audit service from `utils`; a direct call to
198
+ `raiseDocumentSequenceFloor` or `raiseDocumentSequenceFloorsToExistingRows` passes it as the required `auditLogs`
199
+ (`servicesRegistry.getAuditLogsService()`), and a raise with none is refused rather than run unrecorded.
188
200
  - Register it with `transactionalCore: true` and the counters as a participant, like the "issue" operation.
189
201
  - **Which rows to pass** to `raiseDocumentSequenceFloorsToExistingRows`: every row of the resource, in every
190
202
  organization, read without the caller's organization filter. A row left out keeps its number, so the counter can
@@ -210,14 +222,14 @@ Two cases, both handled by raising a sequence's counter, never by writing number
210
222
  * pass `floor: 417` and the next is INV-2026-00418), or when a field that already held numbers gains
211
223
  * `.documentSequence(...)` (see `raiseDocumentSequenceFloorsToExistingRows`).
212
224
  *
213
- * It only RAISES. A floor below the counter is refused (`document_sequence_floor_below_counter`), because lowering it
225
+ * It only RAISES. A floor below the counter is refused (409, `DocumentSequenceRefusalCode.FLOOR_BELOW_COUNTER`), because lowering it
214
226
  * would hand out numbers already issued; pass `whenBelowCounter: KEEP_COUNTER` to keep the counter instead. Raising
215
227
  * skips numbers on purpose: the numbers between the old counter and the floor must exist in the other system or in the
216
228
  * existing rows.
217
229
  *
218
230
  * It runs in the caller's transaction and refuses without one. It serializes with documents numbered at the same
219
231
  * moment: on PostgreSQL it waits on the counter's row lock, and on MongoDB the transaction is retried. A
220
- * compare-and-set on the counter's value backs that up (`document_sequence_counter_moved`), so a stale read can never
232
+ * compare-and-set on the counter's value backs that up (409, `DocumentSequenceRefusalCode.COUNTER_MOVED`), so a stale read can never
221
233
  * overwrite a number already handed out.
222
234
  *
223
235
  * From an operation, call {@link raiseDocumentSequenceFloorInOperation}. The engine exposes no endpoint for it, so your
@@ -229,9 +241,12 @@ Two cases, both handled by raising a sequence's counter, never by writing number
229
241
  * - **Why**: put a required, bounded `justification` string in the request DTO and declare
230
242
  * `auditableEvent: { reasonField: 'justification' }`, with a `HIGH` or `CRITICAL` risk level. The trail then records
231
243
  * who ran it, when, and the justification.
232
- * - **What it does NOT record**: the counter's previous and new value. No other request value is copied into the
233
- * trail, so state the floor in the justification, and return the outcome from the operation. A dedicated event
234
- * recording the move is planned.
244
+ * - **What**: the engine records the move itself. Once the transaction commits, a raise that moved the counter writes
245
+ * a `DOCUMENT_SEQUENCE_FLOOR_RAISED` row naming the resource, the field, the scope (and organization), the period and
246
+ * `previousValue` → `value`, attributed to the operation's caller. A refused raise, a raise to the counter's own value
247
+ * and a kept counter (`raised: false`) record nothing, and a raise whose transaction rolls back records nothing.
248
+ * `raiseDocumentSequenceFloorInOperation` takes the audit service from `utils`; called directly, the raise takes it as
249
+ * the required `auditLogs`, and refuses to run where none is bound.
235
250
  *
236
251
  * Import from `@wildo-ai/saas-backend-lib`.
237
252
  *
@@ -263,31 +278,48 @@ export async function raiseDocumentSequenceFloor(input: {
263
278
  readonly whenBelowCounter?: DocumentSequenceFloorBelowCounter;
264
279
  readonly executionContext: ExecutionContext<any>;
265
280
  readonly options: RepositoryOptions | undefined;
281
+ /** Records the move once the transaction commits. Required: see {@link DocumentSequenceFloorRaiseAuditLogs}. */
282
+ readonly auditLogs: DocumentSequenceFloorRaiseAuditLogs;
266
283
  /** Only used to default `periodKey`. */
267
284
  readonly now?: Date;
268
285
  }): Promise<DocumentSequenceFloorRaise> {
269
286
  const { registry, errorBuilder, executionContext, resourceType } = input;
287
+ // A wiring or internal fault, for the logs: its context never reaches the client.
270
288
  const refuse = (type: ErrorType, reason: string, extra: Record<string, unknown> = {}) =>
271
- errorBuilder.buildError(type, executionContext, { context: { reason, resourceType, fieldName: input.fieldName, ...extra } });
289
+ errorBuilder.buildError(type, executionContext, { context: { reason, resourceType, sequenceFieldName: input.fieldName, ...extra } });
290
+ // A refusal of the REQUEST (#3081): its code reaches the client, and its reference words it. It names no field: the
291
+ // sequence's field is not a field of the operation's form, so it travels as `sequenceFieldName`, a diagnostic.
292
+ const refuseRequest = (
293
+ type: ErrorType.CONFLICT | ErrorType.VALIDATION,
294
+ code: DocumentSequenceRefusalCode,
295
+ customMessageReference: ErrorCustomMessageReference,
296
+ extra: Record<string, unknown> = {},
297
+ ) => errorBuilder.buildError(type, executionContext, {
298
+ customMessageReference,
299
+ context: { code, resourceType, sequenceFieldName: input.fieldName, ...extra },
300
+ });
272
301
  const field = documentSequenceFieldsOf(input.mainSchema).find((candidate) => candidate.fieldName === input.fieldName);
273
302
  if (field === undefined) throw refuse(ErrorType.CONFIGURATION, 'document_sequence_field_not_declared');
274
- if (!Number.isSafeInteger(input.floor) || input.floor < 0) throw refuse(ErrorType.VALIDATION, 'document_sequence_floor_invalid', { floor: input.floor });
303
+ if (!Number.isSafeInteger(input.floor) || input.floor < 0) throw refuseRequest(ErrorType.VALIDATION, DocumentSequenceRefusalCode.FLOOR_INVALID, ErrorCustomMessageReference.DOCUMENT_SEQUENCE_FLOOR_INVALID, { floor: input.floor });
275
304
  const transaction = input.options?.transaction;
276
305
  if (transaction === undefined) throw refuse(ErrorType.CONFIGURATION, 'document_sequence_requires_transaction');
306
+ // The type requires it; a JavaScript caller or a cast could still pass nothing, and the raise must not move a counter
307
+ // it cannot record.
308
+ if (typeof input.auditLogs?.logDocumentSequenceFloorRaised !== 'function') throw refuse(ErrorType.CONFIGURATION, 'document_sequence_floor_raise_without_audit');
277
309
 
278
310
  const isOrganizationSequence = field.params.scope === DocumentSequenceScope.ORGANIZATION;
279
311
  const organizationId = input.organizationId;
280
312
  if (isOrganizationSequence && (typeof organizationId !== 'string' || organizationId.length === 0)) {
281
- throw refuse(ErrorType.VALIDATION, 'document_sequence_floor_without_organization');
313
+ throw refuseRequest(ErrorType.VALIDATION, DocumentSequenceRefusalCode.FLOOR_WITHOUT_ORGANIZATION, ErrorCustomMessageReference.VALIDATION);
282
314
  }
283
315
  // An organization named for an APPLICATION sequence would be silently ignored, and the floor applied to everyone.
284
- if (!isOrganizationSequence && organizationId !== undefined) throw refuse(ErrorType.VALIDATION, 'document_sequence_floor_organization_for_application_sequence');
316
+ if (!isOrganizationSequence && organizationId !== undefined) throw refuseRequest(ErrorType.VALIDATION, DocumentSequenceRefusalCode.FLOOR_ORGANIZATION_FOR_APPLICATION_SEQUENCE, ErrorCustomMessageReference.VALIDATION);
285
317
  const scopeKey = isOrganizationSequence ? organizationId! : DOCUMENT_SEQUENCE_APPLICATION_SCOPE_KEY;
286
318
 
287
319
  const parsed = parseDocumentSequenceFormat(field.params.format);
288
320
  const periodKey = input.periodKey
289
321
  ?? documentSequencePeriodKey(parsed, input.now ?? new Date(), await organizationTimeZone(input, field, scopeKey, new Map()));
290
- if (!PERIOD_KEY_SHAPE[parsed.period].test(periodKey)) throw refuse(ErrorType.VALIDATION, 'document_sequence_floor_period_invalid', { periodKey, period: parsed.period });
322
+ if (!PERIOD_KEY_SHAPE[parsed.period].test(periodKey)) throw refuseRequest(ErrorType.VALIDATION, DocumentSequenceRefusalCode.FLOOR_PERIOD_INVALID, ErrorCustomMessageReference.DOCUMENT_SEQUENCE_FLOOR_PERIOD_INVALID, { periodKey, period: parsed.period });
291
323
 
292
324
  const _id = await ensureDocumentSequenceCounter(registry, executionContext, transaction, { resourceType, fieldName: field.fieldName, scopeKey, periodKey });
293
325
  const current = await registry.readUnscopedByKey<DocumentSequenceCounter>(COUNTERS, { _id }, { transaction });
@@ -298,11 +330,30 @@ export async function raiseDocumentSequenceFloor(input: {
298
330
  if ((input.whenBelowCounter ?? DocumentSequenceFloorBelowCounter.REFUSE) === DocumentSequenceFloorBelowCounter.KEEP_COUNTER) {
299
331
  return { previousValue, value: previousValue, raised: false };
300
332
  }
301
- throw refuse(ErrorType.CONFLICT, 'document_sequence_floor_below_counter', { floor: input.floor, counter: previousValue, periodKey });
333
+ throw refuseRequest(ErrorType.CONFLICT, DocumentSequenceRefusalCode.FLOOR_BELOW_COUNTER, ErrorCustomMessageReference.DOCUMENT_SEQUENCE_FLOOR_BELOW_COUNTER, { floor: input.floor, counter: previousValue, periodKey });
302
334
  }
303
335
  // Compare-and-set: a number allocated since the read moves the value, and this write then matches nothing.
304
336
  const written = await registry.atomicGuardedMutation<DocumentSequenceCounter>(COUNTERS, { _id, value: previousValue }, { set: { value: input.floor } }, undefined, { transaction });
305
- if (written === null) throw refuse(ErrorType.CONFLICT, 'document_sequence_counter_moved', { periodKey });
337
+ if (written === null) throw refuseRequest(ErrorType.CONFLICT, DocumentSequenceRefusalCode.COUNTER_MOVED, ErrorCustomMessageReference.DOCUMENT_SEQUENCE_COUNTER_MOVED, { periodKey });
338
+ // #2657: the move is recorded once the transaction commits, never before. The audit store is not part of this
339
+ // transaction, so a row written now would survive a rollback and describe a raise that never happened; a retried
340
+ // MongoDB attempt gets a fresh context, so only the attempt that commits records. Keyed per counter, so one transaction
341
+ // raising several sequences records each. The post-commit lane never throws into the committed caller, and
342
+ // `_createAuditLog` reports a failed write rather than failing the request (the raise has landed by then).
343
+ const auditLogs = input.auditLogs;
344
+ const event = {
345
+ resourceType,
346
+ fieldName: field.fieldName,
347
+ scope: field.params.scope,
348
+ ...(isOrganizationSequence ? { organizationId: scopeKey } : {}),
349
+ periodKey,
350
+ previousValue,
351
+ value: input.floor,
352
+ };
353
+ registerTransactionPostCommitEffect(transaction, {
354
+ key: ['document-sequence-floor-raised', _id, transaction.id].join(':'),
355
+ execute: () => auditLogs.logDocumentSequenceFloorRaised(event, executionContext),
356
+ });
306
357
  return { previousValue, value: input.floor, raised: true };
307
358
  }
308
359
 
@@ -318,6 +369,8 @@ export async function raiseDocumentSequenceFloorInOperation(
318
369
  readonly repositoriesRegistry: RepositoriesRegistryHandlerBackendService;
319
370
  readonly errorBuilder: ErrorBuilderBackendService;
320
371
  readonly resourcesRegistry: { getResourceConfiguration(resourceType: string): { mainSchema: z.ZodTypeAny } };
372
+ /** Where the audit service is read from (#2657): an operation's `utils.servicesRegistry`. */
373
+ readonly servicesRegistry: { getAuditLogsService(): DocumentSequenceFloorRaiseAuditLogs | undefined };
321
374
  readonly serviceOptions?: { readonly transaction?: RepositoryOptions['transaction'] };
322
375
  },
323
376
  input: {
@@ -333,8 +386,15 @@ export async function raiseDocumentSequenceFloorInOperation(
333
386
  const field = documentSequenceFieldsOf(mainSchema).find((candidate) => candidate.fieldName === input.fieldName);
334
387
  const routeOrganizationId = input.executionContext.getContextResourceId(coreResourceShared_FieldIdentifier[CoreResourceType.ORGANIZATIONS]);
335
388
  const isOrganizationSequence = field?.params.scope === DocumentSequenceScope.ORGANIZATION;
389
+ const auditLogs = utils.servicesRegistry.getAuditLogsService();
390
+ // Fail closed: a container that binds no audit service cannot record the move, so it may not make it.
391
+ if (auditLogs === undefined) {
392
+ throw utils.errorBuilder.buildError(ErrorType.CONFIGURATION, input.executionContext, {
393
+ context: { reason: 'document_sequence_floor_raise_without_audit', resourceType: input.resourceType, sequenceFieldName: input.fieldName },
394
+ });
395
+ }
336
396
  return raiseDocumentSequenceFloor({
337
- registry: utils.repositoriesRegistry,
397
+ registry: engineRepositoriesRegistry(utils),
338
398
  errorBuilder: utils.errorBuilder,
339
399
  resourceType: input.resourceType,
340
400
  mainSchema,
@@ -346,6 +406,7 @@ export async function raiseDocumentSequenceFloorInOperation(
346
406
  ...(input.whenBelowCounter === undefined ? {} : { whenBelowCounter: input.whenBelowCounter }),
347
407
  executionContext: input.executionContext,
348
408
  options: utils.serviceOptions?.transaction === undefined ? undefined : { transaction: utils.serviceOptions.transaction },
409
+ auditLogs,
349
410
  });
350
411
  }
351
412
  ```
@@ -16,6 +16,7 @@ follow later.
16
16
  | Money, file, range, duration, phone, postal address, code, big decimal | dedicated `z_*` factory | The framework already has richer semantics for these shapes. |
17
17
  | Postal address | `z_address(options?)` — never a `z.string()` | Parts are validated and normalised, the country is an ISO code, two spellings of one place compare equal (`isSameAddress`), and the form and display fields are the framework's. |
18
18
  | A calendar day (a due date, a birthday, an invoice or expense date, a start or end date) | `z.date().isCalendarDate()` | A plain `Date` is an INSTANT, and an instant falls on a different day in another time zone: a due date picked as 3 Oct in Paris read 2 Oct in New York. Declared, it is held as UTC midnight of the day, picked and shown as that day for every reader, and "tomorrow" is measured from the reader's own today. |
19
+ | A month (a monthly budget's period, a billing month, a reporting month) | `z_yearMonth()` — never a `z.date()` pinned to the 1st, never a bare `z.string()` | Stored `YYYY-MM`, validated on every write, so it sorts as text, joins a compound unique key (one budget per department per month) and no reader's zone moves it into the neighbouring month. Read as "October 2026" in the reader's language, picked as a month and a year, and a list filter over it is a month picker whose chip names the month — or two, for a range of months, when the filter declares `Resources_Filter_YearMonthRangeSchema`. |
19
20
  | A moment in time (`createdAt`, `expiresAt`, `completedAt`, `occurredAt`) | `z.date()` — no declaration | An instant, shown in the reader's time zone and locale: their own preferences (member, then organization) when signed in, their browser's when they have no account. Add `.dateTimeUI()` when the time of day is part of the fact; without it the instant is shown as its day. |
20
21
 
21
22
  ## Enum Rule
@@ -58,6 +59,7 @@ Open `special-factories.md` when the field is not "just a primitive":
58
59
  - monetary value with currency/precision semantics
59
60
  - file upload reference
60
61
  - range (`from`/`to`)
62
+ - a calendar month with no day (`YYYY-MM`) — `z_yearMonth()`
61
63
  - duration value + unit
62
64
  - phone number normalization
63
65
  - postal address (street, city, postal code, country, optional geocode)
@@ -156,6 +156,19 @@ export enum ZodDecorator {
156
156
  * not marked. No check runs over an application's resources yet: there the marker documents the field.
157
157
  */
158
158
  IS_DECIDER = "isDecider",
159
+ /**
160
+ * Role grant: this field's values are roles the WRITER grants (a membership's `roles`, a machine credential's
161
+ * `roles`, a unit assignment's `role`, an account's `appRoles`). A pure marker, read back with
162
+ * `isRoleGrantField(schema)`.
163
+ *
164
+ * What it changes: a form offers only the roles the person filling it may grant (#3248), decided by the rule the
165
+ * server's role-ceiling gate applies (`resolveRoleGrantCeiling` in `@wildo-ai/saas-models`), plus any role the
166
+ * record already holds, so a stored role is never dropped from view. It grants nothing and refuses nothing: the
167
+ * server gate on the write is the control, and the marker only keeps the form from offering what that gate refuses.
168
+ * Mark a field that a form offers roles in, where a write of it is checked against the writer's ceiling. A role
169
+ * grant typed as free text (an SSO connection's `roleMapping`) offers no roles, so marking it would narrow nothing.
170
+ */
171
+ IS_ROLE_GRANT = "isRoleGrant",
159
172
  /**
160
173
  * RAG source: this field's TEXT is a retrieval-corpus source. The framework chunks the value
161
174
  * (extracting text first for file fields), stores the chunks in the application's OWN datastore
@@ -227,6 +240,11 @@ export enum ZodDecorator {
227
240
  * (single field vs composite). Mixing is rejected at decoration time.
228
241
  */
229
242
  OBJECT_BUSINESS_KEY_SET = "businessKeySet",
243
+ /**
244
+ * Object-level: one NON-unique index over several fields, for reads that filter on the leading fields and sort on
245
+ * the last (#3142). Accumulates: each call declares one more index. See {@link CompoundIndexParams}.
246
+ */
247
+ OBJECT_COMPOUND_INDEX = "compoundIndex",
230
248
  /**
231
249
  * Object-level: the object (`{ resourceType, resourceId }`) names one row of a resource whose type is chosen at
232
250
  * run time from a published target set. See {@link ResourceReferenceParams}.
@@ -345,6 +363,7 @@ export type ZodDecorator_ParamsType = {
345
363
  // Last-action-record marker — parameterless: a field either records the last action or is state.
346
364
  [ZodDecorator.IS_LAST_ACTION_RECORD]: undefined;
347
365
  [ZodDecorator.IS_DECIDER]: undefined;
366
+ [ZodDecorator.IS_ROLE_GRANT]: undefined;
348
367
  /**
349
368
  * RAG-source declaration. The config object is optional — `.ragSource()` with no argument is a
350
369
  * complete declaration — and the chokepoint normalizes an omitted config to `{}` so every reader
@@ -363,6 +382,8 @@ export type ZodDecorator_ParamsType = {
363
382
  [ZodDecorator.DOCUMENT_SEQUENCE]: DocumentSequenceParams;
364
383
  // Composite business key (object-level decorator carrying the ordered list of field names)
365
384
  [ZodDecorator.OBJECT_BUSINESS_KEY_SET]: BusinessKeySetParams | DecoratorUpdater<BusinessKeySetParams>;
385
+ // One more compound index per call (the stored metadata is the accumulated list)
386
+ [ZodDecorator.OBJECT_COMPOUND_INDEX]: CompoundIndexParams;
366
387
  [ZodDecorator.RESOURCE_REFERENCE]: ResourceReferenceParams;
367
388
  [ZodDecorator.TTL]: TtlFieldParams | DecoratorUpdater<TtlFieldParams>;
368
389
  // String edit mode convenience decorators
@@ -447,6 +468,7 @@ export type ZodDecorator_Types = {
447
468
  /** Last-action-record marker — stored as the bare `true` sentinel (parameterless, like IS_AUDIT_EVIDENCE). */
448
469
  [ZodDecorator.IS_LAST_ACTION_RECORD]: true;
449
470
  [ZodDecorator.IS_DECIDER]: true;
471
+ [ZodDecorator.IS_ROLE_GRANT]: true;
450
472
  /** RAG-source config — ALWAYS the normalized object ( `{}` when authored with no argument): the
451
473
  * chokepoint validates and normalizes on the way in, so every reader sees one shape and
452
474
  * `getRagSourceConfig` can answer "is this field a source?" by presence alone. */
@@ -463,6 +485,8 @@ export type ZodDecorator_Types = {
463
485
  [ZodDecorator.DOCUMENT_SEQUENCE]: DocumentSequenceParams;
464
486
  // Composite business key (object-level — stored params shape after resolver unwraps DecoratorUpdater)
465
487
  [ZodDecorator.OBJECT_BUSINESS_KEY_SET]: BusinessKeySetParams;
488
+ // Every compound index the object declares, in declaration order
489
+ [ZodDecorator.OBJECT_COMPOUND_INDEX]: CompoundIndexParams[];
466
490
  [ZodDecorator.RESOURCE_REFERENCE]: ResourceReferenceParams;
467
491
  [ZodDecorator.TTL]: TtlFieldParams;
468
492
  // String edit mode convenience decorators
@@ -557,6 +581,7 @@ export interface CustomFieldMetadata {
557
581
  [ZodDecorator.IS_AUDIT_EVIDENCE]?: ZodDecorator_Types[ZodDecorator.IS_AUDIT_EVIDENCE];
558
582
  [ZodDecorator.IS_LAST_ACTION_RECORD]?: ZodDecorator_Types[ZodDecorator.IS_LAST_ACTION_RECORD];
559
583
  [ZodDecorator.IS_DECIDER]?: ZodDecorator_Types[ZodDecorator.IS_DECIDER];
584
+ [ZodDecorator.IS_ROLE_GRANT]?: ZodDecorator_Types[ZodDecorator.IS_ROLE_GRANT];
560
585
  [ZodDecorator.RAG_SOURCE]?: ZodDecorator_Types[ZodDecorator.RAG_SOURCE];
561
586
  [ZodDecorator.IS_VIRTUAL]?: ZodDecorator_Types[ZodDecorator.IS_VIRTUAL];
562
587
  [ZodDecorator.IS_DISCRIMINATOR]?: ZodDecorator_Types[ZodDecorator.IS_DISCRIMINATOR];
@@ -568,6 +593,7 @@ export interface CustomFieldMetadata {
568
593
  [ZodDecorator.IS_BUSINESS_KEY]?: ZodDecorator_Types[ZodDecorator.IS_BUSINESS_KEY];
569
594
  [ZodDecorator.DOCUMENT_SEQUENCE]?: ZodDecorator_Types[ZodDecorator.DOCUMENT_SEQUENCE];
570
595
  [ZodDecorator.OBJECT_BUSINESS_KEY_SET]?: ZodDecorator_Types[ZodDecorator.OBJECT_BUSINESS_KEY_SET];
596
+ [ZodDecorator.OBJECT_COMPOUND_INDEX]?: ZodDecorator_Types[ZodDecorator.OBJECT_COMPOUND_INDEX];
571
597
  [ZodDecorator.RESOURCE_REFERENCE]?: ZodDecorator_Types[ZodDecorator.RESOURCE_REFERENCE];
572
598
  [ZodDecorator.TTL]?: ZodDecorator_Types[ZodDecorator.TTL];
573
599
  // String edit mode convenience decorators
@@ -299,52 +299,6 @@ export function isPersonalDataAboutAnotherParty(schema: z.ZodTypeAny): boolean {
299
299
 
300
300
  ### Origin Package: `@wildo-ai/zod-decorators`
301
301
 
302
- ```typescript
303
- *
304
- * Declare WHICH KINDS of personal data this field holds — the vocabulary a privacy notice
305
- * enumerates. Import `PersonalDataCategory` from `@wildo-ai/saas-models`.
306
- *
307
- * Accepts a single category (the common case) or an array when a field genuinely spans two. At
308
- * least one is required: a field that holds NO personal data carries no declaration at all, and
309
- * that absence is exactly what the compliance gap report reads.
310
- *
311
- * Declare it on the field that holds the value. Never on a field merely because its NAME suggests
312
- * a category — `credentials` is the one category the framework derives for you, and it derives it
313
- * from `.isPassword()` / `.isOtp()` / `.isWriteOnlySecret()`, never from an identifier.
314
- *
315
- * `options.personalOnlyWhen` takes a `PersonalDataCondition` (also from `@wildo-ai/saas-models`)
316
- * for a field that is personal data only on some rows. The case it exists for is a field naming
317
- * the PARTY a row describes — a customer account, a supplier: it is an individual's data when that
318
- * party is a sole trader, and a company's when it is not. The field still counts as personal data
319
- * for erasure, export and every guard; the privacy notice lists it as held "where the customer is
320
- * an individual" instead of claiming it about every customer. Do not use it for a field naming a
321
- * person AT a company (a contact's email): that is personal on every row.
322
- *
323
- * `options.aboutAnotherParty: true` says the field names a party OTHER than the one the row is about: a
324
- * copy of another organization's name kept on a cost record or a relationship. It decides only one thing:
325
- * a resource declaring `retentionPolicy: RETAIN_ONLY` ("no personal data about its own subject") may keep
326
- * such a copy. Leave it off the row's own party's name (a customer account's own name), which that
327
- * resource may not keep.
328
- *
329
- * @example
330
- * fullName: z.string().dataCategories(PersonalDataCategory.IDENTITY)
331
- * @example
332
- * email: z.email().nullish().dataCategories(PersonalDataCategory.CONTACT_DETAILS)
333
- * @example
334
- * // A field that genuinely spans two — an array never forces you to pick a lie.
335
- * dietaryNotes: z.string().dataCategories([PersonalDataCategory.USER_CONTENT, PersonalDataCategory.SPECIAL_CATEGORY_HEALTH])
336
- * @example
337
- * // A customer account's name: a person's data only when the customer is a sole trader.
338
- * accountName: z.string().dataCategories(PersonalDataCategory.IDENTITY, { personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON })
339
- * @example
340
- * // The billed customer's name copied onto an invoice line: another party's name, not the line's subject.
341
- * customerName: z.string().dataCategories(PersonalDataCategory.IDENTITY, { personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON, aboutAnotherParty: true })
342
- */
343
- [ZodDecorator.DATA_CATEGORIES](categories: string | readonly string[], options?: DataCategoriesOptions): DecoratedPrimitiveZodType<T>;
344
- ```
345
-
346
- ### Origin Package: `@wildo-ai/zod-decorators`
347
-
348
302
  ```typescript
349
303
  */
350
304
  export function addDataCategories<T extends z.ZodTypeAny>(
@@ -358,3 +312,49 @@ export function addDataCategories<T extends z.ZodTypeAny>(
358
312
  ]);
359
313
  }
360
314
  ```
315
+
316
+ ### Origin Package: `@wildo-ai/zod-decorators`
317
+
318
+ ```typescript
319
+ *
320
+ * Declare WHICH KINDS of personal data this field holds — the vocabulary a privacy notice
321
+ * enumerates. Import `PersonalDataCategory` from `@wildo-ai/saas-models`.
322
+ *
323
+ * Accepts a single category (the common case) or an array when a field genuinely spans two. At
324
+ * least one is required: a field that holds NO personal data carries no declaration at all, and
325
+ * that absence is exactly what the compliance gap report reads.
326
+ *
327
+ * Declare it on the field that holds the value. Never on a field merely because its NAME suggests
328
+ * a category — `credentials` is the one category the framework derives for you, and it derives it
329
+ * from `.isPassword()` / `.isOtp()` / `.isWriteOnlySecret()`, never from an identifier.
330
+ *
331
+ * `options.personalOnlyWhen` takes a `PersonalDataCondition` (also from `@wildo-ai/saas-models`)
332
+ * for a field that is personal data only on some rows. The case it exists for is a field naming
333
+ * the PARTY a row describes — a customer account, a supplier: it is an individual's data when that
334
+ * party is a sole trader, and a company's when it is not. The field still counts as personal data
335
+ * for erasure, export and every guard; the privacy notice lists it as held "where the customer is
336
+ * an individual" instead of claiming it about every customer. Do not use it for a field naming a
337
+ * person AT a company (a contact's email): that is personal on every row.
338
+ *
339
+ * `options.aboutAnotherParty: true` says the field names a party OTHER than the one the row is about: a
340
+ * copy of another organization's name kept on a cost record or a relationship. It decides only one thing:
341
+ * a resource declaring `retentionPolicy: RETAIN_ONLY` ("no personal data about its own subject") may keep
342
+ * such a copy. Leave it off the row's own party's name (a customer account's own name), which that
343
+ * resource may not keep.
344
+ *
345
+ * @example
346
+ * fullName: z.string().dataCategories(PersonalDataCategory.IDENTITY)
347
+ * @example
348
+ * email: z.email().nullish().dataCategories(PersonalDataCategory.CONTACT_DETAILS)
349
+ * @example
350
+ * // A field that genuinely spans two — an array never forces you to pick a lie.
351
+ * dietaryNotes: z.string().dataCategories([PersonalDataCategory.USER_CONTENT, PersonalDataCategory.SPECIAL_CATEGORY_HEALTH])
352
+ * @example
353
+ * // A customer account's name: a person's data only when the customer is a sole trader.
354
+ * accountName: z.string().dataCategories(PersonalDataCategory.IDENTITY, { personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON })
355
+ * @example
356
+ * // The billed customer's name copied onto an invoice line: another party's name, not the line's subject.
357
+ * customerName: z.string().dataCategories(PersonalDataCategory.IDENTITY, { personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON, aboutAnotherParty: true })
358
+ */
359
+ [ZodDecorator.DATA_CATEGORIES](categories: string | readonly string[], options?: DataCategoriesOptions): DecoratedPrimitiveZodType<this>;
360
+ ```
@@ -45,6 +45,11 @@ export interface SchemaFamilyConfig<
45
45
  * built. The client tells the variants apart by this field, and a response that withheld it from every variant
46
46
  * could not be parsed by anyone. Remove the declaration; if the value really is sensitive, it cannot be the
47
47
  * discriminator.
48
+ *
49
+ * A `.default(value)` on the base field means a record that leaves the discriminator out IS a `value` record: the
50
+ * family's union, and every create request derived from it, fill it in, so a client may omit the field exactly as
51
+ * the published schema says. An update never fills it: a partial update that leaves the discriminator out keeps the
52
+ * record's own variant.
48
53
  */
49
54
  field: TDiscriminatorField;
50
55
  /**
@@ -211,12 +216,22 @@ export function createSchemaFamily<
211
216
  // Build discriminated union - use any to avoid Zod 4 type complexity
212
217
  const allVariantSchemas: z.ZodObject<z.ZodRawShape>[] = [];
213
218
 
219
+ // The default the base field declares is what a record that omits the discriminator IS (#2076). Each union member's
220
+ // literal replaces the base field, so the member holding that value must carry the default itself, in the one shape a
221
+ // Zod 4 discriminated union can route an absent key by: see `withDeclaredFamilyDiscriminatorDefault`. Only the UNION
222
+ // members carry it; `variants` and `inheritenceSchemaDefinition` describe one variant each, where the literal names it.
223
+ const declaredDiscriminatorDefault = declaredFamilyDiscriminatorDefault(baseShape[discriminator.field]);
224
+ const unionMemberDiscriminator = (value: string) => withDeclaredFamilyDiscriminatorDefault(
225
+ discriminatorLiteralFor(discriminator.field, value, baseShape[discriminator.field], resolvedBaseValues),
226
+ declaredDiscriminatorDefault,
227
+ );
228
+
214
229
  // Add base schemas for baseValues
215
230
  // Mark discriminator field with isDiscriminator decorator so it's distinguished from non-discriminator literals
216
231
  for (const value of resolvedBaseValues || []) {
217
232
  allVariantSchemas.push(
218
233
  base.extend({
219
- [discriminator.field]: discriminatorLiteralFor(discriminator.field, value, baseShape[discriminator.field], resolvedBaseValues)
234
+ [discriminator.field]: unionMemberDiscriminator(value)
220
235
  }) as z.ZodObject<z.ZodRawShape>
221
236
  );
222
237
  }
@@ -226,7 +241,7 @@ export function createSchemaFamily<
226
241
  for (const [value, schema] of Object.entries(extendedVariants)) {
227
242
  allVariantSchemas.push(
228
243
  schema.extend({
229
- [discriminator.field]: discriminatorLiteralFor(discriminator.field, value, baseShape[discriminator.field], resolvedBaseValues)
244
+ [discriminator.field]: unionMemberDiscriminator(value)
230
245
  }) as z.ZodObject<z.ZodRawShape>
231
246
  );
232
247
  }
@@ -10,6 +10,12 @@ Use it when you need to confirm:
10
10
  - that the same methods remain available after common wrappers like `.default()` and `.optional()`
11
11
  - which methods are the right shared-layer primitives before any UI/spec follow-up
12
12
 
13
+ Which of these a field offers depends on its schema type, and only on that. A decorator returns the
14
+ schema's own type, so `z.enum(...).isDBIndexed()` offers what an enum offers: `.isUnique()` and
15
+ `.isPrimaryKey()` are not on an enum, and the chain does not compile. If the compiler says a decorator
16
+ does not exist on a type, it does not exist there at run time either; put the constraint on a field
17
+ whose type carries it (for a compound unique key, `organizationId.isUnique({ compoundWith: 'unit' })`).
18
+
13
19
  ## Shared Structural Methods
14
20
 
15
21
  ## Import Origins
@@ -170,6 +176,27 @@ Use it when you need to confirm:
170
176
  },
171
177
  ]);
172
178
  },
179
+ // compoundIndex (#3142): one more NON-unique index over several fields of this object. Validated at decoration time,
180
+ // like businessKeySet, so an index cannot name a field the row does not carry; storage would otherwise build an index
181
+ // over a path that is always empty, or the SQL plan would refuse at migration time, far from the declaration.
182
+ compoundIndex: function(this: z.ZodTypeAny, fields: string[]): DecoratedPrimitiveZodType<z.ZodTypeAny> {
183
+ if (!Array.isArray(fields) || fields.length < 2) {
184
+ throw new Error(
185
+ `compoundIndex([...]) needs at least two field names (received ${JSON.stringify(fields)}); a one-field index is .isDBIndexed() on the field.`,
186
+ );
187
+ }
188
+ const repeated = fields.filter((field, index) => fields.indexOf(field) !== index);
189
+ if (repeated.length > 0) {
190
+ throw new Error(`compoundIndex([...]) names a field more than once: ${[...new Set(repeated)].join(', ')}.`);
191
+ }
192
+ const node = this as unknown as { shape?: Record<string, unknown>; _zod?: { def?: { shape?: Record<string, unknown> } } };
193
+ const shape = node.shape ?? node._zod?.def?.shape;
194
+ const missing = fields.filter((field) => !shape || !(field in shape));
195
+ if (missing.length > 0) {
196
+ throw new Error(`compoundIndex([...]) references field(s) not present in the schema shape: ${missing.join(', ')}.`);
197
+ }
198
+ return addDecorators(this, [{ ref: ZodDecorator.OBJECT_COMPOUND_INDEX, params: { fields: [...fields] } }]);
199
+ },
173
200
  // isResourceReference (#2471): the object names one row of a resource chosen at run time. Validated at decoration
174
201
  // time, like businessKeySet: the object must HAVE the two members the reference is read through, or a form would
175
202
  // offer a picker that writes into fields the schema does not carry.
@@ -192,30 +219,15 @@ Use it when you need to confirm:
192
219
  ### Origin Package: `@wildo-ai/zod-decorators`
193
220
 
194
221
  ```typescript
195
- [ZodDecorator.IS_DB_INDEXED](): DecoratedPrimitiveZodType<T>;
196
- [ZodDecorator.IS_FOREIGN_KEY](params?: ZodDecorator_ParamsType[ZodDecorator.IS_FOREIGN_KEY]): DecoratedPrimitiveZodType<T>;
197
- [ZodDecorator.IS_SUMMARY_FIELD](params?: ZodDecorator_ParamsType[ZodDecorator.IS_SUMMARY_FIELD]): DecoratedPrimitiveZodType<T>;
198
- [ZodDecorator.IS_BACKEND_ONLY](params?: ZodDecorator_ParamsType[ZodDecorator.IS_BACKEND_ONLY]): DecoratedPrimitiveZodType<T>;
199
- [ZodDecorator.IS_WRITE_ONLY_SECRET](params?: ZodDecorator_ParamsType[ZodDecorator.IS_WRITE_ONLY_SECRET]): DecoratedPrimitiveZodType<T>;
200
- [ZodDecorator.IS_DISCRIMINATOR](params?: ZodDecorator_ParamsType[ZodDecorator.IS_DISCRIMINATOR]): DecoratedPrimitiveZodType<T>;
201
- [ZodDecorator.EXCLUDE_FROM_CREATE](): DecoratedPrimitiveZodType<T>;
202
- [ZodDecorator.EXCLUDE_FROM_UPDATE](): DecoratedPrimitiveZodType<T>;
203
- [ZodDecorator.IS_UNIQUE](params?: ZodDecorator_ParamsType[ZodDecorator.IS_UNIQUE]): DecoratedPrimitiveZodType<T>;
204
- [ZodDecorator.IS_PRIMARY_KEY](): DecoratedPrimitiveZodType<T>;
205
- [ZodDecorator.IS_BUSINESS_KEY](): DecoratedPrimitiveZodType<T>;
206
- [ZodDecorator.DOCUMENT_SEQUENCE](params: DocumentSequenceParams): DecoratedPrimitiveZodType<T>;
207
- [ZodDecorator.OBJECT_BUSINESS_KEY_SET](fields: string[], params?: Omit<BusinessKeySetParams, 'fields'>): DecoratedPrimitiveZodType<T>;
208
- [ZodDecorator.RESOURCE_REFERENCE](params: ResourceReferenceParams): DecoratedPrimitiveZodType<T>;
209
- [ZodDecorator.TTL](params: ZodDecorator_ParamsType[ZodDecorator.TTL]): DecoratedPrimitiveZodType<T>;
210
- /**
211
- * `z.date().isCalendarDate()` — the date is a CALENDAR DAY (a due date, a birthday, an invoice date), not an
212
- * instant. It is held as UTC midnight of the day and shown and picked as that day for every reader, whatever
213
- * their time zone; "tomorrow" is still measured from the reader's today. Leave it off a moment in time
214
- * (`createdAt`, `expiresAt`, `completedAt`): an undeclared date is an instant, shown in the reader's zone.
215
- * A day has no time of day, so it cannot also declare `dateTimeUI()`: combining the two throws when the schema
216
- * loads. Use `dateUI()` to style a calendar date's display, and `dateTimeUI()` alone for a moment.
217
- */
218
- [ZodDecorator.IS_CALENDAR_DATE](): DecoratedPrimitiveZodType<T>;
222
+ /**
223
+ * `z.date().isCalendarDate()` — the date is a CALENDAR DAY (a due date, a birthday, an invoice date), not an
224
+ * instant. It is held as UTC midnight of the day and shown and picked as that day for every reader, whatever
225
+ * their time zone; "tomorrow" is still measured from the reader's today. Leave it off a moment in time
226
+ * (`createdAt`, `expiresAt`, `completedAt`): an undeclared date is an instant, shown in the reader's zone.
227
+ * A day has no time of day, so it cannot also declare `dateTimeUI()`: combining the two throws when the schema
228
+ * loads. Use `dateUI()` to style a calendar date's display, and `dateTimeUI()` alone for a moment.
229
+ */
230
+ [ZodDecorator.IS_CALENDAR_DATE](): DecoratedPrimitiveZodType<this>;
219
231
  ```
220
232
 
221
233
  ### Origin Package: `@wildo-ai/zod-decorators`