@wildo-ai/framework-knowledge 1.1.11 → 1.1.13

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 (812) 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 +180 -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 +30 -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 +87 -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 +55 -8
  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 +19 -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/method.md +14 -0
  272. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +11 -7
  273. package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
  274. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
  275. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
  276. package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
  277. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
  278. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
  279. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
  280. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
  281. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
  282. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
  283. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
  284. package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
  285. package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
  286. package/dist/knowledge/references/application-maturity.config.md +70 -1
  287. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
  288. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
  289. package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
  290. package/dist/knowledge/references/brand.name-screening.config.md +30 -3
  291. package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
  292. package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
  293. package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
  294. package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
  295. package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
  296. package/dist/knowledge/references/companion.market.generation-service.md +46 -5
  297. package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
  298. package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
  299. package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
  300. package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
  301. package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
  302. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
  303. package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
  304. package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
  305. package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
  306. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
  307. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
  308. package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
  309. package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
  310. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
  311. package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
  312. package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
  313. package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
  314. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
  315. package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +21 -0
  316. package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
  317. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
  318. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
  319. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
  320. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
  321. package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
  322. package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
  323. package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
  324. package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
  325. package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
  326. package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
  327. package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
  328. package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
  329. package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
  330. package/dist/knowledge/references/example.website.section.stats.md +1 -1
  331. package/dist/knowledge/references/experience-plan.config.md +111 -1
  332. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
  333. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
  334. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
  335. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
  336. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
  337. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
  338. package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
  339. package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
  340. package/dist/knowledge/references/integration-plan.config.md +7 -7
  341. package/dist/knowledge/references/placement-plan.config.md +19 -0
  342. package/dist/knowledge/references/platform.config.backing-services.md +9 -11
  343. package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
  344. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
  345. package/dist/knowledge/references/platform.config.infrastructure-host.md +1 -1
  346. package/dist/knowledge/references/platform.config.platform-key-management.md +89 -10
  347. package/dist/knowledge/references/platform.config.saas.md +20 -18
  348. package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
  349. package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
  350. package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
  351. package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
  352. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
  353. package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
  354. package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
  355. package/dist/knowledge/references/requirements.engine-substance.md +38 -0
  356. package/dist/knowledge/references/requirements.functional-requirement.config.md +11 -0
  357. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +15 -4
  358. package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
  359. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +49 -2
  360. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
  361. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
  362. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
  363. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  364. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
  365. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
  366. package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
  367. package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
  368. package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
  369. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
  370. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
  371. package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
  372. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
  373. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
  374. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +435 -2
  375. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
  376. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
  377. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
  378. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
  379. package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
  380. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
  381. package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
  382. package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
  383. package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
  384. package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
  385. package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
  386. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
  387. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
  388. package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
  389. package/dist/knowledge/references/saas.frontend.chart-dashboard.md +133 -0
  390. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
  391. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
  392. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
  393. package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
  394. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
  395. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
  396. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
  397. package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
  398. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
  399. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
  400. package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
  401. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
  402. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
  403. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
  404. package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
  405. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
  406. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
  407. package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
  408. package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
  409. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
  410. package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
  411. package/dist/knowledge/references/saas.models.chart-dashboard-tile-sizes.md +40 -0
  412. package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
  413. package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
  414. package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
  415. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
  416. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
  417. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
  418. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
  419. package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
  420. package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
  421. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
  422. package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
  423. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
  424. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
  425. package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails-environment.md +52 -0
  426. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
  427. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
  428. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
  429. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
  430. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
  431. package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
  432. package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
  433. package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
  434. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
  435. package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
  436. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
  437. package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
  438. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
  439. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
  440. package/dist/knowledge/references/saas.models.organization-dashboard-layout.md +61 -0
  441. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
  442. package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
  443. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
  444. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
  445. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
  446. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
  447. package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
  448. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
  449. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
  450. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
  451. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
  452. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
  453. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
  454. package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
  455. package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
  456. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
  457. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
  458. package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
  459. package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
  460. package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
  461. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
  462. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
  463. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
  464. package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
  465. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
  466. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
  467. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
  468. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
  469. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
  470. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
  471. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
  472. package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
  473. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
  474. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
  475. package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
  476. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
  477. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
  478. package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
  479. package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
  480. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
  481. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
  482. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
  483. package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
  484. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
  485. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
  486. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
  487. package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
  488. package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
  489. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
  490. package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
  491. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
  492. package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
  493. package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
  494. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
  495. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
  496. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
  497. package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
  498. package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
  499. package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
  500. package/dist/knowledge/references/service-method.config.md +35 -2
  501. package/dist/knowledge/references/vision.constraint.config.md +4 -2
  502. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
  503. package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
  504. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
  505. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
  506. package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
  507. package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
  508. package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
  509. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
  510. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
  511. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
  512. package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
  513. package/dist/knowledge/references/zod.factories.code.md +4 -4
  514. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  515. package/dist/knowledge/references/zod.factories.money.md +4 -4
  516. package/dist/knowledge/references/zod.factories.phone.md +4 -4
  517. package/dist/knowledge/references/zod.factories.year-month.md +79 -0
  518. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  519. package/dist/knowledge/registries/framework-topics.json +455 -2
  520. package/dist/knowledge/registries/playbooks.json +51 -39
  521. package/dist/knowledge/registries/source-tags.json +2505 -1627
  522. package/dist/knowledge/rules/database-migration-obligation.md +6 -7
  523. package/dist/knowledge/rules/live-context-door.md +1 -1
  524. package/dist/knowledge/skills/INDEX.md +3 -1
  525. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
  526. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
  527. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
  528. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
  529. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
  530. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
  531. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
  532. package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
  533. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
  534. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
  535. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
  536. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
  537. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
  538. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
  539. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
  540. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
  541. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  542. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
  543. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
  544. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
  545. package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
  546. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
  547. package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
  548. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
  549. package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
  550. package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +90 -0
  551. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
  552. package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
  553. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
  554. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
  555. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
  556. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
  557. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
  558. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
  559. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
  560. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
  561. package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
  562. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
  563. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
  564. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
  565. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
  566. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
  567. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
  568. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
  569. package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
  570. package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
  571. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
  572. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
  573. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
  574. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
  575. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
  576. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +240 -9
  577. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
  578. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
  579. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
  580. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
  581. package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
  582. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
  583. package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
  584. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
  585. package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
  586. package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
  587. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
  588. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
  589. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
  590. package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
  591. package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +78 -0
  592. package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
  593. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
  594. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
  595. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
  596. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
  597. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
  598. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +13 -3
  599. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
  600. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +34 -11
  601. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
  602. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
  603. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +188 -10
  604. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
  605. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
  606. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
  607. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
  608. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
  609. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +447 -8
  610. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
  611. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
  612. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
  613. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +13 -3
  614. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
  615. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
  616. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +13 -3
  617. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
  618. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
  619. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -1
  620. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +6 -5
  621. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +50 -14
  622. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
  623. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
  624. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
  625. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
  626. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
  627. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
  628. package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
  629. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
  630. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
  631. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
  632. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
  633. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
  634. package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
  635. package/dist/knowledge/skills/infra-environment-config/SKILL.md +149 -77
  636. package/dist/knowledge/skills/infra-environment-config/references/framework-agent-content-guardrails-environment-api.md +67 -0
  637. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
  638. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
  639. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +1 -1
  640. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +89 -10
  641. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
  642. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
  643. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
  644. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
  645. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
  646. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
  647. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
  648. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
  649. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
  650. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
  651. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
  652. package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
  653. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
  654. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
  655. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
  656. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
  657. package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
  658. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
  659. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
  660. package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
  661. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
  662. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
  663. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
  664. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
  665. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
  666. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
  667. package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -15
  668. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
  669. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
  670. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
  671. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
  672. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
  673. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
  674. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
  675. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
  676. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
  677. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
  678. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
  679. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
  680. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
  681. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
  682. package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
  683. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
  684. package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
  685. package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
  686. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
  687. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
  688. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
  689. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
  690. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
  691. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +34 -7
  692. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
  693. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
  694. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
  695. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +28 -2
  696. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
  697. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
  698. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
  699. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
  700. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
  701. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
  702. package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
  703. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
  704. package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
  705. package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
  706. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
  707. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
  708. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
  709. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
  710. package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
  711. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
  712. package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
  713. package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
  714. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
  715. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
  716. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
  717. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
  718. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
  719. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
  720. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
  721. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
  722. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
  723. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
  724. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
  725. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
  726. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
  727. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
  728. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
  729. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
  730. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
  731. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  732. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
  733. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
  734. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
  735. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
  736. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
  737. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
  738. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
  739. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
  740. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
  741. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
  742. package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
  743. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
  744. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
  745. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
  746. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
  747. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
  748. package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
  749. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
  750. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
  751. package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
  752. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
  753. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
  754. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
  755. package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
  756. package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
  757. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
  758. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
  759. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
  760. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
  761. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
  762. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
  763. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
  764. package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
  765. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
  766. package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
  767. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
  768. package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
  769. package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
  770. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
  771. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
  772. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  773. package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
  774. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
  775. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
  776. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
  777. package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +371 -0
  778. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
  779. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
  780. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
  781. package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
  782. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
  783. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
  784. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
  785. package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
  786. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
  787. package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
  788. package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
  789. package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
  790. package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
  791. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
  792. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
  793. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
  794. package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
  795. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
  796. package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
  797. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
  798. package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
  799. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
  800. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
  801. package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
  802. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
  803. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
  804. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
  805. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
  806. package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
  807. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
  808. package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
  809. package/dist/knowledge/topic-index.json +2422 -723
  810. package/dist/tsconfig.build.tsbuildinfo +1 -1
  811. package/package.json +6 -6
  812. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -126,6 +126,50 @@ function assertCalendarDateNotDateTime(decorator: ZodDecorator, currentMetadata:
126
126
  }
127
127
  }
128
128
 
129
+ /**
130
+ * The decorators that mark a value as a SECRET, each with the reason a subject-disclosed backend-only field
131
+ * (`isBackendOnly({ disclosedToSubject: true })`, #2958) may never carry it. One table, consulted in both application
132
+ * orders by {@link assertSubjectDisclosureAdmissible}, at the same chokepoint as the RAG-source pairs, so no door into the
133
+ * metadata bypasses it.
134
+ */
135
+ const SUBJECT_DISCLOSURE_REFUSED_COMPANIONS: ReadonlyMap<ZodDecorator, string> = new Map([
136
+ [ZodDecorator.IS_PASSWORD, 'a password never leaves the backend, not even to the person it belongs to.'],
137
+ [ZodDecorator.IS_OTP, 'a one-time code never leaves the backend once it was sent.'],
138
+ [ZodDecorator.IS_WRITE_ONLY_SECRET, 'a write-only secret is masked on every response, so it is not disclosed to anyone.'],
139
+ [ZodDecorator.IS_EPHEMERAL, 'an ephemeral value is shown once, when it is minted, and never again.'],
140
+ ]);
141
+
142
+ /** Whether a stored `IS_BACKEND_ONLY` value declares the subject-disclosure opt-in. */
143
+ function declaresDisclosedToSubject(value: unknown): boolean {
144
+ return typeof value === 'object' && value !== null && (value as BackendOnlyFieldParams).disclosedToSubject === true;
145
+ }
146
+
147
+ /**
148
+ * Refuse `isBackendOnly({ disclosedToSubject: true })` on a field that holds a secret, in either order (#2958): applied to
149
+ * a field already marked a secret, applied with `isReturnedAtCreation` (a server-minted secret shown once), or a secret
150
+ * marker applied to a field already opted in. Run after an updater is resolved, so an updater that adds the opt-in is
151
+ * checked too, and before anything is written.
152
+ */
153
+ function assertSubjectDisclosureAdmissible(decorator: ZodDecorator, params: unknown, currentMetadata: CustomFieldMetadata): void {
154
+ if (decorator === ZodDecorator.IS_BACKEND_ONLY) {
155
+ if (!declaresDisclosedToSubject(params)) return;
156
+ if ((params as BackendOnlyFieldParams).isReturnedAtCreation) {
157
+ throw new Error('isBackendOnly() cannot declare both disclosedToSubject and isReturnedAtCreation: a value returned once at creation is a '
158
+ + 'server-minted secret, and a subject export never discloses a secret.');
159
+ }
160
+ for (const [companion, reason] of SUBJECT_DISCLOSURE_REFUSED_COMPANIONS) {
161
+ if (currentMetadata[companion] !== undefined) {
162
+ throw new Error(`isBackendOnly({ disclosedToSubject: true }) cannot be combined with ${companion}(): ${reason}`);
163
+ }
164
+ }
165
+ return;
166
+ }
167
+ const reason = SUBJECT_DISCLOSURE_REFUSED_COMPANIONS.get(decorator);
168
+ if (reason !== undefined && declaresDisclosedToSubject(currentMetadata[ZodDecorator.IS_BACKEND_ONLY])) {
169
+ throw new Error(`${decorator}() cannot be combined with isBackendOnly({ disclosedToSubject: true }): ${reason}`);
170
+ }
171
+ }
172
+
129
173
  function applySingleDecorator<T extends z.ZodTypeAny>(
130
174
  schema: T,
131
175
  decorator: ZodDecorator,
@@ -155,6 +199,8 @@ function applySingleDecorator<T extends z.ZodTypeAny>(
155
199
  params = (params as (current: unknown) => unknown)(currentValue) as typeof params;
156
200
  resolvedFromUpdater = true;
157
201
  }
202
+ // A subject-disclosed backend-only field never holds a secret (#2958). Checked on the RESOLVED params, before any write.
203
+ assertSubjectDisclosureAdmissible(decorator, params, currentMetadata);
158
204
  // After function resolution, params is a concrete value (never a function).
159
205
  // TypeScript can't narrow this from control flow. Use `rp<D>()` for typed
160
206
  // access in cases that read properties; use `p` for simple assignments.
@@ -314,6 +360,9 @@ function applySingleDecorator<T extends z.ZodTypeAny>(
314
360
  case ZodDecorator.IS_DECIDER:
315
361
  currentMetadata[ZodDecorator.IS_DECIDER] = true;
316
362
  break;
363
+ case ZodDecorator.IS_ROLE_GRANT:
364
+ currentMetadata[ZodDecorator.IS_ROLE_GRANT] = true;
365
+ break;
317
366
  case ZodDecorator.RAG_SOURCE: {
318
367
  // NORMALIZE HERE, not in the doors — the impersonalizeWith discipline. A bare `.ragSource()`
319
368
  // (the common case) stores `{}` rather than `true`/`undefined`, so every reader sees ONE
@@ -391,6 +440,17 @@ function applySingleDecorator<T extends z.ZodTypeAny>(
391
440
  case ZodDecorator.OBJECT_BUSINESS_KEY_SET:
392
441
  currentMetadata[ZodDecorator.OBJECT_BUSINESS_KEY_SET] = p;
393
442
  break;
443
+ case ZodDecorator.OBJECT_COMPOUND_INDEX: {
444
+ // ACCUMULATES: each call declares one more index. A fresh array, never a push, so the schema this one was
445
+ // derived from keeps its own list (decorators are builders, #1308). The same field list twice is one index.
446
+ const existing = (currentMetadata[ZodDecorator.OBJECT_COMPOUND_INDEX] ?? []) as CompoundIndexParams[];
447
+ const declared = p as CompoundIndexParams;
448
+ const key = declared.fields.join('\u0000');
449
+ currentMetadata[ZodDecorator.OBJECT_COMPOUND_INDEX] = existing.some((index) => index.fields.join('\u0000') === key)
450
+ ? existing
451
+ : [...existing, { fields: [...declared.fields] }];
452
+ break;
453
+ }
394
454
  case ZodDecorator.RESOURCE_REFERENCE:
395
455
  currentMetadata[ZodDecorator.RESOURCE_REFERENCE] = p;
396
456
  break;
@@ -226,52 +226,6 @@ export function isPersonalDataAboutAnotherParty(schema: z.ZodTypeAny): boolean {
226
226
 
227
227
  ### Origin Package: `@wildo-ai/zod-decorators`
228
228
 
229
- ```typescript
230
- *
231
- * Declare WHICH KINDS of personal data this field holds — the vocabulary a privacy notice
232
- * enumerates. Import `PersonalDataCategory` from `@wildo-ai/saas-models`.
233
- *
234
- * Accepts a single category (the common case) or an array when a field genuinely spans two. At
235
- * least one is required: a field that holds NO personal data carries no declaration at all, and
236
- * that absence is exactly what the compliance gap report reads.
237
- *
238
- * Declare it on the field that holds the value. Never on a field merely because its NAME suggests
239
- * a category — `credentials` is the one category the framework derives for you, and it derives it
240
- * from `.isPassword()` / `.isOtp()` / `.isWriteOnlySecret()`, never from an identifier.
241
- *
242
- * `options.personalOnlyWhen` takes a `PersonalDataCondition` (also from `@wildo-ai/saas-models`)
243
- * for a field that is personal data only on some rows. The case it exists for is a field naming
244
- * the PARTY a row describes — a customer account, a supplier: it is an individual's data when that
245
- * party is a sole trader, and a company's when it is not. The field still counts as personal data
246
- * for erasure, export and every guard; the privacy notice lists it as held "where the customer is
247
- * an individual" instead of claiming it about every customer. Do not use it for a field naming a
248
- * person AT a company (a contact's email): that is personal on every row.
249
- *
250
- * `options.aboutAnotherParty: true` says the field names a party OTHER than the one the row is about: a
251
- * copy of another organization's name kept on a cost record or a relationship. It decides only one thing:
252
- * a resource declaring `retentionPolicy: RETAIN_ONLY` ("no personal data about its own subject") may keep
253
- * such a copy. Leave it off the row's own party's name (a customer account's own name), which that
254
- * resource may not keep.
255
- *
256
- * @example
257
- * fullName: z.string().dataCategories(PersonalDataCategory.IDENTITY)
258
- * @example
259
- * email: z.email().nullish().dataCategories(PersonalDataCategory.CONTACT_DETAILS)
260
- * @example
261
- * // A field that genuinely spans two — an array never forces you to pick a lie.
262
- * dietaryNotes: z.string().dataCategories([PersonalDataCategory.USER_CONTENT, PersonalDataCategory.SPECIAL_CATEGORY_HEALTH])
263
- * @example
264
- * // A customer account's name: a person's data only when the customer is a sole trader.
265
- * accountName: z.string().dataCategories(PersonalDataCategory.IDENTITY, { personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON })
266
- * @example
267
- * // The billed customer's name copied onto an invoice line: another party's name, not the line's subject.
268
- * customerName: z.string().dataCategories(PersonalDataCategory.IDENTITY, { personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON, aboutAnotherParty: true })
269
- */
270
- [ZodDecorator.DATA_CATEGORIES](categories: string | readonly string[], options?: DataCategoriesOptions): DecoratedPrimitiveZodType<T>;
271
- ```
272
-
273
- ### Origin Package: `@wildo-ai/zod-decorators`
274
-
275
229
  ```typescript
276
230
  */
277
231
  export function addDataCategories<T extends z.ZodTypeAny>(
@@ -285,3 +239,49 @@ export function addDataCategories<T extends z.ZodTypeAny>(
285
239
  ]);
286
240
  }
287
241
  ```
242
+
243
+ ### Origin Package: `@wildo-ai/zod-decorators`
244
+
245
+ ```typescript
246
+ *
247
+ * Declare WHICH KINDS of personal data this field holds — the vocabulary a privacy notice
248
+ * enumerates. Import `PersonalDataCategory` from `@wildo-ai/saas-models`.
249
+ *
250
+ * Accepts a single category (the common case) or an array when a field genuinely spans two. At
251
+ * least one is required: a field that holds NO personal data carries no declaration at all, and
252
+ * that absence is exactly what the compliance gap report reads.
253
+ *
254
+ * Declare it on the field that holds the value. Never on a field merely because its NAME suggests
255
+ * a category — `credentials` is the one category the framework derives for you, and it derives it
256
+ * from `.isPassword()` / `.isOtp()` / `.isWriteOnlySecret()`, never from an identifier.
257
+ *
258
+ * `options.personalOnlyWhen` takes a `PersonalDataCondition` (also from `@wildo-ai/saas-models`)
259
+ * for a field that is personal data only on some rows. The case it exists for is a field naming
260
+ * the PARTY a row describes — a customer account, a supplier: it is an individual's data when that
261
+ * party is a sole trader, and a company's when it is not. The field still counts as personal data
262
+ * for erasure, export and every guard; the privacy notice lists it as held "where the customer is
263
+ * an individual" instead of claiming it about every customer. Do not use it for a field naming a
264
+ * person AT a company (a contact's email): that is personal on every row.
265
+ *
266
+ * `options.aboutAnotherParty: true` says the field names a party OTHER than the one the row is about: a
267
+ * copy of another organization's name kept on a cost record or a relationship. It decides only one thing:
268
+ * a resource declaring `retentionPolicy: RETAIN_ONLY` ("no personal data about its own subject") may keep
269
+ * such a copy. Leave it off the row's own party's name (a customer account's own name), which that
270
+ * resource may not keep.
271
+ *
272
+ * @example
273
+ * fullName: z.string().dataCategories(PersonalDataCategory.IDENTITY)
274
+ * @example
275
+ * email: z.email().nullish().dataCategories(PersonalDataCategory.CONTACT_DETAILS)
276
+ * @example
277
+ * // A field that genuinely spans two — an array never forces you to pick a lie.
278
+ * dietaryNotes: z.string().dataCategories([PersonalDataCategory.USER_CONTENT, PersonalDataCategory.SPECIAL_CATEGORY_HEALTH])
279
+ * @example
280
+ * // A customer account's name: a person's data only when the customer is a sole trader.
281
+ * accountName: z.string().dataCategories(PersonalDataCategory.IDENTITY, { personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON })
282
+ * @example
283
+ * // The billed customer's name copied onto an invoice line: another party's name, not the line's subject.
284
+ * customerName: z.string().dataCategories(PersonalDataCategory.IDENTITY, { personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON, aboutAnotherParty: true })
285
+ */
286
+ [ZodDecorator.DATA_CATEGORIES](categories: string | readonly string[], options?: DataCategoriesOptions): DecoratedPrimitiveZodType<this>;
287
+ ```
@@ -153,6 +153,19 @@ export enum ZodDecorator {
153
153
  * not marked. No check runs over an application's resources yet: there the marker documents the field.
154
154
  */
155
155
  IS_DECIDER = "isDecider",
156
+ /**
157
+ * Role grant: this field's values are roles the WRITER grants (a membership's `roles`, a machine credential's
158
+ * `roles`, a unit assignment's `role`, an account's `appRoles`). A pure marker, read back with
159
+ * `isRoleGrantField(schema)`.
160
+ *
161
+ * What it changes: a form offers only the roles the person filling it may grant (#3248), decided by the rule the
162
+ * server's role-ceiling gate applies (`resolveRoleGrantCeiling` in `@wildo-ai/saas-models`), plus any role the
163
+ * record already holds, so a stored role is never dropped from view. It grants nothing and refuses nothing: the
164
+ * server gate on the write is the control, and the marker only keeps the form from offering what that gate refuses.
165
+ * Mark a field that a form offers roles in, where a write of it is checked against the writer's ceiling. A role
166
+ * grant typed as free text (an SSO connection's `roleMapping`) offers no roles, so marking it would narrow nothing.
167
+ */
168
+ IS_ROLE_GRANT = "isRoleGrant",
156
169
  /**
157
170
  * RAG source: this field's TEXT is a retrieval-corpus source. The framework chunks the value
158
171
  * (extracting text first for file fields), stores the chunks in the application's OWN datastore
@@ -224,6 +237,11 @@ export enum ZodDecorator {
224
237
  * (single field vs composite). Mixing is rejected at decoration time.
225
238
  */
226
239
  OBJECT_BUSINESS_KEY_SET = "businessKeySet",
240
+ /**
241
+ * Object-level: one NON-unique index over several fields, for reads that filter on the leading fields and sort on
242
+ * the last (#3142). Accumulates: each call declares one more index. See {@link CompoundIndexParams}.
243
+ */
244
+ OBJECT_COMPOUND_INDEX = "compoundIndex",
227
245
  /**
228
246
  * Object-level: the object (`{ resourceType, resourceId }`) names one row of a resource whose type is chosen at
229
247
  * run time from a published target set. See {@link ResourceReferenceParams}.
@@ -342,6 +360,7 @@ export type ZodDecorator_ParamsType = {
342
360
  // Last-action-record marker — parameterless: a field either records the last action or is state.
343
361
  [ZodDecorator.IS_LAST_ACTION_RECORD]: undefined;
344
362
  [ZodDecorator.IS_DECIDER]: undefined;
363
+ [ZodDecorator.IS_ROLE_GRANT]: undefined;
345
364
  /**
346
365
  * RAG-source declaration. The config object is optional — `.ragSource()` with no argument is a
347
366
  * complete declaration — and the chokepoint normalizes an omitted config to `{}` so every reader
@@ -360,6 +379,8 @@ export type ZodDecorator_ParamsType = {
360
379
  [ZodDecorator.DOCUMENT_SEQUENCE]: DocumentSequenceParams;
361
380
  // Composite business key (object-level decorator carrying the ordered list of field names)
362
381
  [ZodDecorator.OBJECT_BUSINESS_KEY_SET]: BusinessKeySetParams | DecoratorUpdater<BusinessKeySetParams>;
382
+ // One more compound index per call (the stored metadata is the accumulated list)
383
+ [ZodDecorator.OBJECT_COMPOUND_INDEX]: CompoundIndexParams;
363
384
  [ZodDecorator.RESOURCE_REFERENCE]: ResourceReferenceParams;
364
385
  [ZodDecorator.TTL]: TtlFieldParams | DecoratorUpdater<TtlFieldParams>;
365
386
  // String edit mode convenience decorators
@@ -444,6 +465,7 @@ export type ZodDecorator_Types = {
444
465
  /** Last-action-record marker — stored as the bare `true` sentinel (parameterless, like IS_AUDIT_EVIDENCE). */
445
466
  [ZodDecorator.IS_LAST_ACTION_RECORD]: true;
446
467
  [ZodDecorator.IS_DECIDER]: true;
468
+ [ZodDecorator.IS_ROLE_GRANT]: true;
447
469
  /** RAG-source config — ALWAYS the normalized object ( `{}` when authored with no argument): the
448
470
  * chokepoint validates and normalizes on the way in, so every reader sees one shape and
449
471
  * `getRagSourceConfig` can answer "is this field a source?" by presence alone. */
@@ -460,6 +482,8 @@ export type ZodDecorator_Types = {
460
482
  [ZodDecorator.DOCUMENT_SEQUENCE]: DocumentSequenceParams;
461
483
  // Composite business key (object-level — stored params shape after resolver unwraps DecoratorUpdater)
462
484
  [ZodDecorator.OBJECT_BUSINESS_KEY_SET]: BusinessKeySetParams;
485
+ // Every compound index the object declares, in declaration order
486
+ [ZodDecorator.OBJECT_COMPOUND_INDEX]: CompoundIndexParams[];
463
487
  [ZodDecorator.RESOURCE_REFERENCE]: ResourceReferenceParams;
464
488
  [ZodDecorator.TTL]: TtlFieldParams;
465
489
  // String edit mode convenience decorators
@@ -151,6 +151,12 @@ export const StringDisplayMode = {
151
151
  * `edit.editMode: StringEditMode.ORGANIZATION_ROLE` so the field is picked the way it is read.
152
152
  */
153
153
  ORGANIZATION_ROLE: 'organization_role',
154
+ /**
155
+ * The value is a calendar month, `YYYY-MM` — render it as the month and the year in the reader's locale
156
+ * ("October 2026", "octobre 2026"), never the raw string. A value that is not a year-month shows as typed. Declared
157
+ * by `z_yearMonth()`, which pairs it with `edit.editMode: StringEditMode.YEAR_MONTH`.
158
+ */
159
+ YEAR_MONTH: 'year_month',
154
160
  } as const;
155
161
  export type StringDisplayMode = typeof StringDisplayMode[keyof typeof StringDisplayMode];
156
162
 
@@ -182,6 +188,11 @@ export const StringEditMode = {
182
188
  * the operation's offer alone. The server remains the control: it decides what holding the role grants.
183
189
  */
184
190
  ORGANIZATION_ROLE: 'organization_role',
191
+ /**
192
+ * A MONTH-AND-YEAR picker: a list of the twelve months, named in the reader's locale, and a year. It writes the value
193
+ * as `YYYY-MM` and nothing else, so the user never types the format. Declared by `z_yearMonth()`.
194
+ */
195
+ YEAR_MONTH: 'year_month',
185
196
  } as const;
186
197
  export type StringEditMode = typeof StringEditMode[keyof typeof StringEditMode];
187
198
 
@@ -295,9 +295,10 @@ export function createFileSchema(
295
295
  * re-declaring them made both interfaces below fail TS2320: an interface may not extend two types
296
296
  * whose same-named member differs, and `TSelf` is not `DecoratedPrimitiveZodType<this>`.
297
297
  *
298
- * Removing the mixin costs nothing, because `DecoratedPrimitiveZodType<T>` is `T & { … }` — an
299
- * INTERSECTION. `z_file().isHidden()` still returns something assignable to `DecoratedFileSchema`,
300
- * and the full decorator surface is now available rather than the four this mixin listed.
298
+ * Removing the mixin costs nothing: every `ZodObject` decorator returns `DecoratedPrimitiveZodType<this>`,
299
+ * which is `this` itself (#3031), and `this` is `DecoratedFileSchema` here. So `z_file().isHidden()`
300
+ * stays a `DecoratedFileSchema`, keeps `fileUI`/`fileSpec`, and offers every decorator the `ZodObject`
301
+ * augmentation declares rather than the four this mixin listed.
301
302
  */
302
303
 
303
304
  /**
@@ -112,26 +112,6 @@ export function getRagSourceConfig(schema: z.ZodTypeAny): RagSourceConfiguration
112
112
 
113
113
  ### Origin Package: `@wildo-ai/zod-decorators`
114
114
 
115
- ```typescript
116
- *
117
- * `.ragSource(config?)` — declare this field's text a source of the application's retrieval
118
- * corpus. Live on every string-backed schema (`z.string()` and every string FORMAT such as
119
- * `z.email()` / `z.url()`) and carried across the `.optional()` / `.nullable()` / `.default()`
120
- * wrappers, so it composes anywhere in a decorator chain.
121
- *
122
- * The config is OPTIONAL and there is no `enabled` flag: a bare `.ragSource()` is a complete
123
- * declaration that accepts the framework chunking defaults. Presence IS enablement.
124
- *
125
- * @example
126
- * z.string().ragSource()
127
- * @example
128
- * z.string().ragSource({ chunkingStrategy: RAGChunkingStrategy.MARKDOWN, chunkSize: 1200, chunkOverlap: 150 }).optional()
129
- */
130
- [ZodDecorator.RAG_SOURCE](config?: RagSourceConfiguration): DecoratedPrimitiveZodType<T>;
131
- ```
132
-
133
- ### Origin Package: `@wildo-ai/zod-decorators`
134
-
135
115
  ```typescript
136
116
  *
137
117
  * Standalone form of `.ragSource(config?)` — declare a field's text a RAG retrieval-corpus source.
@@ -166,3 +146,23 @@ export function addRagSource<T extends z.ZodTypeAny>(
166
146
  ]);
167
147
  }
168
148
  ```
149
+
150
+ ### Origin Package: `@wildo-ai/zod-decorators`
151
+
152
+ ```typescript
153
+ *
154
+ * `.ragSource(config?)` — declare this field's text a source of the application's retrieval
155
+ * corpus. Live on every string-backed schema (`z.string()` and every string FORMAT such as
156
+ * `z.email()` / `z.url()`) and carried across the `.optional()` / `.nullable()` / `.default()`
157
+ * wrappers, so it composes anywhere in a decorator chain.
158
+ *
159
+ * The config is OPTIONAL and there is no `enabled` flag: a bare `.ragSource()` is a complete
160
+ * declaration that accepts the framework chunking defaults. Presence IS enablement.
161
+ *
162
+ * @example
163
+ * z.string().ragSource()
164
+ * @example
165
+ * z.string().ragSource({ chunkingStrategy: RAGChunkingStrategy.MARKDOWN, chunkSize: 1200, chunkOverlap: 150 }).optional()
166
+ */
167
+ [ZodDecorator.RAG_SOURCE](config?: RagSourceConfiguration): DecoratedPrimitiveZodType<this>;
168
+ ```
@@ -41,6 +41,7 @@ export interface CustomFieldMetadata {
41
41
  [ZodDecorator.IS_AUDIT_EVIDENCE]?: ZodDecorator_Types[ZodDecorator.IS_AUDIT_EVIDENCE];
42
42
  [ZodDecorator.IS_LAST_ACTION_RECORD]?: ZodDecorator_Types[ZodDecorator.IS_LAST_ACTION_RECORD];
43
43
  [ZodDecorator.IS_DECIDER]?: ZodDecorator_Types[ZodDecorator.IS_DECIDER];
44
+ [ZodDecorator.IS_ROLE_GRANT]?: ZodDecorator_Types[ZodDecorator.IS_ROLE_GRANT];
44
45
  [ZodDecorator.RAG_SOURCE]?: ZodDecorator_Types[ZodDecorator.RAG_SOURCE];
45
46
  [ZodDecorator.IS_VIRTUAL]?: ZodDecorator_Types[ZodDecorator.IS_VIRTUAL];
46
47
  [ZodDecorator.IS_DISCRIMINATOR]?: ZodDecorator_Types[ZodDecorator.IS_DISCRIMINATOR];
@@ -52,6 +53,7 @@ export interface CustomFieldMetadata {
52
53
  [ZodDecorator.IS_BUSINESS_KEY]?: ZodDecorator_Types[ZodDecorator.IS_BUSINESS_KEY];
53
54
  [ZodDecorator.DOCUMENT_SEQUENCE]?: ZodDecorator_Types[ZodDecorator.DOCUMENT_SEQUENCE];
54
55
  [ZodDecorator.OBJECT_BUSINESS_KEY_SET]?: ZodDecorator_Types[ZodDecorator.OBJECT_BUSINESS_KEY_SET];
56
+ [ZodDecorator.OBJECT_COMPOUND_INDEX]?: ZodDecorator_Types[ZodDecorator.OBJECT_COMPOUND_INDEX];
55
57
  [ZodDecorator.RESOURCE_REFERENCE]?: ZodDecorator_Types[ZodDecorator.RESOURCE_REFERENCE];
56
58
  [ZodDecorator.TTL]?: ZodDecorator_Types[ZodDecorator.TTL];
57
59
  // String edit mode convenience decorators
@@ -158,6 +158,27 @@
158
158
  },
159
159
  ]);
160
160
  },
161
+ // compoundIndex (#3142): one more NON-unique index over several fields of this object. Validated at decoration time,
162
+ // like businessKeySet, so an index cannot name a field the row does not carry; storage would otherwise build an index
163
+ // over a path that is always empty, or the SQL plan would refuse at migration time, far from the declaration.
164
+ compoundIndex: function(this: z.ZodTypeAny, fields: string[]): DecoratedPrimitiveZodType<z.ZodTypeAny> {
165
+ if (!Array.isArray(fields) || fields.length < 2) {
166
+ throw new Error(
167
+ `compoundIndex([...]) needs at least two field names (received ${JSON.stringify(fields)}); a one-field index is .isDBIndexed() on the field.`,
168
+ );
169
+ }
170
+ const repeated = fields.filter((field, index) => fields.indexOf(field) !== index);
171
+ if (repeated.length > 0) {
172
+ throw new Error(`compoundIndex([...]) names a field more than once: ${[...new Set(repeated)].join(', ')}.`);
173
+ }
174
+ const node = this as unknown as { shape?: Record<string, unknown>; _zod?: { def?: { shape?: Record<string, unknown> } } };
175
+ const shape = node.shape ?? node._zod?.def?.shape;
176
+ const missing = fields.filter((field) => !shape || !(field in shape));
177
+ if (missing.length > 0) {
178
+ throw new Error(`compoundIndex([...]) references field(s) not present in the schema shape: ${missing.join(', ')}.`);
179
+ }
180
+ return addDecorators(this, [{ ref: ZodDecorator.OBJECT_COMPOUND_INDEX, params: { fields: [...fields] } }]);
181
+ },
161
182
  // isResourceReference (#2471): the object names one row of a resource chosen at run time. Validated at decoration
162
183
  // time, like businessKeySet: the object must HAVE the two members the reference is read through, or a form would
163
184
  // offer a picker that writes into fields the schema does not carry.
@@ -180,30 +201,15 @@
180
201
  ### Origin Package: `@wildo-ai/zod-decorators`
181
202
 
182
203
  ```typescript
183
- [ZodDecorator.IS_DB_INDEXED](): DecoratedPrimitiveZodType<T>;
184
- [ZodDecorator.IS_FOREIGN_KEY](params?: ZodDecorator_ParamsType[ZodDecorator.IS_FOREIGN_KEY]): DecoratedPrimitiveZodType<T>;
185
- [ZodDecorator.IS_SUMMARY_FIELD](params?: ZodDecorator_ParamsType[ZodDecorator.IS_SUMMARY_FIELD]): DecoratedPrimitiveZodType<T>;
186
- [ZodDecorator.IS_BACKEND_ONLY](params?: ZodDecorator_ParamsType[ZodDecorator.IS_BACKEND_ONLY]): DecoratedPrimitiveZodType<T>;
187
- [ZodDecorator.IS_WRITE_ONLY_SECRET](params?: ZodDecorator_ParamsType[ZodDecorator.IS_WRITE_ONLY_SECRET]): DecoratedPrimitiveZodType<T>;
188
- [ZodDecorator.IS_DISCRIMINATOR](params?: ZodDecorator_ParamsType[ZodDecorator.IS_DISCRIMINATOR]): DecoratedPrimitiveZodType<T>;
189
- [ZodDecorator.EXCLUDE_FROM_CREATE](): DecoratedPrimitiveZodType<T>;
190
- [ZodDecorator.EXCLUDE_FROM_UPDATE](): DecoratedPrimitiveZodType<T>;
191
- [ZodDecorator.IS_UNIQUE](params?: ZodDecorator_ParamsType[ZodDecorator.IS_UNIQUE]): DecoratedPrimitiveZodType<T>;
192
- [ZodDecorator.IS_PRIMARY_KEY](): DecoratedPrimitiveZodType<T>;
193
- [ZodDecorator.IS_BUSINESS_KEY](): DecoratedPrimitiveZodType<T>;
194
- [ZodDecorator.DOCUMENT_SEQUENCE](params: DocumentSequenceParams): DecoratedPrimitiveZodType<T>;
195
- [ZodDecorator.OBJECT_BUSINESS_KEY_SET](fields: string[], params?: Omit<BusinessKeySetParams, 'fields'>): DecoratedPrimitiveZodType<T>;
196
- [ZodDecorator.RESOURCE_REFERENCE](params: ResourceReferenceParams): DecoratedPrimitiveZodType<T>;
197
- [ZodDecorator.TTL](params: ZodDecorator_ParamsType[ZodDecorator.TTL]): DecoratedPrimitiveZodType<T>;
198
- /**
199
- * `z.date().isCalendarDate()` — the date is a CALENDAR DAY (a due date, a birthday, an invoice date), not an
200
- * instant. It is held as UTC midnight of the day and shown and picked as that day for every reader, whatever
201
- * their time zone; "tomorrow" is still measured from the reader's today. Leave it off a moment in time
202
- * (`createdAt`, `expiresAt`, `completedAt`): an undeclared date is an instant, shown in the reader's zone.
203
- * A day has no time of day, so it cannot also declare `dateTimeUI()`: combining the two throws when the schema
204
- * loads. Use `dateUI()` to style a calendar date's display, and `dateTimeUI()` alone for a moment.
205
- */
206
- [ZodDecorator.IS_CALENDAR_DATE](): DecoratedPrimitiveZodType<T>;
204
+ /**
205
+ * `z.date().isCalendarDate()` — the date is a CALENDAR DAY (a due date, a birthday, an invoice date), not an
206
+ * instant. It is held as UTC midnight of the day and shown and picked as that day for every reader, whatever
207
+ * their time zone; "tomorrow" is still measured from the reader's today. Leave it off a moment in time
208
+ * (`createdAt`, `expiresAt`, `completedAt`): an undeclared date is an instant, shown in the reader's zone.
209
+ * A day has no time of day, so it cannot also declare `dateTimeUI()`: combining the two throws when the schema
210
+ * loads. Use `dateUI()` to style a calendar date's display, and `dateTimeUI()` alone for a moment.
211
+ */
212
+ [ZodDecorator.IS_CALENDAR_DATE](): DecoratedPrimitiveZodType<this>;
207
213
  ```
208
214
 
209
215
  ### Origin Package: `@wildo-ai/zod-decorators`
@@ -89,6 +89,35 @@ export interface BackendOnlyFieldParams {
89
89
  * material is attributable.
90
90
  */
91
91
  isReturnedAtCreation?: boolean;
92
+ /**
93
+ * `true` declares that this backend-only value is the SUBJECT'S OWN DATA, so a person's ACCESS export (GDPR Art. 15)
94
+ * carries it: `isBackendOnly({ disclosedToSubject: true })`. It changes nothing else: the field is still stripped from
95
+ * every request and response DTO, every listing and every model or tool output.
96
+ *
97
+ * Why it exists (#2958). A subject export reads rows below the DTO projection, so it withholds every backend-only field
98
+ * as a security floor: that is what keeps a password hash or a token hash out of a bundle. Many backend-only fields are
99
+ * not secrets, though. They are kept off the API because a generic reader must not see them (who a pending decision is
100
+ * routed to, when it was decided, which chat card a person was sent), and to the person they are about they are plain
101
+ * personal data. Without this declaration such a row reached its subject with that substance withheld.
102
+ *
103
+ * Declare it only where the value is about the person who receives the export: never on a credential, a secret, a
104
+ * token or a lease, never on a field holding other people's data (a list of everyone a row names). When the row can also
105
+ * reach someone it is NOT about (a conversation's owner, for the id of the person who decided on it), the resource
106
+ * withholds the field from that path as other people's data (`subjectExportOthersDataFields`).
107
+ *
108
+ * A portability export (Art. 20) still withholds it: a backend-only value is written by the system and never provided
109
+ * by the subject through any request, so it is outside what Art. 20 covers.
110
+ *
111
+ * Refused, at the decorator chokepoint and in either order, beside `isPassword()`, `isOtp()`, `isWriteOnlySecret()`,
112
+ * `isEphemeral()` and `isReturnedAtCreation`: each marks a secret. A field the application declares
113
+ * `.dataCategories(CREDENTIALS)` is refused when its resource configuration is built.
114
+ *
115
+ * spec-cite: GDPR Art. 15(1), 15(3) (https://gdpr-info.eu/art-15-gdpr/); Art. 20(1) (https://gdpr-info.eu/art-20-gdpr/)
116
+ *
117
+ * assurance-control: WILDO.PRIVACY.SUBJECT_DATA_EXPORT — a backend-only value about the subject reaches their access
118
+ * export only by this declaration, never by loosening the floor.
119
+ */
120
+ disclosedToSubject?: true;
92
121
  }
93
122
 
94
123
  /**
@@ -266,6 +295,40 @@ export interface BusinessKeySetParams {
266
295
  conflictMessageReference?: string;
267
296
  }
268
297
 
298
+ /**
299
+ * One NON-UNIQUE index over several fields, declared with the object-level `compoundIndex([...])` decorator (#3142).
300
+ *
301
+ * Declare one for a read that filters on some fields and sorts on another, when the table grows without bound: "one
302
+ * organization's audit rows of one event type, newest first" is `['organizationId', 'eventType', 'createdAt']`. Order is
303
+ * the index's identity and decides which reads it serves: the equality filters come first, the sort field last. A read
304
+ * filtering on a leading PREFIX of the list is served as well, so `['organizationId', 'createdAt']` also serves "one
305
+ * organization's rows". The index is walked in either direction, so newest-first needs no descending declaration.
306
+ *
307
+ * Why separate per-field `.isDBIndexed()` declarations are not the same thing: the database may combine two of them for
308
+ * an equality filter, but it cannot use them to return a filtered set already in sort order, so it either sorts the whole
309
+ * filtered set or walks the sort field's index and discards every row of the other tenants. Measured on a 580,000-row
310
+ * PostgreSQL audit trail: 534 ms and 2.2 s through per-field indexes, 1 to 9 ms through the compound one.
311
+ *
312
+ * Uniqueness is NOT what this declares; a composite IDENTITY is `.businessKeySet([...])`. Every field must be declared
313
+ * on the object (checked at decoration time) and STORED (not `.isVirtual()`), there must be at least two (one field is
314
+ * `.isDBIndexed()`), and none may repeat. Several indexes are declared by calling the decorator once per index. An
315
+ * object derived with `.omit()` / `.pick()` keeps only the indexes whose fields it still has. Both storage adapters
316
+ * honour it: MongoDB builds the index (ended on `_id`, as every plain index is, so a paged read's total order is
317
+ * served), and the PostgreSQL plan records it so `wildo db generate` writes the migration that creates it. Not yet
318
+ * supported on the BASE schema of a polymorphic resource, which refuses outer-level metadata it cannot carry to its
319
+ * variants: declare it on a resource whose main schema is a plain object.
320
+ *
321
+ * @example
322
+ * // one tenant's trail, optionally of one event type, newest first
323
+ * z.object({ organizationId: z.string().optional(), eventType: z.string(), createdAt: z.date() })
324
+ * .compoundIndex(['organizationId', 'eventType', 'createdAt'])
325
+ * .compoundIndex(['organizationId', 'createdAt'])
326
+ */
327
+ export interface CompoundIndexParams {
328
+ /** The indexed fields, in index order: equality filters first, the sort field last. */
329
+ fields: string[];
330
+ }
331
+
269
332
  /**
270
333
  * Parameters for the object-level `isResourceReference({ targetSet })` decorator (#2471).
271
334
  *
@@ -99,6 +99,35 @@ export interface BackendOnlyFieldParams {
99
99
  * material is attributable.
100
100
  */
101
101
  isReturnedAtCreation?: boolean;
102
+ /**
103
+ * `true` declares that this backend-only value is the SUBJECT'S OWN DATA, so a person's ACCESS export (GDPR Art. 15)
104
+ * carries it: `isBackendOnly({ disclosedToSubject: true })`. It changes nothing else: the field is still stripped from
105
+ * every request and response DTO, every listing and every model or tool output.
106
+ *
107
+ * Why it exists (#2958). A subject export reads rows below the DTO projection, so it withholds every backend-only field
108
+ * as a security floor: that is what keeps a password hash or a token hash out of a bundle. Many backend-only fields are
109
+ * not secrets, though. They are kept off the API because a generic reader must not see them (who a pending decision is
110
+ * routed to, when it was decided, which chat card a person was sent), and to the person they are about they are plain
111
+ * personal data. Without this declaration such a row reached its subject with that substance withheld.
112
+ *
113
+ * Declare it only where the value is about the person who receives the export: never on a credential, a secret, a
114
+ * token or a lease, never on a field holding other people's data (a list of everyone a row names). When the row can also
115
+ * reach someone it is NOT about (a conversation's owner, for the id of the person who decided on it), the resource
116
+ * withholds the field from that path as other people's data (`subjectExportOthersDataFields`).
117
+ *
118
+ * A portability export (Art. 20) still withholds it: a backend-only value is written by the system and never provided
119
+ * by the subject through any request, so it is outside what Art. 20 covers.
120
+ *
121
+ * Refused, at the decorator chokepoint and in either order, beside `isPassword()`, `isOtp()`, `isWriteOnlySecret()`,
122
+ * `isEphemeral()` and `isReturnedAtCreation`: each marks a secret. A field the application declares
123
+ * `.dataCategories(CREDENTIALS)` is refused when its resource configuration is built.
124
+ *
125
+ * spec-cite: GDPR Art. 15(1), 15(3) (https://gdpr-info.eu/art-15-gdpr/); Art. 20(1) (https://gdpr-info.eu/art-20-gdpr/)
126
+ *
127
+ * assurance-control: WILDO.PRIVACY.SUBJECT_DATA_EXPORT — a backend-only value about the subject reaches their access
128
+ * export only by this declaration, never by loosening the floor.
129
+ */
130
+ disclosedToSubject?: true;
102
131
  }
103
132
 
104
133
  /**
@@ -466,6 +495,40 @@ export interface BusinessKeySetParams {
466
495
  conflictMessageReference?: string;
467
496
  }
468
497
 
498
+ /**
499
+ * One NON-UNIQUE index over several fields, declared with the object-level `compoundIndex([...])` decorator (#3142).
500
+ *
501
+ * Declare one for a read that filters on some fields and sorts on another, when the table grows without bound: "one
502
+ * organization's audit rows of one event type, newest first" is `['organizationId', 'eventType', 'createdAt']`. Order is
503
+ * the index's identity and decides which reads it serves: the equality filters come first, the sort field last. A read
504
+ * filtering on a leading PREFIX of the list is served as well, so `['organizationId', 'createdAt']` also serves "one
505
+ * organization's rows". The index is walked in either direction, so newest-first needs no descending declaration.
506
+ *
507
+ * Why separate per-field `.isDBIndexed()` declarations are not the same thing: the database may combine two of them for
508
+ * an equality filter, but it cannot use them to return a filtered set already in sort order, so it either sorts the whole
509
+ * filtered set or walks the sort field's index and discards every row of the other tenants. Measured on a 580,000-row
510
+ * PostgreSQL audit trail: 534 ms and 2.2 s through per-field indexes, 1 to 9 ms through the compound one.
511
+ *
512
+ * Uniqueness is NOT what this declares; a composite IDENTITY is `.businessKeySet([...])`. Every field must be declared
513
+ * on the object (checked at decoration time) and STORED (not `.isVirtual()`), there must be at least two (one field is
514
+ * `.isDBIndexed()`), and none may repeat. Several indexes are declared by calling the decorator once per index. An
515
+ * object derived with `.omit()` / `.pick()` keeps only the indexes whose fields it still has. Both storage adapters
516
+ * honour it: MongoDB builds the index (ended on `_id`, as every plain index is, so a paged read's total order is
517
+ * served), and the PostgreSQL plan records it so `wildo db generate` writes the migration that creates it. Not yet
518
+ * supported on the BASE schema of a polymorphic resource, which refuses outer-level metadata it cannot carry to its
519
+ * variants: declare it on a resource whose main schema is a plain object.
520
+ *
521
+ * @example
522
+ * // one tenant's trail, optionally of one event type, newest first
523
+ * z.object({ organizationId: z.string().optional(), eventType: z.string(), createdAt: z.date() })
524
+ * .compoundIndex(['organizationId', 'eventType', 'createdAt'])
525
+ * .compoundIndex(['organizationId', 'createdAt'])
526
+ */
527
+ export interface CompoundIndexParams {
528
+ /** The indexed fields, in index order: equality filters first, the sort field last. */
529
+ fields: string[];
530
+ }
531
+
469
532
  /**
470
533
  * Parameters for the object-level `isResourceReference({ targetSet })` decorator (#2471).
471
534
  *
@@ -104,10 +104,10 @@ export function createBigDecimalSchema(
104
104
 
105
105
  /**
106
106
  * The chainable methods of `DecoratedBigDecimalSchema`, returning `this` so a chain of several decorations keeps
107
- * the type it reached: `.isSummaryField()` turns the field into a `DecoratedPrimitiveZodType<DecoratedBigDecimalSchema>`,
108
- * and a spec or UI method called after it must return that, not the bare factory type. A method
109
- * returning `DecoratedBigDecimalSchema` itself won that overload inside the intersection, so a resource
110
- * specification's field map rejected `schemaShape.x.<factory>Spec(...)` on a decorated field.
107
+ * the type it reached, whatever the receiver is (`typeof field` in a resource specification's field map).
108
+ * A method returning the bare `DecoratedBigDecimalSchema` once won the overload inside the intersection, so that
109
+ * field map rejected `schemaShape.x.<factory>Spec(...)` on a field decorated first. Every other decorator
110
+ * returns the receiver's own type too (#3031), so `.isSummaryField()` leaves the field a `DecoratedBigDecimalSchema`.
111
111
  */
112
112
  export interface DecoratedBigDecimalSchemaMethods {
113
113
  [ZodDecorator.IS_DB_INDEXED](): this;
@@ -85,10 +85,10 @@ export function createCodeSchema(
85
85
 
86
86
  /**
87
87
  * The chainable methods of `DecoratedCodeSchema`, returning `this` so a chain of several decorations keeps
88
- * the type it reached: `.isSummaryField()` turns the field into a `DecoratedPrimitiveZodType<DecoratedCodeSchema>`,
89
- * and a spec or UI method called after it must return that, not the bare factory type. A method
90
- * returning `DecoratedCodeSchema` itself won that overload inside the intersection, so a resource
91
- * specification's field map rejected `schemaShape.x.<factory>Spec(...)` on a decorated field.
88
+ * the type it reached, whatever the receiver is (`typeof field` in a resource specification's field map).
89
+ * A method returning the bare `DecoratedCodeSchema` once won the overload inside the intersection, so that
90
+ * field map rejected `schemaShape.x.<factory>Spec(...)` on a field decorated first. Every other decorator
91
+ * returns the receiver's own type too (#3031), so `.isSummaryField()` leaves the field a `DecoratedCodeSchema`.
92
92
  */
93
93
  export interface DecoratedCodeSchemaMethods {
94
94
  [ZodDecorator.IS_DB_INDEXED](): this;