@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
@@ -0,0 +1,65 @@
1
+ # presets.3d.frame-style-resolution
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/presets-components-3d`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/presets-components-3d`
10
+
11
+ ```typescript
12
+ /**
13
+ * The frame style for a point on the theme personality axes, in one layout's catalog (#2477).
14
+ *
15
+ * Starts from the catalog's fallback (so the layout's own light angle and background stay), then takes, per region,
16
+ * the corner radius from the theme the point's shape was copied from, the shadow from its elevation's, the frost,
17
+ * gradient and background glow from its material's, and the rim from its edge weight's. The default point gives the
18
+ * fallback exactly.
19
+ *
20
+ * @example
21
+ * import { cozyThemePersonality } from '@wildo-ai/presets-components/themes';
22
+ * deriveFrame3DThemeStyle(INHERIT_FRAME_STYLES, cozyThemePersonality); // cozy's radius, shadow and rim
23
+ */
24
+ export function deriveFrame3DThemeStyle(catalog: Frame3DStyleCatalog, personality: ThemePersonality): Frame3DThemeStyle {
25
+ const base = catalog.fallback;
26
+ const shape = catalog.byThemeId[FRAME_SOURCE_BY_SHAPE[personality.shape]];
27
+ const elevation = catalog.byThemeId[FRAME_SOURCE_BY_ELEVATION[personality.elevation]];
28
+ const material = catalog.byThemeId[FRAME_SOURCE_BY_MATERIAL[personality.material]];
29
+ const edge = catalog.byThemeId[FRAME_SOURCE_BY_EDGE_WEIGHT[personality.edgeWeight]];
30
+ const regions = { ...base.regions };
31
+ for (const region of Object.values(ShellRegion)) {
32
+ regions[region] = {
33
+ ...base.regions[region],
34
+ radiusScale: shape.regions[region].radiusScale,
35
+ shadow: elevation.regions[region].shadow,
36
+ frost: material.regions[region].frost,
37
+ gradient: material.regions[region].gradient,
38
+ rim: edge.regions[region].rim,
39
+ };
40
+ }
41
+ return { ...base, background: { ...base.background, glow: material.background.glow }, regions };
42
+ }
43
+
44
+ /**
45
+ * The frame style for the active theme, then the application's `all` override, then its override for that theme id:
46
+ *
47
+ * 1. a built-in theme id takes the layout's own entry for it;
48
+ * 2. any other theme that records the point it was composed from (`personality`, which `composeTheme` sets) takes a
49
+ * style derived from that point ({@link deriveFrame3DThemeStyle}), so a theme composed from the brand's words gets
50
+ * a frame that matches its recipes;
51
+ * 3. anything else takes the layout's fallback.
52
+ */
53
+ export function resolveFrame3DThemeStyle(
54
+ catalog: Frame3DStyleCatalog,
55
+ theme: Pick<ComponentStyleTheme, 'id' | 'personality'>,
56
+ overrides?: Frame3DStyleOverrides,
57
+ ): Frame3DThemeStyle {
58
+ const base = isBuiltInThemeId(theme.id)
59
+ ? catalog.byThemeId[theme.id]
60
+ : theme.personality === undefined
61
+ ? catalog.fallback
62
+ : deriveFrame3DThemeStyle(catalog, theme.personality);
63
+ return mergeTheme(mergeTheme(base, overrides?.all), overrides?.byThemeId?.[theme.id]);
64
+ }
65
+ ```
@@ -137,7 +137,7 @@ ${ownRules}`;
137
137
 
138
138
  /** Every selector in `css` (outside `@keyframes`) whose declarations include an animation or a transition. */
139
139
  export function layout2DMovingSelectors(css: string): string[] {
140
- let rest = css.replace(/\/\*[\s\S]*?\*\//g, '');
140
+ let rest = blankStylesheetComments(css);
141
141
  // Drop every @keyframes block, braces balanced.
142
142
  for (let start = rest.indexOf('@keyframes'); start !== -1; start = rest.indexOf('@keyframes')) {
143
143
  let depth = 0;
@@ -0,0 +1,32 @@
1
+ # presets.models.field-form-control-variant
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/presets-components-models`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/presets-components-models`
10
+
11
+ ```typescript
12
+ /**
13
+ * The {@link FormControlVariant} members that draw a FIELD: the box a person types a value into, or picks one
14
+ * through (an input, a textarea, a select, a combobox, a date or time picker's trigger, a code or markdown editor).
15
+ * `CHECKBOX` and `SWITCH` are controls of their own shape and are not field styles.
16
+ *
17
+ * An application chooses its field style once, on its theme (`ComponentStyleTheme.fieldVariant`), and every field
18
+ * control renders it. `Input` and `Textarea` also take a `variant` prop for the one field that differs.
19
+ *
20
+ * Derived from the enum, so it is the one list of field styles; the theme contract checks the border widths of
21
+ * exactly these recipes.
22
+ *
23
+ * @example
24
+ * import { FormControlVariant } from '@wildo-ai/presets-components-models';
25
+ * import { composeTheme } from '@wildo-ai/presets-components/themes';
26
+ * theme: composeTheme({}, { fieldVariant: FormControlVariant.FILLED }),
27
+ */
28
+ export const FIELD_FORM_CONTROL_VARIANTS = [FormControlVariant.DEFAULT, FormControlVariant.FILLED, FormControlVariant.UNDERLINED] as const;
29
+
30
+ /** One field style: `DEFAULT` (outlined), `FILLED` or `UNDERLINED`. See {@link FIELD_FORM_CONTROL_VARIANTS}. */
31
+ export type FieldFormControlVariant = (typeof FIELD_FORM_CONTROL_VARIANTS)[number];
32
+ ```
@@ -38,6 +38,13 @@ export enum LabellingTypes {
38
38
  ROLES = "roles",
39
39
  SYSTEM_ENUMS = "system_enums",
40
40
  SIDEBAR_SECTIONS = "sidebar_sections",
41
+ /**
42
+ * The command menu's APPLICATION-defined categories (#3122): `command_categories.<ref>.label`, the heading of the
43
+ * group a command or a record search sits under. The engine's own categories (navigation, actions, help, other,
44
+ * settings) keep their words on the command menu component; an application's are its own ref space, like its
45
+ * sidebar sections, so they are planned from its launcher contributions.
46
+ */
47
+ COMMAND_CATEGORIES = "command_categories",
41
48
  SETTINGS_HUB = "settings_hub",
42
49
  COMPOSITE_VIEWS = "composite_views",
43
50
  VIEWS = "views",
@@ -50,6 +57,35 @@ export enum LabellingTypes {
50
57
  BILLING_CREDIT_POOLS = "billing_credit_pools",
51
58
  BACKEND_AUTH_MESSAGES = "backend_auth_messages",
52
59
  BACKEND_SMS = "backend_sms",
60
+ /**
61
+ * The words of documents the BACKEND writes outside a PDF template (#2907): today the approval page of an approved
62
+ * deliverable's manifested copy (`backend_documents.approval_manifestation.<word>`). Planned from the engine's
63
+ * declaration of each document's words (`APPROVAL_SEAL_MANIFESTATION_WORDS`), backend-only, read in ONE language.
64
+ */
65
+ BACKEND_DOCUMENTS = "backend_documents",
66
+ }
67
+
68
+ /**
69
+ * The command menu's OWN categories (#3122): the groups the engine heads with the command menu component's words
70
+ * (`components.APPLICATION_LEVEL_COMMAND_MENU.<category>`). Any other `category` a command or a record search names
71
+ * is the application's, and is headed by `command_categories.<category>.label`, which the labelling pipeline plans
72
+ * from the application's launcher contributions.
73
+ */
74
+ export enum CommandMenuEngineCategory {
75
+ NAVIGATION = 'navigation',
76
+ ACTIONS = 'actions',
77
+ HELP = 'help',
78
+ OTHER = 'other',
79
+ SETTINGS = 'settings',
80
+ /** The engine's billing command (`BILLING_COMMAND_MENU_ITEM`), which every application with billing lists. */
81
+ BILLING = 'billing',
82
+ }
83
+
84
+ const COMMAND_MENU_ENGINE_CATEGORIES: ReadonlySet<string> = new Set(Object.values(CommandMenuEngineCategory));
85
+
86
+ /** Whether `category` is one of the engine's own command-menu categories ({@link CommandMenuEngineCategory}). */
87
+ export function isCommandMenuEngineCategory(category: string): boolean {
88
+ return COMMAND_MENU_ENGINE_CATEGORIES.has(category);
53
89
  }
54
90
 
55
91
  /**
@@ -64,6 +100,8 @@ export const EAGER_I18N_SECTIONS: LabellingTypes[] = [
64
100
  LabellingTypes.ERRORS_REFUSALS,
65
101
  LabellingTypes.ERRORS_GUIDANCE,
66
102
  LabellingTypes.SIDEBAR_SECTIONS,
103
+ // Eager like the sidebar's sections: the command menu is global, opens from a shortcut, and heads each group with one.
104
+ LabellingTypes.COMMAND_CATEGORIES,
67
105
  LabellingTypes.SETTINGS_HUB,
68
106
  LabellingTypes.LIFECYCLE,
69
107
  // Eager since #1851: a feature's and a limit's words (a `SectionedVocabulary`) are read wherever a feature or limit
@@ -79,5 +117,6 @@ export const EAGER_I18N_SECTIONS: LabellingTypes[] = [
79
117
  export const BACKEND_ONLY_I18N_SECTIONS: LabellingTypes[] = [
80
118
  LabellingTypes.BACKEND_AUTH_MESSAGES,
81
119
  LabellingTypes.BACKEND_SMS,
120
+ LabellingTypes.BACKEND_DOCUMENTS,
82
121
  ];
83
122
  ```
@@ -329,8 +329,9 @@ const INSET_DEFAULT_POLICY: SurfacePolicy = {
329
329
  * TILE — one field's value on a fact tile (`SurfaceVariant.TILE`). Derived from INSET, the recessed
330
330
  * well it most resembles, with the differences a single label/value pair needs: the chrome owns the
331
331
  * inner spacing (`gap: 'item'`, no policy padding), text wraps rather than truncates (a tile is
332
- * narrow and a clipped value is a lost fact), figures align tabular, and nothing inside it is a
333
- * section, so section wrapping is flat.
332
+ * narrow and a clipped value is a lost fact), and nothing inside it is a section, so section wrapping is flat.
333
+ * Figures keep the face's own spacing: a tile holds ONE value, and tabular figures, which align a column, only
334
+ * made a lone date read as monospaced (#3066). A table sets them at its root, where values do stand in columns.
334
335
  */
335
336
  const TILE_DEFAULT_POLICY: SurfacePolicy = {
336
337
  ...INSET_DEFAULT_POLICY,
@@ -342,7 +343,6 @@ const TILE_DEFAULT_POLICY: SurfacePolicy = {
342
343
  content: {
343
344
  ...INSET_DEFAULT_POLICY.content,
344
345
  wrapStrategy: 'wrap',
345
- numericAlignment: 'tabular',
346
346
  },
347
347
  autoRender: {
348
348
  ...INSET_DEFAULT_POLICY.autoRender,
@@ -56,10 +56,11 @@ export enum SurfaceVariant {
56
56
  * A FACT TILE — the small bounded surface one field's value sits on when a record's facts are laid
57
57
  * out as a grid (`DisplayChromeMode.TILE`, hosted by `<FieldTiles>`): its name above, the value below.
58
58
  *
59
- * Quieter than a CARD on purpose: a hairline edge and a faint inset tint, never a shadow, so a row
60
- * of tiles reads as one set of facts inside the section around it rather than as N competing cards.
61
- * It holds a label and a value and nothing else, so its policy owns no padding of its own (the
62
- * chrome sets the inner spacing), frames always, and aligns figures in tabular columns.
59
+ * Quieter than a CARD on purpose: in the default theme a hairline rule above the fact and no fill, never a
60
+ * shadow (#3066), so a row of tiles reads as one set of facts under the section around it rather than as N
61
+ * identical boxes. A theme may draw it framed or tinted instead. It holds a label and a value and nothing else,
62
+ * so its policy owns no padding of its own (the chrome sets the inner spacing), and its figures keep the face's
63
+ * own spacing: a tile holds ONE value, and tabular figures only matter where a column of them must line up.
63
64
  */
64
65
  TILE = 'tile',
65
66
  }
@@ -15,8 +15,9 @@
15
15
  * theme does differently. A field set to `undefined` is REMOVED rather than inherited: a top-level field, a recipe
16
16
  * field, or one key of `states` or `motion`. That is how a theme says it has no shadow, or no hover state, where the
17
17
  * default has one. (`states` and `motion` themselves merge, so to drop a state set that state's key, not `states`.)
18
+ * The point itself is not overridable: the theme records the point it was composed from (`personality`).
18
19
  */
19
- export interface ThemeCompositionOverrides extends Partial<Omit<ComponentStyleTheme, RecipeFamily>> {
20
+ export interface ThemeCompositionOverrides extends Partial<Omit<ComponentStyleTheme, RecipeFamily | 'personality'>> {
20
21
  readonly interactive?: Partial<Record<InteractiveVariant, Partial<UIBehaviorRecipe>>>;
21
22
  readonly surface?: Partial<Record<SurfaceVariant, Partial<UIBehaviorRecipe>>>;
22
23
  readonly formControl?: Partial<Record<FormControlVariant, Partial<UIBehaviorRecipe>>>;
@@ -17,8 +17,8 @@
17
17
  *
18
18
  * `kind` classifies the NFR onto a standard quality axis so downstream
19
19
  * surfaces can route it — most importantly, `COMPLIANCE` NFRs are
20
- * consumed alongside the vision family's compliance CONSTRAINTS by the
21
- * top-down compliance-posture playbook (U10). At scaffold depth an NFR is
20
+ * read beside the compliance posture (`compliance-posture` family) by
21
+ * the document facts and the build decomposer, which lands each one. At scaffold depth an NFR is
22
22
  * a `kind` + a prose `statement` ("p95 API latency under 200ms") + an
23
23
  * optional prose `metric` and `acceptanceCriteria` — the DEEP
24
24
  * quality-attribute taxonomy (per-axis obligation models, measurement
@@ -31,8 +31,8 @@
31
31
  * vocabulary (enum, per project rule — enums over literal unions),
32
32
  * covering the standard NFR / quality-attribute axes at scaffold depth.
33
33
  * `COMPLIANCE` is called out as its own member — not folded into
34
- * `SECURITY` — because it is the seam the compliance-posture playbook
35
- * (U10) selects on. Deliberately NOT exhaustive of a formal
34
+ * `SECURITY` — because compliance requirements are routed on their own:
35
+ * the build decomposer lands each one beside the researched regimes. Deliberately NOT exhaustive of a formal
36
36
  * quality-model taxonomy; `OTHER` catches axes the fixed buckets miss.
37
37
  */
38
38
  export enum NonFunctionalRequirementKind {
@@ -96,9 +96,8 @@ export type RequirementsExcludedMarketPain = z.infer<typeof RequirementsExcluded
96
96
  * `validateRequirementsSnapshot`, never a parse failure.
97
97
  * - **`nonFunctional`** — ref-addressable collection of qualities the
98
98
  * product must exhibit (`default([])`), classified by
99
- * `NonFunctionalRequirementKind` (incl. `COMPLIANCE`, the seam the
100
- * compliance-posture playbook (U10) reads alongside vision compliance
101
- * constraints).
99
+ * `NonFunctionalRequirementKind` (incl. `COMPLIANCE`, read beside the
100
+ * compliance posture by the document facts and the build decomposer).
102
101
  * - **`excludedStatedFacts`** — facts the creator stated that no
103
102
  * requirement carries, each with its reason (`default([])`). Not
104
103
  * ref-addressable: an exclusion is a recorded decision, not something
@@ -52,6 +52,16 @@ export const ApprovalSealsAdminEndpointPath = {
52
52
  * application does not hold the export key's record yet.
53
53
  */
54
54
  SIGNING_LOG_EXPORT: '/signing-log/export',
55
+ /**
56
+ * POST — rebuild the manifested copy of ONE SEALED seal's approved PDF (#2907): `{ "sealId": "…", "justification": "…",
57
+ * "operator"?: "…" }`. Only when the seal names no copy, or names one whose file is gone, unlinked or no longer
58
+ * servable; the copy is made exactly as the relay makes it, from the attested original and the seal, and the seal names
59
+ * it. The justification is required and recorded (`approval_seal_manifested_copy_rebuilt`) before the seal names the
60
+ * copy; when it cannot be recorded the copy is discarded and the rebuild refused. 404 for an unknown seal (a seal whose approver was erased is not found here: the copy prints their
61
+ * name, and nothing may print it again); 409 for one not SEALED, with no file deliverable, whose copy is present, or of
62
+ * which no copy can be made (`reason` names why, `detail` says more).
63
+ */
64
+ MANIFESTED_COPY_REBUILD: '/manifested-copy/rebuild',
55
65
  } as const;
56
66
 
57
67
  /**
@@ -70,10 +80,16 @@ export enum SigningLogSealStanding {
70
80
  */
71
81
  RESIGNED = 'resigned',
72
82
  /**
73
- * No stored seal has this decision: a signature the custodian made that the application does not hold. Until approval
74
- * evidence that is deliberately destroyed leaves a record of it (#2924), a seal purged with its record shows here too.
83
+ * No stored seal has this decision, and no record says it was destroyed: a signature the custodian made that the
84
+ * application does not hold.
75
85
  */
76
86
  UNACCOUNTED = 'unaccounted',
87
+ /**
88
+ * The seal is not stored because it was destroyed with the record it attested (#2924): an `APPROVAL_EVIDENCE_DESTROYED`
89
+ * row names this signature's `jti` and decision. Accounted for: evidence follows its record, and the record's removal
90
+ * is what destroyed it. A destroyed seal that had been signed must have been signed with exactly these claims.
91
+ */
92
+ DESTROYED = 'destroyed',
77
93
  }
78
94
 
79
95
  /** One seal signature of an export that the application does not store. Names no person. */
@@ -93,6 +109,8 @@ export interface SigningLogReconciliation {
93
109
  readonly resigned: readonly SigningLogUnaccountedSeal[];
94
110
  /** Signatures of a decision no stored seal has (UNACCOUNTED). */
95
111
  readonly unaccounted: readonly SigningLogUnaccountedSeal[];
112
+ /** Signatures of seals destroyed with their record (DESTROYED, #2924): accounted for, listed so the operator sees them. */
113
+ readonly destroyed: readonly SigningLogUnaccountedSeal[];
96
114
  }
97
115
 
98
116
  /** `POST /signing-log/export`'s answer: what the operator keeps (`jws`, `key`), where its next pull starts, and the reconciliation. */
@@ -128,4 +146,13 @@ export interface ApprovalSealRetryResult {
128
146
  /** True when the relay's immediate attempt signed it; false when the batch will. */
129
147
  readonly sealed: boolean;
130
148
  }
149
+
150
+ /** `POST /manifested-copy/rebuild`'s answer. */
151
+ export interface ApprovalSealManifestedCopyRebuildResult {
152
+ readonly sealId: string;
153
+ /** The new copy's file. */
154
+ readonly fileId: string;
155
+ /** The copy the seal named before, when it named one. */
156
+ readonly replacedFileId?: string;
157
+ }
131
158
  ```
@@ -43,7 +43,9 @@
43
43
  * A flow run is refused BEFORE each of its model calls once its organization's allowance is spent or unverifiable: the
44
44
  * step fails with the budget's error, the run ends FAILED on that step, nothing of the step is written, and a
45
45
  * `MODEL_SPEND_LIMIT_REFUSED` row names the door `flow_step`. A flow's spend counts against the organization's
46
- * allowance, never a person's ceiling.
46
+ * allowance, never a person's ceiling. A call made in no turn and no flow but attributed to an organization is refused
47
+ * the same way, before it runs, through the door `organization_work` (#2957); its row names that organization and no
48
+ * person. A call attributed to no organization is neither charged nor refused.
47
49
  *
48
50
  * A call whose provider reported no token usage is charged an ESTIMATE (the characters it sent and received, at the
49
51
  * provider-documented four characters per token, plus a fixed figure per image), never nothing. RAG embeddings,
@@ -77,14 +79,18 @@
77
79
  * which one (`MODEL_BUDGET_EXHAUSTED`, `PERSON_MODEL_CEILING_EXHAUSTED`, or the recoverable
78
80
  * `MODEL_BUDGET_UNVERIFIABLE`). Granting neither leaves in-app chat uncapped, as it was.
79
81
  *
80
- * ## Every refusal is recorded
82
+ * ## Every refusal leaves a record
81
83
  *
82
84
  * A turn either limit refuses, at any door, writes one `MODEL_SPEND_LIMIT_REFUSED` audit row: the door
83
85
  * (`initiationKind`), which limit (`ceiling`: `organization_budget` or `person_ceiling`), why (`reason`:
84
86
  * `allowance_exhausted`, `allowance_unverifiable` or `consumption_unverifiable`), and the allowance and consumption
85
87
  * when they were known. A call a unit ceiling refuses writes the same row with the unit's ceiling
86
88
  * (`embedding_token_ceiling`, `extraction_page_ceiling` or `screening_text_record_ceiling`), its counts in
87
- * `allowanceUnits` / `consumedUnits`, and the door only when the call was made in one. The actor is the person or machine whose turn it was, and the row's organization is the one
89
+ * `allowanceUnits` / `consumedUnits`, and the door only when the call was made in one. A unit call made in a turn or a
90
+ * flow writes one row per refusal; a call made in NEITHER (the embedding drain, an ingestion sweep, which re-ask a spent
91
+ * ceiling on every run) writes one row per organization, unit, reason and period in each process, and later refusals
92
+ * of the same combination are logged at DEBUG. A restart or a second process records it again, so it errs toward
93
+ * recording. The actor is the person or machine whose turn it was, and the row's organization is the one
88
94
  * whose allowance refused it. The gate writes it, not the door, so no door can refuse without a record. An autonomous
89
95
  * turn refused for spend writes it as well as its own `AUTONOMOUS_AGENT_TURN_REFUSED` row (reason `over_budget`).
90
96
  * An admitted turn writes none.
@@ -119,7 +125,8 @@
119
125
  * we cannot prove the tenant is under it — the coherent choice for a spend boundary. This is safe
120
126
  * to fail closed precisely because the counter lives in the application's primary datastore: if
121
127
  * that is unreachable the application is down anyway, so this can never be the *sole* cause of an
122
- * outage (unlike a Redis blip, which is why the burst throttle fails OPEN instead).
128
+ * outage (unlike a Redis blip, which is why the burst throttle counts in process instead of refusing
129
+ * everyone, #3275).
123
130
  *
124
131
  * ## Overage tolerance
125
132
  *
@@ -52,6 +52,27 @@ export interface ActorExecutionContinuation<T = unknown> {
52
52
  * CALENDAR clock in an application with no `reviewCalendar`, and a host whose actor store cannot keep the clocks.
53
53
  */
54
54
  readonly deadlines?: ReviewDeadlinesDeclaration;
55
+ /**
56
+ * Whether an answer to this system's questions must carry a fresh step-up proof bound to the question (#2923), as an
57
+ * operation approval's `requiresApproval.requiresStepUpAuthentication` does. The person re-proves a factor
58
+ * (`POST /auth/reauth` with a `decisionBinding` naming the question and the presentation they answer) and answers from
59
+ * the decision inbox with it in `X-Reauth-Token`; a chat answer carries none and is refused. Armed on each ROUTED
60
+ * question when it is raised (the ones the inbox answers, as `deadlines` are) and stored with it, so a change to this
61
+ * declaration never changes what a waiting question requires. The engine also refuses to settle such a question for any
62
+ * door whose decider shows no step-up meeting it.
63
+ */
64
+ readonly requiresStepUpAuthentication?: boolean;
65
+ /**
66
+ * What that step-up must ALSO be (#2923), with `requiresStepUpAuthentication: true`; startup refuses it without:
67
+ * `maximumAgeSeconds` (at most 300) since the factor was proven, and a `minimumAssurance` of `reproven`, `possession`
68
+ * or `phishing_resistant`. The factor and the instant it was proven are recorded on the decision and its approval seal.
69
+ */
70
+ readonly stepUp?: HumanDecision_StepUpRequirement;
71
+ /**
72
+ * The channels that may answer this system's routed questions (#2923): `web_session`, `chat`, `api_client`. Armed and
73
+ * stored with each question like its step-up. `chat` is refused beside a step-up.
74
+ */
75
+ readonly answerChannels?: HumanDecision_AnswerChannels;
55
76
  /** Continue the run with the person's answer. Runs as the run's executor, under the run's work attribution. */
56
77
  continue(input: ActorExecutionContinuationInput): Promise<T>;
57
78
  /** How the continuation's result is read: whether it asks again, and how it concluded. */
@@ -12,7 +12,11 @@
12
12
  /**
13
13
  * The contract `backend-api/src/saas-config.backend.ts` default-exports.
14
14
  *
15
- * Import path: `@wildo-ai/saas-backend-lib`.
15
+ * Import path: `@wildo-ai/saas-backend-lib`, as `import type { AppConfiguration_BackendAuthored }`. Take the
16
+ * vocabularies the file names (`Argon2Type`, `AuthenticatorAttachment`, `UserVerification`, `AttestationType`,
17
+ * `TotpAlgorithm`, `CimdTrustPolicy`) from `@wildo-ai/saas-models`: every website build evaluates this file to read
18
+ * which public documents the application serves, and a VALUE imported from the backend library makes that read load
19
+ * the whole library.
16
20
  *
17
21
  * A DEEP-PARTIAL of the backend-authored managed sections — but several
18
22
  * branches are REQUIRED WITH NO ENGINE DEFAULT, so omitting them does not
@@ -25,7 +25,7 @@ export interface ApplicationInitializationAssemblyInput {
25
25
  | 'productDefinitions'
26
26
  | 'notificationBadgeDefinitions'
27
27
  >;
28
- backendRegistry: Pick<BackendDomainModule, 'operations' | 'controllers' | 'flowsActors' | 'pdfTemplateBindings' | 'pdfCollectionExportTemplates' | 'chartDefinitions' | 'seeds' | 'dataSeedScopeResolvers' | 'inboundHandlers' | 'humanDecisionNoticeHandler' | 'chatReplyHandlers' | 'operationApprovalResolvers'>;
28
+ backendRegistry: Pick<BackendDomainModule, 'operations' | 'controllers' | 'flowsActors' | 'pdfTemplateBindings' | 'pdfCollectionExportTemplates' | 'chartDefinitions' | 'seeds' | 'dataSeedScopeResolvers' | 'inboundHandlers' | 'humanDecisionNoticeHandler' | 'chatReplyHandlers' | 'operationApprovalResolvers' | 'externalEffectCompensators'>;
29
29
  defaultFlowsActorsRegistry?: ApplicationInitializationConfig['flowsActorsRegistry'];
30
30
  defaultCustomLabels?: ApplicationInitializationConfig['customLabels'];
31
31
  defaultBackendProviderRegistry?: ApplicationInitializationConfig['backendProviderRegistry'];
@@ -31,7 +31,10 @@
31
31
  *
32
32
  * SEMANTICS. Every requested role must lie within the caller's EFFECTIVE authority — the union of the
33
33
  * `inheritFrom` hierarchies of the roles the caller actually holds, each expanded within the scope of
34
- * the membership that granted it. Hierarchy-awareness is not a convenience: with the default table
34
+ * the membership that granted it, plus every application-declared role whose whole authority is within a held
35
+ * role's (a custom role off the core chain, such as a supervisor inheriting `ORG_MANAGER`, which an `ORG_OWNER`
36
+ * may grant when every operation, approval or decision route and action naming the supervisor also admits the owner,
37
+ * measured against the live registries by `AuthorizationsBackendService.getRolesWithinAuthority`). Hierarchy-awareness is not a convenience: with the default table
35
38
  * (`ORG_OWNER → ORG_ADMIN → ORG_MANAGER → ORG_MEMBER → ORG_GUEST`) an `ORG_ADMIN`'s membership row
36
39
  * holds the literal string `ORG_ADMIN` and nothing else, so a raw set-membership test would reject
37
40
  * that admin granting the DEFAULT `ORG_MEMBER` role and break the entire invite flow — while still
@@ -56,6 +59,13 @@
56
59
  * `createAsSystem`) is the framework itself, not a user principal (it synthesises a super-admin
57
60
  * system EC), and carries no human ceiling — it is trusted to assign any role.
58
61
  *
62
+ * ONE RULE, SHARED WITH THE FORMS (#3248). The ceiling itself is `resolveRoleGrantCeiling` in
63
+ * `@wildo-ai/saas-models`, which this gate calls with the live role tables and a role-offering form calls with the same
64
+ * tables and the backend's own role entries, so the form and this gate make the same ceiling decision (a form that knew
65
+ * less offered `ORG_OWNER` to an `ORG_ADMIN`, and picking it answered 403). The form decides from the role entries it
66
+ * loaded with the session, so a role changed since can still be refused here, and the write's other checks (a role the
67
+ * organization's type does not offer) still apply: the gate stays the control.
68
+ *
59
69
  * SCOPE OF THE COMPARISON. Only the roles the caller holds IN the organization the write acts inside
60
70
  * (`executionContext.organizationId`) are counted, plus their APPLICATION roles. Until 2026-09-25 the
61
71
  * roles were unioned across every membership, on the stated premise that the authorization layer had
@@ -68,6 +78,8 @@
68
78
  * `roles` field is caller-settable, passing the roles AS AUTHORED BY THE CALLER — not the
69
79
  * post-resolution set. Framework-injected defaults (e.g. an organization type's `defaultMemberRole`)
70
80
  * are policy-derived, not a caller request, and must not be measured against the caller's ceiling.
81
+ * Declare the field `.isRoleGrant()` in the same change: a form then offers only the roles the person filling it may
82
+ * grant (plus any the record already holds), decided by this same rule, instead of offering roles this gate refuses.
71
83
  *
72
84
  * THE REFUSAL IS RECORDED — as a `RESOURCE_OPERATION_DENIED` audit event with
73
85
  * `denialReason: role_ceiling_exceeded`, carrying the roles that were refused. A privilege-escalation
@@ -16,7 +16,10 @@
16
16
  *
17
17
  * A prefix that authors a server-owned field (one marked `.excludeFromCreate()` /
18
18
  * `.excludeFromUpdate()`) relies on `preserveServerInjectedFields` to carry that value past the
19
- * repository's strict `requestDto` re-parse. That allow-list is normally derived by diffing the
19
+ * repository's strict `requestDto` re-parse. So does a prefix that sets a value BELOW a field: the
20
+ * request contract strips an `.isBackendOnly()` field at every depth, so the re-parse of the
21
+ * containing field drops what the prefix put there. Declare the TOP-LEVEL field that contains it
22
+ * (an SSO connection's prefix parses `saml.x509Certificates` from a PEM, and declares `saml`). That allow-list is normally derived by diffing the
20
23
  * prefix output against a snapshot of the payload keys taken BEFORE the prefix ran, so only keys
21
24
  * the hook *introduced* are preserved — which is what stops a client smuggling a value into a
22
25
  * field it may not write.
@@ -0,0 +1,38 @@
1
+ # saas.backend.custom-operation.core-write-precondition
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-backend-lib`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
10
+
11
+ ```typescript
12
+ /**
13
+ * What the row must still hold for the CORE write to land, per field (`{ status: ['ACTIVE'] }`). Folded into the single
14
+ * statement that writes, beside what the operation's `enabledCondition` read, so a concurrent writer that moved the row
15
+ * since the prefix judged it makes this write match nothing, and the caller gets 409 `version_conflict`.
16
+ * Declare it when the PREFIX judges the row's state (a status transition's starting states): it holds on every path the
17
+ * registration runs on, including one no `enabledCondition` guards. On a bulk variant it holds for every selected row,
18
+ * and one row that no longer does refuses the whole selection.
19
+ *
20
+ * It holds for every caller of the registration, and `updateAsSystem` resolves the operation's default. So when the system
21
+ * must still write a row a person may not (bookkeeping on a closed record), declare an `INTERNAL_CALL` default beside the
22
+ * `API_CALL` one and register this on the route: the service tier prefers an internal default, so the system door reaches
23
+ * neither the hook nor the fence, while a route, an MCP tool, a function tool and a chat command dispatch by path. What the
24
+ * route declares (`referenceConstraints`, its request) stays the route's: the internal variant declares none of it.
25
+ * The doors that resolve the default reach the internal variant whoever's context they carry, so on such a resource none of
26
+ * them may run a person's write: an in-process `servicesRegistry.update()` (use `doByOperationPath`), a declared flow's
27
+ * `update` step, and a nested `childOperations` mutation. An inbound channel's `ctx.resources.update` is refused there.
28
+ */
29
+ coreWritePrecondition?: AdmissionWritePrecondition;
30
+ /**
31
+ * The core write lands only on the row at the version the hooks read. Declare it when the PREFIX computes the write from
32
+ * the row and no field states what it judged: it rewrites a whole array (`domains[]`), which a field pin cannot guard.
33
+ * A concurrent writer of ANY field then refuses this write with 409 `version_conflict`, so prefer
34
+ * `coreWritePrecondition` wherever a field does state it. Beside it, not instead: a guarded mutation moves a field without
35
+ * advancing the version. Refused on an OVERRIDE_ALL implementation, which runs no core write.
36
+ */
37
+ coreWritePinsRowVersion?: true;
38
+ ```
@@ -0,0 +1,109 @@
1
+ # saas.backend.custom-operation.external-effect-reservation
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-backend-lib`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
10
+
11
+ ```typescript
12
+ /** The provider metadata key a reserved object carries when its provider mints the id, so a lost one can be found. */
13
+ export const EXTERNAL_EFFECT_RESERVATION_METADATA_KEY = 'wildoExternalEffectReservation';
14
+ ```
15
+
16
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
17
+
18
+ ```typescript
19
+ /** What an application's compensator is given beside the object's id. */
20
+ export interface ApplicationExternalEffectCompensationContext {
21
+ /**
22
+ * The application's container, to resolve the client that undoes the object. Resolve it here, on use: the compensator
23
+ * is declared in a module file, before the container is populated.
24
+ */
25
+ readonly container: Container;
26
+ /** The reservation being settled, for the application's logs. */
27
+ readonly reservationId: string;
28
+ }
29
+
30
+ /**
31
+ * Undo ONE provider object an application's operation created, by its id. Idempotent: an object already gone is the state
32
+ * asked for, so treat the provider's "not found" as done. Throw on any other failure: the reservation is kept and the next
33
+ * settlement calls it again.
34
+ */
35
+ export type ApplicationExternalEffectCompensator = (providerObjectId: string, context: ApplicationExternalEffectCompensationContext) => Promise<void>;
36
+
37
+ /**
38
+ * An application's compensators, keyed by its OWN compensation kinds: declared in a backend module's
39
+ * `externalEffectCompensators`. Key it by an enum the application owns, and write it `satisfies Record<MyKind, …>` so a kind
40
+ * added without its compensator fails to compile.
41
+ */
42
+ export type ApplicationExternalEffectCompensators = Readonly<Record<string, ApplicationExternalEffectCompensator>>;
43
+ ```
44
+
45
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
46
+
47
+ ```typescript
48
+ /** What every reservation declares before its provider call, whoever undoes it. */
49
+ export interface ExternalEffectReservationRequestBase {
50
+ /** The operation reserving it, for the logs. */
51
+ readonly operationResourceType: string;
52
+ readonly operationIdentifier: string;
53
+ /** The resource and field whose row names the object once the operation landed. */
54
+ readonly ownerResourceType: string;
55
+ readonly ownerField: string;
56
+ /** The reservation id, when the caller derived the provider object's id from it before reserving. */
57
+ readonly reservationId?: string;
58
+ /** The object's id, when the caller chose it (derived from {@link reservationId}); else recorded with `identify`. */
59
+ readonly providerObjectId?: string;
60
+ }
61
+
62
+ /** A reservation the ENGINE undoes, by one of its own kinds. */
63
+ export interface EngineExternalEffectReservationRequest extends ExternalEffectReservationRequestBase {
64
+ readonly kind: EngineExternalEffectCompensationKind;
65
+ /** None: an engine kind names no application kind (a reservation row carries null here). */
66
+ readonly applicationCompensationKind?: null;
67
+ }
68
+
69
+ /**
70
+ * A reservation the APPLICATION undoes (#3446): `applicationCompensationKind` is a key of a backend module's
71
+ * `externalEffectCompensators`. A kind no module declares is refused before anything is written.
72
+ */
73
+ export interface ApplicationExternalEffectReservationRequest extends ExternalEffectReservationRequestBase {
74
+ readonly applicationCompensationKind: string;
75
+ readonly kind?: never;
76
+ }
77
+
78
+ /** What a prefix declares before its provider call. */
79
+ export type ExternalEffectReservationRequest = EngineExternalEffectReservationRequest | ApplicationExternalEffectReservationRequest;
80
+
81
+ /** What the prefix holds after reserving. */
82
+ export interface ExternalEffectReservationHandle {
83
+ readonly reservationId: string;
84
+ /** Record the id the provider minted, as soon as it answered. Throws when the store refuses. */
85
+ identify(providerObjectId: string): Promise<void>;
86
+ /** Delete the reservation: the provider call certainly created nothing. Never throws; a reservation left is settled later. */
87
+ release(): Promise<void>;
88
+ }
89
+
90
+ /** Mint a reservation id before reserving, so a provider object's id can be derived from it: 24 hex characters, safe inside one. */
91
+ export function mintExternalEffectReservationId(): string {
92
+ return randomBytes(12).toString('hex');
93
+ }
94
+ ```
95
+
96
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
97
+
98
+ ```typescript
99
+ /**
100
+ * Record an external effect BEFORE making it (#3441). Written in its own write, never in a transaction, so it survives the
101
+ * failure it exists for. Throws when the store refuses, and the caller must then make no provider call. A custom
102
+ * implementation passes its `utils`, which carry both dependencies. An `applicationCompensationKind` no backend module
103
+ * declares is refused here, before anything is written (#3446).
104
+ */
105
+ export async function reserveExternalEffect(
106
+ deps: { readonly repositoriesRegistry: ApplicationRepositoriesRegistry; readonly logger: ExternalEffectReservationDeps['logger'] },
107
+ request: ExternalEffectReservationRequest,
108
+ ): Promise<ExternalEffectReservationHandle>
109
+ ```