@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
@@ -14,16 +14,15 @@ when the migration exists and is committed.
14
14
 
15
15
  ```bash
16
16
  rg -n "applicationDatabase" infrastructure/*/wildo.infra.*.config.ts
17
- rg -n "persistenceAdapter: PersistenceAdapter.POSTGRESQL" shared-lib backend-api
18
17
  ```
19
18
 
20
- You are out of it only when BOTH hold: every environment declares
21
- `applicationDatabase: { engine: DatabaseEngine.MONGODB }`, and no resource
22
- declares `persistenceAdapter: PersistenceAdapter.POSTGRESQL`. Stop here in that
19
+ You are out of it only when every environment declares
20
+ `applicationDatabase: { engine: DatabaseEngine.MONGODB }`. Stop here in that
23
21
  case. Otherwise every line below is live: an environment that names no
24
- `applicationDatabase` persists to PostgreSQL, one environment on PostgreSQL is
25
- enough, and a resource kept on PostgreSQL in a MongoDB application owes its
26
- table. `wildo db generate` plans exactly the tables your environments need.
22
+ `applicationDatabase` persists to PostgreSQL, and one environment on PostgreSQL
23
+ is enough. An application uses exactly one transactional store, so no resource
24
+ can be kept on PostgreSQL inside a MongoDB application. `wildo db generate` plans
25
+ exactly the tables your environments need.
27
26
 
28
27
  ## What you owe, and when
29
28
 
@@ -25,7 +25,7 @@ empty or fails.
25
25
  | `wildo context workspace map\|get\|related` | the application's own code, by resource — its fields, operations and relationships — instead of the whole registry |
26
26
  | `wildo context journey` | where the application's creation stands: what is eligible, what is unmet, and what each run took and spent — per round and per child for a composite, with the rounds that began from a state an earlier round had already begun from |
27
27
  | `wildo context coherence` | what disagrees across the landed specification families |
28
- | `wildo context launch-blockers` | what still stands between the application and a real user — each open compliance decision (an undeclared part of `operatorComplianceIdentity`, an unanswered governance question, an undeclared retention class, undeclared subject-data recipients, sign-up acceptance) and a brand name its trademark screening has not cleared, where it is decided and what settles it. It marks and never blocks; a settled item is gone on the next read |
28
+ | `wildo context launch-blockers` | what still stands between the application and a real user — each open compliance decision (an undeclared part of `operatorComplianceIdentity`, an unanswered governance question, an undeclared retention class, undeclared subject-data recipients, sign-up acceptance, a HARD obligation of the compliance programme that is not met, a data residency answered and not yet declared, a data-serving provider not placed inside the residency) and a brand name its trademark screening has not cleared, where it is decided and what settles it. It marks and never blocks; a settled item is gone on the next read |
29
29
  | `wildo context health` | whether the companion is answering at all |
30
30
 
31
31
  ## Commands that ask the running application backend
@@ -41,6 +41,7 @@ describes adding or changing its capabilities.
41
41
  | **`resource-status-lifecycle`** — give a resource states the engine enforces: one operation per transition (`enabledCondition` + `basicPrefixOperation` + `authoritativeFields`), the status excluded from UPDATE, the record frozen once final, and a conversion's write in one transaction; for a quote, order or invoice, the parts that make it a trustworthy commercial document | "accept a quote", "issue the invoice", "mark it paid", "lock it after it is sent", "only allow X when Y", "convert the quote into a job" |
42
42
  | **`resource-config-wiring`** — edit `*.resources-config.ts` for operations, variants, relationships, roles | "wire a new operation variant", "add a custom operation to a resource", "configure resource relationships in registry", "change operation roles" |
43
43
  | **`resource-retention-binding`** — bind a resource to a retention class and start point so expired rows are deleted on schedule | "delete closed tickets after 90 days", "how long do we keep X", "keep invoices ten years", "purge old logs", "retention period for this resource" |
44
+ | **`subject-data-export`** — answer an access or portability request with the subject export, and deliver portability as one archive with the files the person uploaded | "export everything we hold about this user", "answer a data access request", "download my data", "include the user's uploaded files in their export", "zip the export" |
44
45
  | **`resource-ui-behavior`** — edit `*.ui-behavior.tsx` for layouts, display/edit modes, enum UI | "change how the priority field renders", "tweak the tasks list UI behavior", "add display-mode badge-with-colors", "conditional visibility on a field" |
45
46
  | **`resource-custom-view`** — implement `*CustomView.tsx` components bound to operation context | "implement TaskExecutionView", "write a custom view component", "hook custom React into a resource operation", "author a resource-owned view host" |
46
47
  | **`resource-rag-source-fields`** — declare which fields feed the retrieval corpus (`.ragSource()`), their chunking, and embeddings | "make this searchable by AI", "add RAG over our documents", "let the assistant answer from the knowledge base", "make uploaded PDFs searchable", "set up embeddings" |
@@ -256,6 +257,7 @@ Anything that changes **backend-api code** beyond schema-driven CRUD.
256
257
  | **`application-roles-authoring`** — declare the application's own user roles (`shared-lib/src/engine/roles.ts`), offer each on its organization types (`availableOrgRoles`) and name it in the `roles` of every operation it unlocks; roles are configuration, never a resource of role names or permissions | "office and field users see different things", "add a technician role", "only admins can issue invoices", "permissions per role", "different user roles see different screens", "who can do what" |
257
258
  | **`authorization-unit-narrowing`** — declare a resource confined to the organization UNIT (department / region / team) a member holds a role in, via the `organizationUnitNarrowing` startup opt-in, or to the rows a member OWNS via `organizationOwnRows`; confines reads and writes without touching the organization scope | "scope this resource to a department", "each team should only see their own records", "each employee should only see their own requests", "regional managers should only manage their region's data", "restrict projects to the user's business unit", "add unit-level permissions", "why can a unit manager see every record" |
258
259
  | **`professional-qualifications`** — decide who may take a decision (a role, a relationship role, one named person, or a person holding a verified professional qualification) and declare it: `professionalQualificationKinds`, the organization's qualifications register, and `requiredQualificationKinds` on an approval gate, an operation's `requiresApproval` or a flow's person step | "only a chartered accountant may approve", "the approver must be licensed", "a qualified person must sign off", "track our staff's certifications", "who is allowed to approve this" |
260
+ | **`electronic-signature-deliverables`** — have an approved file deliverable signed by its approver through a trust-service vendor: `FunctionTool.electronicSignature`, the `ELECTRONIC_SIGNATURE` capability, and what makes a request SIGNED (the validated signed PDF, never the vendor's word) | "the client must e-sign the engagement letter", "send the approved report for electronic signature", "we need an advanced electronic signature", "the signature request stays open", "why is the signed document rejected" |
259
261
  | **`organization-relationships`** — let one organization's people work inside other organizations (an agency, a practice, a partner) under a relationship the granting organization proposes or accepts, can confine to some of its teams, and can end on the next request; relationship kinds under the top-level `organizationRelationships`, and each relationship's records separated from the others' in one tenant | "let an agency work in our customers' workspaces", "our consultants need access to client accounts", "managed service provider access", "limit the agency to one department", "two firms serve one client and must not see each other's work", "how does a client revoke an outside firm" |
260
262
 
261
263
  ### Data seeding — declarative row materialization + operations
@@ -360,7 +362,7 @@ contracts and the `InboundContact` resource.
360
362
  | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
361
363
  | **`website-page-authoring`** — author an application homepage, product page, solution page or other website page: page kind (route, menu placement, essential sections), product message, visual direction, composed sections, manifest and route | "create the homepage", "make the landing page more modern", "add a product page", "add a solution page for <audience>", "add a new website page", "compose a landing page", "create a new marketing route" |
362
364
  | **`website-page-variants`** — add a page for a distinct audience or campaign (a SOLUTION page at `/solutions/<slug>`, or its own page); the engine has no variant field and serves one page per route | "add an audience variant", "create a /for-X version of the landing page", "spin up a campaign variant", "split-test a landing page" |
363
- | **`website-label-pack`** — author the per-locale JSON label packs (`website/src/i18n/<locale>.json`) a section's `expectedLabelKeys` commit to, read through `useWebsiteLabel` / `useWebsiteLabelByKey` | "add a translation key", "author a label pack", "override a page label per locale", "give an audience page its own words" |
365
+ | **`website-label-pack`** — author the per-locale JSON label packs (`website/src/i18n/<locale>.json`, a section's words in its own `<locale>/<page>.<sectionRef>.json`) a section's `expectedLabelKeys` commit to, read through `useWebsiteLabel` / `useWebsiteLabelByKey` | "add a translation key", "author a label pack", "override a page label per locale", "give an audience page its own words" |
364
366
  | **`website-seo-aeo-geo`** — configure first-class SEO / AEO / GEO surfaces (meta, canonical, hreflang, JSON-LD, llms.txt, robots.txt, sitemap, AI crawler policy) | "configure SEO", "add JSON-LD for X", "wire llms.txt", "configure AI crawler policy", "add hreflang", "audit our SEO/AEO/GEO posture" |
365
367
  | **`website-blog-authoring`** — author blog posts as fully localized MDX files per locale; auto-emit `BlogPosting` JSON-LD | "add a blog post", "author a per-locale article", "publish an MDX article", "configure blog frontmatter" |
366
368
  | **`website-navigation-authoring`** — author the site menu declared in `website/src/site-menu.ts` (links, Product/Solutions panels with described items, featured card, overview, header actions into the application by entry point) rendered by the engine's `WebsiteSiteHeader` (desktop panels, mobile drawer, sticky / auto-hide) and `WebsiteSiteFooterMenu`; build-checked routes and derived label keys | "add a menu item", "add a Products / Solutions mega menu", "wire site navigation", "add a sign-in button to the header", "make the header sticky", "configure footer columns", "swap the header on a campaign page" |
@@ -26,6 +26,9 @@ How it fits together:
26
26
  the proposing agent there too: an operation an agent's tool call dispatched sees it as
27
27
  `executionContext.agentActor.agentRef` (evidence only, never authority). Mark the question `review` only when it is
28
28
  set; a question a person proposed is not a review of any agent.
29
+ A CHOICE field whose options are record ids (which document, which person) gives each id its words in
30
+ `optionLabels` — `{ [id]: title }`, only for ids in `options` — so the reviewer picks between documents, not ids;
31
+ the answer still carries the id, and the decision's seal records the words the reviewer read.
29
32
  A run that must be the only open question on its subject (one bank line, one invoice) carries `exclusiveSubject`,
30
33
  but a WAITING run holds no lease: check for an open run on the subject yourself before opening another.
31
34
  2. The run waits on your application's own actor-plane rows; the question appears in the decision inbox of the people
@@ -97,6 +100,27 @@ export interface ActorExecutionContinuation<T = unknown> {
97
100
  * CALENDAR clock in an application with no `reviewCalendar`, and a host whose actor store cannot keep the clocks.
98
101
  */
99
102
  readonly deadlines?: ReviewDeadlinesDeclaration;
103
+ /**
104
+ * Whether an answer to this system's questions must carry a fresh step-up proof bound to the question (#2923), as an
105
+ * operation approval's `requiresApproval.requiresStepUpAuthentication` does. The person re-proves a factor
106
+ * (`POST /auth/reauth` with a `decisionBinding` naming the question and the presentation they answer) and answers from
107
+ * the decision inbox with it in `X-Reauth-Token`; a chat answer carries none and is refused. Armed on each ROUTED
108
+ * question when it is raised (the ones the inbox answers, as `deadlines` are) and stored with it, so a change to this
109
+ * declaration never changes what a waiting question requires. The engine also refuses to settle such a question for any
110
+ * door whose decider shows no step-up meeting it.
111
+ */
112
+ readonly requiresStepUpAuthentication?: boolean;
113
+ /**
114
+ * What that step-up must ALSO be (#2923), with `requiresStepUpAuthentication: true`; startup refuses it without:
115
+ * `maximumAgeSeconds` (at most 300) since the factor was proven, and a `minimumAssurance` of `reproven`, `possession`
116
+ * or `phishing_resistant`. The factor and the instant it was proven are recorded on the decision and its approval seal.
117
+ */
118
+ readonly stepUp?: HumanDecision_StepUpRequirement;
119
+ /**
120
+ * The channels that may answer this system's routed questions (#2923): `web_session`, `chat`, `api_client`. Armed and
121
+ * stored with each question like its step-up. `chat` is refused beside a step-up.
122
+ */
123
+ readonly answerChannels?: HumanDecision_AnswerChannels;
100
124
  /** Continue the run with the person's answer. Runs as the run's executor, under the run's work attribution. */
101
125
  continue(input: ActorExecutionContinuationInput): Promise<T>;
102
126
  /** How the continuation's result is read: whether it asks again, and how it concluded. */
@@ -75,7 +75,7 @@ export const AGENT_WORK_REASON_CODE_VOCABULARY = ApplicationConfigVocabulary.AGE
75
75
  * A tool approval is always a proposal and needs no marker.
76
76
  */
77
77
  review: z.strictObject({
78
- surface: z.enum(AgentWorkDecisionSurface),
78
+ surface: z.enum(AgentWorkDecisionSurface).systemEnum('AgentWorkDecisionSurface'),
79
79
  }).optional(),
80
80
  ```
81
81
 
@@ -167,7 +167,7 @@ const CountryCodeSchema = z.string().length(2).refine((code) => COUNTRY_CODES.ha
167
167
  /** The `ref` of the request field this form field asks. Opaque, as the request's refs are. */
168
168
  const FieldRefSchema = z.string().min(1);
169
169
 
170
- export const HumanInputForm_TextFieldSchema = z.strictObject({
170
+ const TEXT_FIELD_SHAPE = {
171
171
  ref: FieldRefSchema,
172
172
  type: z.literal(HumanInputForm_FieldType.TEXT).systemEnum('HumanInputForm_FieldType'),
173
173
  format: z.enum(HumanInputForm_TextFormat).systemEnum('HumanInputForm_TextFormat').optional(),
@@ -176,11 +176,13 @@ export const HumanInputForm_TextFieldSchema = z.strictObject({
176
176
  textareaRows: z.int().min(2).max(20).optional(),
177
177
  minLength: z.int().min(1).optional(),
178
178
  maxLength: z.int().min(1).optional(),
179
- }).refine((field) => field.minLength === undefined || field.maxLength === undefined || field.minLength <= field.maxLength, {
179
+ };
180
+ export const HumanInputForm_TextFieldSchema = z.strictObject(TEXT_FIELD_SHAPE)
181
+ .refine((field) => field.minLength === undefined || field.maxLength === undefined || field.minLength <= field.maxLength, {
180
182
  message: 'minLength is above maxLength.',
181
183
  });
182
184
 
183
- export const HumanInputForm_NumberFieldSchema = z.strictObject({
185
+ const NUMBER_FIELD_SHAPE = {
184
186
  ref: FieldRefSchema,
185
187
  type: z.literal(HumanInputForm_FieldType.NUMBER).systemEnum('HumanInputForm_FieldType'),
186
188
  integer: z.boolean().optional(),
@@ -192,7 +194,9 @@ export const HumanInputForm_NumberFieldSchema = z.strictObject({
192
194
  prefix: z.string().min(1).max(8).optional(),
193
195
  /** Shown after the value, such as "kg" or "%". */
194
196
  suffix: z.string().min(1).max(12).optional(),
195
- }).refine((field) => field.min === undefined || field.max === undefined || field.min <= field.max, {
197
+ };
198
+ export const HumanInputForm_NumberFieldSchema = z.strictObject(NUMBER_FIELD_SHAPE)
199
+ .refine((field) => field.min === undefined || field.max === undefined || field.min <= field.max, {
196
200
  message: 'min is above max.',
197
201
  }).refine((field) => field.editMode !== NumberEditMode.SLIDER || (field.min !== undefined && field.max !== undefined), {
198
202
  message: 'A SLIDER needs min and max.',
@@ -208,13 +212,15 @@ export const HumanInputForm_DateTimeFieldSchema = z.strictObject({
208
212
  type: z.literal(HumanInputForm_FieldType.DATETIME).systemEnum('HumanInputForm_FieldType'),
209
213
  });
210
214
 
211
- export const HumanInputForm_MoneyFieldSchema = z.strictObject({
215
+ const MONEY_FIELD_SHAPE = {
212
216
  ref: FieldRefSchema,
213
217
  type: z.literal(HumanInputForm_FieldType.MONEY).systemEnum('HumanInputForm_FieldType'),
214
218
  currenciesAllowed: z.array(z.enum(CurrencyAllowed)).min(1).optional(),
215
219
  allowCurrencyChange: z.boolean().optional(),
216
220
  defaultCurrency: AvailableCurrencySchema.optional(),
217
- }).refine((field) => !field.defaultCurrency || currencyIsInAllowedCategories(field.defaultCurrency, field.currenciesAllowed), {
221
+ };
222
+ export const HumanInputForm_MoneyFieldSchema = z.strictObject(MONEY_FIELD_SHAPE)
223
+ .refine((field) => !field.defaultCurrency || currencyIsInAllowedCategories(field.defaultCurrency, field.currenciesAllowed), {
218
224
  message: 'defaultCurrency is not in currenciesAllowed.',
219
225
  });
220
226
 
@@ -233,14 +239,16 @@ export const HumanInputForm_RangeFieldSchema = z.strictObject({
233
239
  message: 'A range whose start and end are both optional can be answered with nothing.',
234
240
  });
235
241
 
236
- export const HumanInputForm_DurationFieldSchema = z.strictObject({
242
+ const DURATION_FIELD_SHAPE = {
237
243
  ref: FieldRefSchema,
238
244
  type: z.literal(HumanInputForm_FieldType.DURATION).systemEnum('HumanInputForm_FieldType'),
239
245
  allowedUnits: z.array(z.enum(DurationUnit)).min(1).optional(),
240
246
  defaultUnit: z.enum(DurationUnit).optional(),
241
247
  minValue: z.number().optional(),
242
248
  maxValue: z.number().optional(),
243
- }).refine((field) => !field.defaultUnit || !field.allowedUnits || field.allowedUnits.includes(field.defaultUnit), {
249
+ };
250
+ export const HumanInputForm_DurationFieldSchema = z.strictObject(DURATION_FIELD_SHAPE)
251
+ .refine((field) => !field.defaultUnit || !field.allowedUnits || field.allowedUnits.includes(field.defaultUnit), {
244
252
  message: 'defaultUnit is not one of allowedUnits.',
245
253
  });
246
254
 
@@ -250,24 +258,28 @@ export const HumanInputForm_PhoneFieldSchema = z.strictObject({
250
258
  defaultCountry: CountryCodeSchema.optional(),
251
259
  });
252
260
 
253
- export const HumanInputForm_AddressFieldSchema = z.strictObject({
261
+ const ADDRESS_FIELD_SHAPE = {
254
262
  ref: FieldRefSchema,
255
263
  type: z.literal(HumanInputForm_FieldType.ADDRESS).systemEnum('HumanInputForm_FieldType'),
256
264
  countriesAllowed: z.array(CountryCodeSchema).min(1).optional(),
257
265
  defaultCountry: CountryCodeSchema.optional(),
258
- }).refine((field) => !field.defaultCountry || !field.countriesAllowed
266
+ };
267
+ export const HumanInputForm_AddressFieldSchema = z.strictObject(ADDRESS_FIELD_SHAPE)
268
+ .refine((field) => !field.defaultCountry || !field.countriesAllowed
259
269
  || field.countriesAllowed.some((country) => country.toUpperCase() === field.defaultCountry!.toUpperCase()), {
260
270
  message: 'defaultCountry is not one of countriesAllowed.',
261
271
  });
262
272
 
263
- export const HumanInputForm_DecimalFieldSchema = z.strictObject({
273
+ const DECIMAL_FIELD_SHAPE = {
264
274
  ref: FieldRefSchema,
265
275
  type: z.literal(HumanInputForm_FieldType.DECIMAL).systemEnum('HumanInputForm_FieldType'),
266
276
  /** Most decimal places a value may have. */
267
277
  precision: z.int().min(0).max(20).optional(),
268
278
  min: BigDecimalValueSchema.optional(),
269
279
  max: BigDecimalValueSchema.optional(),
270
- }).refine((field) => field.min === undefined || field.max === undefined || bigDecimalCompare(field.min, field.max) <= 0, {
280
+ };
281
+ export const HumanInputForm_DecimalFieldSchema = z.strictObject(DECIMAL_FIELD_SHAPE)
282
+ .refine((field) => field.min === undefined || field.max === undefined || bigDecimalCompare(field.min, field.max) <= 0, {
271
283
  message: 'min is above max.',
272
284
  });
273
285
 
@@ -303,6 +315,29 @@ export const HumanInputForm_FieldSchema = z.discriminatedUnion('type', [
303
315
  ]);
304
316
  export type HumanInputForm_Field = z.infer<typeof HumanInputForm_FieldSchema>;
305
317
 
318
+ /** One member of {@link HumanInputForm_FieldSchema}: the schema of one field type. */
319
+ export type HumanInputForm_FieldTypeSchema = (typeof HumanInputForm_FieldSchema)['options'][number];
320
+
321
+ /**
322
+ * The schema of each field type, by type (#3146). Total over `HumanInputForm_FieldType`, so a type added tomorrow does not
323
+ * compile until it has one. A form a model composes is written in a narrower vocabulary, the same types without their
324
+ * validation constraints (#3176), and is a form of this one.
325
+ */
326
+ export const HUMAN_INPUT_FORM_FIELD_SCHEMA_BY_TYPE: Readonly<Record<HumanInputForm_FieldType, HumanInputForm_FieldTypeSchema>> = {
327
+ [HumanInputForm_FieldType.TEXT]: HumanInputForm_TextFieldSchema,
328
+ [HumanInputForm_FieldType.NUMBER]: HumanInputForm_NumberFieldSchema,
329
+ [HumanInputForm_FieldType.DATE]: HumanInputForm_DateFieldSchema,
330
+ [HumanInputForm_FieldType.DATETIME]: HumanInputForm_DateTimeFieldSchema,
331
+ [HumanInputForm_FieldType.MONEY]: HumanInputForm_MoneyFieldSchema,
332
+ [HumanInputForm_FieldType.RANGE]: HumanInputForm_RangeFieldSchema,
333
+ [HumanInputForm_FieldType.DURATION]: HumanInputForm_DurationFieldSchema,
334
+ [HumanInputForm_FieldType.PHONE]: HumanInputForm_PhoneFieldSchema,
335
+ [HumanInputForm_FieldType.ADDRESS]: HumanInputForm_AddressFieldSchema,
336
+ [HumanInputForm_FieldType.DECIMAL]: HumanInputForm_DecimalFieldSchema,
337
+ [HumanInputForm_FieldType.CHOICE]: HumanInputForm_ChoiceFieldSchema,
338
+ [HumanInputForm_FieldType.CONFIRM]: HumanInputForm_ConfirmFieldSchema,
339
+ };
340
+
306
341
  /**
307
342
  * One heading and the fields under it: a `<Section>` or a `<WizardStep>`. Its words are the asker's, written as text
308
343
  * (`DisplayOrFormSectionLabel.title`). It has no name: the compiler names it by position.
@@ -242,8 +242,8 @@ together.
242
242
  | Visible UI, navigation and labels | `frontend/src/**` |
243
243
  | Application configuration | `wildo.saas.config.ts` and explicitly referenced config files |
244
244
  | Documentation plan — which chapters exist, each one's title, kind and audiences | `specifications/src/documentation-plan/index.ts` |
245
- | **Chapter bodies — the documentation authoring target** | `specifications/src/technical-documentation/index.ts` |
246
- | Wiring of both | `specifications/src/companion-exports.ts` (`documentationPlan`, `documentationChapters`) |
245
+ | **Chapter bodies — the documentation authoring target** | `specifications/src/technical-documentation/chapters/<chapterRef>.ts`, one file per chapter |
246
+ | Wiring | `specifications/src/companion-exports.ts` (`documentationPlan`). A chapter file needs no wiring: publication reads the directory |
247
247
  | Generated portal output | `technical-doc/src/generated/**` — written by `wildo docs publish`, read/verify only |
248
248
 
249
249
  ## When to use
@@ -291,9 +291,11 @@ A chapter is published only when TWO accepted files agree on it:
291
291
  1. the **documentation plan** (`specifications/src/documentation-plan/index.ts`)
292
292
  declares its `chapterRef` (`chapter-<slug>`), title, kind and reader
293
293
  audiences — the plan owns the chapter's identity;
294
- 2. the **chapter file** (`specifications/src/technical-documentation/index.ts`)
295
- carries its body under that same key, through
296
- `defineApplicationDocumentationChapters({ … })`.
294
+ 2. the **chapter file** (`specifications/src/technical-documentation/chapters/<chapterRef>.ts`,
295
+ named by the chapter) carries its body under that same key, through
296
+ `export const documentationChapter = defineApplicationDocumentationChapter('<chapterRef>', { … })`.
297
+ One file per chapter, and nothing imports it: several chapters are written at once,
298
+ so never edit another chapter's file, and never add the chapter to an index.
297
299
 
298
300
  Confirm the plan declares the chapter you are writing. If it does not, and your
299
301
  task does not own the plan, stop and return a documentation design packet —
@@ -304,9 +306,13 @@ never write generated MDX.
304
306
 
305
307
  Decide the chapter's `classification` explicitly: `PUBLIC` publishes, and
306
308
  `RESTRICTED` keeps it out of the public portal. There is no default — an
307
- unclassified chapter does not load. Mark unfinished work
308
- `editorialStatus: DRAFT`; it stays in the file and is not published. Read
309
- `references/framework-documentation-chapters-api.md` for the exact contract.
309
+ unclassified chapter is refused when the file is evaluated, by the
310
+ `check:specification-exports` verification of the task that writes it and by
311
+ publication. Mark unfinished work `editorialStatus: DRAFT`; it stays in the file
312
+ and is not published. A chapter file imports only `@wildo-ai/*` packages (it is
313
+ re-read when the file itself changes, so a local helper it imported would go
314
+ stale). Read `references/framework-documentation-chapters-api.md` for the exact
315
+ contract.
310
316
 
311
317
  ### Step 3: Build the source-fact matrix
312
318
 
@@ -399,9 +405,14 @@ message — for every word, and the API reference and the sign-in hand-off page
399
405
  `technical-doc/i18n/<locale>/code.json`: the `docs.search.*` ids, one
400
406
  `docs.search.readerAudience.<VALUE>` entry for every reader audience (the words
401
407
  of the audience filter), and the `docs.apiReference.*` and `docs.authExchange.*`
402
- ids. A counted word is a `|`-separated plural message with `{count}`. To publish the site in another locale, add it to
403
- `i18n.locales` in `docusaurus.config.ts`, copy `technical-doc/i18n/en/code.json`
404
- to `technical-doc/i18n/<locale>/code.json`, and translate each `message`. Do not
408
+ ids. A counted word is a `|`-separated plural message with `{count}`. The site's
409
+ other languages are written by `wildo generate translate`: it translates
410
+ `technical-doc/i18n/en/code.json` into `technical-doc/i18n/<locale>/code.json`
411
+ for each language the application serves (`--units documentation_site` for the
412
+ site alone), whole or not at all, and `docusaurus.config.ts` lists a locale
413
+ exactly when that file exists (`src/documentation-site-locales.ts`). So add a
414
+ word to the English file and run the translation; never add a locale to
415
+ `i18n.locales` by hand, which would show its readers ids. Do not
405
416
  use `docusaurus write-translations` for these entries: the calls carry no
406
417
  default message, so it writes each id as its own message, drops the authored
407
418
  descriptions, and with `--override` replaces the English words with ids. An
@@ -431,8 +442,8 @@ source-backed in `references/framework-documentation-chapters-api.md`.
431
442
  - [ ] V2: every material claim has an accepted application source
432
443
  - [ ] V3: common framework, application-specific, API and internal content are
433
444
  routed to their correct owners
434
- - [ ] V4: the plan declares every chapter key, and the body lives only in
435
- `specifications/src/technical-documentation/index.ts`
445
+ - [ ] V4: the plan declares every chapter key, and each body lives only in its own
446
+ `specifications/src/technical-documentation/chapters/<chapterRef>.ts`
436
447
  - [ ] V5: the category has one landing and focused task/reference/support pages
437
448
  - [ ] V6: consumer prose contains no Wildo/app-creator/internal vocabulary
438
449
  - [ ] V7: variable roles/labels/capabilities are source-derived, not copied
@@ -444,24 +455,24 @@ source-backed in `references/framework-documentation-chapters-api.md`.
444
455
  | Invariant | Command |
445
456
  |---|---|
446
457
  | No framework/internal vocabulary in consumer prose | see the commands below the table |
447
- | No generic related labels | `rg -n "Related documentation" specifications/src/technical-documentation/index.ts` |
458
+ | No generic related labels | `rg -n "Related documentation" specifications/src/technical-documentation/` |
448
459
  | No endpoint inventory disguised as a guide | see the commands below the table |
449
- | No hand-typed API-reference URL in a body | `rg -n "\]\(/api" specifications/src/technical-documentation/index.ts` prints nothing |
460
+ | No hand-typed API-reference URL in a body | `rg -n "\]\(/api" specifications/src/technical-documentation/` prints nothing |
450
461
  | Every chapter key is planned | run the command below the table; it prints nothing |
451
462
  | No hand-authored generated output | `git diff --name-only -- technical-doc/src/generated` changes only after `wildo docs publish` |
452
463
  | Every chapter materialized | `ls technical-doc/src/generated/consumer-documentation/docusaurus/docs/guides/` |
453
464
 
454
465
  ```bash
455
466
  # No framework/internal vocabulary in consumer prose
456
- rg -n "Wildo|framework-capabilit|projectionRef|app-creator" specifications/src/technical-documentation/index.ts
467
+ rg -n "Wildo|framework-capabilit|projectionRef|app-creator" specifications/src/technical-documentation/
457
468
 
458
469
  # No endpoint inventory disguised as a guide
459
- rg -n "^(GET|POST|PUT|PATCH|DELETE) /" specifications/src/technical-documentation/index.ts
470
+ rg -n "^(GET|POST|PUT|PATCH|DELETE) /" specifications/src/technical-documentation/
460
471
  ```
461
472
 
462
473
  ```bash
463
474
  # Every chapter key is planned
464
- comm -23 <(rg -o -N "chapter-[a-z0-9-]+" specifications/src/technical-documentation/index.ts | sort -u) <(rg -o -N "chapter-[a-z0-9-]+" specifications/src/documentation-plan/index.ts | sort -u)
475
+ comm -23 <(rg -o -N --no-filename "chapter-[a-z0-9-]+" specifications/src/technical-documentation/ | sort -u) <(rg -o -N "chapter-[a-z0-9-]+" specifications/src/documentation-plan/index.ts | sort -u)
465
476
  ```
466
477
 
467
478
  ## Common rationalizations
@@ -470,7 +481,7 @@ comm -23 <(rg -o -N "chapter-[a-z0-9-]+" specifications/src/technical-documentat
470
481
  |---|---|
471
482
  | “The framework supports it, so this application has it.” | Support is not configuration or availability. V2/V7 require application evidence. |
472
483
  | “I know where docs usually live.” | There is exactly one authoring target, keyed by the plan. V4 prevents a parallel convention. |
473
- | “I'll classify it later; public is the obvious default.” | There is no default: an unclassified chapter does not load. Decide PUBLIC or RESTRICTED from the sources. |
484
+ | “I'll classify it later; public is the obvious default.” | There is no default: an unclassified chapter is refused when its file is evaluated. Decide PUBLIC or RESTRICTED from the sources. |
474
485
  | “A business use case can be assembled from generic feature names.” | It needs accepted domain semantics and a real outcome. V1/V2 catch filler. |
475
486
  | “Copying the API operations will make the guide concrete.” | Decisions and recovery make a guide concrete. V3 keeps API reference separate. |
476
487
  | “The sample app uses these roles.” | The target application's labels and roles are authoritative. V7 catches copying. |
@@ -1,8 +1,8 @@
1
1
  # Documentation chapter file contract
2
2
 
3
- The exact contract of `specifications/src/technical-documentation/index.ts` — the
4
- one file in which this application authors the prose of its documentation
5
- portal.
3
+ The exact contract of a chapter file,
4
+ `specifications/src/technical-documentation/chapters/<chapterRef>.ts` — one file per
5
+ chapter, in which this application authors the prose of its documentation portal.
6
6
 
7
7
  Read this when you:
8
8
 
@@ -30,10 +30,16 @@ publication joins the two by `chapterRef`.
30
30
  *
31
31
  * ## Where it lives, and what makes it accepted
32
32
  *
33
- * One file: `specifications/src/technical-documentation/index.ts`, exporting a
34
- * `defineApplicationDocumentationChapters({ … })` value wired into the specifications package's
35
- * companion exports as `documentationChapters`. The file is keyed by `chapterRef`, which is also what
36
- * a build task's landing probe looks for in it.
33
+ * One file PER CHAPTER: `specifications/src/technical-documentation/chapters/<chapterRef>.ts`, exporting
34
+ * `documentationChapter = defineApplicationDocumentationChapter('<chapterRef>', { … })`. The file is named
35
+ * by the chapter's `chapterRef` and declares that same ref, which is what a build task's landing probe looks
36
+ * for in it. Publication reads every file in that directory; nothing imports or registers them, so writing
37
+ * one chapter never edits a file another chapter is written in, and a build writes its chapters at once
38
+ * (#3204: with one shared file, 23 chapter tasks queued behind each other for about 48 minutes).
39
+ *
40
+ * A set may still be written inline, as a `defineApplicationDocumentationChapters({ … })` value wired into
41
+ * the companion exports as `documentationChapters`. Publication merges the two and refuses a chapter
42
+ * declared in both, or in two files.
37
43
  *
38
44
  * Accepted means COMMITTED — there is no acceptance state, ledger or digest beside git. Publication
39
45
  * (`wildo docs publish`) renders the WORKING TREE, exactly as every other specification-derived page
@@ -62,12 +68,11 @@ publication joins the two by `chapterRef`.
62
68
  *
63
69
  * @example
64
70
  * ```ts
65
- * export const applicationDocumentationChapters = defineApplicationDocumentationChapters({
66
- * 'chapter-close-a-deal': {
67
- * classification: TechnicalDocumentationSourceClassification.PUBLIC,
68
- * body: 'Closing a deal moves it to won and notifies its owner.\n\n## Before you start\n\n…',
69
- * apiReferences: [{ label: 'Change a deal status', resource: 'deals', operation: 'change_status' }],
70
- * },
71
+ * // specifications/src/technical-documentation/chapters/chapter-close-a-deal.ts
72
+ * export const documentationChapter = defineApplicationDocumentationChapter('chapter-close-a-deal', {
73
+ * classification: TechnicalDocumentationSourceClassification.PUBLIC,
74
+ * body: 'Closing a deal moves it to won and notifies its owner.\n\n## Before you start\n\n…',
75
+ * apiReferences: [{ label: 'Change a deal status', resource: 'deals', operation: 'change_status' }],
71
76
  * });
72
77
  * ```
73
78
  */
@@ -132,6 +137,7 @@ export const ApplicationDocumentationChapterSourceSchema = z.strictObject({
132
137
  applicabilityRequirements: z.array(TechnicalDocumentationApplicabilityRequirementV1Schema).default([]),
133
138
  });
134
139
  export type ApplicationDocumentationChapterSource = z.infer<typeof ApplicationDocumentationChapterSourceSchema>;
140
+ export type ApplicationDocumentationChapterSourceInput = z.input<typeof ApplicationDocumentationChapterSourceSchema>;
135
141
 
136
142
  /** Every authored chapter, keyed by the plan's `chapterRef`. */
137
143
  export const ApplicationDocumentationChapterSetSchema = z
@@ -164,4 +170,33 @@ export type ApplicationDocumentationChapterSetInput = z.input<typeof Application
164
170
  export function defineApplicationDocumentationChapters(chapters: ApplicationDocumentationChapterSetInput): ApplicationDocumentationChapterSet {
165
171
  return ApplicationDocumentationChapterSetSchema.parse(chapters);
166
172
  }
173
+
174
+ /**
175
+ * Where a chapter's own file lives, relative to the specifications package's `src/`: one file per chapter, named by
176
+ * its `chapterRef` (#3204).
177
+ */
178
+ export const APPLICATION_DOCUMENTATION_CHAPTER_FILES_DIRECTORY = 'technical-documentation/chapters';
179
+ /** The export a chapter file declares its chapter under. */
180
+ export const APPLICATION_DOCUMENTATION_CHAPTER_FILE_EXPORT = 'documentationChapter';
181
+
182
+ /** One chapter, as its own file declares it: the ref it is the body of, and the body. */
183
+ export interface ApplicationDocumentationChapterDeclaration {
184
+ readonly chapterRef: string;
185
+ readonly chapter: ApplicationDocumentationChapterSource;
186
+ }
187
+
188
+ /**
189
+ * Declares ONE chapter, in its own file `technical-documentation/chapters/<chapterRef>.ts` (#3204): the ref's shape, the
190
+ * body rules, and a chapter relating to itself are checked when the file is evaluated. Nothing imports a chapter file, so
191
+ * the specifications package's own load never evaluates it: a build task writing one evaluates it in its
192
+ * `check:specification-exports` verification, and publication evaluates every file before it merges them. Whether a
193
+ * related chapter EXISTS is a question about the whole set, answered by that merge, since sibling chapters are written at
194
+ * the same time. A chapter file imports only `@wildo-ai/*` packages.
195
+ */
196
+ export function defineApplicationDocumentationChapter(chapterRef: string, chapter: ApplicationDocumentationChapterSourceInput): ApplicationDocumentationChapterDeclaration {
197
+ const ref = ApplicationDocumentationChapterRefSchema.parse(chapterRef);
198
+ const parsed = ApplicationDocumentationChapterSourceSchema.parse(chapter);
199
+ if (parsed.relatedChapterRefs.includes(ref)) throw new Error(`${ref} cannot relate to itself`);
200
+ return { chapterRef: ref, chapter: parsed };
201
+ }
167
202
  ```
@@ -37,8 +37,8 @@ Only write the strongest statement supported by the accepted authoring inputs.
37
37
 
38
38
  ## Design packet when the plan does not declare the chapter
39
39
 
40
- The only accepted place to persist a chapter is
41
- `specifications/src/technical-documentation/index.ts`, under a `chapterRef` the
40
+ The only accepted place to persist a chapter is its own file,
41
+ `specifications/src/technical-documentation/chapters/<chapterRef>.ts`, under a `chapterRef` the
42
42
  documentation plan declares. When the plan does not declare the chapter you
43
43
  would write, and your task does not own the plan, return:
44
44
 
@@ -31,9 +31,10 @@ from is committed as `backend-api/migrations/schema-plan.lock.json`. When the
31
31
  two disagree, that difference is **drift**, and a migration is what closes it.
32
32
 
33
33
  Only resources stored in PostgreSQL are in the plan. A resource read through
34
- from another system (`persistenceAdapter: HTTP_API`), an introspected one, or one
35
- pinned to MongoDB has no table and owes no migration. Moving an existing resource
36
- to one of those adapters drops its table, which is a destructive change.
34
+ from another system (`persistenceAdapter: HTTP_API`) or an introspected one has no
35
+ table and owes no migration, and neither does any resource of a MongoDB
36
+ application. Moving an existing resource to a read-through or introspected adapter
37
+ drops its table, which is a destructive change.
37
38
 
38
39
  Nothing warns you until the backend refuses to start:
39
40
 
@@ -48,21 +49,18 @@ command that writes it. This skill is how you avoid ever reading it.
48
49
 
49
50
  ## Am I even on PostgreSQL?
50
51
 
51
- Check before anything else. MongoDB must be declared, and a resource can still be
52
- kept on PostgreSQL inside a MongoDB application:
52
+ Check before anything else. MongoDB must be declared:
53
53
 
54
54
  ```bash
55
55
  rg -n "applicationDatabase" infrastructure/*/wildo.infra.*.config.ts
56
- rg -n "persistenceAdapter: PersistenceAdapter.POSTGRESQL" shared-lib backend-api
57
56
  ```
58
57
 
59
58
  `applicationDatabase: { engine: DatabaseEngine.POSTGRESQL }` means every workflow
60
59
  below is live for you, and so does an ABSENT `applicationDatabase`: an environment
61
60
  that declares nothing persists to PostgreSQL. One such environment is enough. You
62
- opt out only when every environment declares `{ engine: DatabaseEngine.MONGODB }`
63
- AND no resource declares `persistenceAdapter: PersistenceAdapter.POSTGRESQL`; a
64
- resource kept on PostgreSQL owes its table, and `wildo db generate` plans that table
65
- alone (`references/postgresql-vs-mongodb-obligations.md`).
61
+ opt out only when every environment declares `{ engine: DatabaseEngine.MONGODB }`.
62
+ An application uses exactly one transactional store, so no resource is kept on
63
+ PostgreSQL inside a MongoDB application (`references/postgresql-vs-mongodb-obligations.md`).
66
64
 
67
65
  Your application already carries its INITIAL migration: `wildo init` writes it beside the lockfile
68
66
  for a PostgreSQL application, because the platform seeds your database during the first registration
@@ -87,7 +85,7 @@ author a baseline — you generate the migrations that follow your own resource
87
85
 
88
86
  ## When NOT to Use
89
87
 
90
- - Every environment is on MongoDB and no resource is kept on PostgreSQL — nothing here applies
88
+ - Every environment is on MongoDB — nothing here applies
91
89
  - You are designing the schema itself → `resource-schema-authoring`
92
90
  - You are adding a whole resource → `resource-add-resource` (come back here at its last step)
93
91
  - You are choosing the store or the backing services → `infra-environment-config`
@@ -197,6 +195,7 @@ narrow, and both limits are worth knowing:
197
195
  - `references/framework-application-database-api.md` — source-backed `applicationDatabase` contract
198
196
  - `references/migration-refusals.md` — every refusal, what it means, and what to do
199
197
  - `references/postgresql-vs-mongodb-obligations.md` — what differs once you are on PostgreSQL
198
+ - `references/postgresql-supported-surfaces.md` — which framework features run on PostgreSQL, and the few observable differences
200
199
 
201
200
  ## Verification
202
201
 
@@ -0,0 +1,64 @@
1
+ # What works on PostgreSQL
2
+
3
+ Read this when you are choosing `applicationDatabase`, or when you need to know
4
+ whether a framework feature behaves the same once your application persists to
5
+ PostgreSQL. `postgresql-vs-mongodb-obligations.md` covers what PostgreSQL asks of
6
+ you (migrations); this file covers what you get.
7
+
8
+ The short answer: **every framework surface runs on PostgreSQL.** No engine
9
+ resource is pinned to MongoDB, so a PostgreSQL application keeps all of its
10
+ framework data (users, organizations, files, audit rows, deliveries, billing
11
+ records, agent conversations) in its own PostgreSQL database. The differences
12
+ below are the whole list, and each is a property of the store, not a missing
13
+ feature.
14
+
15
+ ## Supported surfaces
16
+
17
+ | Surface | On PostgreSQL | What to know |
18
+ |---|---|---|
19
+ | Resources: create, read, update, delete, list, search, count, bulk writes | Supported | Same operations, same authorization and tenancy scoping as on MongoDB. Scope-anchored list, search and count resolve through the membership junction on both stores. |
20
+ | Field aggregation (sum, max, … used by charts and computed totals) | Supported | A dotted path into a nested object, or a field only one variant carries, is aggregated too. A present value that is not a number FAILS the aggregation instead of counting as 0. |
21
+ | Uniqueness and document numbers | Supported | A unique index is created by your migration; concurrent document-number allocation is serialized by the database. |
22
+ | Files | Supported | File metadata is a row in your database and commits in the same transaction as the row that links it. |
23
+ | Retrieval-augmented generation (`.ragSource()` fields) | Supported, through pgvector | The database must expose the `vector` extension. Startup EXECUTES a vector expression on the live connection and refuses to start without it. The chunk tables are created and kept current by the framework itself, not by your migrations. See the `resource-rag-source-fields` skill. |
24
+ | Audit trail (the database audit rows) | Supported | Audit rows are a resource in your database. One row per event id is enforced by the store, and organization routing is the same as on MongoDB. An optional tamper-evident audit provider (immudb) is a separate backing service and does not depend on which database you chose. |
25
+ | Durable delivery records (inbound deliveries, the billing effect outbox, webhook and SIEM delivery rows and their dead-letter drains) | Supported | The message broker (RabbitMQ) carries the work; the record the framework reads back to deduplicate, retry and drain is a resource in your database. |
26
+ | Transactions | Supported | See below. |
27
+
28
+ ## The differences you can observe
29
+
30
+ **Filter operators.** The portable operators are `$eq`, `$ne`, `$gt`, `$gte`,
31
+ `$lt`, `$lte`, `$in`, `$nin`, `$and`, `$or`, `$not`, `$regex`, `$startsWith`,
32
+ `$endsWith`, `$contains` and `$exists`. MongoDB-specific operators (`$where`,
33
+ `$expr`, `$jsonSchema`, `$elemMatch`, `$all`, `$size`, `$type`, `$mod`, `$text`
34
+ and the geospatial ones) are REFUSED on PostgreSQL with an error; nothing
35
+ silently ignores them. A filter written with the portable set runs on both.
36
+
37
+ **A cleared field reads back as absent.** Clearing a `.nullish()` field returns
38
+ it ABSENT on both stores. What is not portable is telling "explicitly set to
39
+ null" apart from "never set": PostgreSQL stores both as NULL. If your logic
40
+ needs that distinction, give it a field of its own.
41
+
42
+ **Transaction options.** `isolationLevel` and `maxWaitMs` (the lock wait) apply
43
+ on PostgreSQL only. `timeoutMs` bounds each statement on PostgreSQL and the
44
+ commit on MongoDB. A transaction that PostgreSQL aborts for a serialization
45
+ failure or a deadlock is run again from the start, up to three runs in total,
46
+ before the error reaches you.
47
+
48
+ **Nesting.** A nested `executeTransaction` either refuses
49
+ (`TransactionNestedBehavior.ERROR`, the default) or joins the active transaction
50
+ (`TransactionNestedBehavior.REUSE`). There is no nested rollback (savepoint) on
51
+ either store: a failure inside a joined call aborts the whole transaction.
52
+
53
+ ## One store per application
54
+
55
+ An application uses exactly one transactional store. Every resource it declares
56
+ lives there; startup refuses a resource pinned to the other store. Resources read
57
+ through from another system (`HTTP_API`) or computed from the application
58
+ (`INTROSPECTION`) have no table and behave the same whichever store you chose.
59
+
60
+ ## What has not been measured
61
+
62
+ Throughput and latency at production volume have not been benchmarked against a
63
+ representative workload on PostgreSQL. Everything above is verified for
64
+ correctness, not for performance. Size your database from your own load tests.