@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
@@ -78,6 +78,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
78
78
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
79
79
  materialAccess: CryptoKey_MaterialAccess.REMOTE_OPERATION_ONLY,
80
80
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
81
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
81
82
  },
82
83
  },
83
84
  [CryptoKey_Purpose.PLATFORM_RESPONSE_INTEGRITY]: {
@@ -98,6 +99,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
98
99
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
99
100
  materialAccess: CryptoKey_MaterialAccess.REMOTE_OPERATION_ONLY,
100
101
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
102
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
101
103
  },
102
104
  },
103
105
  [CryptoKey_Purpose.APPLICATION_AUTH_TOKEN]: {
@@ -119,6 +121,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
119
121
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
120
122
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
121
123
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
124
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
122
125
  },
123
126
  },
124
127
  [CryptoKey_Purpose.APPLICATION_WEBHOOK]: {
@@ -140,6 +143,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
140
143
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
141
144
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
142
145
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
146
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
143
147
  },
144
148
  },
145
149
  [CryptoKey_Purpose.APPLICATION_PLATFORM_REQUEST]: {
@@ -161,6 +165,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
161
165
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
162
166
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
163
167
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
168
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
164
169
  },
165
170
  },
166
171
  [CryptoKey_Purpose.APPLICATION_WORKER_REQUEST]: {
@@ -182,6 +187,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
182
187
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
183
188
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
184
189
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
190
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
185
191
  },
186
192
  },
187
193
  [CryptoKey_Purpose.TOOL_APPROVAL_SIGNING]: {
@@ -203,6 +209,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
203
209
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
204
210
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
205
211
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
212
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
206
213
  },
207
214
  },
208
215
  [CryptoKey_Purpose.SUBMISSION_CHALLENGE]: {
@@ -224,6 +231,30 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
224
231
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
225
232
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
226
233
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
234
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
235
+ },
236
+ },
237
+ [CryptoKey_Purpose.ONE_TIME_CODE_DIGEST]: {
238
+ primitive: CryptoKey_Primitive.HMAC_SHA256,
239
+ jwsTypes: [],
240
+ holding: CryptoKey_Holding.APPLICATION_SECRETS,
241
+ scopes: [CryptoKey_Scope.APPLICATION],
242
+ publication: CryptoKey_Publication.PRIVATE,
243
+ // A digest is matched only while its code lives (ten minutes at most), so a retired version is needed for no longer.
244
+ rotationClass: CryptoKey_RotationClass.MATCH_ALL_RETAINED,
245
+ // A symmetric authentication key: under 2 years (Table 1, row 3); the lower bound of the signing keys'.
246
+ cryptoperiodDays: 365,
247
+ custodies: [CryptoKey_Custody.PLATFORM],
248
+ // Only the backend mints and checks a one-time code.
249
+ heldBy: [CryptoKey_Runtime.APPLICATION_BACKEND],
250
+ mayRequestSignature: [],
251
+ mayRequestDataKeys: [],
252
+ // The runtime that holds it computes with the retrieved key, so the floor allows retrieval.
253
+ engineFloor: {
254
+ protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
255
+ materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
256
+ provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
257
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
227
258
  },
228
259
  },
229
260
  [CryptoKey_Purpose.DECISION_PRESENTATION_ID]: {
@@ -245,6 +276,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
245
276
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
246
277
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
247
278
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
279
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
248
280
  },
249
281
  },
250
282
  [CryptoKey_Purpose.AGENT_WORK_CORRECTION_DIGEST]: {
@@ -266,6 +298,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
266
298
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
267
299
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
268
300
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
301
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
269
302
  },
270
303
  },
271
304
  [CryptoKey_Purpose.EVALUATION_PSEUDONYM]: {
@@ -287,6 +320,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
287
320
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
288
321
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
289
322
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
323
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
290
324
  },
291
325
  },
292
326
  [CryptoKey_Purpose.SIEM_DELIVERY_INTEGRITY]: {
@@ -308,6 +342,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
308
342
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
309
343
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
310
344
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
345
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
311
346
  },
312
347
  },
313
348
  [CryptoKey_Purpose.SIEM_DESTINATION_FINGERPRINT]: {
@@ -329,6 +364,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
329
364
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
330
365
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
331
366
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
367
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
332
368
  },
333
369
  },
334
370
  [CryptoKey_Purpose.EXTERNAL_DATA_ERASURE_SUPPRESSION]: {
@@ -350,6 +386,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
350
386
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
351
387
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
352
388
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
389
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
353
390
  },
354
391
  },
355
392
  [CryptoKey_Purpose.SEALED_SECRETS]: {
@@ -375,6 +412,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
375
412
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
376
413
  materialAccess: CryptoKey_MaterialAccess.REMOTE_OPERATION_ONLY,
377
414
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
415
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
378
416
  },
379
417
  },
380
418
  [CryptoKey_Purpose.SIGNING_LOG_EXPORT]: {
@@ -397,6 +435,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
397
435
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
398
436
  materialAccess: CryptoKey_MaterialAccess.REMOTE_OPERATION_ONLY,
399
437
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
438
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
400
439
  },
401
440
  },
402
441
  };
@@ -44,6 +44,13 @@ export enum CryptoKey_Purpose {
44
44
  TOOL_APPROVAL_SIGNING = 'tool_approval_signing',
45
45
  /** MACs a proof-of-work challenge the application issues to a public form, so it cannot be minted by the client (#2893). */
46
46
  SUBMISSION_CHALLENGE = 'submission_challenge',
47
+ /**
48
+ * Keys the digest a consumable-token row keeps of a one-time code (an email, SMS or phone-verification code), so the
49
+ * code itself is never stored (#3506). A six-digit code has 900,000 values, so an unkeyed hash of it is reversed by
50
+ * enumeration; under this key, someone who reads the row but not the key learns nothing. Held by the backend only,
51
+ * which mints and checks every code.
52
+ */
53
+ ONE_TIME_CODE_DIGEST = 'one_time_code_digest',
47
54
  /**
48
55
  * Keys the id of what a person was shown before deciding (#2893), so an answer names the exact presentation it was given
49
56
  * and a stale card is refused. Held by the backend and the minions, which both present decisions.
@@ -298,84 +298,6 @@ export function isPersistenceAdapter(
298
298
  export const DEFAULT_PERSISTENCE_ADAPTER: PersistenceAdapter =
299
299
  PersistenceAdapter.MONGODB;
300
300
 
301
- /**
302
- * A resource's declared relationship to CROSS-ADAPTER ATOMIC WRITE BOUNDARIES.
303
- *
304
- * **Why this exists.** An application is wholly one persistence adapter by default, and the
305
- * resources registry REFUSES a per-resource `persistenceAdapter` that disagrees with
306
- * `database.defaultAdapter`. That refusal protects exactly one property: a mixed application
307
- * cannot commit two resources in one native transaction, so every cross-resource boundary
308
- * silently degrades from atomic to at-least-once.
309
- *
310
- * The refusal is right as a DEFAULT and wrong as an absolute — some resources provably never
311
- * participate in such a boundary, and for those the blanket refusal forbids a legitimate,
312
- * safe deployment (a retrieval corpus kept on PostgreSQL in an application whose MongoDB runs no `mongot`, say) with
313
- * no way past it. A construct that refuses must ship the door in the same change, or a correct
314
- * refusal becomes a permanent lockout: this enum IS that door. Declaring a member is a positive claim
315
- * about the resource's write topology, made by its author, recorded in the config, and logged
316
- * at registration — never an ambient tolerance and never a flag that merely silences an error.
317
- *
318
- * **This declaration is a claim, not an exemption.** It does not weaken any runtime guarantee:
319
- * `ResourcePersistenceUnitOfWorkBackendService.assessCompatibility` still classifies any real
320
- * boundary whose ATOMIC participants resolve to more than one adapter as
321
- * `MIXED_PERSISTENCE_ADAPTERS`, and `executeInUnitOfWork` still THROWS on it. So a resource
322
- * that declares a member here and then IS reached by a cross-adapter atomic boundary fails
323
- * loudly at that boundary, exactly as it would have without the declaration. What the
324
- * declaration buys is the right to boot; what it can never buy is a silent degradation.
325
- *
326
- * assurance-control: WILDO.DATA.TRANSACTIONAL_INTEGRITY — the declaration a resource must make
327
- * before it may sit on a non-default persistence adapter.
328
- */
329
- export enum ResourcePersistenceAdapterIsolation {
330
- /**
331
- * This resource participates in NO cross-adapter atomic write boundary.
332
- *
333
- * The author asserts that no operation commits this resource and a resource on another
334
- * adapter inside one native transaction — neither as the subject of a
335
- * `ResourcePersistenceUnitOfWork` boundary nor as a participant in someone else's.
336
- *
337
- * Legitimate when the resource is a self-contained store whose writes stand alone: a
338
- * retrieval corpus, an append-only analytical sink, a projection rebuilt from its source
339
- * rather than written beside it. It is NOT legitimate merely because no such boundary
340
- * exists *today* — the claim is about the resource's design, and a later operation that
341
- * makes it false must change the declaration rather than discover the refusal at runtime.
342
- */
343
- NO_CROSS_ADAPTER_TRANSACTION = 'NO_CROSS_ADAPTER_TRANSACTION',
344
- }
345
-
346
- /**
347
- * String-value form accepted by authored resource configuration, mirroring the
348
- * {@link PersistenceAdapterType} convention so declarative config may use either the enum
349
- * member or its serialized value.
350
- *
351
- * **Deliberately one member.** A second — "participates only as a COMPENSATABLE participant",
352
- * mirroring the persistence unit of work's own
353
- * `ResourcePersistenceParticipantCoupling.COMPENSATABLE` — is describable, but no resource is
354
- * asking for it, and an admission path with no caller is an admission path with no coverage.
355
- * Add it when a real resource needs it, with the compensating path named at its call site.
356
- */
357
- export type ResourcePersistenceAdapterIsolationType = `${ResourcePersistenceAdapterIsolation}`;
358
-
359
- const RESOURCE_PERSISTENCE_ADAPTER_ISOLATION_VALUES: readonly string[] =
360
- Object.freeze(Object.values(ResourcePersistenceAdapterIsolation));
361
-
362
- /**
363
- * Runtime guard for isolation declarations entering through erased, serialized, or otherwise
364
- * untyped configuration boundaries — which is exactly how the resources registry sees them, since
365
- * it reads heterogeneous resource configurations through an erased index.
366
- *
367
- * Deliberately a MEMBERSHIP test rather than a presence test: the registry admits a non-default
368
- * adapter only on a recognised member, so a typo, a stale value from an older vocabulary, or a
369
- * truthy non-string cannot open the door. Fail-closed is the point — an unrecognised declaration
370
- * is treated as no declaration at all, and the application is refused with the standard message.
371
- */
372
- export function isResourcePersistenceAdapterIsolation(
373
- value: unknown,
374
- ): value is ResourcePersistenceAdapterIsolationType {
375
- return typeof value === 'string'
376
- && RESOURCE_PERSISTENCE_ADAPTER_ISOLATION_VALUES.includes(value);
377
- }
378
-
379
301
  /**
380
302
  * Variant key constants for operation variants.
381
303
  * Values are identical to DataMode.SUMMARY and DataMode.CONTEXT.
@@ -66,6 +66,16 @@ export enum EngineCapability {
66
66
  */
67
67
  EMAIL_INBOUND = 'EMAIL_INBOUND',
68
68
  SMS = 'SMS',
69
+ /**
70
+ * A deliverable signed by its signers' own electronic signatures, applied by a trust-service vendor (#2293): level 2 of
71
+ * epic #2916, opt-in per deliverable. Level 1 (the operator's seal over a decision, `KEY_MANAGEMENT`) needs no vendor.
72
+ *
73
+ * Its own slot: which vendor applies a client's signature is a legal and procurement decision (its levels, its
74
+ * environments, where it keeps the signed documents) that no other provider choice should make. Enabling it declares
75
+ * that deliverables are sent for signature, so an enabled slot with no provider refuses to start
76
+ * (`ENGINE_CAPABILITIES_REQUIRING_A_PROVIDER_WHEN_ENABLED`).
77
+ */
78
+ ELECTRONIC_SIGNATURE = 'ELECTRONIC_SIGNATURE',
69
79
 
70
80
  AI_LLM = 'AI_LLM',
71
81
  AI_IMAGE_GENERATION = 'AI_IMAGE_GENERATION',
@@ -183,8 +193,7 @@ export enum EngineCapability {
183
193
  * `BUILTIN_PROVIDER_CAPABILITY.BILLING` and fills `EngineCapability.BILLING`, which is the slot
184
194
  * applications enable and `getProvidersForEngineCapability` gates on. Payment EXECUTION is served
185
195
  * through that same provider's `BILLING_PROVIDER` protocol; splitting it into a second engine slot
186
- * was a plan-era intention (`provider-registry-materialization-workflow.md`) that the shipped
187
- * model settled the other way. So the withdrawal removes a name, not a capability.
196
+ * was an early plan that the shipped model settled the other way. So the withdrawal removes a name, not a capability.
188
197
  *
189
198
  * The reason a reserved slot is worse than no slot is `EngineCapabilityResolutionMode`: every
190
199
  * member must be classified, `BILLING_PAYMENTS` was classified `SELECT_ONE`, and `SELECT_ONE`
@@ -32,6 +32,8 @@
32
32
  * - `EMAIL_INBOUND` — enabling it declares that work arrives by email; with no
33
33
  * provider nothing hosts the receiving domain, so every message is lost
34
34
  * before the engine sees it and nothing anywhere records that it was (#1630).
35
+ * - `ELECTRONIC_SIGNATURE` — enabling it declares that deliverables are sent
36
+ * to be signed; with no provider every one of them would stay unsigned (#2293).
35
37
  *
36
38
  * DELIBERATELY ABSENT, with the reason each would need to overturn:
37
39
  * - the `AI_*` slots — consumed per feature (an agent, the logo generator)
@@ -61,5 +63,6 @@ export const ENGINE_CAPABILITIES_REQUIRING_A_PROVIDER_WHEN_ENABLED: ReadonlySet<
61
63
  EngineCapability.BILLING,
62
64
  EngineCapability.SMS,
63
65
  EngineCapability.EMAIL_INBOUND,
66
+ EngineCapability.ELECTRONIC_SIGNATURE,
64
67
  ]);
65
68
  ```
@@ -291,11 +291,15 @@ export enum ExternalDataFieldCoercion {
291
291
  NONE = 'none',
292
292
  /**
293
293
  * Odoo spells an ABSENT value as boolean `false` — a mapped string field would otherwise store
294
- * literal `false`. Applied by DEFAULT for ODOO_JSONRPC sources; declaring it on another dialect
294
+ * literal `false`. Applied by DEFAULT for Odoo sources (either dialect, #3391); declaring it on another dialect
295
295
  * is refused (the name is Odoo's semantics, not a generic null-coalesce).
296
296
  */
297
297
  ODOO_FALSE_AS_NULL = 'odoo-false-as-null',
298
- /** Parse a strict-ISO datetime string into a Date for a date-typed local field. */
298
+ /**
299
+ * Parse a datetime string into a Date for a date-typed local field. RFC 3339 only: a full-date, or a date-time with
300
+ * seconds and its offset (`Z` or `±hh:mm`); a value with no offset names no instant and rejects the row. On an Odoo
301
+ * source, Odoo's own `'YYYY-MM-DD HH:MM:SS'` is read too, as the UTC instant Odoo means by it (#3485).
302
+ */
299
303
  ISO_STRING_TO_DATE = 'iso-string-to-date',
300
304
  }
301
305
 
@@ -728,13 +732,16 @@ export const ExternalDataIncrementalExtractionDeclarationSchema = z.discriminate
728
732
  export type ExternalDataIncrementalExtractionDeclaration = z.infer<typeof ExternalDataIncrementalExtractionDeclarationSchema>;
729
733
 
730
734
  /**
731
- * The dialect each incremental mode is spoken over. A `Record` over the enum so a mode added without
732
- * its dialect is a compile error rather than a declaration the coherence check silently waves through.
735
+ * The dialects each incremental mode is spoken over. A `Record` over the enum so a mode added without
736
+ * its dialects is a compile error rather than a declaration the coherence check silently waves through.
737
+ *
738
+ * A LIST per mode since #3391: `write_date` is a column of Odoo's ORM, not of a wire, so it is read the same way
739
+ * through `/jsonrpc` and through JSON-2 — one mode, two dialects. Kept in the order the dialects were added.
733
740
  */
734
- export const EXTERNAL_DATA_INCREMENTAL_MODE_DIALECT: Readonly<Record<ExternalDataIncrementalExtractionMode, HttpApiTransportDialect>> = {
735
- [ExternalDataIncrementalExtractionMode.ODOO_WRITE_DATE]: HttpApiTransportDialect.ODOO_JSONRPC,
736
- [ExternalDataIncrementalExtractionMode.ODATA_MODIFIED_AT]: HttpApiTransportDialect.ODATA,
737
- [ExternalDataIncrementalExtractionMode.ODATA_DELTA_LINK]: HttpApiTransportDialect.ODATA,
741
+ export const EXTERNAL_DATA_INCREMENTAL_MODE_DIALECTS: Readonly<Record<ExternalDataIncrementalExtractionMode, readonly HttpApiTransportDialect[]>> = {
742
+ [ExternalDataIncrementalExtractionMode.ODOO_WRITE_DATE]: [HttpApiTransportDialect.ODOO_JSONRPC, HttpApiTransportDialect.ODOO_JSON2],
743
+ [ExternalDataIncrementalExtractionMode.ODATA_MODIFIED_AT]: [HttpApiTransportDialect.ODATA],
744
+ [ExternalDataIncrementalExtractionMode.ODATA_DELTA_LINK]: [HttpApiTransportDialect.ODATA],
738
745
  };
739
746
  ```
740
747
 
@@ -110,8 +110,8 @@ export enum AgentBehaviorReportRemedyKind {
110
110
 
111
111
  /** A resolution's link to its remedy. A reference, never a copy of what changed. */
112
112
  export const AgentBehaviorReportRemedyRefSchema = z.strictObject({
113
- kind: z.enum(AgentBehaviorReportRemedyKind).systemEnum('AgentBehaviorReportRemedyKind'),
114
- ref: z.string().trim().min(1).max(200),
113
+ kind: z.enum(AgentBehaviorReportRemedyKind).systemEnum('AgentBehaviorReportRemedyKind').describe('What the remedy is: `guardrail_event`, the audit event of a guardrail decision that now catches the behaviour, or `agent_configuration_change`, the change made to the agent (an agent-policy change\'s audit event, or the release that changed its configuration).'),
114
+ ref: z.string().trim().min(1).max(200).describe('The remedy\'s reference: the audit event id for `guardrail_event`, the audit event id or release reference for `agent_configuration_change`. A reference, never a copy of what changed.'),
115
115
  });
116
116
  export type AgentBehaviorReportRemedyRef = z.infer<typeof AgentBehaviorReportRemedyRefSchema>;
117
117
 
@@ -206,8 +206,12 @@ export const AgentBehaviorReportSchema = z.object({
206
206
  /** The stored message the report is about, sent by the reporter: an agent's reply in that conversation. */
207
207
  turnMessageId: z.string().min(1).max(200).excludeFromUpdate().isAuditEvidence().portabilityProvenance(DataPortabilityProvenance.SUBJECT_PROVIDED)
208
208
  .dataCategories(PersonalDataCategory.USAGE),
209
- /** The actor system the conversation runs, read from the conversation when the report is received. */
210
- systemRef: z.string().min(1).max(200).excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
209
+ /**
210
+ * The actor system the conversation runs, read from the conversation when the report is received. A summary field: a
211
+ * report is labelled by its agent, else by this system, and a report on a system with no named agent kept no name on
212
+ * its card while this was not carried (the label sweep, #2329 widened by #3066 review L1).
213
+ */
214
+ systemRef: z.string().min(1).max(200).isSummaryField().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
211
215
  /** The agent that answered in it, when the system names a conversational agent. */
212
216
  agentRef: z.string().min(1).max(200).optional().isDBIndexed().isSummaryField().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
213
217
  /** When the reported reply was produced, read from the stored message when the report was received. */
@@ -305,13 +309,13 @@ export type AgentBehaviorReportDismissDto = z.infer<typeof AgentBehaviorReportDi
305
309
  * erased with their account): the report never kept a copy, so there is nothing else to show.
306
310
  */
307
311
  export const AgentBehaviorReportedTurnSchema = z.object({
308
- available: z.boolean(),
312
+ available: z.boolean().describe('`false` when the conversation or the reply no longer exists (deleted by the reporter, or erased with their account). The report never kept a copy, so nothing else is returned.'),
309
313
  /** The person's message the reply answered, when the conversation still holds one before it, and when it was sent. */
310
- prompt: z.string().optional(),
311
- promptAt: z.date().optional(),
314
+ prompt: z.string().optional().describe('The person\'s message the reply answered, when the conversation still holds one before it.'),
315
+ promptAt: z.date().optional().describe('When that message was sent.'),
312
316
  /** The agent's reply, as the person read it (Markdown when the agent answered in Markdown), and when it was produced. */
313
- reply: z.string().optional(),
314
- replyAt: z.date().optional(),
317
+ reply: z.string().optional().describe('The agent\'s reply as the person read it, in Markdown when the agent answered in Markdown.'),
318
+ replyAt: z.date().optional().describe('When the reply was produced.'),
315
319
  });
316
320
  export type AgentBehaviorReportedTurn = z.infer<typeof AgentBehaviorReportedTurnSchema>;
317
321
  ```
@@ -45,8 +45,37 @@ export enum StructuredGenerationExecutionMode {
45
45
  export type FlowsActors_Agent_LLMConfiguration = FlowsActors_LeafElements_Configuration & FlowsActors_Agent_ExecutionConfiguration & {
46
46
  operationKey: LLMProvider_OperationKey,
47
47
  seed?: number, // Random seed for deterministic output
48
+ /**
49
+ * CALL-TIME FAILOVER (#2301): the models, each on its provider, that take a model call this agent's own model failed
50
+ * TRANSIENTLY, tried in order. A model call is a READ at the provider (it changes nothing there), so it is handed on
51
+ * after the provider was unreachable, timed out, throttled (429) or answered 5xx, and never after a refusal of the
52
+ * request itself: an invalid request, a refused credential or account (no credits, a spend limit), a content refusal.
53
+ *
54
+ * The fence is ONE model call (one step of the agent's loop), never the whole turn: the failed step is asked again of
55
+ * the alternative with the same conversation, so a tool a previous step already ran is never run again. A STREAMED
56
+ * call is handed on only while the provider has not started its stream; once it has, a failure reaches the caller,
57
+ * because the parts already delivered cannot be taken back. Within one invocation the hand-over is sticky: the later
58
+ * steps go to the model that answered.
59
+ *
60
+ * Each alternative must be one this runtime may reach for `AI_LLM` exactly as a selected provider must (declared in
61
+ * the runtime scope with the capability, loaded — which the application's data residency decides — and bound to its
62
+ * declared processing region), enabled, with a credential, on the API transport (not `executionProfileRef`), and able
63
+ * to serve what the agent asks (its reasoning effort, tools, structured output, images where the model's catalog row
64
+ * says). Startup refuses one that is not. The provider-call record names the provider and model that answered, the
65
+ * agent operation record the ids the provider reported, and the call's trace context `modelFailovers` names each
66
+ * hand-over: who failed, who served, why.
67
+ */
68
+ modelFailover?: readonly FlowsActors_Agent_ModelAlternative[],
48
69
  };
49
70
 
71
+ /** One model a {@link FlowsActors_Agent_LLMConfiguration.modelFailover} hands a failed model call to (#2301). */
72
+ export interface FlowsActors_Agent_ModelAlternative {
73
+ /** The provider that serves it: a provider declared in the runtime scope with `AI_LLM`. */
74
+ readonly providerRef: string;
75
+ /** The vendor's model id on that provider. A concrete id: an alternative does not resolve by applicability. */
76
+ readonly model: string;
77
+ }
78
+
50
79
  /**
51
80
  * The IMAGE execution arm of an agent config. Carries image-generation
52
81
  * parameters (`size` / `quality` / `background` / …) instead of LLM sampling,
@@ -0,0 +1,52 @@
1
+ # saas.models.flows-actors.agent-content-guardrails-environment
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-models`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-models`
10
+
11
+ ```typescript
12
+ *
13
+ * What an environment does with an agent's classifier-backed content guardrails (`contentGuardrails.promptInjection`,
14
+ * `contentGuardrails.outputModeration`) when NO classifier for the guardrail is present there: its configuration declares
15
+ * no provider for `EngineCapability.AI_CONTENT_SAFETY`, the provider it selects does not offer that guardrail, or that
16
+ * provider's credentials are not authored in this environment's `secrets.json → providerEnv`. Imported
17
+ * from `@wildo-ai/saas-models`; authored as `agentContentGuardrails` in `infrastructure/<env>/wildo.infra.<env>.config.ts`.
18
+ */
19
+ export enum AgentContentGuardrailsWithoutClassifier {
20
+ /** The default, and what an environment that authors nothing gets: the agent refuses every turn. */
21
+ REFUSE = 'refuse',
22
+ /**
23
+ * The agent runs without each guardrail no classifier is present for here (its tool results unscreened, or its output
24
+ * unmoderated). A classifier that is there and cannot be used is never waived: a declared provider that did not load or
25
+ * a category it does not assess still refuses the turn, and a key that is set and refused, or an outage, still
26
+ * withholds the output. Named at startup, and listed by launch-blockers outside a local environment.
27
+ */
28
+ RUN_UNGUARDED = 'run_unguarded',
29
+ }
30
+
31
+ /**
32
+ * The environment's declaration. `reason` is required with `RUN_UNGUARDED`: it is printed beside every agent the backend
33
+ * leaves unguarded, so the next reader knows it was decided, and by whom or why.
34
+ *
35
+ * ```ts
36
+ * agentContentGuardrails: {
37
+ * withoutClassifier: AgentContentGuardrailsWithoutClassifier.RUN_UNGUARDED,
38
+ * reason: 'Staging has no Azure Content Safety key; production authors one.',
39
+ * },
40
+ * ```
41
+ */
42
+ export const EnvironmentAgentContentGuardrailsSchema = z.discriminatedUnion('withoutClassifier', [
43
+ z.strictObject({
44
+ withoutClassifier: z.literal(AgentContentGuardrailsWithoutClassifier.REFUSE),
45
+ }),
46
+ z.strictObject({
47
+ withoutClassifier: z.literal(AgentContentGuardrailsWithoutClassifier.RUN_UNGUARDED),
48
+ reason: z.string().trim().min(10, 'Say why this environment runs its agents unguarded (at least 10 characters).').max(500),
49
+ }),
50
+ ]);
51
+ export type EnvironmentAgentContentGuardrails = z.output<typeof EnvironmentAgentContentGuardrailsSchema>;
52
+ ```
@@ -59,6 +59,13 @@ export const AgentOperationToolCallSchema = z.object({
59
59
  * Absent when the agent screens nothing, and for an empty result (released without a screening, carrying no text).
60
60
  */
61
61
  screening: z.enum(ContentSafetyScreeningOutcome).systemEnum('ContentSafetyScreeningOutcome').optional(),
62
+ /**
63
+ * RESULT (#3369): what reached the model under the strictest agent policy because nothing the engine observed could say
64
+ * whose it was, read by tools acting in no organization. For a tool returning records, the rows of an
65
+ * organization-owned resource that named no organization; for a tool that treats its own output (whose rows never name
66
+ * one), 1 for the whole result. A count, never the content; absent when every owner was known.
67
+ */
68
+ rowsOwnerNotDerived: z.number().int().min(1).optional(),
62
69
  });
63
70
  export type AgentOperationToolCall = z.infer<typeof AgentOperationToolCallSchema>;
64
71
 
@@ -42,6 +42,12 @@ export enum HumanDecision_AnswerChannel {
42
42
  * `lastAuthenticatedAt`, OIDC `auth_time`). Absent when the token carries none (a chat answer, a delegated token).
43
43
  * - `amr`: how that sign-in was made, RFC 8176 values. Absent when nothing registered applies, never `[]`.
44
44
  * - `stepUpMethod`: the method of the step-up proof this very act carried and consumed, when it carried one.
45
+ * - `stepUpAt`: when that factor was proven, epoch seconds (#2923): the instant the step-up proof was minted, so a
46
+ * verifier compares it with the decision's own instant and sees how fresh the factor that answered was. Absent when
47
+ * the act carried no proof, or the proof records no instant.
48
+ * - `stepUpUserVerified`: for a passkey step-up, whether the authenticator verified the PERSON (the assertion's UV flag,
49
+ * WebAuthn L3 §6.1), not only that it was present (#2923). A step-up ceremony demands it, so a recorded `false` never
50
+ * occurs; the flag is recorded so a verifier need not take that on trust.
45
51
  * - `act`: for `PERSON_THROUGH_CLIENT`, the client that acted for the person.
46
52
  * - `answeredThrough`: for `CHAT`, the stored inbound delivery the answer arrived in; `chatIdentityLinkId` the link that
47
53
  * tied the chat account to the person. The RESOLVED row also carries the delivery as its flat
@@ -55,6 +61,8 @@ export const HumanDecision_DeciderContextSchema = z.object({
55
61
  authTime: z.number().int().nonnegative().optional(),
56
62
  amr: z.array(z.string().trim().min(1)).min(1).optional(),
57
63
  stepUpMethod: z.enum(AuthMethod).systemEnum('AuthMethod').optional(),
64
+ stepUpAt: z.number().int().nonnegative().optional(),
65
+ stepUpUserVerified: z.boolean().optional(),
58
66
  answeredThrough: Inbound_ArrivalSchema.optional(),
59
67
  chatIdentityLinkId: z.string().trim().min(1).optional(),
60
68
  });
@@ -140,7 +140,7 @@ const CountryCodeSchema = z.string().length(2).refine((code) => COUNTRY_CODES.ha
140
140
  /** The `ref` of the request field this form field asks. Opaque, as the request's refs are. */
141
141
  const FieldRefSchema = z.string().min(1);
142
142
 
143
- export const HumanInputForm_TextFieldSchema = z.strictObject({
143
+ const TEXT_FIELD_SHAPE = {
144
144
  ref: FieldRefSchema,
145
145
  type: z.literal(HumanInputForm_FieldType.TEXT).systemEnum('HumanInputForm_FieldType'),
146
146
  format: z.enum(HumanInputForm_TextFormat).systemEnum('HumanInputForm_TextFormat').optional(),
@@ -149,11 +149,13 @@ export const HumanInputForm_TextFieldSchema = z.strictObject({
149
149
  textareaRows: z.int().min(2).max(20).optional(),
150
150
  minLength: z.int().min(1).optional(),
151
151
  maxLength: z.int().min(1).optional(),
152
- }).refine((field) => field.minLength === undefined || field.maxLength === undefined || field.minLength <= field.maxLength, {
152
+ };
153
+ export const HumanInputForm_TextFieldSchema = z.strictObject(TEXT_FIELD_SHAPE)
154
+ .refine((field) => field.minLength === undefined || field.maxLength === undefined || field.minLength <= field.maxLength, {
153
155
  message: 'minLength is above maxLength.',
154
156
  });
155
157
 
156
- export const HumanInputForm_NumberFieldSchema = z.strictObject({
158
+ const NUMBER_FIELD_SHAPE = {
157
159
  ref: FieldRefSchema,
158
160
  type: z.literal(HumanInputForm_FieldType.NUMBER).systemEnum('HumanInputForm_FieldType'),
159
161
  integer: z.boolean().optional(),
@@ -165,7 +167,9 @@ export const HumanInputForm_NumberFieldSchema = z.strictObject({
165
167
  prefix: z.string().min(1).max(8).optional(),
166
168
  /** Shown after the value, such as "kg" or "%". */
167
169
  suffix: z.string().min(1).max(12).optional(),
168
- }).refine((field) => field.min === undefined || field.max === undefined || field.min <= field.max, {
170
+ };
171
+ export const HumanInputForm_NumberFieldSchema = z.strictObject(NUMBER_FIELD_SHAPE)
172
+ .refine((field) => field.min === undefined || field.max === undefined || field.min <= field.max, {
169
173
  message: 'min is above max.',
170
174
  }).refine((field) => field.editMode !== NumberEditMode.SLIDER || (field.min !== undefined && field.max !== undefined), {
171
175
  message: 'A SLIDER needs min and max.',
@@ -181,13 +185,15 @@ export const HumanInputForm_DateTimeFieldSchema = z.strictObject({
181
185
  type: z.literal(HumanInputForm_FieldType.DATETIME).systemEnum('HumanInputForm_FieldType'),
182
186
  });
183
187
 
184
- export const HumanInputForm_MoneyFieldSchema = z.strictObject({
188
+ const MONEY_FIELD_SHAPE = {
185
189
  ref: FieldRefSchema,
186
190
  type: z.literal(HumanInputForm_FieldType.MONEY).systemEnum('HumanInputForm_FieldType'),
187
191
  currenciesAllowed: z.array(z.enum(CurrencyAllowed)).min(1).optional(),
188
192
  allowCurrencyChange: z.boolean().optional(),
189
193
  defaultCurrency: AvailableCurrencySchema.optional(),
190
- }).refine((field) => !field.defaultCurrency || currencyIsInAllowedCategories(field.defaultCurrency, field.currenciesAllowed), {
194
+ };
195
+ export const HumanInputForm_MoneyFieldSchema = z.strictObject(MONEY_FIELD_SHAPE)
196
+ .refine((field) => !field.defaultCurrency || currencyIsInAllowedCategories(field.defaultCurrency, field.currenciesAllowed), {
191
197
  message: 'defaultCurrency is not in currenciesAllowed.',
192
198
  });
193
199
 
@@ -206,14 +212,16 @@ export const HumanInputForm_RangeFieldSchema = z.strictObject({
206
212
  message: 'A range whose start and end are both optional can be answered with nothing.',
207
213
  });
208
214
 
209
- export const HumanInputForm_DurationFieldSchema = z.strictObject({
215
+ const DURATION_FIELD_SHAPE = {
210
216
  ref: FieldRefSchema,
211
217
  type: z.literal(HumanInputForm_FieldType.DURATION).systemEnum('HumanInputForm_FieldType'),
212
218
  allowedUnits: z.array(z.enum(DurationUnit)).min(1).optional(),
213
219
  defaultUnit: z.enum(DurationUnit).optional(),
214
220
  minValue: z.number().optional(),
215
221
  maxValue: z.number().optional(),
216
- }).refine((field) => !field.defaultUnit || !field.allowedUnits || field.allowedUnits.includes(field.defaultUnit), {
222
+ };
223
+ export const HumanInputForm_DurationFieldSchema = z.strictObject(DURATION_FIELD_SHAPE)
224
+ .refine((field) => !field.defaultUnit || !field.allowedUnits || field.allowedUnits.includes(field.defaultUnit), {
217
225
  message: 'defaultUnit is not one of allowedUnits.',
218
226
  });
219
227
 
@@ -223,24 +231,28 @@ export const HumanInputForm_PhoneFieldSchema = z.strictObject({
223
231
  defaultCountry: CountryCodeSchema.optional(),
224
232
  });
225
233
 
226
- export const HumanInputForm_AddressFieldSchema = z.strictObject({
234
+ const ADDRESS_FIELD_SHAPE = {
227
235
  ref: FieldRefSchema,
228
236
  type: z.literal(HumanInputForm_FieldType.ADDRESS).systemEnum('HumanInputForm_FieldType'),
229
237
  countriesAllowed: z.array(CountryCodeSchema).min(1).optional(),
230
238
  defaultCountry: CountryCodeSchema.optional(),
231
- }).refine((field) => !field.defaultCountry || !field.countriesAllowed
239
+ };
240
+ export const HumanInputForm_AddressFieldSchema = z.strictObject(ADDRESS_FIELD_SHAPE)
241
+ .refine((field) => !field.defaultCountry || !field.countriesAllowed
232
242
  || field.countriesAllowed.some((country) => country.toUpperCase() === field.defaultCountry!.toUpperCase()), {
233
243
  message: 'defaultCountry is not one of countriesAllowed.',
234
244
  });
235
245
 
236
- export const HumanInputForm_DecimalFieldSchema = z.strictObject({
246
+ const DECIMAL_FIELD_SHAPE = {
237
247
  ref: FieldRefSchema,
238
248
  type: z.literal(HumanInputForm_FieldType.DECIMAL).systemEnum('HumanInputForm_FieldType'),
239
249
  /** Most decimal places a value may have. */
240
250
  precision: z.int().min(0).max(20).optional(),
241
251
  min: BigDecimalValueSchema.optional(),
242
252
  max: BigDecimalValueSchema.optional(),
243
- }).refine((field) => field.min === undefined || field.max === undefined || bigDecimalCompare(field.min, field.max) <= 0, {
253
+ };
254
+ export const HumanInputForm_DecimalFieldSchema = z.strictObject(DECIMAL_FIELD_SHAPE)
255
+ .refine((field) => field.min === undefined || field.max === undefined || bigDecimalCompare(field.min, field.max) <= 0, {
244
256
  message: 'min is above max.',
245
257
  });
246
258
 
@@ -276,6 +288,29 @@ export const HumanInputForm_FieldSchema = z.discriminatedUnion('type', [
276
288
  ]);
277
289
  export type HumanInputForm_Field = z.infer<typeof HumanInputForm_FieldSchema>;
278
290
 
291
+ /** One member of {@link HumanInputForm_FieldSchema}: the schema of one field type. */
292
+ export type HumanInputForm_FieldTypeSchema = (typeof HumanInputForm_FieldSchema)['options'][number];
293
+
294
+ /**
295
+ * The schema of each field type, by type (#3146). Total over `HumanInputForm_FieldType`, so a type added tomorrow does not
296
+ * compile until it has one. A form a model composes is written in a narrower vocabulary, the same types without their
297
+ * validation constraints (#3176), and is a form of this one.
298
+ */
299
+ export const HUMAN_INPUT_FORM_FIELD_SCHEMA_BY_TYPE: Readonly<Record<HumanInputForm_FieldType, HumanInputForm_FieldTypeSchema>> = {
300
+ [HumanInputForm_FieldType.TEXT]: HumanInputForm_TextFieldSchema,
301
+ [HumanInputForm_FieldType.NUMBER]: HumanInputForm_NumberFieldSchema,
302
+ [HumanInputForm_FieldType.DATE]: HumanInputForm_DateFieldSchema,
303
+ [HumanInputForm_FieldType.DATETIME]: HumanInputForm_DateTimeFieldSchema,
304
+ [HumanInputForm_FieldType.MONEY]: HumanInputForm_MoneyFieldSchema,
305
+ [HumanInputForm_FieldType.RANGE]: HumanInputForm_RangeFieldSchema,
306
+ [HumanInputForm_FieldType.DURATION]: HumanInputForm_DurationFieldSchema,
307
+ [HumanInputForm_FieldType.PHONE]: HumanInputForm_PhoneFieldSchema,
308
+ [HumanInputForm_FieldType.ADDRESS]: HumanInputForm_AddressFieldSchema,
309
+ [HumanInputForm_FieldType.DECIMAL]: HumanInputForm_DecimalFieldSchema,
310
+ [HumanInputForm_FieldType.CHOICE]: HumanInputForm_ChoiceFieldSchema,
311
+ [HumanInputForm_FieldType.CONFIRM]: HumanInputForm_ConfirmFieldSchema,
312
+ };
313
+
279
314
  /**
280
315
  * One heading and the fields under it: a `<Section>` or a `<WizardStep>`. Its words are the asker's, written as text
281
316
  * (`DisplayOrFormSectionLabel.title`). It has no name: the compiler names it by position.