@wildo-ai/framework-knowledge 1.1.3 → 1.1.5

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 (841) hide show
  1. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  2. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  3. package/dist/esm/framework-knowledge.definitions.js +349 -17
  4. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  5. package/dist/esm/framework-knowledge.loader.d.ts +19 -0
  6. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  7. package/dist/esm/framework-knowledge.loader.js +47 -1
  8. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  9. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  10. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
  11. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  12. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +125 -0
  13. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
  14. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
  15. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
  16. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
  17. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  18. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +326 -8
  19. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  20. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +5 -3
  21. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  22. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +21 -14
  23. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
  25. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
  26. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
  27. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
  28. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
  29. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
  30. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
  31. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
  32. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
  33. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
  34. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
  35. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
  36. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
  37. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +10 -5
  39. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
  41. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
  42. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
  43. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
  44. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
  45. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
  47. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +67 -0
  49. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
  50. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
  51. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
  52. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
  53. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
  54. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
  55. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
  56. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
  57. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
  58. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +71 -0
  60. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
  61. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
  62. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
  63. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
  64. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
  65. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
  66. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
  67. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
  68. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
  69. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
  70. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
  71. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
  72. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
  74. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +171 -1
  76. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +146 -1
  78. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
  80. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
  81. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
  82. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
  83. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
  84. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  85. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +172 -4
  86. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  87. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
  88. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  89. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +8 -7
  90. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  91. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
  92. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  93. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +22 -3
  94. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  95. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +5 -3
  96. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +21 -12
  98. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  99. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +192 -27
  100. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  101. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +172 -33
  102. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  103. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +2 -1
  104. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  105. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +6 -2
  106. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  107. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +182 -5
  108. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  109. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +191 -5
  110. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  111. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +2 -1
  112. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  113. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +3 -2
  114. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  115. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +154 -0
  116. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
  117. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
  118. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
  119. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
  120. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
  121. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
  122. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
  123. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
  124. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  125. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +2 -1
  126. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  127. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
  128. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  129. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +6 -2
  130. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  131. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
  132. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  133. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +2 -1
  134. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  135. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
  136. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  137. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -3
  138. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  139. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +32 -4
  140. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  141. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +27 -3
  142. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  143. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -2
  144. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  145. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +4 -2
  146. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  147. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
  148. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
  149. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
  150. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
  151. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
  152. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  153. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +18 -4
  154. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
  156. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  157. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -4
  158. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  159. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +6 -5
  160. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  161. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +18 -17
  162. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  163. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  164. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
  165. package/dist/knowledge/manifest.json +9 -8
  166. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
  167. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
  168. package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
  169. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
  170. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
  171. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
  172. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
  173. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
  174. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
  175. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
  176. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
  177. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
  178. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
  179. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
  180. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
  181. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
  182. package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
  183. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
  184. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
  185. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
  186. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
  187. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
  188. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
  189. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
  190. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
  191. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
  192. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
  193. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
  194. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
  195. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
  196. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
  197. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
  198. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
  199. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
  200. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
  201. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
  202. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
  203. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
  204. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
  205. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
  206. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
  207. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
  208. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
  209. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
  210. package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
  211. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
  212. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
  213. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
  214. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
  215. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
  216. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
  217. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
  218. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
  219. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
  220. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
  221. package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
  222. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
  223. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
  224. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
  225. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
  226. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
  227. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
  228. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
  229. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
  230. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
  231. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
  232. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
  233. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
  234. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
  235. package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
  236. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
  237. package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
  238. package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
  239. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
  240. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
  241. package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
  242. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
  243. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
  244. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
  245. package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
  246. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
  247. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
  248. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
  249. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
  250. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
  251. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  252. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  253. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
  254. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
  255. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
  256. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
  257. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
  258. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
  259. package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
  260. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
  261. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
  262. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
  263. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
  264. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
  265. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
  266. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
  267. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
  268. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
  269. package/dist/knowledge/references/acp.execution-profile.md +266 -0
  270. package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
  271. package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
  272. package/dist/knowledge/references/acp.permission-escalation.md +37 -0
  273. package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
  274. package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
  275. package/dist/knowledge/references/application-maturity.config.md +319 -0
  276. package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
  277. package/dist/knowledge/references/assertions.specification.config.md +1 -1
  278. package/dist/knowledge/references/brand.asset.config.md +8 -16
  279. package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
  280. package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
  281. package/dist/knowledge/references/brand.snapshot.config.md +16 -2
  282. package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
  283. package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
  284. package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
  285. package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
  286. package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
  287. package/dist/knowledge/references/capability-composition.config.md +155 -0
  288. package/dist/knowledge/references/cli.market.utils.md +1 -0
  289. package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
  290. package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
  291. package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
  292. package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
  293. package/dist/knowledge/references/engine.saas-website.config.md +22 -10
  294. package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
  295. package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
  296. package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
  297. package/dist/knowledge/references/example.config.design-system.full.md +3 -0
  298. package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
  299. package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
  300. package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
  301. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
  302. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
  303. package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
  304. package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
  305. package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
  306. package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
  307. package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
  308. package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
  309. package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
  310. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
  311. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
  312. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
  313. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
  314. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
  315. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
  316. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
  317. package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
  318. package/dist/knowledge/references/example.worker.node-route.md +94 -0
  319. package/dist/knowledge/references/experience-plan.config.md +311 -0
  320. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
  321. package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
  322. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
  323. package/dist/knowledge/references/integration-plan.config.md +185 -0
  324. package/dist/knowledge/references/market.alternative.config.md +1 -1
  325. package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
  326. package/dist/knowledge/references/market.channel.config.md +3 -3
  327. package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
  328. package/dist/knowledge/references/market.gain.config.md +1 -1
  329. package/dist/knowledge/references/market.icp.config.md +2 -2
  330. package/dist/knowledge/references/market.job.config.md +1 -1
  331. package/dist/knowledge/references/market.message-template.config.md +2 -2
  332. package/dist/knowledge/references/market.objection.config.md +1 -1
  333. package/dist/knowledge/references/market.pain.config.md +1 -1
  334. package/dist/knowledge/references/market.persona.config.md +2 -2
  335. package/dist/knowledge/references/market.proof.config.md +1 -1
  336. package/dist/knowledge/references/market.snapshot.validation.md +15 -0
  337. package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
  338. package/dist/knowledge/references/market.trigger.config.md +1 -1
  339. package/dist/knowledge/references/minions.tick-contract.md +83 -0
  340. package/dist/knowledge/references/placement-plan.config.md +369 -0
  341. package/dist/knowledge/references/platform.config.application-database.md +5 -2
  342. package/dist/knowledge/references/platform.config.backing-services.md +0 -21
  343. package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
  344. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
  345. package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
  346. package/dist/knowledge/references/platform.config.saas.md +261 -9
  347. package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
  348. package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
  349. package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
  350. package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
  351. package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
  352. package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
  353. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
  354. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
  355. package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
  356. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
  357. package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
  358. package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
  359. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
  360. package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
  361. package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
  362. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
  363. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
  364. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
  365. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
  366. package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
  367. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
  368. package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
  369. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
  370. package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
  371. package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
  372. package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
  373. package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
  374. package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
  375. package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
  376. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
  377. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
  378. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
  379. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
  380. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
  381. package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
  382. package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
  383. package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
  384. package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
  385. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
  386. package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
  387. package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
  388. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
  389. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
  390. package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
  391. package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
  392. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
  393. package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
  394. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
  395. package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
  396. package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
  397. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
  398. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
  399. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
  400. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
  401. package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
  402. package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
  403. package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
  404. package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
  405. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
  406. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
  407. package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
  408. package/dist/knowledge/references/saas.models.config.registration.md +188 -0
  409. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
  410. package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
  411. package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
  412. package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
  413. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
  414. package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
  415. package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
  416. package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
  417. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
  418. package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
  419. package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
  420. package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
  421. package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
  422. package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
  423. package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
  424. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
  425. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
  426. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
  427. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
  428. package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
  429. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
  430. package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
  431. package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
  432. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
  433. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
  434. package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
  435. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
  436. package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
  437. package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
  438. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
  439. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
  440. package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
  441. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
  442. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
  443. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
  444. package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
  445. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
  446. package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
  447. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
  448. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
  449. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
  450. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
  451. package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
  452. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
  453. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
  454. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
  455. package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
  456. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
  457. package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
  458. package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
  459. package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
  460. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
  461. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
  462. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
  463. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
  464. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
  465. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
  466. package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
  467. package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
  468. package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
  469. package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
  470. package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
  471. package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
  472. package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
  473. package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
  474. package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
  475. package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
  476. package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
  477. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
  478. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
  479. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
  480. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
  481. package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
  482. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
  483. package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
  484. package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
  485. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
  486. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
  487. package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
  488. package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
  489. package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
  490. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
  491. package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
  492. package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
  493. package/dist/knowledge/references/saas.website.consent.context.md +162 -0
  494. package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
  495. package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
  496. package/dist/knowledge/references/saas.website.page.context.md +4 -3
  497. package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
  498. package/dist/knowledge/references/saas.website.section.context.md +3 -2
  499. package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
  500. package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
  501. package/dist/knowledge/references/website-plan.config.md +205 -0
  502. package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
  503. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
  504. package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
  505. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
  506. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
  507. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
  508. package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
  509. package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
  510. package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
  511. package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
  512. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
  513. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
  514. package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
  515. package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
  516. package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
  517. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
  518. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
  519. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
  520. package/dist/knowledge/references/zod.factories.address.md +118 -0
  521. package/dist/knowledge/references/zod.factories.code.md +2 -0
  522. package/dist/knowledge/references/zod.factories.duration.md +2 -0
  523. package/dist/knowledge/references/zod.factories.money.md +2 -0
  524. package/dist/knowledge/references/zod.factories.phone.md +14 -1
  525. package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
  526. package/dist/knowledge/registries/framework-topics.json +1215 -11
  527. package/dist/knowledge/registries/playbooks.json +454 -50
  528. package/dist/knowledge/registries/source-tags.json +3153 -1043
  529. package/dist/knowledge/rules/database-migration-obligation.md +110 -0
  530. package/dist/knowledge/rules/live-context-door.md +108 -0
  531. package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
  532. package/dist/knowledge/skills/INDEX.md +46 -11
  533. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
  534. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
  535. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
  536. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
  537. package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
  538. package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
  539. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
  540. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
  541. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
  542. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
  543. package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
  544. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
  545. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
  546. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
  547. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
  548. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
  549. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
  550. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
  551. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
  552. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
  553. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
  554. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
  555. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
  556. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
  557. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
  558. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
  559. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
  560. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
  561. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
  562. package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
  563. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
  564. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
  565. package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
  566. package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
  567. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
  568. package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
  569. package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
  570. package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
  571. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
  572. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
  573. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
  574. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
  575. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
  576. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
  577. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
  578. package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
  579. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
  580. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
  581. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
  582. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
  583. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
  584. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
  585. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
  586. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
  587. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
  588. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
  589. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
  590. package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
  591. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
  592. package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
  593. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
  594. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
  595. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
  596. package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
  597. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
  598. package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
  599. package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
  600. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
  601. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
  602. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
  603. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
  604. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
  605. package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
  606. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
  607. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
  608. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
  609. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
  610. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
  611. package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
  612. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
  613. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
  614. package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
  615. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
  616. package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
  617. package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
  618. package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
  619. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
  620. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
  621. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
  622. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
  623. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
  624. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
  625. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
  626. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
  627. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
  628. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
  629. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
  630. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
  631. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
  632. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
  633. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
  634. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
  635. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
  636. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
  637. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
  638. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
  639. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
  640. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
  641. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
  642. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
  643. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
  644. package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
  645. package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
  646. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
  647. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
  648. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
  649. package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
  650. package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
  651. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
  652. package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
  653. package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
  654. package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
  655. package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
  656. package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
  657. package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
  658. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
  659. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
  660. package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
  661. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
  662. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
  663. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
  664. package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
  665. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
  666. package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
  667. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
  668. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
  669. package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
  670. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
  671. package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
  672. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
  673. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
  674. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
  675. package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
  676. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
  677. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
  678. package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
  679. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
  680. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
  681. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
  682. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
  683. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
  684. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
  685. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
  686. package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
  687. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
  688. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
  689. package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
  690. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
  691. package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
  692. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
  693. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
  694. package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
  695. package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
  696. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
  697. package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
  698. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
  699. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
  700. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
  701. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
  702. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
  703. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
  704. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
  705. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
  706. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
  707. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
  708. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
  709. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
  710. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
  711. package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
  712. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
  713. package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
  714. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
  715. package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
  716. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
  717. package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
  718. package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
  719. package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
  720. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
  721. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
  722. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
  723. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
  724. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
  725. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
  726. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
  727. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
  728. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
  729. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
  730. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
  731. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
  732. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
  733. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
  734. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
  735. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
  736. package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
  737. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
  738. package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
  739. package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
  740. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
  741. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
  742. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
  743. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
  744. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
  745. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
  746. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
  747. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
  748. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
  749. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
  750. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
  751. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
  752. package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
  753. package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
  754. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
  755. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
  756. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
  757. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
  758. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
  759. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
  760. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
  761. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
  762. package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
  763. package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
  764. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
  765. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
  766. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
  767. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
  768. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
  769. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
  770. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
  771. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
  772. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
  773. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
  774. package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
  775. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
  776. package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
  777. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
  778. package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
  779. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
  780. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
  781. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
  782. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
  783. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
  784. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
  785. package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
  786. package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
  787. package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
  788. package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
  789. package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
  790. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
  791. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
  792. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
  793. package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
  794. package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
  795. package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
  796. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
  797. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
  798. package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
  799. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
  800. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
  801. package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
  802. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
  803. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
  804. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
  805. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
  806. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
  807. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
  808. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
  809. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
  810. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
  811. package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
  812. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
  813. package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
  814. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
  815. package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
  816. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
  817. package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
  818. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
  819. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
  820. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
  821. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
  822. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
  823. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
  824. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
  825. package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
  826. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
  827. package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
  828. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
  829. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
  830. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
  831. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
  832. package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
  833. package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
  834. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
  835. package/dist/knowledge/topic-index.json +5335 -1010
  836. package/dist/tsconfig.build.tsbuildinfo +1 -1
  837. package/dist/tsconfig.tsbuildinfo +1 -1
  838. package/package.json +4 -4
  839. package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
  840. package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
  841. /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
@@ -0,0 +1,493 @@
1
+ # Framework Background Work API
2
+
3
+ How an application runs work outside a request, and the architectural distinction that decides
4
+ how it scales.
5
+
6
+ ## ⚠️ Queue consumers are not a separate tier
7
+
8
+ They run **inside each backend API pod**. Every pod both enqueues jobs and consumes them.
9
+
10
+ **So scaling job processing means scaling the BACKEND.** There is no worker tier to grow.
11
+
12
+ And the name that misleads: a declared `workers:` entry is **not** a queue consumer. It is a
13
+ standalone HTTP service the backend CALLS — it never connects to the broker, has no database and no
14
+ cache, and cannot read or write application resources except through what the caller puts in the
15
+ request. Adding one adds no queue capacity whatsoever.
16
+
17
+ ## Choose the execution shape
18
+
19
+ | Shape | Declared as | Scheduling / invocation | Business execution |
20
+ |---|---|---|---|
21
+ | **scheduled operation** | a `CRON_JOB` operation variant with a `cronExpression` (and `resourceOperationLike`) | Platform scheduler publishes a signed instruction to the application scheduled queue | Application backend queue consumer executes the resource operation |
22
+ | **scheduled custom batch** | A custom batch registered during backend initialization, with `cronJobExpression` and validated `cronJobInput` | Startup synchronizes the registered schedule; the platform publishes a signed `batchRef` instruction | Application backend resolves and executes the registered batch |
23
+ | **queued job** | an operation's service runtime mode set to queued, or a custom batch enqueued by reference | Enqueued into the application queue | Application backend pods host the consumers |
24
+ | **worker** | `workers:` in `wildo.saas.config.ts` + its own `wildo.worker.config.ts` (port, probe paths) | Backend calls its HTTP endpoint | Its own HTTP service |
25
+ | **cron-mode minion** | `minions:` in `wildo.saas.config.ts` with `resourceAccess` and `platformAccess.scopes`; `mode: 'cron'` in its own `wildo.minion.config.ts` | Platform scheduler sends a tick to the named minion's dedicated queue | That minion's own runtime invokes its tick handler |
26
+ | **always-up minion** | `minions:` in the application config and `mode: 'always-up'` in its package config; omit `schedule` | No recurring platform schedule; ongoing work needs an implementation in the runtime | The separate minion process; mode selection does not create an automatic `onTick` loop |
27
+
28
+ The platform owns the clock and signed dispatch, not execution of the application's
29
+ business handler. A scheduled custom batch identified by `batchRef` uses the
30
+ application's scheduled queue too; the backend executes that batch. Cron-mode minion ticks
31
+ use separate per-minion queues so backend consumers do not compete for them.
32
+ Scaling backend queue consumers and scaling minion runtimes are different decisions.
33
+
34
+ A Node worker registers routes with `defineWorkerInit`; a worker in another language implements the
35
+ same probe paths and token verification itself. A cron-mode minion package calls `defineMinionInit`
36
+ with its own name and a tick handler. Minion config also supports `always-up`; the scheduler-driven
37
+ row above describes only `cron` mode. A cron declaration requires `schedule`; always-up rejects it.
38
+ Both modes initialize the headless backend and subscribe to their dedicated tick queue. Under normal
39
+ operation, always-up receives no scheduler ticks. `onTick` is called for a verified incoming tick,
40
+ not repeatedly because the mode is always-up. Implement and manage any ongoing work explicitly;
41
+ a configuration fragment alone does not provide a running work loop.
42
+
43
+ Registered custom batches are discovered from the running backend’s batch registry. Merely listing
44
+ a batch in a descriptive manifest does not bind its implementation. Its configured scheduled input
45
+ must pass its input schema and resolve to a record before synchronization. That validation rejects
46
+ invalid configuration; it does not guarantee the later business execution succeeds.
47
+
48
+ ## What the engine already enqueues for you
49
+
50
+ Outbound webhooks, audit export delivery, agent push delivery and email fan-out all publish a job
51
+ rather than working inline. You reach the same runtime by declaring a custom batch and enqueueing it
52
+ by reference.
53
+
54
+ The queued service runtime mode is also an authoring surface for application operations. Choose it
55
+ according to the operation’s execution contract; the built-in enqueue paths are examples, not an
56
+ exclusive list of consumers.
57
+
58
+ ## Tune a queued operation
59
+
60
+ Declare `queueConfig` beside `serviceRuntimeMode` on the operation, outside `variants`.
61
+ The resource factory validates the declaration, fills omitted defaults and shares the policy with
62
+ its generated variants. Use `timeoutMs` for the caller's reply deadline; expiry does not cancel work.
63
+ Set `maxRetries` for additional attempts after failure, and `retryConfig` for their backoff.
64
+ `priority` selects the initial queue lane; it is not a guarantee that retries retain that lane.
65
+ A zero retry budget does not prevent broker redelivery after a connection interruption.
66
+
67
+ ## Import Origins
68
+
69
+ - `@wildo-ai/saas-models`
70
+
71
+ ## Source Excerpts
72
+
73
+ ### Origin Package: `@wildo-ai/saas-models`
74
+
75
+ ```typescript
76
+ *
77
+ * Queue policy for an operation declared with createResourceConfiguration_Initialization
78
+ * from @wildo-ai/saas-models. Set queueConfig beside serviceRuntimeMode, outside variants.
79
+ * Omitted fields take the schema defaults. timeoutMs limits caller waiting, not execution.
80
+ * Priority selects the initial queue lane; retries do not promise permanent priority ordering.
81
+ * maxRetries limits additional attempts after an actual failure, not duplicate broker deliveries.
82
+ *
83
+ * @example
84
+ * // Inside an operation configuration:
85
+ * // serviceRuntimeMode: ResourceOperation_ServiceRuntimeMode.QUEUED,
86
+ * // queueConfig: { timeoutMs: 30000, maxRetries: 0 },
87
+ */
88
+ export const ResourceConfiguration_QueueConfigSchema = z.object({
89
+ /** Priority for queue routing (HIGH/CRITICAL → priority queue) */
90
+ priority: z.enum(JobPriority).default(JobPriority.NORMAL),
91
+
92
+ /** Maximum retry attempts before dead-letter */
93
+ maxRetries: z.number().int().min(0).default(3),
94
+
95
+ /** Caller reply-wait deadline in milliseconds (default: 5 minutes). Does not cancel worker execution. */
96
+ timeoutMs: z.number().int().min(1000).max(2147483647).default(300000),
97
+
98
+ /**
99
+ * Retry backoff timing (base delay, cap, curve). Controls how long a failed
100
+ * job of this operation waits before each re-attempt. Optional — unset fields
101
+ * fall back to `QUEUE_RETRY_DEFAULTS`. Honored by the queue worker via a
102
+ * durable broker delay queue (see `QueueRetryBackoffConfig`). Distinct from
103
+ * `maxRetries` (how many attempts) and `timeoutMs` (caller reply-wait deadline).
104
+ */
105
+ retryConfig: QueueRetryBackoffConfigSchema.optional(),
106
+
107
+ }).strict().optional();
108
+
109
+ export type ResourceConfiguration_QueueConfig = z.infer<typeof ResourceConfiguration_QueueConfigSchema>;
110
+
111
+ /** Application input accepts omitted defaulted fields; the resource factory validates and resolves them. */
112
+ export type ResourceConfiguration_QueueConfigAuthored = z.input<typeof ResourceConfiguration_QueueConfigSchema>;
113
+ ```
114
+
115
+ ## Operate scheduled work without confusing dispatch with completion
116
+
117
+ Automatic resource-cron, registered custom-batch and cron-minion extraction sends UTC expressions.
118
+ Their declarations do not acquire local-time or daylight-saving behavior from the scheduler's
119
+ lower-level timezone support. The authenticated application jobs-sync API can submit an explicit
120
+ timezone and update schedules while the application runs. A full sync replaces that application's
121
+ declared job set, including withdrawing omitted jobs; do not send a one-job fragment as if it were
122
+ a patch. Source-file edits alone are not watched by this path: normal declaration changes reach the
123
+ scheduler through application startup synchronization. The scheduler periodically reconciles the
124
+ accepted active job set and its timezones.
125
+
126
+ Scheduler replicas coordinate through a shared lease. The leader arms schedules and checks ownership
127
+ before dispatch; this does not make the receiving business handler exactly-once. Deployment
128
+ replacement policy does not serialize cron handlers. A publisher can race with takeover after checking its lease. Replicas derive the same scheduled occurrence ID, and receiving runtimes atomically admit that occurrence through durable execution history. This prevents duplicate admission; recovery after worker loss still needs effect-level idempotency or reconciliation. Distinct scheduled occurrences remain separate work, so business keys must also prevent cross-occurrence duplication where necessary.
129
+
130
+ | Evidence or failure | Application-builder consequence |
131
+ |---|---|
132
+ | Startup sync accepted | The platform knows the submitted job set; it does not prove a tick ran. A failed configured sync retries without failing application startup; an uninitialized or unconfigured sync is skipped, not repaired by waiting. |
133
+ | Destination queue absent | Start or repair its owning backend/minion and queue topology. The scheduler checks the queue instead of inventing its declaration. |
134
+ | Scheduler run marked `PUBLISHED` | Dispatch reached the broker; verify the receiving handler and its business effect separately. |
135
+ | Queued tick expires | A token has a five-minute lifetime, with 30 seconds of verifier clock tolerance. An old queued instruction cannot authorize work indefinitely. |
136
+ | Backend verification fails | The consumer rejects before persistence or execution. |
137
+ | Authenticated handler fails or loses contact | Durable execution history owns recovery according to the local handler contract. Default behavior preserves an unresolved review record; there is no automatic retry without declared safety. |
138
+ | Minion tick fails | The same durable recovery contract applies in its dedicated application/minion queue. A later cron occurrence is fresh work, not replay of the failed operation. |
139
+
140
+ After an outage, identify missing business effects before triggering catch-up. Reusing an expired
141
+ token cannot recover them. Broker redelivery reuses the occurrence record. Recovery is driven from persisted due work after startup, independently of broker redelivery or expired JWTs.
142
+
143
+ A minion declared with the `OWN_CRON_RECORDS` platform-access scope can read its own schedule and
144
+ recent run history through its authenticated runtime surface. A token alone is insufficient: the
145
+ service checks that scope. The attestation confines the read to both application and minion name; a matching name in another
146
+ application grants no visibility. This diagnoses scheduling and publication, not business completion.
147
+ For a missing dispatch, also inspect the application's broker virtual host and publishing permission;
148
+ the scheduler backs off rejected hosts rather than probing them on every tick.
149
+
150
+
151
+ ## Declare scheduled recovery on the handler that owns the effects
152
+
153
+ Use `scheduledRecovery` on a CRON_JOB or BATCH_JOB variant, or on the arguments to `createCustomBatchExecutionService`. A minion declares `tickRecovery` beside `onTick` in `defineMinionInit`. These are local implementation contracts, not deployment overrides or message-supplied permissions.
154
+
155
+ - `MANUAL` is the default: an error may follow a committed effect, so the runtime records uncertainty rather than repeating it.
156
+ - `IDEMPOTENT` permits bounded recovery after worker loss. Choose it only when the complete handler tolerates repetition, including external calls and individual items in a batch.
157
+ - `RECONCILE` invokes `reconcileScheduled` (operation registration/custom batch) or `reconcileTick` (minion). It returns `COMPLETED` with optional serialized evidence, `SAFE_TO_RETRY`, or `INCONCLUSIVE`. Missing evidence or an error does not authorize replay.
158
+
159
+ `retryReportedFailures` is separate from recovery after lost contact. Turning it on requires idempotent effects or reconciliation, and explicit nonretryable framework errors still stop automatic retry. `maxAttempts` counts initial execution, further executions and reconciliation admissions together; `maxRecoveryMs` starts at the first verified receipt and never resets. Use `backoff` and `jitterRatio` to bound retry pressure. For example, a four-admission reconcile budget may cover execution, reconciliation, execution and one final reconciliation.
160
+
161
+ ```typescript
162
+ import { ScheduledReplaySafety } from '@wildo-ai/saas-models';
163
+
164
+ const scheduledRecovery = {
165
+ contractVersion: '1',
166
+ replaySafety: ScheduledReplaySafety.IDEMPOTENT,
167
+ retryReportedFailures: true,
168
+ maxAttempts: 4,
169
+ maxRecoveryMs: 60 * 60 * 1000,
170
+ leaseMs: 60_000,
171
+ backoff: { baseDelayMs: 2000, maxDelayMs: 30_000 },
172
+ jitterRatio: 0.2,
173
+ };
174
+ ```
175
+
176
+ This declaration does not itself make an effect idempotent. Use a business identifier (for example an invoice ID) for a provider idempotency key when the same effect can be reached from different cron occurrences. Execution receives a stable `occurrenceId` and distinct `attemptId`/`attemptNumber`: custom batches use `utilities.scheduledAttempt`, resource implementations use `utils.serviceOptions.scheduledAttempt`, and minions use `context.scheduledAttempt`. The minion's first argument is a `MinionTickInvocation` containing business identity/input, publication time `createdAt` and optional cron occurrence time `scheduledAt`, not a reusable signed JWT. The occurrence time survives recovery; independent manual invocations leave it absent. Do not substitute publication time for the scheduled instant when assessing run timing or coverage.
177
+
178
+ A heartbeat expiry means lost contact, not cancellation. A slow or partitioned worker may still reach a provider. State fencing prevents its late database completion from overwriting another attempt, but only effect-level idempotency or reconciliation protects the external system. A changed `contractVersion` or policy moves outstanding recovery to review rather than silently adopting new replay permissions.
179
+
180
+ ## Resolve uncertain work explicitly
181
+
182
+ The initialized `JobConsumerBackendService.resolveScheduledReview` and `MinionTickConsumerBackendService.resolveTickReview` expose trusted backend administration methods. Call them from an application operation that has already authorized its operator; these methods do not add an HTTP endpoint or perform that application's role checks. They derive application/queue ownership from the initialized runtime, require an expected revision, and persist actor, reason and decision with the state transition.
183
+
184
+ ```typescript
185
+ import { ScheduledReviewOutcome } from '@wildo-ai/saas-models';
186
+
187
+ // Inside your already-authorized operator operation; consumer is the injected runtime service.
188
+ await consumer.resolveScheduledReview({
189
+ jobId: selectedOccurrence.jobId,
190
+ expectedRevision: selectedOccurrence.scheduledState.revision,
191
+ actor: authenticatedOperatorId,
192
+ reason: 'Verified the provider receipt against the business record.',
193
+ outcome: ScheduledReviewOutcome.CONFIRM_COMPLETED,
194
+ resultJson: JSON.stringify(verifiedReceipt),
195
+ });
196
+ ```
197
+
198
+ `RETRY` preserves identity and the declared safety/budget; it does not override an unsafe handler. If no attempt ever began because a handler was absent, an attributed decision can admit its first execution with the now-present contract, without extending the original deadline. `ABANDON` closes the occurrence as unsuccessful instead of fabricating completion. Use that decision when the work must not run; start a genuinely new business invocation only deliberately.
199
+
200
+ Unresolved scheduled claims have no automatic expiry. Terminal scheduled history is retained through its replay horizon and normal history period. Ordinary queue history still expires after 30 days; result payload retention remains separate. This is operational history, not a long-term assurance archive.
201
+
202
+ Minions require framework database grants for their execution ledger and retained results even without authored business-resource access. The platform grants execution-history insert/update (not delete) and result read/append separately from business resource permissions. Existing minions lacking database principals need normal provisioning to acquire these grants; credential rotation does not create a previously absent principal.
203
+
204
+ ## Retain selected scheduled evidence
205
+
206
+ Operational history is not a period-covering archive. Opt in on the **backend application configuration** with `scheduledEvidence.batches`, `.operations` or `.minions`, keyed by exact registered batch reference, operation path key or minion name. The same policy mechanism covers built-in batches; do not replace their implementation just to retain evidence. Unselected targets retain their normal operational lifetime. Unknown keys produce startup diagnostics and do not select another target.
207
+
208
+ ```typescript
209
+ import type { ScheduledEvidencePolicy } from '@wildo-ai/saas-models';
210
+
211
+ // Illustrative duration only: choose and document the period your application actually requires.
212
+ const selectedRunEvidence = {
213
+ policyRef: 'application/background-evidence/v1',
214
+ retainForMs: 90 * 24 * 60 * 60 * 1000,
215
+ resultFields: ['affected', 'deferred'],
216
+ deferredField: 'deferred',
217
+ } satisfies ScheduledEvidencePolicy;
218
+
219
+ // In the existing authored backend configuration:
220
+ const scheduledEvidence = {
221
+ batches: { 'your-registered-batch-ref': selectedRunEvidence },
222
+ };
223
+ ```
224
+
225
+ A selected policy requires a reference and finite duration (one day through ten years); no duration is assumed. A policy replacement replaces the whole target policy instead of inheriting omitted fields. Each occurrence captures its policy at admission, so subsequent configuration edits do not rewrite old evidence or its expiry. An unavailable handler may bind policy when an attributed operator admits its first execution.
226
+
227
+ Only the selected top-level scalar output fields enter retained evidence: at most 32 fields, with strings limited to 512 characters. Choose counters or receipt identifiers rather than personal data. Nested objects, missing fields or unsuitable values are reported as unavailable evidence; they are not replaced with zero. An explicit boolean deferral field distinguishes a successful invocation with deferred work from a run that completed all intended work. No raw request, unselected output or exception text is copied into the archive.
228
+
229
+ After the terminal execution transition, `JobPayloadStorageBackendService` stores the selected result and occurrence metadata in the existing payload resource. Archival failure retries independently without rerunning the business action. Pending archival has the ordinary operational-history expiry: a longer storage outage can leave a gap, rather than extending custody of raw input indefinitely. Archive expiry is original completion plus the captured duration; retries cannot extend it. Reads refuse expired evidence before physical TTL cleanup. Operator confirmation, abandonment and reconciliation remain visibly distinct from observed execution.
230
+
231
+ ## Assess a retained period
232
+
233
+ `assessScheduledEvidenceCoverage` from `@wildo-ai/saas-backend-lib` consumes the existing payload and job-tracking services. Call it from an authorized backend reporting operation; it is not a public authorization endpoint. Supply the application, exact queue/target, `[from,to)` period, start-delay tolerance and **accepted historical schedule segments**, each with effective dates, cron expression, timezone, enabled status and authority reference. Current defaults and observed runs cannot reconstruct missing schedule history.
234
+
235
+ The report separates retained occurrence coverage from invocation success, selected-result availability, deferred business work and first-execution timeliness. Missing historical authority or future windows are unknown. Missing retained occurrences, duplicate jobs at an expected instant and saturated bounds are incomplete. A successful zero-effect run remains evidence. Unknown scheduled timestamps remain unknown, selected by publication interval, and cannot fill an expected slot. The same occurrence found in operational and archive stores is counted once. The report retains the supplied authority references; callers must preserve and verify that historical basis before using it in an assurance claim.
236
+
237
+ ## Import Origins
238
+
239
+ - `@wildo-ai/saas-models`
240
+
241
+ ## Source Excerpts
242
+
243
+ ### Origin Package: `@wildo-ai/saas-models`
244
+
245
+ ```typescript
246
+ /** First receipt is short-lived; persisted recovery has its own policy deadline. */
247
+ export const SCHEDULED_INITIAL_ADMISSION_MAX_AGE_MS = 5 * 60 * 1000;
248
+ export const SCHEDULED_INITIAL_ADMISSION_FUTURE_SKEW_MS = 30 * 1000;
249
+
250
+ /** How the handler's complete effects tolerate execution after an uncertain outcome. */
251
+ export enum ScheduledReplaySafety {
252
+ /** No automatic repetition; a failed call can already have committed effects. */
253
+ MANUAL = 'manual',
254
+ /** All effects use stable business keys or equivalent idempotency mechanisms. */
255
+ IDEMPOTENT = 'idempotent',
256
+ /** A backend reconciler must establish completion or safety before repetition. */
257
+ RECONCILE = 'reconcile',
258
+ }
259
+
260
+ /** Durable admission phase, independent from the presentation status of a job. */
261
+ export enum ScheduledExecutionPhase {
262
+ READY = 'ready',
263
+ RUNNING = 'running',
264
+ RECONCILING = 'reconciling',
265
+ WAITING = 'waiting',
266
+ REVIEW = 'review',
267
+ FINISHED = 'finished',
268
+ }
269
+
270
+ export enum ScheduledReconciliationOutcome {
271
+ COMPLETED = 'completed',
272
+ SAFE_TO_RETRY = 'safe_to_retry',
273
+ INCONCLUSIVE = 'inconclusive',
274
+ }
275
+
276
+ /** Operator decisions are distinct from evidence returned by a handler's reconciler. */
277
+ export enum ScheduledReviewOutcome {
278
+ CONFIRM_COMPLETED = 'confirm_completed',
279
+ RETRY = 'retry',
280
+ ABANDON = 'abandon',
281
+ }
282
+
283
+ /** A declaration is a contract, not a mechanism that makes side effects idempotent. */
284
+ export const ScheduledRecoveryPolicySchema = z.object({
285
+ contractVersion: z.string().min(1).default('1'),
286
+ replaySafety: z.enum(ScheduledReplaySafety).default(ScheduledReplaySafety.MANUAL),
287
+ retryReportedFailures: z.boolean().default(false),
288
+ /** Total admissions, including reconciliation; initial execution consumes one. */
289
+ maxAttempts: z.number().int().min(1).max(100).default(1),
290
+ /** Elapsed horizon from first authenticated receipt, never extended by recovery. */
291
+ maxRecoveryMs: z.number().int().min(1000).max(30 * 24 * 60 * 60 * 1000).default(24 * 60 * 60 * 1000),
292
+ /** Heartbeat lease: expiry means contact was lost, not that the old worker stopped. */
293
+ leaseMs: z.number().int().min(3000).max(60 * 60 * 1000).default(60000),
294
+ backoff: QueueRetryBackoffConfigSchema.optional(),
295
+ jitterRatio: z.number().min(0).max(1).default(0.2),
296
+ }).superRefine((policy, ctx) => {
297
+ if (policy.retryReportedFailures && policy.replaySafety === ScheduledReplaySafety.MANUAL) {
298
+ ctx.addIssue({ code: 'custom', path: ['retryReportedFailures'], message: 'Automatic retry requires idempotent effects or reconciliation.' });
299
+ }
300
+ });
301
+ export type ScheduledRecoveryPolicy = z.infer<typeof ScheduledRecoveryPolicySchema>;
302
+ export function normalizeScheduledRecoveryPolicy(policy?: Partial<ScheduledRecoveryPolicy>): ScheduledRecoveryPolicy {
303
+ return ScheduledRecoveryPolicySchema.parse(policy ?? {});
304
+ }
305
+
306
+ /** Finite, application-owned evidence policy. No policy means no long-term projection. */
307
+ export const ScheduledEvidencePolicySchema = z.object({
308
+ policyRef: z.string().trim().min(1).max(160),
309
+ /** Absolute expiry is completion plus this duration, never the date an archive retry succeeds. */
310
+ retainForMs: z.number().int().min(86400000).max(3650 * 86400000),
311
+ /** Only these top-level scalar result fields may enter retained evidence. */
312
+ resultFields: z.array(z.string().regex(/^[A-Za-z][A-Za-z0-9_]*$/).max(80)).max(32),
313
+ /** Selected boolean flag identifying deferred business work independently from invocation success. */
314
+ deferredField: z.string().min(1).optional(),
315
+ }).superRefine((policy, ctx) => {
316
+ if (new Set(policy.resultFields).size !== policy.resultFields.length) ctx.addIssue({ code: 'custom', message: 'Evidence result fields must be unique' });
317
+ if (policy.deferredField && !policy.resultFields.includes(policy.deferredField)) {
318
+ ctx.addIssue({ code: 'custom', path: ['deferredField'], message: 'Deferred flag must be a selected result field' });
319
+ }
320
+ });
321
+ export type ScheduledEvidencePolicy = z.infer<typeof ScheduledEvidencePolicySchema>;
322
+
323
+ export enum ScheduledEvidenceSource {
324
+ EXECUTION = 'execution',
325
+ RECONCILIATION = 'reconciliation',
326
+ OPERATOR_CONFIRMATION = 'operator_confirmation',
327
+ ABANDONMENT = 'abandonment',
328
+ }
329
+ export enum ScheduledEvidenceResultStatus {
330
+ CAPTURED = 'captured',
331
+ UNAVAILABLE = 'unavailable',
332
+ }
333
+
334
+ /**
335
+ * Bounded projection, not arbitrary job input, output or exception text.
336
+ *
337
+ * `applicationId` is the application RECORD id (`applications._id`), projected from the job row it
338
+ * describes — never the platform id the wire payload carried. The coverage report refuses a record
339
+ * whose value differs from its scope, so a copy of this field retained under the wrong id is not
340
+ * merely stale: it makes every window that reaches it fail (the follow-up migration of #1296).
341
+ */
342
+ const ScheduledRunEvidenceFieldsSchema = z.object({
343
+ jobId: z.uuid(), applicationId: z.string().min(1), queueName: z.string().min(1),
344
+ jobType: z.enum(JobType), batchRef: z.string().optional(), operationPathKey: z.string().optional(), minionName: z.string().optional(),
345
+ scheduledAt: z.date().optional(), publishedAt: z.date(), startedAt: z.date().optional(), completedAt: z.date(), expiresAt: z.date(),
346
+ invocationStatus: z.enum(JobExecutionStatus), source: z.enum(ScheduledEvidenceSource),
347
+ attemptCount: z.number().int().nonnegative(), policy: ScheduledEvidencePolicySchema,
348
+ resultStatus: z.enum(ScheduledEvidenceResultStatus), deferred: z.boolean().optional(),
349
+ results: z.record(z.string(), z.union([z.string().max(512), z.number().finite(), z.boolean(), z.null()])),
350
+ });
351
+ export const ScheduledRunEvidenceSchema = ScheduledRunEvidenceFieldsSchema.superRefine((evidence, ctx) => {
352
+ const targetCount = [evidence.batchRef, evidence.operationPathKey, evidence.minionName].filter(value => value !== undefined).length;
353
+ if (targetCount !== 1 || (evidence.jobType === JobType.MINION_TICK ? !evidence.minionName
354
+ : evidence.jobType !== JobType.SCHEDULED_CRON || !(evidence.batchRef || evidence.operationPathKey))) {
355
+ ctx.addIssue({ code: 'custom', message: 'Evidence requires exactly one scheduled batch, operation or minion target' });
356
+ }
357
+ const expectedStatus = evidence.source === ScheduledEvidenceSource.ABANDONMENT ? JobExecutionStatus.FAILED : JobExecutionStatus.COMPLETED;
358
+ if (evidence.invocationStatus !== expectedStatus) {
359
+ ctx.addIssue({ code: 'custom', path: ['invocationStatus'], message: 'Terminal outcome must agree with evidence source' });
360
+ }
361
+
362
+ if (evidence.expiresAt.getTime() !== evidence.completedAt.getTime() + evidence.policy.retainForMs) {
363
+ ctx.addIssue({ code: 'custom', path: ['expiresAt'], message: 'Evidence expiry must follow the captured policy and original completion' });
364
+ }
365
+ const fields = Object.keys(evidence.results);
366
+ if (fields.some(field => !evidence.policy.resultFields.includes(field))) {
367
+ ctx.addIssue({ code: 'custom', path: ['results'], message: 'Only policy-selected result fields may be retained' });
368
+ }
369
+ if (evidence.resultStatus === ScheduledEvidenceResultStatus.CAPTURED && evidence.policy.resultFields.some(field => !Object.hasOwn(evidence.results, field))) {
370
+ ctx.addIssue({ code: 'custom', path: ['resultStatus'], message: 'Captured evidence requires every selected field' });
371
+ }
372
+ const selectedDeferred = evidence.policy.deferredField ? evidence.results[evidence.policy.deferredField] : undefined;
373
+ if (evidence.deferred !== (typeof selectedDeferred === 'boolean' ? selectedDeferred : undefined)
374
+ || (evidence.resultStatus === ScheduledEvidenceResultStatus.CAPTURED && evidence.policy.deferredField && typeof selectedDeferred !== 'boolean')) {
375
+ ctx.addIssue({ code: 'custom', path: ['deferred'], message: 'Deferral must agree with the selected boolean result' });
376
+ }
377
+ });
378
+ export type ScheduledRunEvidence = z.infer<typeof ScheduledRunEvidenceSchema>;
379
+
380
+ /** Stable occurrence identity and distinct attempt identity made available to handler code. */
381
+ export interface ScheduledAttemptContext {
382
+ occurrenceId: string;
383
+ attemptId: string;
384
+ attemptNumber: number;
385
+ }
386
+ export interface ScheduledReconciliationResult {
387
+ outcome: ScheduledReconciliationOutcome;
388
+ resultJson?: string;
389
+ }
390
+ ```
391
+
392
+ ## Background Work Topology
393
+
394
+ ## Import Origins
395
+
396
+ - `@wildo-ai/saas-backend-lib`
397
+
398
+ ## Source Excerpts
399
+
400
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
401
+
402
+ ```typescript
403
+ *
404
+ * Where an application's background jobs actually run.
405
+ *
406
+ * ⚠️ **Queue consumers are NOT a separate tier.** They run inside each backend API pod, so every pod
407
+ * both ENQUEUES jobs (as an API handler) and CONSUMES them (as a worker). The consequence is the one
408
+ * that matters when a queue backs up: **scaling job processing means scaling the BACKEND**, not
409
+ * adding worker processes.
410
+ *
411
+ * ⚠️ **A declared `workers:` entry is a different thing entirely, and its name misleads.** That is a
412
+ * standalone HTTP service the backend CALLS — it never connects to the broker, has no database and
413
+ * no cache, and cannot read or write application resources except through what the caller puts in the
414
+ * request. Adding one does not add queue capacity.
415
+ *
416
+ * Queue Worker Initializer Backend Service
417
+ *
418
+ * Initializes queue workers within the backend API application.
419
+ *
420
+ * This service is called during application startup to:
421
+ * 1. Connect to RabbitMQ
422
+ * 2. Start job consumers for operations queues
423
+ * 3. Start monitoring
424
+ * 4. Register graceful shutdown handlers
425
+ *
426
+ * Every backend API pod can both:
427
+ * - Enqueue jobs (as API handlers)
428
+ * - Consume and execute jobs (as workers)
429
+ *
430
+ ```
431
+
432
+ ## Declaring a scheduled operation
433
+
434
+ `cronExpression` on a `CRON_JOB` variant is where the schedule is written, and the four things it does
435
+ not tell you are below.
436
+
437
+ ## Import Origins
438
+
439
+ - `@wildo-ai/saas-models`
440
+
441
+ ## Source Excerpts
442
+
443
+ ### Origin Package: `@wildo-ai/saas-models`
444
+
445
+ ```typescript
446
+ *
447
+ * A CRON_JOB variant — the declaration that makes an operation run on a schedule.
448
+ *
449
+ * The job does not run inside your application's own process on a timer. Your application PUBLISHES
450
+ * its declared schedules to the platform scheduler at startup, and the scheduler later delivers a
451
+ * signed tick back onto your application's queue. Four consequences follow, and none of them is
452
+ * visible from this type:
453
+ *
454
+ * **This declaration is interpreted in UTC.** There is no timezone field here: automatic resource
455
+ * schedule extraction sends `UTC`. `'0 3 * * *'` is 03:00 UTC wherever your users are. The lower-level
456
+ * authenticated jobs-sync API supports an explicit timezone; that does not give this declaration
457
+ * local-time or daylight-saving behavior.
458
+ *
459
+ * **Editing this declaration takes effect through startup synchronization.** There is no file watch
460
+ * that retimes a running application's jobs when its source changes. The lower-level synchronization
461
+ * API can update jobs while the application is running; its full replacement contract is distinct
462
+ * from this declaration-driven startup path. Keep one owner for the complete submitted schedule set.
463
+ *
464
+ * **A failed sync does not fail startup.** The application boots, one capped in-process retry is kept
465
+ * pending, and until it succeeds the scheduler keeps running the schedule it was last given. So a
466
+ * retimed job that appears not to have moved is the expected shape of a sync that has not landed yet,
467
+ * not a broken expression.
468
+ *
469
+ * **The scheduler records that it PUBLISHED the tick, never that your application ran it.** A tick
470
+ * that reached the broker and then failed inside the application still reads as a successful run on
471
+ * the scheduler's side, so verify a scheduled job by its effect in your own storage rather than by
472
+ * the platform's execution record.
473
+ */
474
+ type ResourceConfiguration_OperationVariant_CronJob_BuilderParameters = ResourceConfiguration_OperationVariant_Base & {
475
+ /** Recovery contract for this exact scheduled handler; undeclared effects require manual review after an unknown outcome. */
476
+ scheduledRecovery?: Partial<ScheduledRecoveryPolicy>;
477
+ variantType : ResourceOperationVariantType.CRON_JOB,
478
+ /** Standard five-field cron expression, interpreted in UTC. See the note above this type. */
479
+ cronExpression: string,
480
+ /**
481
+ * Explicit response contract for a CRON_JOB custom operation whose return shape
482
+ * is NOT the resource row implied by `resourceOperationLike`. A scheduled
483
+ * generator/sweeper (e.g. a recurring-occurrence generator) borrows a core verb
484
+ * (UPDATE/CREATE) for its repo/DTO semantics but returns a RUN SUMMARY, not an
485
+ * occurrence. The factory already reads `customResponseDto` off any variant
486
+ * params (`resources-config.shared.factory.ts`) and warns when a borrowed-verb
487
+ * custom op omits it — this exposes it on the CRON_JOB params so the cron op can
488
+ * declare its true return shape instead of inheriting the verb's occurrence
489
+ * -shaped envelope (which the executor would reject the summary against).
490
+ */
491
+ customResponseDto?: z.ZodSchema<any>,
492
+ }
493
+ ```
@@ -0,0 +1,153 @@
1
+ # Framework Capability Resolution API
2
+
3
+ How the engine picks which provider fulfils an `EngineCapability` when an application declares more
4
+ than one — and the one sentence that belongs beside every provider selection you author.
5
+
6
+ ## ⚠️ `whenUnavailable` is not a failover list
7
+
8
+ For a `SELECT_ONE` capability — billing, email, observability, language models, nearly everything —
9
+ at most one provider is active: the first eligible ref after applying the selection order.
10
+
11
+ `whenUnavailable` orders eligible substitutes after the primary. Remaining eligible providers follow
12
+ those policy refs, so an invalid primary does not empty an otherwise nonempty eligible set.
13
+ Eligibility requires the registered provider to declare the capability and the active runtime scope
14
+ to declare it for that provider. Resolution does not test credentials, protocol enablement or vendor health. Without a
15
+ selection policy, configured providers sort first and remaining refs sort by name; missing provider
16
+ configuration alone is not an eligibility filter.
17
+
18
+ **Nothing retries a second provider when a call to the first one FAILS.** The call raises the
19
+ primary's error and stops. So:
20
+
21
+ - do not read a declared `whenUnavailable` entry as redundancy;
22
+ - do not size an availability argument on it;
23
+ - an application that wants call-time failover builds it at its own call site, per capability. That
24
+ is a deliberate framework boundary, not an omission.
25
+
26
+ The field was renamed from `fallbacks` on 2026-09-08 precisely because that name promised what it
27
+ does not do. Notes and configs older than that may still use the old name.
28
+
29
+ ## `FAN_OUT` is the other shape
30
+
31
+ The eligible providers form an additive set — no primary or substitutes. The compliance audit
32
+ consumer attempts each configured destination independently. A sink can fail; failure handling and
33
+ recovery belong to that consumer and sink, rather than to provider selection.
34
+
35
+ The mode is a declared property of the capability, not a per-consumer convention, and the config
36
+ validators branch on it — so a `FAN_OUT` capability is validated by DECLARATION and never keyed off
37
+ `selection`.
38
+
39
+ ## Capability Resolution Mode
40
+
41
+ ## Import Origins
42
+
43
+ - `@wildo-ai/saas-models`
44
+
45
+ ## Source Excerpts
46
+
47
+ ### Origin Package: `@wildo-ai/saas-models`
48
+
49
+ ```typescript
50
+ *
51
+ * How the engine resolves the provider(s) fulfilling an `EngineCapability`
52
+ * when more than one is declared for the same scope.
53
+ *
54
+ * This is a FIRST-CLASS, declared property of a capability — NOT an implicit
55
+ * per-consumer convention. A reader can tell whether a capability picks one
56
+ * provider or writes to all of them; a new capability author declares it
57
+ * here; and both the runtime registry resolver and the `defineSaaSProviders`
58
+ * config validators branch on it (so a `FAN_OUT` capability is validated by
59
+ * DECLARATION and never keyed off `selection`).
60
+ */
61
+ export enum EngineCapabilityResolutionMode {
62
+ /**
63
+ * At most one active provider: the first eligible ref after selection ordering. The default for every capability
64
+ * (billing, email, observability, …), and a request is served by that one provider.
65
+ *
66
+ * ⚠️ `whenUnavailable` is NOT a failover list, and the field was renamed from `fallbacks` on
67
+ * 2026-09-08 precisely because that name promised one. It names ORDERED SUBSTITUTES for a
68
+ * primary that is not eligible in the active runtime scope. Eligible policy refs come first;
69
+ * remaining eligible providers follow, so an invalid primary does not empty that set.
70
+ * Eligibility requires a registered module declaring the capability and an active scope
71
+ * declaration for it; resolution does not validate credentials or vendor health. Nothing
72
+ * retries a second provider when a call to the first one FAILS: the send raises the primary's
73
+ * error and stops.
74
+ *
75
+ * So do not read a declared `whenUnavailable` entry as redundancy, and do not size an
76
+ * availability argument on it. An application that wants call-time failover builds it at its own
77
+ * call site, per capability — a deliberate framework boundary, not an omission.
78
+ */
79
+ SELECT_ONE = 'SELECT_ONE',
80
+ /**
81
+ * ALL declared providers are active simultaneously — every one receives
82
+ * every emission (no primary, no failover). For sinks whose nature is
83
+ * additive rather than substitutable: `COMPLIANCE_AUDIT_TRAIL` writes each
84
+ * audit event to every configured destination.
85
+ */
86
+ FAN_OUT = 'FAN_OUT',
87
+ }
88
+ ```
89
+
90
+ ## Which capabilities refuse to boot when nothing serves them
91
+
92
+ Three do. Every other enabled-but-unserved slot fails where the feature is used instead, which is why
93
+ trying one of them teaches the wrong rule.
94
+
95
+ ## Import Origins
96
+
97
+ - `@wildo-ai/saas-models`
98
+
99
+ ## Source Excerpts
100
+
101
+ ### Origin Package: `@wildo-ai/saas-models`
102
+
103
+ ```typescript
104
+ /**
105
+ * Engine capabilities that REQUIRE a resolved provider the moment an
106
+ * application ENABLES them — the engine-level MAIN floor (#328).
107
+ *
108
+ * The asymmetry is the thing to carry away: **enabling a capability with nothing serving it fails at
109
+ * BOOT for these three and at the point of USE for every other slot.** So an author who tries one
110
+ * unserved slot, sees the application come up, and concludes that an unserved capability degrades
111
+ * gracefully has learned the wrong rule from the larger half of the vocabulary.
112
+ *
113
+ * `EngineCapabilityActivation.required` is the application's decision;
114
+ * this set is the ENGINE's: for each member, an enabled capability with no
115
+ * provider is not a degraded mode but a boot-time misconfiguration, because
116
+ * an engine flow the application already relies on fails at first use:
117
+ *
118
+ * - `EMAIL_TRANSACTIONAL` — invitations, address verification and password
119
+ * reset are engine flows that send mail; with no provider they fail
120
+ * silently at the moment a user needs them.
121
+ * - `BILLING` — `initializeBillingServices` already fails loud with no
122
+ * provider; the floor names it in the same place as the others.
123
+ * - `SMS` — phone verification and MFA-by-SMS are engine flows.
124
+ *
125
+ * DELIBERATELY ABSENT, with the reason each would need to overturn:
126
+ * - the `AI_*` slots — consumed per feature (an agent, the logo generator)
127
+ * and legitimately served on a DIFFERENT host (the companion reaches image
128
+ * generation; the backend need not), so "enabled with no backend provider"
129
+ * is a normal topology, not a fault. A feature that needs one refuses at
130
+ * its own site.
131
+ * - the sinks (`COMPLIANCE_AUDIT_TRAIL`, `LLM_OBSERVABILITY`,
132
+ * `OBSERVABILITY_TELEMETRY`) — fail-OPEN by design (the G4 reconcile
133
+ * warns), because Layer-1 persistence is unaffected.
134
+ * - `EMAIL_MARKETING` — a campaign feature, not an engine flow.
135
+ * - the `FRONTEND_*` slots — resolved by the frontend facet, invisible to
136
+ * the backend registry that evaluates this floor.
137
+ * - `ORGANIZATIONS` and `MULTI_LANGUAGE` — no provider token maps to them,
138
+ * deliberately and by declaration; see
139
+ * `ENGINE_CAPABILITIES_WITH_NO_PROVIDER_CAPABILITY`. A floor requiring a
140
+ * resolved provider for a slot nothing can fill would refuse every boot that
141
+ * enabled them. (`BILLING_PAYMENTS` was named here too until it was withdrawn
142
+ * from the enum on 2026-09-09.)
143
+ *
144
+ * The floor runs only on a host expected to SERVE these slots (see
145
+ * `ApplicationRuntimeProfileBootAssertions.assertsEngineCapabilityProviderFloor`);
146
+ * a minion's scope-filtered registry legitimately resolves none of them.
147
+ */
148
+ export const ENGINE_CAPABILITIES_REQUIRING_A_PROVIDER_WHEN_ENABLED: ReadonlySet<EngineCapability> = new Set([
149
+ EngineCapability.EMAIL_TRANSACTIONAL,
150
+ EngineCapability.BILLING,
151
+ EngineCapability.SMS,
152
+ ]);
153
+ ```