@wildo-ai/framework-knowledge 1.1.11 → 1.1.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (803) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
  3. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
  4. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
  5. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
  6. package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
  7. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
  8. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
  9. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
  10. package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
  11. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  12. package/dist/esm/framework-knowledge.definitions.js +170 -32
  13. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  14. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  15. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  16. package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
  17. package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
  18. package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
  19. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  20. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  21. package/dist/esm/index.d.ts.map +1 -1
  22. package/dist/esm/index.js.map +1 -1
  23. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
  24. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
  31. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  32. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
  35. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
  45. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
  47. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
  50. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
  52. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
  54. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +29 -3
  56. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +80 -16
  58. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  61. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
  62. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  63. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
  64. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  65. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
  66. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
  68. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  69. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  71. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
  72. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
  74. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
  76. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
  78. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  80. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
  81. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
  82. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  83. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
  84. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
  85. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
  86. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
  88. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  89. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  90. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
  91. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  92. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
  93. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  94. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
  95. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
  96. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
  99. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
  101. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  103. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
  104. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  105. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  106. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
  107. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  108. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
  109. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  110. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
  111. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
  113. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  114. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
  115. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  116. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
  117. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  118. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
  119. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
  121. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  122. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
  123. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  124. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
  125. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
  127. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  129. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
  130. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  131. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
  132. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  133. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
  134. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  135. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  136. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  137. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
  138. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  139. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
  140. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  141. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  142. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  143. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  144. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
  145. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  146. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  147. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  148. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
  149. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  150. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  151. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  153. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
  154. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  156. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
  157. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  158. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
  159. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  160. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
  161. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  162. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
  163. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  164. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
  165. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  166. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
  167. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  168. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
  169. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  170. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
  171. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
  172. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
  173. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
  174. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
  175. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  176. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
  177. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  178. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
  179. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  180. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
  181. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  182. package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
  183. package/dist/esm/source-anchor-grammar.js.map +1 -1
  184. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  185. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  186. package/dist/knowledge/manifest.json +7 -7
  187. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
  188. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
  189. package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
  190. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
  191. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  192. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  193. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
  194. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
  195. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
  196. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
  197. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
  198. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
  199. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
  200. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
  201. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
  202. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  203. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  204. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
  205. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
  206. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
  207. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
  208. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
  209. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +51 -7
  210. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
  211. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
  212. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +10 -2
  213. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
  214. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
  215. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
  216. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
  217. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
  218. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
  219. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
  220. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
  221. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
  222. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
  223. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
  224. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
  225. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
  226. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
  227. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
  228. package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
  229. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
  230. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
  231. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
  232. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  233. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  234. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
  235. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
  236. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
  237. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
  238. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
  239. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
  240. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
  241. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
  242. package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
  243. package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
  244. package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
  245. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
  246. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
  247. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
  248. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
  249. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
  250. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
  251. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
  252. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
  253. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
  254. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
  255. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
  256. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
  257. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
  258. package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
  259. package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
  260. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
  261. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
  262. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
  263. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
  264. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
  265. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
  266. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
  267. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
  268. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  269. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  270. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
  271. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +10 -6
  272. package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
  273. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
  274. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
  275. package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
  276. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
  277. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
  278. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
  279. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
  280. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
  281. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
  282. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
  283. package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
  284. package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
  285. package/dist/knowledge/references/application-maturity.config.md +27 -1
  286. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
  287. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
  288. package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
  289. package/dist/knowledge/references/brand.name-screening.config.md +30 -3
  290. package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
  291. package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
  292. package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
  293. package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
  294. package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
  295. package/dist/knowledge/references/companion.market.generation-service.md +46 -5
  296. package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
  297. package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
  298. package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
  299. package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
  300. package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
  301. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
  302. package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
  303. package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
  304. package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
  305. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
  306. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
  307. package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
  308. package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
  309. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
  310. package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
  311. package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
  312. package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
  313. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
  314. package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
  315. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
  316. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
  317. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
  318. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
  319. package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
  320. package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
  321. package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
  322. package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
  323. package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
  324. package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
  325. package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
  326. package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
  327. package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
  328. package/dist/knowledge/references/example.website.section.stats.md +1 -1
  329. package/dist/knowledge/references/experience-plan.config.md +111 -1
  330. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
  331. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
  332. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
  333. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
  334. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
  335. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
  336. package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
  337. package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
  338. package/dist/knowledge/references/integration-plan.config.md +7 -7
  339. package/dist/knowledge/references/placement-plan.config.md +19 -0
  340. package/dist/knowledge/references/platform.config.backing-services.md +9 -11
  341. package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
  342. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
  343. package/dist/knowledge/references/platform.config.infrastructure-host.md +0 -1
  344. package/dist/knowledge/references/platform.config.platform-key-management.md +84 -8
  345. package/dist/knowledge/references/platform.config.saas.md +20 -18
  346. package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
  347. package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
  348. package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
  349. package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
  350. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
  351. package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
  352. package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
  353. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +4 -4
  354. package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
  355. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +29 -2
  356. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
  357. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
  358. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
  359. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  360. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
  361. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
  362. package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
  363. package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
  364. package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
  365. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
  366. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
  367. package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
  368. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
  369. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
  370. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +363 -2
  371. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
  372. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
  373. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
  374. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
  375. package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
  376. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
  377. package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
  378. package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
  379. package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
  380. package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
  381. package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
  382. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
  383. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
  384. package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
  385. package/dist/knowledge/references/saas.frontend.chart-dashboard.md +130 -0
  386. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
  387. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
  388. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
  389. package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
  390. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
  391. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
  392. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
  393. package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
  394. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
  395. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
  396. package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
  397. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
  398. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
  399. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
  400. package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
  401. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
  402. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
  403. package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
  404. package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
  405. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
  406. package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
  407. package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
  408. package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
  409. package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
  410. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
  411. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
  412. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
  413. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
  414. package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
  415. package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
  416. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
  417. package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
  418. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
  419. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
  420. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
  421. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
  422. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
  423. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
  424. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
  425. package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
  426. package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
  427. package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
  428. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
  429. package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
  430. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
  431. package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
  432. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
  433. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
  434. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
  435. package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
  436. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
  437. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
  438. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
  439. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
  440. package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
  441. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
  442. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
  443. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
  444. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
  445. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
  446. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
  447. package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
  448. package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
  449. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
  450. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
  451. package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
  452. package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
  453. package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
  454. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
  455. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
  456. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
  457. package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
  458. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
  459. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
  460. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
  461. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
  462. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
  463. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
  464. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
  465. package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
  466. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
  467. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
  468. package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
  469. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
  470. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
  471. package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
  472. package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
  473. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
  474. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
  475. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
  476. package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
  477. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
  478. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
  479. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
  480. package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
  481. package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
  482. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
  483. package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
  484. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
  485. package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
  486. package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
  487. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
  488. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
  489. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
  490. package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
  491. package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
  492. package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
  493. package/dist/knowledge/references/service-method.config.md +35 -2
  494. package/dist/knowledge/references/vision.constraint.config.md +4 -2
  495. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
  496. package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
  497. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
  498. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
  499. package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
  500. package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
  501. package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
  502. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
  503. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
  504. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
  505. package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
  506. package/dist/knowledge/references/zod.factories.code.md +4 -4
  507. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  508. package/dist/knowledge/references/zod.factories.money.md +4 -4
  509. package/dist/knowledge/references/zod.factories.phone.md +4 -4
  510. package/dist/knowledge/references/zod.factories.year-month.md +79 -0
  511. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  512. package/dist/knowledge/registries/framework-topics.json +415 -2
  513. package/dist/knowledge/registries/playbooks.json +51 -39
  514. package/dist/knowledge/registries/source-tags.json +2412 -1604
  515. package/dist/knowledge/rules/database-migration-obligation.md +6 -7
  516. package/dist/knowledge/rules/live-context-door.md +1 -1
  517. package/dist/knowledge/skills/INDEX.md +3 -1
  518. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
  519. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
  520. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
  521. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
  522. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
  523. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
  524. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
  525. package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
  526. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
  527. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
  528. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
  529. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
  530. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
  531. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
  532. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
  533. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
  534. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  535. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
  536. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
  537. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
  538. package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
  539. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
  540. package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
  541. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
  542. package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
  543. package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +79 -0
  544. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
  545. package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
  546. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
  547. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
  548. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
  549. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
  550. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
  551. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
  552. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
  553. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
  554. package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
  555. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
  556. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
  557. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
  558. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
  559. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
  560. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
  561. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
  562. package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
  563. package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
  564. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
  565. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
  566. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
  567. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
  568. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
  569. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +197 -9
  570. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
  571. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
  572. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
  573. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
  574. package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
  575. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
  576. package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
  577. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
  578. package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
  579. package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
  580. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
  581. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
  582. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
  583. package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
  584. package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +61 -0
  585. package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
  586. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
  587. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
  588. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
  589. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
  590. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
  591. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +1 -1
  592. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
  593. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +18 -7
  594. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
  595. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
  596. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +44 -4
  597. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
  598. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
  599. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
  600. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
  601. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
  602. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +375 -8
  603. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
  604. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
  605. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
  606. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +1 -1
  607. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
  608. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
  609. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +1 -1
  610. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
  611. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
  612. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +3 -3
  613. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +37 -14
  614. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
  615. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
  616. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
  617. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
  618. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
  619. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
  620. package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
  621. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
  622. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
  623. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
  624. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
  625. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
  626. package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
  627. package/dist/knowledge/skills/infra-environment-config/SKILL.md +125 -77
  628. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
  629. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
  630. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +0 -1
  631. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +84 -8
  632. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
  633. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
  634. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
  635. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
  636. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
  637. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
  638. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
  639. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
  640. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
  641. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
  642. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
  643. package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
  644. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
  645. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
  646. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
  647. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
  648. package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
  649. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
  650. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
  651. package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
  652. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
  653. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
  654. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
  655. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
  656. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
  657. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
  658. package/dist/knowledge/skills/provider-backend-package/SKILL.md +255 -12
  659. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
  660. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
  661. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
  662. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
  663. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
  664. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
  665. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
  666. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
  667. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
  668. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
  669. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
  670. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
  671. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
  672. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
  673. package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
  674. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
  675. package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
  676. package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
  677. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
  678. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
  679. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
  680. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
  681. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
  682. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +33 -7
  683. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
  684. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
  685. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
  686. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +7 -2
  687. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
  688. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
  689. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
  690. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
  691. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
  692. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
  693. package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
  694. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
  695. package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
  696. package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
  697. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
  698. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
  699. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
  700. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
  701. package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
  702. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
  703. package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
  704. package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
  705. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
  706. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
  707. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
  708. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
  709. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
  710. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
  711. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
  712. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
  713. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
  714. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
  715. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
  716. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
  717. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
  718. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
  719. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
  720. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
  721. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
  722. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  723. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
  724. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
  725. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
  726. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
  727. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
  728. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
  729. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
  730. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
  731. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
  732. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
  733. package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
  734. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
  735. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
  736. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
  737. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
  738. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
  739. package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
  740. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
  741. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
  742. package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
  743. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
  744. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
  745. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
  746. package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
  747. package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
  748. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
  749. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
  750. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
  751. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
  752. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
  753. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
  754. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
  755. package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
  756. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
  757. package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
  758. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
  759. package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
  760. package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
  761. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
  762. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
  763. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  764. package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
  765. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
  766. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
  767. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
  768. package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
  769. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
  770. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
  771. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
  772. package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
  773. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
  774. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
  775. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
  776. package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
  777. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
  778. package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
  779. package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
  780. package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
  781. package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
  782. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
  783. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
  784. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
  785. package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
  786. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
  787. package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
  788. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
  789. package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
  790. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
  791. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
  792. package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
  793. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
  794. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
  795. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
  796. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
  797. package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
  798. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
  799. package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
  800. package/dist/knowledge/topic-index.json +2275 -715
  801. package/dist/tsconfig.build.tsbuildinfo +1 -1
  802. package/package.json +6 -6
  803. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -40,14 +40,17 @@ refused it. Its data says:
40
40
 
41
41
  | field | holds |
42
42
  |---|---|
43
- | `initiationKind` | the door (`ModelSpendDoor`): `websocket_session` for in-app chat, `flow_step` for a flow |
43
+ | `initiationKind` | the door (`ModelSpendDoor`): `websocket_session` for in-app chat, `flow_step` for a flow, `resource_operation` for a call one of your operations (or its hooks) makes, `organization_work` for a call your own backend code makes outside any operation for an organization |
44
44
  | `ceiling` | which limit (`TokenSpendCeiling`): `organization_budget`, `person_ceiling`, or a unit ceiling (`embedding_token_ceiling`, `extraction_page_ceiling`, `screening_text_record_ceiling`, below) |
45
- | `reason` | why (`A2ATokenBudgetDenialReason`): `allowance_exhausted`, `allowance_unverifiable`, `consumption_unverifiable` |
45
+ | `reason` | why (`A2ATokenBudgetDenialReason`): `allowance_exhausted`, `allowance_unverifiable`, `consumption_unverifiable`, or `payer_unresolved` (an operation's call nobody can pay for, below) |
46
46
  | `allowanceTokens`, `consumedTokens` | the token limit and the period's consumption, when they could be read |
47
47
  | `allowanceUnits`, `consumedUnits` | a unit ceiling's limit and consumption, in the unit its `ceiling` names (embedding tokens, pages, text records) |
48
48
 
49
49
  A unit ceiling's refusal of a call made in no turn and no flow (the RAG embedding drain, a document ingestion) names no
50
- door (`initiationKind` is absent) and no person; its organization is still the row's.
50
+ door (`initiationKind` is absent) and no person; its organization is still the row's. An allowance refusal of such a
51
+ call names the door `organization_work` and no person: the work it was made in names an organization, never who asked.
52
+ A refusal of a call one of your operations made names the door `resource_operation` and the operation's principal (the
53
+ person or machine whose request it was), so the trail says whose operation was stopped.
51
54
 
52
55
  An admitted turn writes no row. You write no emit: the engine's budget gate records the refusal itself, so a run of
53
56
  them (one account looping the assistant, an organization at its allowance) is visible in the audit trail and the SIEM
@@ -66,13 +69,21 @@ question is asked through, an agent a tool calls, and a declared flow's `agent.c
66
69
  - **A flow is refused before each model call** once the organization's allowance is spent or unverifiable: the step
67
70
  fails, the run ends FAILED on it, and the refusal row names the door `flow_step`. A flow never counts against a
68
71
  person's ceiling.
69
- - **A call made by your own backend code** (an operation, an inbound handler) is charged to the organization its work
70
- is attributed to: the case of a per-record operation (or a CREATE's after-create work) on a `workUnit` resource
71
- (its row's own organization), the organization an inbound handler runs for, or an `attribution` you pass to
72
- `invokeAgent`. It is never refused: nothing asks the allowance before it. A call attributed to no organization (a
73
- collection operation, or any operation on a resource that is not a work unit, with no `attribution`) is charged to
74
- nobody, and its cost is recorded unattributed. Prefer a flow or a turn for model work
75
- an organization should be stopped from doing; otherwise pass `{ attribution: { organizationId } }`.
72
+ - **A call one of your operations makes** (its custom implementation, a hook, an actor run or a nested operation it
73
+ starts) pays as the operation's principal, through the door `resource_operation`, whatever the resource: the
74
+ allowance a turn by that principal would pay from (the organization a person acts in, a person's own with none, an
75
+ organization or application machine's). A principal with no allowance of its own (an internal request, a webhook,
76
+ an inbound handler) pays from the organization the operation acts in (a per-record operation on a `workUnit`
77
+ resource: its case row's), else from the application the principal names. The call is **asked before it runs**
78
+ against that same allowance: once it is spent or cannot be read, `invokeAgent` throws `FEATURE_LIMIT_EXCEEDED`
79
+ (spent) or `INFRASTRUCTURE` (unreadable, retryable) before the model is called, and your operation surfaces that
80
+ error. A call none of them can pay for is refused with `CONFIGURATION` (`payer_unresolved`): pass
81
+ `{ attribution: { organizationId } }` for the organization the work is for, or make the call as a principal that
82
+ pays. An operation called from a turn or a flow is that turn's or that flow's spend instead.
83
+ - **A call made by your own backend code outside any operation** (an inbound handler's own code) is charged to the
84
+ organization its work is attributed to: the organization an inbound handler runs for, the case its work names, or
85
+ an `attribution` you pass to `invokeAgent`, and is asked first through the door `organization_work`, the same way.
86
+ One attributed to no organization is neither asked nor charged: that is the host's own spend.
76
87
  - **A call whose provider reported no token usage** (an image model that reports none, for example) is charged an
77
88
  estimate: four characters of what it sent and returned to a token, plus a fixed figure per image. Never nothing.
78
89
  - **Not counted against the allowance**: RAG embeddings, document extraction and content screening. They are billed in
@@ -113,7 +124,10 @@ flow's, else the one its cost record names). When one is spent, or cannot be che
113
124
  withholds the tool result or the output, exactly as when no classifier answers, and the reason names the ceiling.
114
125
  Size this one generously: a guarded agent that reaches it withholds everything until the period rolls.
115
126
 
116
- Each refusal writes the same `MODEL_SPEND_LIMIT_REFUSED` row, naming the unit's ceiling. Grant none of the three and
127
+ A refusal writes the same `MODEL_SPEND_LIMIT_REFUSED` row, naming the unit's ceiling: one row per refusal when the call
128
+ is made in a turn or a flow, and one row per organization, unit, reason and period (per process) when it is made in
129
+ neither, because a background job such as the embedding drain re-asks a spent ceiling on every run. A restart or a
130
+ second process records it again, so it errs toward recording. Grant none of the three and
117
131
  those calls are not capped. Usage of each is shown on `GET /features/resolved` like the others.
118
132
 
119
133
  ## The engine's contract
@@ -161,7 +175,9 @@ those calls are not capped. Usage of each is shown on `GET /features/resolved` l
161
175
  * A flow run is refused BEFORE each of its model calls once its organization's allowance is spent or unverifiable: the
162
176
  * step fails with the budget's error, the run ends FAILED on that step, nothing of the step is written, and a
163
177
  * `MODEL_SPEND_LIMIT_REFUSED` row names the door `flow_step`. A flow's spend counts against the organization's
164
- * allowance, never a person's ceiling.
178
+ * allowance, never a person's ceiling. A call made in no turn and no flow but attributed to an organization is refused
179
+ * the same way, before it runs, through the door `organization_work` (#2957); its row names that organization and no
180
+ * person. A call attributed to no organization is neither charged nor refused.
165
181
  *
166
182
  * A call whose provider reported no token usage is charged an ESTIMATE (the characters it sent and received, at the
167
183
  * provider-documented four characters per token, plus a fixed figure per image), never nothing. RAG embeddings,
@@ -195,14 +211,18 @@ those calls are not capped. Usage of each is shown on `GET /features/resolved` l
195
211
  * which one (`MODEL_BUDGET_EXHAUSTED`, `PERSON_MODEL_CEILING_EXHAUSTED`, or the recoverable
196
212
  * `MODEL_BUDGET_UNVERIFIABLE`). Granting neither leaves in-app chat uncapped, as it was.
197
213
  *
198
- * ## Every refusal is recorded
214
+ * ## Every refusal leaves a record
199
215
  *
200
216
  * A turn either limit refuses, at any door, writes one `MODEL_SPEND_LIMIT_REFUSED` audit row: the door
201
217
  * (`initiationKind`), which limit (`ceiling`: `organization_budget` or `person_ceiling`), why (`reason`:
202
218
  * `allowance_exhausted`, `allowance_unverifiable` or `consumption_unverifiable`), and the allowance and consumption
203
219
  * when they were known. A call a unit ceiling refuses writes the same row with the unit's ceiling
204
220
  * (`embedding_token_ceiling`, `extraction_page_ceiling` or `screening_text_record_ceiling`), its counts in
205
- * `allowanceUnits` / `consumedUnits`, and the door only when the call was made in one. The actor is the person or machine whose turn it was, and the row's organization is the one
221
+ * `allowanceUnits` / `consumedUnits`, and the door only when the call was made in one. A unit call made in a turn or a
222
+ * flow writes one row per refusal; a call made in NEITHER (the embedding drain, an ingestion sweep, which re-ask a spent
223
+ * ceiling on every run) writes one row per organization, unit, reason and period in each process, and later refusals
224
+ * of the same combination are logged at DEBUG. A restart or a second process records it again, so it errs toward
225
+ * recording. The actor is the person or machine whose turn it was, and the row's organization is the one
206
226
  * whose allowance refused it. The gate writes it, not the door, so no door can refuse without a record. An autonomous
207
227
  * turn refused for spend writes it as well as its own `AUTONOMOUS_AGENT_TURN_REFUSED` row (reason `over_budget`).
208
228
  * An admitted turn writes none.
@@ -237,7 +257,8 @@ those calls are not capped. Usage of each is shown on `GET /features/resolved` l
237
257
  * we cannot prove the tenant is under it — the coherent choice for a spend boundary. This is safe
238
258
  * to fail closed precisely because the counter lives in the application's primary datastore: if
239
259
  * that is unreachable the application is down anyway, so this can never be the *sole* cause of an
240
- * outage (unlike a Redis blip, which is why the burst throttle fails OPEN instead).
260
+ * outage (unlike a Redis blip, which is why the burst throttle counts in process instead of refusing
261
+ * everyone, #3275).
241
262
  *
242
263
  * ## Overage tolerance
243
264
  *
@@ -206,6 +206,12 @@ export enum HumanDecision_AnswerChannel {
206
206
  * `lastAuthenticatedAt`, OIDC `auth_time`). Absent when the token carries none (a chat answer, a delegated token).
207
207
  * - `amr`: how that sign-in was made, RFC 8176 values. Absent when nothing registered applies, never `[]`.
208
208
  * - `stepUpMethod`: the method of the step-up proof this very act carried and consumed, when it carried one.
209
+ * - `stepUpAt`: when that factor was proven, epoch seconds (#2923): the instant the step-up proof was minted, so a
210
+ * verifier compares it with the decision's own instant and sees how fresh the factor that answered was. Absent when
211
+ * the act carried no proof, or the proof records no instant.
212
+ * - `stepUpUserVerified`: for a passkey step-up, whether the authenticator verified the PERSON (the assertion's UV flag,
213
+ * WebAuthn L3 §6.1), not only that it was present (#2923). A step-up ceremony demands it, so a recorded `false` never
214
+ * occurs; the flag is recorded so a verifier need not take that on trust.
209
215
  * - `act`: for `PERSON_THROUGH_CLIENT`, the client that acted for the person.
210
216
  * - `answeredThrough`: for `CHAT`, the stored inbound delivery the answer arrived in; `chatIdentityLinkId` the link that
211
217
  * tied the chat account to the person. The RESOLVED row also carries the delivery as its flat
@@ -219,6 +225,8 @@ export const HumanDecision_DeciderContextSchema = z.object({
219
225
  authTime: z.number().int().nonnegative().optional(),
220
226
  amr: z.array(z.string().trim().min(1)).min(1).optional(),
221
227
  stepUpMethod: z.enum(AuthMethod).systemEnum('AuthMethod').optional(),
228
+ stepUpAt: z.number().int().nonnegative().optional(),
229
+ stepUpUserVerified: z.boolean().optional(),
222
230
  answeredThrough: Inbound_ArrivalSchema.optional(),
223
231
  chatIdentityLinkId: z.string().trim().min(1).optional(),
224
232
  });
@@ -73,7 +73,7 @@ is not established. Read the `ai-use-declaration` skill before choosing the valu
73
73
 
74
74
  | Declaration | Declare it when | Needs |
75
75
  |---|---|---|
76
- | `personalData: { treatment }` | always, on a language-model agent with tools or a conversation: `RedactionType.TOKENIZE` when the agent must refer to a personal value or write it back, `RedactionType.REMOVE` otherwise (a machine turn keeps the placeholders either way) | every tool it is offered declares `personalDataOutput` (what its result carries); the engine's tools do, and startup refuses a hand-written one that does not. Every write tool also declares `argumentsResource`: the engine checks a guarded agent's write arguments whatever the result declares, refuses a withheld marker or an unissued placeholder, and puts an issued placeholder back only into a field of that resource |
76
+ | `personalData: { treatment }` | always, on a language-model agent offered a tool or an MCP server (a treatment acts on what those return, so an agent with neither is sent only what its caller composes and needs none): `RedactionType.TOKENIZE` when the agent must refer to a personal value or write it back, `RedactionType.REMOVE` otherwise (a machine turn keeps the placeholders either way) | every tool it is offered declares `personalDataOutput` (what its result carries); the engine's tools do, and startup refuses a hand-written one that does not. Every write tool also declares `argumentsResource`: the engine checks a guarded agent's write arguments whatever the result declares, refuses a withheld marker or an unissued placeholder, and puts an issued placeholder back only into a field of that resource |
77
77
  | `promptInjection: { screening: THIRD_PARTY_CONTENT }` | the agent reads what somebody else wrote: shared records, documents, retrieved passages, an MCP answer, an inbound email | a provider selected for `EngineCapability.AI_CONTENT_SAFETY` |
78
78
  | `outputModeration: { blockAtOrAbove }` | what the agent writes reaches a person, a record or a message | the same provider |
79
79
 
@@ -78,11 +78,11 @@ export type Flow_Condition = z.infer<typeof Flow_ConditionSchema>;
78
78
  */
79
79
  export const Flow_EdgeSchema = z.object({
80
80
  from: z.object({
81
- type: z.enum(Flow_Node_Type),
81
+ type: z.enum(Flow_Node_Type).systemEnum('Flow_Node_Type'),
82
82
  ref: z.string(),
83
83
  }),
84
84
  to: z.object({
85
- type: z.enum(Flow_Node_Type),
85
+ type: z.enum(Flow_Node_Type).systemEnum('Flow_Node_Type'),
86
86
  ref: z.string(),
87
87
  }),
88
88
  /** The condition under which the run takes this edge; absent, the node's default edge. */
@@ -173,6 +173,25 @@ export type Flow_HumanInTheLoop = {
173
173
  context?: Flow_HumanContextEntry[];
174
174
  /** The questions, as an agent asks its person (`AskPerson_Question`). */
175
175
  questions: AskPerson_Question[];
176
+ /**
177
+ * Whether the answer must carry a fresh step-up proof bound to this question (#2923): the person re-proves a factor
178
+ * (`POST /auth/reauth` with a `decisionBinding` naming the question and the presentation answered) and answers from the
179
+ * decision inbox with it. A chat answer carries none, so it is refused. Use it for a step whose answer commits the
180
+ * person: a sign-off, a payment release.
181
+ */
182
+ requiresStepUpAuthentication?: boolean;
183
+ /**
184
+ * What that step-up must ALSO be (#2923), with `requiresStepUpAuthentication: true` (refused without it):
185
+ * `maximumAgeSeconds` (at most 300) since the factor was proven, and a `minimumAssurance` of `reproven`, `possession`
186
+ * or `phishing_resistant`. Recorded on the decision and its approval seal as `decider.stepUpMethod` / `stepUpAt`.
187
+ */
188
+ stepUp?: HumanDecision_StepUpRequirement;
189
+ /**
190
+ * The channels that may answer this step (#2923): `web_session`, `chat`, `api_client`. Absent: every channel the other
191
+ * requirements allow. `chat` is refused beside a step-up; a chat card for a step it may not answer links to it in the
192
+ * application.
193
+ */
194
+ answerChannels?: HumanDecision_AnswerChannels;
176
195
  };
177
196
 
178
197
  /** One run value a person step shows, and the words that name it to the person (`"Proposed resolution"`). */
@@ -74,7 +74,8 @@ export interface FlowRunResult {
74
74
  *
75
75
  * @throws NOT_FOUND for an unknown flow; VALIDATION for an inactive flow, an ambiguous or unknown trigger, or a `caseRef`
76
76
  * on a resource that is not a work unit; AUTHORIZATION for a requester who is not a person or whose membership
77
- * of `organizationId` does not hold, or whose rebuilt authority acts in another organization
77
+ * of `organizationId` does not hold, who holds none of the roles the flow's `config.accessControl[].roles`
78
+ * opens it to in that organization (`flow_requester_role_not_held`, recorded on the denial trail), or whose rebuilt authority acts in another organization
78
79
  * (`flow_requester_not_in_run_organization`, #2935: its model spend would be charged to the wrong allowance); CONFLICT (`ACTOR_EXECUTION_SUBJECT_BUSY`) while another run of the flow
79
80
  * that is starting or continuing holds `exclusiveSubject`. A run WAITING on a person holds no subject: refuse
80
81
  * a second run yourself when one may be waiting (list the flow's open runs).
@@ -107,7 +107,7 @@ is not established. Read the `ai-use-declaration` skill before choosing the valu
107
107
 
108
108
  | Declaration | Declare it when | Needs |
109
109
  |---|---|---|
110
- | `personalData: { treatment }` | always, on a language-model agent with tools or a conversation: `RedactionType.TOKENIZE` when the agent must refer to a personal value or write it back, `RedactionType.REMOVE` otherwise (a machine turn keeps the placeholders either way) | every tool it is offered declares `personalDataOutput` (what its result carries); the engine's tools do, and startup refuses a hand-written one that does not. Every write tool also declares `argumentsResource`: the engine checks a guarded agent's write arguments whatever the result declares, refuses a withheld marker or an unissued placeholder, and puts an issued placeholder back only into a field of that resource |
110
+ | `personalData: { treatment }` | always, on a language-model agent offered a tool or an MCP server (a treatment acts on what those return, so an agent with neither is sent only what its caller composes and needs none): `RedactionType.TOKENIZE` when the agent must refer to a personal value or write it back, `RedactionType.REMOVE` otherwise (a machine turn keeps the placeholders either way) | every tool it is offered declares `personalDataOutput` (what its result carries); the engine's tools do, and startup refuses a hand-written one that does not. Every write tool also declares `argumentsResource`: the engine checks a guarded agent's write arguments whatever the result declares, refuses a withheld marker or an unissued placeholder, and puts an issued placeholder back only into a field of that resource |
111
111
  | `promptInjection: { screening: THIRD_PARTY_CONTENT }` | the agent reads what somebody else wrote: shared records, documents, retrieved passages, an MCP answer, an inbound email | a provider selected for `EngineCapability.AI_CONTENT_SAFETY` |
112
112
  | `outputModeration: { blockAtOrAbove }` | what the agent writes reaches a person, a record or a message | the same provider |
113
113
 
@@ -18,7 +18,10 @@ Read this at Step 3 (author the agent). It surfaces:
18
18
  arm-specific fields.
19
19
  - `accessControl` + `riskLevel` are required on the config (inherited from the
20
20
  shared leaf-element configuration) — they declare the scope the agent runs
21
- under and its risk classification, not a per-call permission check.
21
+ under and its risk classification, not a per-call permission check. An
22
+ agent's `accessControl` entry takes no `roles`: an agent has no door of its
23
+ own, so who may use it is gated where it is reached — the system's or flow's
24
+ `accessControl[].roles`, or the calling operation's `roles`.
22
25
 
23
26
  All import from `@wildo-ai/saas-models`.
24
27
 
@@ -274,8 +277,37 @@ export enum StructuredGenerationExecutionMode {
274
277
  export type FlowsActors_Agent_LLMConfiguration = FlowsActors_LeafElements_Configuration & FlowsActors_Agent_ExecutionConfiguration & {
275
278
  operationKey: LLMProvider_OperationKey,
276
279
  seed?: number, // Random seed for deterministic output
280
+ /**
281
+ * CALL-TIME FAILOVER (#2301): the models, each on its provider, that take a model call this agent's own model failed
282
+ * TRANSIENTLY, tried in order. A model call is a READ at the provider (it changes nothing there), so it is handed on
283
+ * after the provider was unreachable, timed out, throttled (429) or answered 5xx, and never after a refusal of the
284
+ * request itself: an invalid request, a refused credential or account (no credits, a spend limit), a content refusal.
285
+ *
286
+ * The fence is ONE model call (one step of the agent's loop), never the whole turn: the failed step is asked again of
287
+ * the alternative with the same conversation, so a tool a previous step already ran is never run again. A STREAMED
288
+ * call is handed on only while the provider has not started its stream; once it has, a failure reaches the caller,
289
+ * because the parts already delivered cannot be taken back. Within one invocation the hand-over is sticky: the later
290
+ * steps go to the model that answered.
291
+ *
292
+ * Each alternative must be one this runtime may reach for `AI_LLM` exactly as a selected provider must (declared in
293
+ * the runtime scope with the capability, loaded — which the application's data residency decides — and bound to its
294
+ * declared processing region), enabled, with a credential, on the API transport (not `executionProfileRef`), and able
295
+ * to serve what the agent asks (its reasoning effort, tools, structured output, images where the model's catalog row
296
+ * says). Startup refuses one that is not. The provider-call record names the provider and model that answered, the
297
+ * agent operation record the ids the provider reported, and the call's trace context `modelFailovers` names each
298
+ * hand-over: who failed, who served, why.
299
+ */
300
+ modelFailover?: readonly FlowsActors_Agent_ModelAlternative[],
277
301
  };
278
302
 
303
+ /** One model a {@link FlowsActors_Agent_LLMConfiguration.modelFailover} hands a failed model call to (#2301). */
304
+ export interface FlowsActors_Agent_ModelAlternative {
305
+ /** The provider that serves it: a provider declared in the runtime scope with `AI_LLM`. */
306
+ readonly providerRef: string;
307
+ /** The vendor's model id on that provider. A concrete id: an alternative does not resolve by applicability. */
308
+ readonly model: string;
309
+ }
310
+
279
311
  /**
280
312
  * The IMAGE execution arm of an agent config. Carries image-generation
281
313
  * parameters (`size` / `quality` / `background` / …) instead of LLM sampling,
@@ -125,13 +125,15 @@ export type FlowsActors_Agent_Invocation<
125
125
  * delivered on a STREAMED operation (`STREAM_TEXT`, `STREAM_STRUCTURED`) throws
126
126
  * `AgentModelCallFailedError` instead (exported from `@wildo-ai/saas-backend-lib`, not a
127
127
  * backend error: test it with `instanceof`), carrying the provider's error, its HTTP
128
- * `statusCode` when it refused, and the `usage` of the steps that finished first. Inside a flow run, a
128
+ * `statusCode` when it refused, and the `usage` of the steps that finished first. Inside a flow run, or
129
+ * outside any turn or flow for work attributed to an organization (your own operation or handler, #2957), a
129
130
  * `FEATURE_LIMIT_EXCEEDED` backend error when the organization's model allowance is spent, or `INFRASTRUCTURE`
130
131
  * when it cannot be checked, before the model is called (#2935).
131
132
  *
132
133
  * Every call is charged to the model allowance of the work it is made in (#2935): the conversational turn or flow
133
- * run around it, else the organization its work is attributed to. A call whose provider reported no usage is charged
134
- * an estimate. Application code needs to do nothing for this.
134
+ * run around it, else the organization its work is attributed to, whose allowance is also asked before the call
135
+ * (#2957). A call whose provider reported no usage is charged an estimate. Application code needs to do nothing for
136
+ * this, except pass `attribution` when its work is attributed to no organization otherwise.
135
137
  */
136
138
  public async invokeAgent(
137
139
  request: FlowsActors_Agent_Invocation<any, any, any>,
@@ -129,7 +129,7 @@ an application reaches those through configuration, never through JSX.
129
129
  | `PublicLayout_LegalNotice` | Public legal layout listing the legal name, establishment address and contact always, marking any of those three the operator has not declared yet, and listing legal form, representatives, trade register, VAT number, supervisory authority and regulated profession when declared; it states that no notice is published when the operator owes none. | Use on `/legal-notice`, the route the application router mounts from the public-documents atom and the marketing website links when the notice is owed. | Avoid for governed documents with releases (privacy notice, terms: use the public governed-document page) and for any text the operator did not declare: this page never drafts or invents a particular. |
130
130
  | `PublicLayout_MainContainer` | Minimal full-viewport wrapper driven by `usePublicShellLayout`. In card mode it may open the card with a brand header: the mark when one resolves, and the name — set from the TYPOGRAPHY.HEADING recipe, and not a heading element, since the card content owns the page heading. The login page may pass `organizationBranding` from identification; an explicit shell identity still wins. Tenant color is a decorative identity accent, not a replacement for accessible application theme tokens. Other public pages keep their defaults: a signed-in visitor's organization branding never replaces the application's mark here, since a public page speaks for the application. | Use for auth flows, static marketing content, and other pre-app surfaces. | Avoid for authenticated app shells — use `APP_LAYOUTS_MAIN_CONTAINER`. |
131
131
  | `PublicLayout_StaticContentContainer` | Thin wrapper around centered content within the public shell. | Use for legal, help, or marketing pages that do not need auth chrome. | Avoid for authenticated app surfaces. |
132
- | `PublicLayout_Terms` | Public legal-document layout that shows release version and effective date for a release, a draft notice for an unreleased draft, and a "not yet established" note beneath any clause the document states is incomplete; it shows no partial content when nothing may be displayed, and withholds unapproved releases and drafts only when the application arms its governed-document approval gate (`compliance.governedDocumentApprovalGate`), the same switch every acceptance surface reads. | Use on `/privacy`, `/terms` and future stable-definition public document routes. | Avoid for authenticated governance records, off-site documents, or rendering a draft candidate directly — drafts reach this page only as projected public documents. |
132
+ | `PublicLayout_Terms` | Public legal-document layout that shows release version and effective date for a release, a draft notice for an unreleased draft, a notice with a link to the release in force above a named release that is not in force, and a "not yet established" note beneath any clause the document states is incomplete; it shows no partial content when nothing may be displayed, and withholds unapproved releases and drafts only when the application arms its governed-document approval gate (`compliance.governedDocumentApprovalGate`), the same switch every acceptance surface reads. | Use on `/privacy`, `/terms` and future stable-definition public document routes. | Avoid for authenticated governance records, off-site documents, or rendering a draft candidate directly — drafts reach this page only as projected public documents. |
133
133
 
134
134
  ## Auth (15)
135
135
 
@@ -141,7 +141,7 @@ an application reaches those through configuration, never through JSX.
141
141
  | `Auth_EnrollmentRequired` | Method picker with per-method enrollment ceremonies (TOTP, passkey, phone), or a terminal sign-out when nothing can be enrolled. | Use when an authentication answer requires a second factor and none is usable. | Avoid when a usable second factor exists — use `PUBLIC_LAYOUTS_MFA_CHALLENGE`. |
142
142
  | `Auth_Invitation` | Invitation card with accept/decline and optional sign-in handoff. Beside them, a privacy-notice link opens `/privacy` in a new tab while the application serves its notice, because this screen collects the invitee's name and credential before any session exists (#2976). | Use on invitation deep links. | Avoid when invitations are disabled. |
143
143
  | `Auth_MagicLinkVerify` | Progress + error states for email link verification. | Use on the magic-link landing route. | Avoid when magic links are not offered. |
144
- | `Auth_Main` | Large automated form host switching between password, magic link, passkey, and SSO methods; before any email is typed it also offers username-less passkey sign-in — a sign-in-with-a-passkey button and passkey autofill on the email field — where the device lists every account the person holds a passkey for. Two things it will NOT show: password recovery beside a method that is not the password, and an enterprise method and a password fallback as equal choices — where the tenant requires the former, the page says so. At its foot, beside the recovery and sign-up links, a privacy-notice link opens `/privacy` in a new tab, drawn exactly when that page would render the notice (`resolveServedPublicGovernedDocumentPath`). | Use on the main authentication route. | Avoid for step-up or MFA-only flows — use dedicated MFA layout. |
144
+ | `Auth_Main` | Large automated form host switching between password, magic link, passkey, and SSO methods; before any email is typed it also offers username-less passkey sign-in — a sign-in-with-a-passkey button and passkey autofill on the email field — where the device lists every account the person holds a passkey for. Two things it will NOT show: password recovery beside a method that is not the password, and an enterprise method and a password fallback as equal choices — where the tenant requires the former, the page says so. It never leaves a person in front of an empty page: when it offers no entry point at all it says the person cannot sign in here, and when an identified address is offered no method (an account a directory provisioned, at a domain whose organization switched single sign-on routing off) it tells them to ask whoever manages their sign-in. At its foot, beside the recovery and sign-up links, a privacy-notice link opens `/privacy` in a new tab, drawn exactly when that page would render the notice (`resolveServedPublicGovernedDocumentPath`). | Use on the main authentication route. | Avoid for step-up or MFA-only flows — use dedicated MFA layout. |
145
145
  | `Auth_MfaChallenge` | Session-bound MFA form with method-specific inputs. | Use when `requiresMFA` is returned from identify. | Avoid for first-factor identification. |
146
146
  | `Auth_OAuthConsent` | Approve/deny decision surface for user-delegated (A2A/MCP) OAuth authorization on the /oauth/consent route. | Use on the /oauth/consent route, reached when GET /oauth/authorize returns `consent_required` for an opt-in client; the decision is POSTed to /oauth/authorize/decision. | Avoid for trusted/first-party or machine clients — they auto-grant (requiresConsent defaults false), so the screen never renders for them. |
147
147
  | `Auth_OAuthLoggedOut` | Post-logout confirmation surface on the /oauth/logged-out route; informational only (the session is already terminated server-side by the per-session revocation fence). | Use on the /oauth/logged-out route, reached when GET /oauth/end-session has no registered post_logout_redirect_uri to redirect to (RP-Initiated Logout 1.0 §5). | Avoid when the logout request carries a registered post_logout_redirect_uri — the OP redirects straight back to the relying party (§3) and this screen never renders. |
@@ -454,7 +454,7 @@ an application reaches those through configuration, never through JSX.
454
454
  | `ResourceLayout_DangerZone` | Fenced, destructive-toned section at the bottom of the read view, hosting destructive actions as rows (title, description, button). | Use when a resource exposes destructive (DANGER_ZONE-placement) operations that should be segregated out of the primary action bar. | Avoid when the resource has no destructive operations; the section renders nothing. |
455
455
  | `ResourceLayout_Filters` | Filter controls layout for resource collections. | Use on LIST or SEARCH when filter definitions exist for the resource. | Avoid when the operation has no filter schema. |
456
456
  | `ResourceLayout_Header` | Primary resource header chrome. | Use on operations that need consistent resource titling. | Avoid stuffing unrelated widgets into the header; prefer toolbars. Do not restyle the title in a header template — its voice is the theme recipe — and do not put the record's actions in the bar: they belong on the title line, beside the name they act on. |
457
- | `ResourceLayout_List` | Primary LIST/SEARCH surface that composes resource chrome with the collection renderer; presents as stacked cards or a sortable table per the operation `displayMode`, optionally letting the user switch (choice persisted per resource). | Use for generated LIST operations that need the standard resource list layout lane. | Avoid when the operation replaces the entire view with a custom resource view override. |
457
+ | `ResourceLayout_List` | Primary LIST/SEARCH surface that composes resource chrome with the collection renderer; presents as stacked cards, a sortable table, a status board, a month calendar or a timeline per the operation `displayMode`, optionally letting the user switch (choice persisted per resource). | Use for generated LIST operations that need the standard resource list layout lane. | Avoid when the operation replaces the entire view with a custom resource view override. |
458
458
  | `ResourceLayout_OperationBulk` | Bulk operations host for selected rows. | Use when LIST enables multi-select with bulk semantics. | Avoid when selection is not supported. |
459
459
  | `ResourceLayout_OperationsItems` | Inline item operations renderer. | Use for row-level actions in collections. | Avoid replacing the entire row renderer unless intentional. |
460
460
  | `ResourceLayout_Pagination` | Collection pagination strip. | Use for paginated LIST/SEARCH surfaces. | Avoid when the backend uses infinite scroll only. |
@@ -70,12 +70,12 @@ Group multiple row- or toolbar-level actions with overflow handling, separators,
70
70
  - `size` — Icon button size for action entries in the bar. **Enum** `ButtonSize` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `icon-sm` · `icon`.
71
71
  - `icon-sm` — Default compact toolbar buttons.
72
72
  - `icon` — Larger hit targets when density allows.
73
- - `labelDisplayMode` — How the bar renders action labels. When omitted, falls back to the app-wide default (`ComponentStyleTheme.actionLabelDisplayMode` via `useUI()`). `INLINE` renders label text inside each button; `TOOLTIP` keeps buttons icon-only with tooltip labels; `DROPDOWN` collapses every action into the overflow `…` menu (icon + label per row). **Enum** `ActionLabelDisplayMode` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `TOOLTIP` · `INLINE` · `DROPDOWN`.
73
+ - `labelDisplayMode` — How the bar renders action labels. When omitted, falls back to the app-wide default (`ComponentStyleTheme.actionLabelDisplayMode` via `useUI()`), which is `INLINE` when the theme sets none (`DEFAULT_ACTION_LABEL_DISPLAY_MODE`, #3066): every direct action shows its words. `INLINE` renders label text inside each button; `TOOLTIP` keeps buttons icon-only with tooltip labels; `DROPDOWN` collapses every action into the overflow `…` menu (icon + label per row). **Enum** `ActionLabelDisplayMode` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `TOOLTIP` · `INLINE` · `DROPDOWN`.
74
74
  - `labelDisplayMode` values note: Omitting the prop inherits the app policy; resource views may override it via `layout.actionLabelDisplayMode`.
75
- - `labelDisplayMode` values note: One exception to `TOOLTIP`, scoped to the record header: inside `EmphasisedActionLabelsProvider` an EMPHASISED action (variant `DEFAULT`, `SECONDARY` or `ACCENT`), a single button or a sub-group trigger, shows its label, while the plain ones stay icons. A bare emphasised icon read as a pressed toggle, not as the main verb. Every other bar keeps its label mode as given.
75
+ - `labelDisplayMode` values note: One exception to `TOOLTIP`, scoped to the record header and acting only where a resource or theme chose `TOOLTIP`: inside `EmphasisedActionLabelsProvider` an EMPHASISED action (variant `DEFAULT`, `SECONDARY` or `ACCENT`), a single button or a sub-group trigger, shows its label, while the plain ones stay icons. A bare emphasised icon read as a pressed toggle, not as the main verb. Every other bar keeps its label mode as given.
76
76
  - `labelDisplayMode` values note: The label follows the AUTHORED variant, so a refused emphasised action in the header keeps its words while it is drawn plain: the header does not reflow when the record changes state, and the person can still read what is refused and open the reason.
77
- - `TOOLTIP` — Icon-only buttons with tooltip labels.
78
- - `INLINE` — Label text rendered inside each button.
77
+ - `TOOLTIP` — Icon-only buttons with tooltip labels, for a deliberately dense surface whose glyphs everybody knows. Never for an application's own verbs: a tooltip does not exist on a touch screen.
78
+ - `INLINE` — Label text rendered inside each button (the framework default).
79
79
  - `DROPDOWN` — All actions collapse into the overflow menu (icon + label rows).
80
80
  - `orientation` — Lays the actions out as a horizontal row (default) or a vertical stack. Drives the toolbar flex direction, `aria-orientation`, the inter-item separator axis, and the arrow-key navigation axis. Used e.g. by a resource card whose `cardActionPlacement.orientation` is VERTICAL. **Enum** `DisplayDirection` from `@wildo-ai/zod-decorators` — import it and pass a MEMBER, not a string. Values: `HORIZONTAL` · `VERTICAL`.
81
81
  - `HORIZONTAL` — Buttons in a row (default).
@@ -306,7 +306,7 @@ A whole conversation with an assistant: what was said, what each turn did (its t
306
306
  - A call is named by the host's words when it gives them (`toolCallTitle`, `toolCallInProgress`), else by the engine's: a resource read by the resource's title, a show-records call by what it shows. Any other call is an application's own tool (#2551), named by its own words, `flows_actors_tools.<tool name>.title` on its card and `.working` on the working line, which the labelling pipeline plans from every function tool the application registers (`flowsActorsToolLabelKey`). A tool with no generated words is shown by its name.
307
307
  - Seams instead of forks: `renderApproval` replaces the default approval card, `toolCallTitle` heads a host’s tool cards and `toolCallInProgress` words its working line (kept apart: a card outlives the call, so it must not say it is running), `renderTurnState` rewords how a turn ended, `children` draws a host’s own latest turn.
308
308
  - `.Composer` (`AI_ConversationThreadComposerProps`): `placeholder`, `onSubmit(text)` with the trimmed message, and `onStop` — when given, Stop replaces Send while the latest turn can be stopped (`model.stoppable`, stopping `model.activeExecutionId`). `sendDisabled` holds Send back while the text stays editable (a turn in flight, an assistant not yet available); `disabled` locks the whole composer; `submitting` marks a send in flight; `footerStart` holds the host’s own line beside Send. It also takes the form’s attributes, for a host’s `data-*` hooks.
309
- - `.Discussions` (`AI_ConversationThreadDiscussionsProps`): `discussions` ({ id, title }; an empty title is worded as untitled at render), `currentId`, `onNew`, `onSelect(id)`, and `onDelete(id)` — the delete control appears only when it is given — and `onLoadOlder` with `loadingOlder`, which offer the next older page after the last row only when it is given (#2528). Rows are drawn by the theme’s selectable recipe and the controls are the framework’s Button.
309
+ - `.Discussions` (`AI_ConversationThreadDiscussionsProps`): `discussions` ({ id, title }; an empty title is worded as untitled at render), `currentId`, `onNew`, `onSelect(id)`, and `onDelete(id)` — the delete control appears only when it is given — and `onLoadOlder` with `loadingOlder`, which offer the next older page after the last row only when it is given (#2528). Rows are drawn by the theme’s selectable recipe and the controls are the framework’s Button. It is a full-width band above the thread, and a rail beside it from the `@2xl` CONTAINER width, so its host marks the container (`@container`) and lays the two side by side at the same width: a viewport breakpoint made it a rail inside a 36rem panel on any desktop (#3134).
310
310
  - A successful call to a tool that shows records (`presentRecordsTool`, read back by `presentedRecordsOf`) is not a tool card: it draws a heading (the agent's, else the resource's title) and one card per record, each holding its summary through `ResourceFieldDisplay_ResourceReference`. The cards sit in a display context carrying only the TENANCY — the organization the tool read in (`presentedInOrganizationId`), else the viewer's, and the application, never the viewer's user or a quick-switcher selection — and the host's zone, else PRIMARY. Each card is fetched with the viewer's session each time the conversation is drawn, and opens its record when the resource has a page in that tenancy (a user-nested or API_ONLY target is drawn without a link). While the call runs it is a tool card titled by what it is showing; a failed or refused one stays a tool card titled by what it tried to show. `toolCallTitle` heads neither the cards nor those two.
311
311
  - Selected via `FlowsActorsViewDefinition.layoutPreset`: a preset registered under that name for this component type draws the view. An unregistered name does not fall back to Default: each part draws the not-injected placeholder.
312
312
 
@@ -1281,6 +1281,7 @@ Color picker control integrated with form recipes: swatch trigger opening a fram
1281
1281
  **Composition**
1282
1282
 
1283
1283
  - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1284
+ - Draws the application's field style (`ComponentStyleTheme.fieldVariant`: outlined, filled or underlined), like every field control in the form.
1284
1285
 
1285
1286
  ## `Combobox`
1286
1287
 
@@ -1289,6 +1290,7 @@ Searchable single-select control with keyboard navigation and optional async fil
1289
1290
  **Composition**
1290
1291
 
1291
1292
  - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1293
+ - Draws the application's field style (`ComponentStyleTheme.fieldVariant`: outlined, filled or underlined), like every field control in the form.
1292
1294
 
1293
1295
  ## `ComboboxMultiple`
1294
1296
 
@@ -1297,6 +1299,7 @@ Searchable multi-select with badge chips, async options, and the same command pa
1297
1299
  **Composition**
1298
1300
 
1299
1301
  - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1302
+ - Draws the application's field style (`ComponentStyleTheme.fieldVariant`: outlined, filled or underlined), like every field control in the form.
1300
1303
  - Implementation lives in `@wildo-ai/presets-components` `combobox.tsx`; wrapper + props in `@wildo-ai/saas-frontend-lib` `combobox.tsx`.
1301
1304
 
1302
1305
  ## `Command`
@@ -1346,6 +1349,7 @@ Date-only picker combining popover and calendar.
1346
1349
  **Composition**
1347
1350
 
1348
1351
  - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1352
+ - Draws the application's field style (`ComponentStyleTheme.fieldVariant`: outlined, filled or underlined), like every field control in the form.
1349
1353
 
1350
1354
  ## `DateRangePicker`
1351
1355
 
@@ -1354,6 +1358,7 @@ Picker for inclusive date ranges.
1354
1358
  **Composition**
1355
1359
 
1356
1360
  - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1361
+ - Draws the application's field style (`ComponentStyleTheme.fieldVariant`: outlined, filled or underlined), like every field control in the form.
1357
1362
 
1358
1363
  ## `DateTimePicker`
1359
1364
 
@@ -1362,6 +1367,7 @@ Picker for combined date and time values.
1362
1367
  **Composition**
1363
1368
 
1364
1369
  - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1370
+ - Draws the application's field style (`ComponentStyleTheme.fieldVariant`: outlined, filled or underlined), like every field control in the form.
1365
1371
 
1366
1372
  ## `DateTimeRangePicker`
1367
1373
 
@@ -1370,6 +1376,7 @@ Picker for timestamp intervals.
1370
1376
  **Composition**
1371
1377
 
1372
1378
  - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1379
+ - Draws the application's field style (`ComponentStyleTheme.fieldVariant`: outlined, filled or underlined), like every field control in the form.
1373
1380
 
1374
1381
  ## `DescriptionList`
1375
1382
 
@@ -2834,7 +2841,7 @@ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2834
2841
 
2835
2842
  ## `FormFieldString`
2836
2843
 
2837
- General string input (input, textarea, markdown, password, OTP, color, single organization role) from string UI metadata. `StringEditMode.ORGANIZATION_ROLE` picks ONE key of the organization role table the backend publishes (`organizationRoles`: core plus custom organization roles), each option worded from the `roles` labels, and falls back to a text input when no table is published. `offeredValues` (the values the field's operation offers, `requestFieldOffers`) narrows that table; with `organizationRoleTable: ANOTHER_ORGANIZATION` the field names a role held in another organization and offers `offeredValues` alone, a text input until there are some.
2844
+ General string input (input, textarea, markdown, password, OTP, color, single organization role, month and year) from string UI metadata. `StringEditMode.YEAR_MONTH` (declared by `z_yearMonth()`) is a list of the twelve months named in the reader's locale beside a four-digit year, writing `YYYY-MM` once both are chosen, with a clear action when the field may be emptied (an optional field). `StringEditMode.ORGANIZATION_ROLE` picks ONE key of the organization role table the backend publishes (`organizationRoles`: core plus custom organization roles), each option worded from the `roles` labels, and falls back to a text input when no table is published. `offeredValues` (the values the field's operation offers, `requestFieldOffers`) narrows that table; with `organizationRoleTable: ANOTHER_ORGANIZATION` the field names a role held in another organization and offers `offeredValues` alone, a text input until there are some.
2838
2845
 
2839
2846
  **Composition**
2840
2847
 
@@ -3028,6 +3035,7 @@ Compound text/numeric input with optional prefix/suffix slots and schema-aware t
3028
3035
 
3029
3036
  - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3030
3037
  - Compound component: includes `Input.Root` for affix layouts.
3038
+ - Draws the application's field style (`ComponentStyleTheme.fieldVariant`: outlined, filled or underlined). `variant` overrides it for one field; leave it unset so a form's fields share one style.
3031
3039
 
3032
3040
  ## `InputGroup`
3033
3041
 
@@ -3036,6 +3044,7 @@ Flex row/column shell that visually merges addons, inline buttons, and a borderl
3036
3044
  **Composition**
3037
3045
 
3038
3046
  - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3047
+ - Draws the application's field style (`ComponentStyleTheme.fieldVariant`: outlined, filled or underlined), like every field control in the form.
3039
3048
  - Compound family: pair with `LOW_LEVEL_INPUT_GROUP_*` parts registered from the same presets module.
3040
3049
 
3041
3050
  ## `InputGroupAddon`
@@ -3086,6 +3095,7 @@ One-time code entry with segmented boxes.
3086
3095
  **Composition**
3087
3096
 
3088
3097
  - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3098
+ - Draws the application's field style (`ComponentStyleTheme.fieldVariant`: outlined, filled or underlined), like every field control in the form.
3089
3099
 
3090
3100
  ## `InvoiceHistory`
3091
3101
 
@@ -3190,6 +3200,7 @@ Markdown SOURCE editor for string fields authored with `StringEditMode.MARKDOWN`
3190
3200
  **Composition**
3191
3201
 
3192
3202
  - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3203
+ - Draws the application's field style (`ComponentStyleTheme.fieldVariant`: outlined, filled or underlined), like every field control in the form.
3193
3204
 
3194
3205
  **Through the consumer wrapper**
3195
3206
 
@@ -3394,7 +3405,7 @@ Minimal public-layout frame for static or CMS-driven content with optional child
3394
3405
 
3395
3406
  ## `PublicLayout_Terms`
3396
3407
 
3397
- Public governed-document page for the public shell, serving privacy notices and service terms from the application's `compliance.publicDocuments`: the release in force with the text that release carries, or the latest draft of a document the application has never released.
3408
+ Public governed-document page for the public shell, serving privacy notices and service terms from the application's `compliance.publicDocuments`: the release the SERVER holds in force (asked through the governed-document in-force route, never chosen by the browser's clock) with the text that release carries, the latest draft of a document the application has never released, or the release a link from an acceptance surface names.
3398
3409
 
3399
3410
  **Composition**
3400
3411
 
@@ -3461,6 +3472,8 @@ Resource-aware empty state that resolves i18n and configuration into the generic
3461
3472
  **Props**
3462
3473
 
3463
3474
  - `resourceType` **(required)** — Resource identifier used for scoped i18n lookup. Type: `string`.
3475
+ - `title` — The embedding host's own words for what is empty, already resolved through its i18n (#3078). When given it replaces the resource's empty-state title, and the resource's description is not shown under it. Type: `string`.
3476
+ - `description` — An optional second line in the host's words, read only with `title`. Type: `string`.
3464
3477
 
3465
3478
  **Composition**
3466
3479
 
@@ -3540,7 +3553,7 @@ Danger-zone section grouping the destructive operations of a resource.
3540
3553
 
3541
3554
  ## `ResourceLayout_Filters`
3542
3555
 
3543
- Resource list/search filter strip wired to filter state and backend query params.
3556
+ Resource list/search filter strip wired to filter state and backend query params. One control per filter field, by its classified type: text, number, a yes/no/any choice, an enum list, a date-range picker, a resource-reference picker, a numeric range, a month-and-year picker for a year-month field (`z_yearMonth()`, read from the field or from the resource row), whose applied chip names the month, and two such pickers for a range of months (`Resources_Filter_YearMonthRangeSchema`), whose chip reads "October 2026 – December 2026", "≥ October 2026" or "≤ December 2026".
3544
3557
 
3545
3558
  **Composition**
3546
3559
 
@@ -3548,7 +3561,7 @@ Resource list/search filter strip wired to filter state and backend query params
3548
3561
 
3549
3562
  ## `ResourceLayout_Header`
3550
3563
 
3551
- The page header of a resource operation, in three lines: a bar (back, the parent breadcrumb, and — when the record is open in a split pane — that pane's expand and close), the title line (the resource icon, the title in the theme's `TypographyVariant.RESOURCE_TITLE` voice, and the record's actions), and the facts line (the rest of an authored `layout.header` template: status, priority, the parent chip). A collection's header adds its description under the title.
3564
+ The page header of a resource operation, in three lines: a bar (back, the parent breadcrumb, and — when the record is open in a split pane — that pane's expand and close), the title line (the resource icon, the title in the theme's `TypographyVariant.RESOURCE_TITLE` voice, and the record's actions), and the facts line (the rest of an authored `layout.header` template: status, priority, the parent chip). A collection's header adds its description under the title. On a record's READ page whose body shows the record itself, the name and the facts come from the record the page holds (`heldRecord`), so they change when an operation run from the page changes the record; elsewhere the header reads the record itself and reads it again after an operation on it.
3552
3565
 
3553
3566
  **Composition**
3554
3567
 
@@ -3556,13 +3569,17 @@ The page header of a resource operation, in three lines: a bar (back, the parent
3556
3569
 
3557
3570
  ## `ResourceLayout_List`
3558
3571
 
3559
- Framework list-operation shell for resource collections: a two-line collection toolbar (the promoted quick filter as a segmented control; then one action row with the select-all, expand-on-focus search, icon-only filters, multi-sort, the preset pills, a cards/table view toggle and Create), the collection renderer, and create entry points.
3572
+ Framework list-operation shell for resource collections: a two-line collection toolbar (the promoted quick filter as a segmented control; then one action row with the select-all, expand-on-focus search, icon-only filters, a multi-sort trigger that says "Sort" (a sort glyph is not read alone the way a magnifier or a funnel is), the preset pills, a cards/table view toggle and Create), the collection renderer, and create entry points.
3560
3573
 
3561
3574
  **Composition**
3562
3575
 
3563
3576
  - Default and table presets register in `registerFrameworkLayouts`; apps may add further list presets.
3564
3577
  - The DEFAULT preset owns the data fetch and renders the cards body or the table body in place, so toggling cards/table never refetches. The default body + whether a runtime toggle is shown come from the operation's `operationFrontendConfig.collectionDisplayConfig` (`displayMode` + `userSwitchableDisplayMode`), authored in the resource UI behavior — a pure FRONTEND concern, NOT on the shared resources-config. The table preset is a thin wrapper that seeds the table view.
3565
3578
  - `collectionDisplayConfig` also carries: `cardLayout` (CARDS arrangement — a single-column bordered LIST or an N-column responsive GRID via `CardLayoutStyle`); `cardActionPlacement` (where each card's per-item actions sit — a 2-axis `VerticalPlacement`×`HorizontalPlacement` anchor + `DisplayDirection` orientation, MIDDLE×MIDDLE rejected); and `selectable` (opt-in per-item selection + bulk actions). Selection is a single host-level model shared by the cards checkbox and the table select column (keyed on `resourceFieldIdentifier`), clears on filter/search change but persists across pagination, and while a selection is active the toolbar's action row becomes the selection bar: the select-all (in the rows' checkbox column), the count, then the bulk actions in place of Create; the refine controls and whole-scope collection actions step aside, and a bulk action no selected row can take is hidden. The table also renders a trailing per-row actions column mirroring the cards' per-item operations. All pure FRONTEND presentation.
3579
+ - An embedding host may declare `collectionToolbar: CollectionToolbarPresence.HIDDEN` on the operation context (#3070): the collection then draws its rows and pagination only — no search, filters, sort, tabs, pills, view toggle or Create — for a block of a larger surface (a home) that links to the collection's own page. Independently, a preset pill that assigns a field the host pinned (`pinnedFilters`) is never offered: the pin wins on that key, so the pill could not act. Empty, such a block offers no Create either and reads compact inside its card, and it says what is empty in the host's own words when the host passes `emptyStateWords` (resolved through the host's i18n), never the resource's generic title (#3078).
3580
+ - BOARD (`CollectionDisplayMode.BOARD`, `collectionDisplayConfig.board: { groupByField, transitionOperation? }`, #2298) draws the same fetched rows as one column per value of an ENUM filter field, in declaration order (empty columns kept as drop targets; rows holding no value in a trailing column nothing moves into), each card the CARDS renderer. Each column reads its own rows (the collection read filtered to its value, a page at a time, with "load more"), and its count is that read's total, every row of the value; the rows holding no value are counted (collection total minus the columns) in the trailing column, which says they are seen in cards or table. A column the reader's own filter on the field excludes is empty without a request. A card moves (drag, or Left/Right on the focused card) only through the DECLARED operation, with `{ [groupByField]: value }`: the variants of it whose roles the viewer holds, and among them the highest-rights one whose `enabledCondition` admits that row. The row changes on screen only after the operation succeeded; a refusal leaves the card and shows the backend's words. No transition declared = a read-only board. A misauthored board refuses at frontend-registry build. The view toggle offers BOARD only where one is configured.
3581
+ - CALENDAR (`CollectionDisplayMode.CALENDAR`, `collectionDisplayConfig.calendar: { dateField }`, #2298) draws a month grid in the reader's week (CLDR first weekday), each row on the day its DATE filter field holds: a calendar-day field on its UTC day, an instant on the reader's day in their resolved zone. The visible weeks are a `{ startDate, endDate }` window on that field added to the FETCH only (intersected with the reader's own filter on it; never a chip, never exported, never part of select-all-matching), so another month refetches. EVERY row of the window is read, page after page at the called verb's ceiling (`maxPaginatedResultPerPageLimit`, `DEFAULT_LIST_PAGE_CEILING` 100), up to 5 pages; beyond that a warning above the display counts the rows not shown and asks to narrow the filter. Board, calendar and timeline draw no page control. The grid is one tab stop (WAI-ARIA date grid: arrows, Home/End, Page Up/Down, the focused day's items reachable by Tab); a row opens as a card would. An empty month still renders the grid. A field that is not a date filter field renders the cards; a misauthored calendar refuses at frontend-registry build.
3582
+ - TIMELINE (`CollectionDisplayMode.TIMELINE`, `collectionDisplayConfig.timeline: { startField, endField }`, #2298) draws one row per record with a bar from the day its start field falls on to the day its end field falls on (both DATE filter fields, and different), over the days of the displayed month; a bar cut at the month's edge is marked, and every bar is a button named with the row and its FULL dates, Up/Down walking the bars. The month is the fetch's window as two one-sided windows (start on or before its last day, end on or after its first), so a row missing either date is not on it. CALENDAR and TIMELINE share the displayed month; both render an empty month so it can be left.
3566
3583
  - Sort is one multi-sort model (`SortState[]`, priority = order) shared by the toolbar sort popover and the table column headers, serialized as `sort=field:dir,field:dir` with LIST/SEARCH parity (validated against the operation `sortFields` and applied at the repository).
3567
3584
 
3568
3585
  ## `ResourceLayout_OperationBulk`
@@ -3575,7 +3592,7 @@ Bulk selection actions bar for list operations.
3575
3592
 
3576
3593
  ## `ResourceLayout_OperationsItems`
3577
3594
 
3578
- Per-row operation affordances on list or search results.
3595
+ The actions of one record: a list row (`displayMode` SUMMARY) or the record page header (DETAIL). By default each direct action shows its words (`DEFAULT_ACTION_LABEL_DISPLAY_MODE`, INLINE) and the rest wait in the `…` menu, which shows words too: a list row keeps ONE direct action (none on a phone, `MOBILE_SUMMARY_MAX_PRIMARY_ACTIONS`), the header three (one on a phone, `MOBILE_DETAIL_MAX_PRIMARY_ACTIONS`; `DEFAULT_ACTION_DISCLOSURE`), the first that can run in `displayPriority` order. A resource overrides either view with `layout.actionLabelDisplayMode` / `layout.actionDisclosure`.
3579
3596
 
3580
3597
  **Composition**
3581
3598
 
@@ -3602,6 +3619,7 @@ Provide the framework read-surface contract for resource detail views that resol
3602
3619
 
3603
3620
  - The wrapper resolves the effective read implementation from the preset override key and otherwise falls back to the default read preset.
3604
3621
  - Default and expandable read presets both participate in the framework component registry and therefore belong in this injectable component specification family.
3622
+ - With no authored `layout.display`, the body is GENERATED and laid out by the role each field plays (`classifyRecordFact`, #3066): the status first as its bare pill (`RecordState`: the first enum declared `BADGE`), then content, then the facts as tiles (`FieldTiles`, separated by a hairline rule in the default theme), then who made the record and when on one small muted line (`RecordKeepingFacts`: `createdByUserId` and the managed timestamps). The record's primary-scope column is not shown, and a DECLARED record name is not repeated beneath the header that shows it (unless that field is edited in place there).
3605
3623
  - Direct app code rarely constructs this component manually; most usage flows through route/runtime resource operations that already own `resourceContext` and `navigationZone`.
3606
3624
  - Use `displayPresetOverride.resourceLayoutPresetKey` to choose framework-owned preset variants such as `DEFAULT` or `EXPANDABLE`.
3607
3625
 
@@ -3690,6 +3708,7 @@ Compound select menu for single choice fields.
3690
3708
  **Composition**
3691
3709
 
3692
3710
  - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3711
+ - Draws the application's field style (`ComponentStyleTheme.fieldVariant`: outlined, filled or underlined), like every field control in the form.
3693
3712
  - Compound component with `Select.Trigger`, `Select.Content`, etc.
3694
3713
 
3695
3714
  ## `SelectMultiple`
@@ -3699,6 +3718,7 @@ Multi-select dropdown with badge summaries.
3699
3718
  **Composition**
3700
3719
 
3701
3720
  - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3721
+ - Draws the application's field style (`ComponentStyleTheme.fieldVariant`: outlined, filled or underlined), like every field control in the form.
3702
3722
 
3703
3723
  ## `Separator`
3704
3724
 
@@ -3951,12 +3971,12 @@ Render body and inline copy using the design-system text scale instead of ad-hoc
3951
3971
  - `destructive` — Error or danger-adjacent copy.
3952
3972
  - `success` — Positive status copy.
3953
3973
  - `inherit` — Match parent color.
3954
- - `typography` — The TYPOGRAPHY recipe the text is set in — BODY unless said otherwise; EYEBROW for a tracked uppercase label above a heading or a section. **Enum** `TypographyVariant` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `body` · `eyebrow` · `description` · `resource-title` · `data`. Default `body`.
3974
+ - `typography` — The TYPOGRAPHY recipe the text is set in — BODY unless said otherwise; EYEBROW for the small, muted name of a fact or a group (the caption above a value, a read section's legend). **Enum** `TypographyVariant` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `body` · `eyebrow` · `description` · `resource-title` · `data`. Default `body`.
3955
3975
  - `body` — Body copy — the default.
3956
- - `eyebrow` — A small tracked uppercase label above a heading or a section, worded by the theme.
3976
+ - `eyebrow` — The small, muted name of a fact or a group — the caption above a value, a read section's legend. Sentence case in the body face in the default theme (since #3066); a theme may set it otherwise.
3957
3977
  - `description` — Descriptive copy beneath a title.
3958
3978
  - `resource-title` — The name a page or pane is about, in the voice the resource header uses: a custom view composing its own header should title it with this rather than restyling a heading.
3959
- - `data` — A figure — a date, an amount, a duration, a count — in the theme's data voice (tabular figures; monospace in the default theme). Every value formatter already uses it; a custom view showing a figure should too, rather than adding tabular-nums by hand.
3979
+ - `data` — A figure — a date, an amount, a duration, a count — in the theme's data voice (the body face in the default theme; a table root sets tabular figures so its columns align — since #3066). Every value formatter already uses it; a custom view showing a figure should too, rather than styling it by hand.
3960
3980
  - `size` — Type scale mapped to design-system CSS variables. **Enum** `TextSize` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `xxs` · `xs` · `sm` · `base` · `lg`.
3961
3981
  - `xxs` — Meta / badge scale.
3962
3982
  - `xs` — Compact helper text.
@@ -3990,6 +4010,7 @@ Multi-line text control with shared form-control recipes.
3990
4010
  **Composition**
3991
4011
 
3992
4012
  - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
4013
+ - Draws the application's field style (`ComponentStyleTheme.fieldVariant`: outlined, filled or underlined). `variant` overrides it for one field; leave it unset so a form's fields share one style.
3993
4014
 
3994
4015
  ## `TextLink`
3995
4016
 
@@ -4059,6 +4080,7 @@ Time-of-day picker control.
4059
4080
  **Composition**
4060
4081
 
4061
4082
  - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
4083
+ - Draws the application's field style (`ComponentStyleTheme.fieldVariant`: outlined, filled or underlined), like every field control in the form.
4062
4084
 
4063
4085
  ## `TimeRangePicker`
4064
4086
 
@@ -4067,6 +4089,7 @@ Picker for start/end times within a day.
4067
4089
  **Composition**
4068
4090
 
4069
4091
  - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
4092
+ - Draws the application's field style (`ComponentStyleTheme.fieldVariant`: outlined, filled or underlined), like every field control in the form.
4070
4093
 
4071
4094
  ## `Toaster`
4072
4095
 
@@ -125,7 +125,7 @@ export const GuidanceAudienceSchema = z.object({
125
125
  equals: z.union([z.string(), z.number(), z.boolean()]),
126
126
  })).optional(),
127
127
  /** Only show to users created after this date (for new-user flows) */
128
- createdAfter: z.coerce.date().optional(),
128
+ createdAfter: z.date().nullish(),
129
129
  });
130
130
  export type GuidanceAudience = z.infer<typeof GuidanceAudienceSchema>;
131
131